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

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 os campos CODPARC e TRANSPORTADORA, 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.TRANSPORTADORA = ? and this.CODPARC = ?"
      },
      "parameter": [
         {
           "$": "S",
           "type": "S"
         },
         {
           "$": "567",
           "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.TRANSPORTADORA = ? and this.CODPARC = ?"
        },
        "parameter": [
           {
             "$": "S",
             "type": "S"
           },
           {
             "$": "567",
             "type": "I"
           }
        ]
      },
      "entity": {
        "fieldset": {
          "list": "CODPARC,NOMEPARC,TRANSPORTADORA,CODCID,CLASSIFICMS"
        }
      }
    }
  }
}

Retorno em json:

{
  "serviceName": "CRUDServiceProvider.loadRecords",
  "status": "1",
  "pendingPrinting": "false",
  "transactionId": "11045006CD6E63CFD528873AA09448AE",
  "responseBody": {
      "entities": {
          "total": "1",
          "hasMoreResult": "false",
          "offsetPage": "0",
          "offset": "0",
          "entity": {
              "f1": {
                  "$": "TESTE123"
              },
              "f0": {
                  "$": "567"
              },
              "f3": {
                  "$": "S"
              },                            
              "f5": {
                  "$": "C"
              },
              "f4": {
                  "$": "10"
              }
          },
          "metadata": {
              "fields": {
                  "field": [
                      {
                          "name": "CODPARC"
                      },
                      {
                          "name": "NOMEPARC"
                      },
                      {
                          "name": "TRANSPORTADORA"
                      },                                    
                      {
                          "name": "CODCID"
                      },
                      {
                          "name": "CLASSIFICMS"
                      }
                  ]
              }
          }
      }
  }

}