Regras de negócio

Como o objetivo é vincular os pedidos a uma ordem de carga, pesquisar somente os pedidos de venda pendentes. Quando se define que serão pesquisados apenas lançamentos do Tipo de Movimento "pedido de venda", através do painel de filtros, o sistema habilita as opções "exibir pedidos não confirmados" e "exibir somente pedidos pendentes".
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/360045119713-Ordens-de-Carga

Dependências

Para realizar a vinculação da Ordem de Carga o seguinte fluxo deve ser seguido:

1. Criar o pedido de venda;
2. Criar a Ordem de Carga;
3. Vincular o(s) pedido(s) à Ordem de carga.

IMPORTANTE:
1 - Uma ordem de carga pode ser vinculada a um ou mais pedidos.
2 - Para vincular os pedidos à Ordem de Carga, os pedidos devem pertencer a mesma Empresa.

Detalhes Técnicos

A entidade utilizada é a CabecalhoNota que por sua vez instancia a tabela TGFCAB mapeando os campos principais pertinentes ao cadastro de notas.
Para realizar a vinculação do(s) pedido(s) na Ordem de carga através do Json, os campo(s) abaixo são(é) obrigatório(s):

• ORDEMCARGA – Número da Ordem de carga;
• NUNOTA – Número único da Nota;
Deve ser utilizado o filtro de pedido abaixo para fazer a vinculação da ordem de carga:

        "key":{
                 "NUNOTA":{
                    "$":"3713614"
                  }
              }

O campo NUNOTA deve ser utilizado como filtro para fazer a vinculação da Ordem de carga.

Descritivo de campos da entidade

Acesse aqui o dicionário de dados da tabela TGFCAB

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=CRUDServiceProvider.saveRecord&outputType=json

IMPORTANTE:
O json para realizar esta vinculação permite apenas a gravação de um pedido por vez, caso a ordem de carga tenha vários pedidos, deve ser feita a vinculação de pedido um a um pelo json com o mesmo número de ordem de carga diferenciando apenas o número do pedido.

Corpo de requisição

{
   "serviceName":"CRUDServiceProvider.saveRecord",
   "requestBody":{
      "dataSet":{
         "rootEntity":"CabecalhoNota",
         "includePresentationFields":"S",
         "dataRow":{
            "localFields":{
               "ORDEMCARGA":{
                  "$":"247"
               }
            },
            "key":{
               "NUNOTA" :[{
                    "$":"3713614"
                }]
            }
         },
         "entity":{
            "fieldset":{
               "list":"NUNOTA,CODEMP,CODPARC,ORDEMCARGA"
            }
         }
      }
   }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.saveRecord",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "02533A425C2B872F33CA26401BAD500B",
    "responseBody": {
        "entities": {
            "total": "1",
            "entity": {
                "Parceiro_NOMEPARC": {
                    "$": "SANKHYA JIVA GESTÃO DE NEGÓCIOS"
                },
                "ORDEMCARGA": {
                    "$": "247"
                },
                "NUNOTA": {
                    "$": "3713614"
                },
                "CODPARC": {
                    "$": "1"
                },
                "CODEMP": {
                    "$": "1"
                },
                "Empresa_NOMEFANTASIA": {
                    "$": "WCS PRESTAÇÃO DE SERVIÇOS"
                }
            }
        }
    }
}