Cadastro de Transportadora

Regras de negócio

As principais funções do transporte na logística estão ligadas basicamente às dimensões de tempo e utilidade do lugar. O transporte de mercadorias é utilizado para disponibilizar produtos onde existe demanda potencial, dentro do prazo adequado às necessidades do comprador.
O parceiro transportador está vinculado à ordem de carga utilizada para entregar o item do apontamento de entrega.Quando você efetuar a marcação sistema "transportadora própria", estará indicando que o parceiro é ou possui a própria transportadora e, portanto, não será gerado pedido de frete para a conclusão da ordem de despacho.
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/360044594494-Cadastro-de-Parceiros#abainformaes

Dependências

No cadastro de parceiro, a cidade deve constar no cadastro do ERP Sankhya-Om.

Caso não seja informado o CPF ou CNPJ no campo CGC_CPF, deve se informar no campo CLASSIFICMS como("C" - Consumidor Final Não Contribuinte ou P-Produtor Rural).
Para cadastro de Transportadora, basta acrescentar o campo "TRANSPORTADORA" no corpo da requisição do JSON indicando "S" para Sim para indicar que o parceiro é transportadora.

Detalhes Técnicos

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

• TIPPESSOA – Pessoa Física ou Jurídica;
• NOMEPARC – Nome do Parceiro;
• CODCID – Código de cidade;
• ATIVO – Parceiro ativo(S - Sim ou N - Não);
• TRANSPORTADORA – Parceiro é transportadora(S - Sim ou N - Não);
• CLASSIFICMS – ("C" - Consumidor Final Não Contribuinte ou P-Produtor Rural).


Descritivo de campos da entidade

Acesse aqui o dicionário de dados da tabela TGFPAR
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":"Parceiro",
         "includePresentationFields":"S",
         "dataRow":{
            "localFields":{
               "TIPPESSOA":{
                  "$":"F"
               },               
               "NOMEPARC":{
                  "$":"JON SNOW"
               },               
               "CODCID":{
                  "$":"10"
               },               
               "ATIVO":{
                  "$":"S"
               },
                "TRANSPORTADORA":{
                    "$":"S"
                },
                "CLASSIFICMS":{
                    "$":"C"
                }
            }
         }, "entity":{
            "fieldset":{
               "list":"CODPARC,TIPPESSOA,NOMEPARC,CODCID,ATIVO,TRANSPORTADORA,CLASSIFICMS"
            }
         }
      }
   }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.saveRecord",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "F58A5ED2A26C41F5536A63B7DB34FAE8",
    "responseBody": {
        "entities": {
            "total": "1",
            "entity": {
                "TIPPESSOA": {
                    "$": "F"
                },
                "ATIVO": {
                    "$": "S"
                },
                "NOMEPARC": {
                    "$": "JON SNOW"
                },
                "CLASSIFICMS": {
                    "$": "C"
                },
                "CODPARC": {
                    "$": "567"
                },
                "CODCID": {
                    "$": "10"
                },
                "TRANSPORTADORA": {
                    "$": "S"
                },
                "Cidade_NOMECID": {
                    "$": "TESTE"
                }
            }
        }
    }
}
Language
Click Try It! to start a request and see the response here!