Regras de negócio

O cadastro de pedidos no sistema, permite que você registre e gerencie o que foi vendido e precisa ser faturado e entregue indicando, para qual cliente ou parceiro, quais as condições comerciais e financeiras negociadas e demais informações, proporcionando uma clara visão do que está em cada etapa do processo.
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/360044612654-Portal-de-Vendasbr

Dependências

Para realizar a inclusão do pedido, os seguintes itens são obrigatórios:
1) Logar no sistema utilizando o Serviço de Login descrito nesta documentação em Login;
2) Produtos/Serviços preeviamente cadastrados e ativos;
3) Empresas previamente cadastradas e ativas;
4) Top's configuradas devidamente tipo de movimentação "Pedido de venda";
5) Tipo de negociação cadastrados seja a vista, a prazo, parcelada, cheque.
6) O parceiro deve estar cadastrado e ativo antes da geração do pedido.

Detalhes Técnicos

O serviço utilizado para inclusão de notas é o CACSP.IncluirNota que instancia as entidades principais para o envio de pedido, as entidades que este serviço utiliza são:
• CabecalhoNota; • ItemNota.
Os campos obrigatórios dependem estritamente da configuração de TOP,empresa, produto, etc. Portanto, neste exemplo colocamos os campos tipicamente obrigatórios em todos os casos de uso. Este exemplo não tenta exaurir as possibilidades,que são muitas, então em alguns casos a chamada a esse serviço pode resultar em mensagem de erro exigindo que outros campos sejam enviados. Apenas um pedido/nota pode ser enviado por vez.
Para realizar a inclusão do pedido através do Json, os campos abaixo são obrigatórios:

CABEÇALHO DO PEDIDO

        • NUNOTA – Numero Único da nota;
        • CODPARC – Código do Parceiro;
        • DTNEG – Data de Negociação;
        • CODTIPOPER – Código do Tipo de Operação;
        • CODTIPVENDA – Tipo de Negociação;
        • CODVEND – Código do vendedor;
        • CODEMP – Código da Empresa;
        • TIPMOV – Tipo de Movimento.

ITENS DO PEDIDO

        • CODPROD – Código do Produto;
        • QTDNEG – Quantidade;
        • CODLOCALORIG – Código local de Origem;
        • CODVOL – Código do Volume;
        • IGNOREDESCPROMOQTD - Quando "True" garante que os valores enviados na API não serão alterados devido a algum disconto promocional vigente.

Conforme explicado anteriormente, os campos enviados acima são obrigatórios e são os campos padrões. Os campos abaixo só serão obrigatórios se na requisição o campo "INFORMARPRECO" for igual a true, caso contrário os campos abaixo não serão obrigatórios.

• VLRUNIT – Valor Unitário;
• PERCDESC – Percentual de desconto;
IMPORTANTE: O campo INFORMARPRECO serve para enviar o pedido com os valores já negociados e neste caso, o preço e o desconto terão que serem enviados para serem calculados. Caso o campo informarPreço = N então o ERP irá utilizar valor da tabela de preços vigente no momento da inclusão do pedido.

Descritivo de Campos das Entidades

Acesse aqui o dicionário de dados da tabela TGFCAB
Acesse aqui o dicionário de dados da tabela TGFITE

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mgecom/service.sbr?serviceName=CACSP.incluirNota&outputType=json
IMPORTANTE:

OBSERVAÇÃO: EXEMPLO DE REQUISIÇÃO BASEADO NA BASE DE TESTE. TODOS OS CAMPOS DEVEM SER REVISTOS E AJUSTADOS PARA UM NOVO PEDIDO DE VENDA PARA AMBIENTE PRODUTIVO.

Corpo de requisição

{
   "serviceName":"CACSP.incluirNota",
   "requestBody":{
      "nota":{
         "cabecalho":{
            "NUNOTA":{
            },
            "CODPARC":{
               "$":"1"
            },
            "DTNEG":{
               "$":"09/12/2022"
            },
            "CODTIPOPER":{
               "$":"2000"
            },
            "CODTIPVENDA":{
               "$":"12"
            },
            "CODVEND":{
               "$":"0"
            },
            "CODEMP":{
               "$":"1"
            },
            "TIPMOV":{
               "$":"O"
            }
         },
         "itens":{
            "INFORMARPRECO":"True",
            "item":[
                  {
                   "NUNOTA":{
                  },
                  "IGNOREDESCPROMOQTD": {
                      "$": "True"
                  },
                  "CODPROD":{
                     "$":"8"
                  },
                  "QTDNEG":{
                     "$":"1"
                  },
                  "CODLOCALORIG":{
                     "$":"0"
                  },
                  "CODVOL":{
                     "$":"UN"
                  },
                  "PERCDESC": {
                    "$": "0"
                  },
                 "VLRUNIT": {
                    "$": "1.75"
                  }
               }               
            ]
         }
      }
   }
}

Retorno em json:

{
    "serviceName": "CACSP.incluirNota",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "1484EE05236C4B33DE6355DAA8443EFF",
    "responseBody": {
        "pk": {
            "NUNOTA": {
                "$": "740"
            }
        }
    }
}