Regras de negócio

A sequência de ordem de carga tem a função de informar quais cidades farão parte da rota de entrega.Será necessário efetuar o cadastro no ERP da sequência de entrega.A primeira cidade da rota deverá ter a sequência 1, a segunda a sequência 2, e assim por diante.
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/360045108613-Rotas#abasequenciadeentrega

Dependências

Para realizar o sequenciamento da Ordem de Carga o seguinte fluxo deve ser seguido:

1. Criar o pedido de venda;
2. Criar a Ordem de Carga;
3. Vincular a Ordem de carga ao Pedido de venda criado.
4. Sequenciar os pedidos da Ordem de carga.
IMPORTANTE:
1 - Uma ordem de carga pode ser vinculada a um ou mais pedidos.
2 - Para sequenciar os pedidos, os mesmos devem pertencer a mesma Ordem de carga.

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 o sequenciamento de pedidos na ordem de carga através do Json, os campo(s) abaixo são(é) obrigatório(s):
• SEQCARGA – Sequência da carga;
• NUNOTA – Número único da nota;
Deve ser utilizado o filtro abaixo para fazer o sequenciamento dos pedidos na ordem de carga:

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

O campo NUNOTA deve ser utilizado como filtro para fazer o sequenciamento.

OBSERVAÇÃO: Os pedidos devem estar na mesma Ordem de carga para fazer o sequenciamento.

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 este sequenciamento permite apenas a gravação de um número de sequencia por vez.
Este sequenciamento entre os pedidos da ordem deverão ser feitos manualmente e após isto inserir no campo SEQCARGA o número de sequenciamento deste pedido, lembrando que os números de sequenciamentos não deve ser repetidos nos pedidos da Ordem de carga.

Corpo de requisição

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

Retorno em json:

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