post https://api.sankhya.com.br/Fornecedor
Regras de negócio
O cadastro de fornecedores no sistema ERP visa realizar controle de gestão que definirá as funções do parceiro no sistema.Quando você incluir um novo registro do tipo fornecedor ou mesmo duplicar algum já existente ao salvar este novo registro, o sistema mantém tais opções desmarcadas, ou seja, o novo cadastro não terá seu tipo definido automaticamente.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
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 Fornecedores, basta acrescentar o campo "FORNECEDOR"no corpo da requisição do JSON indicando "S" para Sim para indicar que o parceiro é fornecedor.
Detalhes Técnicos
A entidade utilizada é a Parceiro que por sua vez instancia a tabela TGFPAR mapeando os campos principais pertinentes ao cadastro de fornecedores.Para realizar a importação do cadastro de fornecedores 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);
• FORNECEDOR – Parceiro é fornecedor(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":{
"$":"FORNECEDORXXX"
},
"CODCID":{
"$":"10"
},
"ATIVO":{
"$":"S"
},
"CLIENTE":{
"$":"S"
},
"CLASSIFICMS":{
"$":"C"
},
"FORNECEDOR":{
"$":"S"
}
}
}, "entity":{
"fieldset":{
"list":"CODPARC,TIPPESSOA,NOMEPARC,CODCID,ATIVO,FORNECEDOR,CLASSIFICMS"
}
}
}
}
}
Retorno em json:
{
"serviceName": "CRUDServiceProvider.saveRecord",
"status": "1",
"pendingPrinting": "false",
"transactionId": "F58A5ED2A26C41F5536A63B7DB34FAE8",
"responseBody": {
"entities": {
"total": "1",
"entity": {
"TIPPESSOA": {
"$": "F"
},
"ATIVO": {
"$": "S"
},
"NOMEPARC": {
"$": "FORNECEDORXXX"
},
"CLASSIFICMS": {
"$": "C"
},
"CODPARC": {
"$": "566"
},
"CODCID": {
"$": "10"
},
"FORNECEDOR": {
"$": "S"
},
"Cidade_NOMECID": {
"$": "TESTE"
}
}
}
}
}