Consulta de Clientes x Vendedores

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ências

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

Para melhor performance sempre utilize nas suas consultas apenas os campos necessários, para evitar tráfego de dados que não serão utilizados.

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.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"
                    }
                }
            ]
        }
    }
}
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!