Inserir região

Insere uma região ao Sankhya ERP através da API de serviços

Parâmetros

Parâmetros de configuração.

Campo	Tipo	Descrição
Conta de serviço	Select	Permite o acesso ao sistema através de credenciais fornecidas no painel de contas do Floui.
Nome da região	String	Define o nome da região.
Código da região	String	Define o código da unidade federativa.
Código da região pai	String	Define o código da região pai já definida no sistema.
Campos adicionais	String	Nome do campo, usado como chave. E valor, usado como dados de inserção.
Retorno em modo simplificado	Select	Retorna os dados de resultado da consulta em modo simplificado ao invés da resposta padrão da Sankhya.
Output path	String	Armazena os dados de saída do conector ao final da execução.
Descrição	String	Mensagem visual para descrever a função do conector no contexto do fluxo.

Cadastro de Regiões

post

Regras de negócio

O cadastro de regiões no sistema ERP possibilita o fracionamento de determinado espaço geográfico em regiões, facilitando, por exemplo, a cobrança de frete de acordo com a região e a definição de áreas de atuação de vendedores.
OBS: Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:
https://ajuda.sankhya.com.br/hc/pt-br/articles/360044599074-Regi%C3%B5es

Dependências

Para realizar a importação do cadastro, deve ser informado o código da Região pai correspondente, por exemplo: Região Triângulo mineiro -> Região pai Minas Gerais.

Caso não exista a região pai cadastrada, basta cadastrá-la no cadastro de regiões.

Detalhes Técnicos

A entidade utilizada é a Regiao que por sua vez instancia a tabela TSIREG mapeando os campos principais pertinentes ao cadastro de produto.
Para realizar a importação do cadastro de região através do Json, os campos abaixo são obrigatórios:

• NOMEREG – Nome da região;
• CODREG – Código da Região;
• CODREGPAI – Código da Região pai;

IMPORTANTE: Consultar no sistema Sankhya-Om os códigos das Regiões do cadastro para região pai.

Descritivo de campos da entidade

Acesse aqui o dicionário de dados da tabela TSIREG

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=CRUDServiceProvider.saveRecord&outputType=json

Corpo de requisição

{  "serviceName":"CRUDServiceProvider.saveRecord",
   "requestBody":{
      "dataSet":{
         "rootEntity":"Regiao",
         "includePresentationFields":"N",
         "dataRow":{
            "localFields":{
               "CODREG":{
                  "$":"10999"
               }, 
               "NOMEREG":{
                  "$":"3 B's do TRIÂNGULO"
               },
               "CODREGPAI":{
                   "$":"10100"
               }
            }
         }, "entity":{
            "fieldset":{
               "list":"CODREG,NOMEREG,CODREGPAI"
            }
         }
      }
   }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.saveRecord",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "5695FD3A24469EEC772295A2B8C2E5BC",
    "responseBody": {
        "entities": {
            "total": "1",
            "entity": {
                "CODREG": {
                    "$": "10999"
                },
                "CODREGPAI": {
                    "$": "10000"
                },
                "NOMEREG": {
                    "$": "3 B's do TRIÂNGULO"
                }
            }
        }
    }
}

Responses

201

Cadastro efetuado com sucesso

No content

400

Requisição inválida

500

Erro interno do servidor

post/Regiao

POST /Regiao HTTP/1.1
Accept: */*

No content