Inserir pedido

Crie pedidos no Sankhya ERP através da API de serviços

Parâmetros

Campo	Tipo	Descrição
Conta de serviço	Select	Permite o acesso ao sistema através de credenciais fornecidas no painel de contas do Floui.
Número do pedido	String	Define um número para o pedido criado.
Código do parceiro	String	Define o código do parceiro.
Data da negociação	String	Define uma data de negociação.
Código do tipo da operação	String	Define o código para o tipo de operação.
Código do tipo de negociação	String	Define o código para o tipo de negociação.
Código do vendedor	String	Define o código do vendedor.
Código da empresa	String	Define o código da empresa..
Tipo de movimento	String	Define o tipo de movimento aplicado.
Informar preço dos itens	Select	Usado para enviar o pedido com os valores já negociados.
Modo de inserção dos itens do pedido	Select	Define a máscara de inserção simples ou completa através de um objeto javascript.
Código do produto	String	Define o código do produto.
Quantidade	String	Define um valor inteiro para a quantidade de itens.
Código local origem	String	Define o código local de origem.
Volume	String	Define o volume do item.
Valor unitário	String	Aplica um valor unitário ao produto.
Percentual desconto	String	Define um percentual de desconto.
Nome do campo	String	Caso haja campos adicionais, insira o campo interno interno existente no ERP.
Valor	String	Defina o valor associado ao nome do campo.
Retorno em modo simplificado	Select	Retorna os dados de resultado em modo simplificado ao invés da resposta padrão da Sankhya.
Output path	String	Armazena os dados de saída do conector ao final da execução.
Descrição	String	Mensagem visual para descrever a função do conector no contexto do fluxo.

Cadastro de Pedidos

post

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.                     

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":{
                  },
                  "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"
            }
        }
    }
}

Responses

201

Inclusão de pedidos realizada com sucesso!

400

Requisição inválida

500

Erro interno do servidor

post

/Pedidos

HTTPcURLJavaScriptPython

POST /Pedidos HTTP/1.1
Accept: */*

No content