get https://api.sankhya.com.br/ClientesVendedores
Regras de negócio
Para realizar a consulta de cliente x vendedores no ERP será necessário efetuar o cadastramento preencher, inicialmente, os campos obrigatórios. Pois este cadastro ligará o vendedor/Comprador ao seu parceiro, ou seja, se o vendedor ou comprador é um cliente ou fornecedor da empresa.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/360045111133-Vendedores-Compradores
Dependências
Não possui dependênciasDetalhes Técnicos
A entidade utilizada é a Parceiro que por sua vez instancia a tabela TGFPAR mapeando os campos principais.Para realizarmos a busca através do Json, utilizamos o serviço "CRUDServiceProvider.loadRecords".
O serviço CRUDServiceProvider.loadRecords é um otimo serviço para ser utilizado para consulta de dados através do JSON.
No exemplo abaixo foi utilizado como filtro o campo CODVEND, porém você pode utilizar outros campos da entidade .
Para utilizar o filtro, basta acrescentar o corpo da requisição o código abaixo utilizando o criteria:
"criteria": {
"expression": {
"$": "this.CODVEND = ?"
},
"parameter": [
{
"$": "17",
"type": "I"
}
]
}
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.loadRecords&outputType=json Corpo de requisição
{
"serviceName": "CRUDServiceProvider.loadRecords",
"requestBody": {
"dataSet": {
"rootEntity": "Parceiro",
"includePresentationFields": "N",
"offsetPage": "0",
"criteria": {
"expression": {
"$": "this.CODVEND = ?"
},
"parameter": [
{
"$": "17",
"type": "I"
}
]
},
"entity": {
"fieldset": {
"list": "CODVEND,CODPARC,NOMEPARC"
}
}
}
}
}
Retorno em json:
{
"serviceName": "CRUDServiceProvider.loadRecords",
"status": "1",
"pendingPrinting": "false",
"transactionId": "4696DC25A786AEC3E9E6967BBF97023C",
"responseBody": {
"entities": {
"total": "2",
"hasMoreResult": "false",
"offsetPage": "0",
"offset": "0",
"metadata": {
"fields": {
"field": [
{
"name": "CODVEND"
},
{
"name": "CODPARC"
},
{
"name": "NOMEPARC"
}
]
}
},
"entity": [
{
"f0": {
"$": "17"
},
"f1": {
"$": "571"
},
"f2": {
"$": "TESTE INTEGRAÇÃO"
}
},
{
"f0": {
"$": "17"
},
"f1": {
"$": "572"
},
"f2": {
"$": "GENOVEVO"
}
}
]
}
}
}