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"
                }
            }
        }
    }
}