post https://api.sankhya.com.br/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 TGFPARExemplo 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"
}
}
}
}
}