Componente Sankhya - Criar Pedido

O componente Criar Pedido é responsável por registrar um pedido de venda no ERP Sankhya diretamente a partir do fluxo do bot construído na plataforma Neppo.

Ele utiliza as informações coletadas ao longo da jornada de venda, como cliente, tipo de operação, tipo de negociação e itens do carrinho, para criar a movimentação comercial no Sankhya.

Após a execução, o pedido é criado no ERP e pode ser consultado na tela Portal de Vendas, utilizando o Número Único do Pedido (NUNOTA) retornado pela operação.

Índice:

• Interface do componente (leitura da tela)
• Itens do pedido
• Armazenamento
• Integração técnica
• Estrutura do retorno
• Descrição dos campos retornados
• Onde visualizar o pedido no Sankhya
• Exemplos de uso no bot
• Tratamento de erros
• Boas práticas

• Dados do Cliente

• Obter pedidos

• Itens do Pedido

• Criar Pedido

• Preço do Produto

• Estoque do Produto

• Locais de Estoque

• Volumes Alternativos

• Obter Preferência

• Tabela de Preço

• Tipo de Operação

• Tipos de Negociação

• Detalhe do Produto

• Busca de Produto

• Adicionar ao Carrinho

• Alterar Quantidade no Carrinho

• Obter Itens do Carrinho

---

Objetivo do componente

Automatizar a criação de pedidos no Sankhya garantindo que:

• As regras comerciais do ERP sejam respeitadas

• Os dados financeiros e fiscais estejam corretos

• O fluxo digital reproduza o mesmo comportamento de uma venda realizada manualmente no sistema

---

Interface do componente (leitura da tela)

Cabeçalho da nota

Informações principais do pedido

Campo	Descrição	Origem Sankhya
Parceiro*	Código do cliente ou fornecedor no Sankhya	TGFPAR.CODPARC
Empresa*	Código da empresa responsável pela venda	TGFCAB.CODEMP
Centro de Custo*	Centro de resultado da venda	TGFCAB.CODCENCUS
Projeto*	Código do projeto vinculado ao pedido	TGFCAB.CODPROJ
Natureza*	Natureza da operação financeira	TGFCAB.CODNAT
Vendedor Preferencial*	Código do vendedor responsável	TGFCAB.CODVEND
Tipo de Operação (TOP)*	Tipo de operação comercial do pedido	TGFCAB.CODTIPOPER
Tipo de Venda*	Tipo de negociação (forma de pagamento)	TGFCAB.CODTIPVENDA

Observação

Alguns desses campos normalmente são obtidos dinamicamente a partir de consultas anteriores no fluxo, como:

• Dados do cliente

• Tipos de negociação

• Tipo de operação

• Preferências

• Tabela de preço

---

Itens do pedido

Os itens do pedido não são informados diretamente nesse componente.

Na jornada de Venda Digital, os itens são obtidos automaticamente a partir do carrinho de compras do bot, que deve estar estruturado previamente no fluxo.

⚠️ Alerta exibido na interface

Para a jornada de venda digital com Sankhya, serão utilizados os itens do carrinho para a criação do pedido.
Verifique a estrutura do fluxo antes da publicação.

Cada item do carrinho será transformado em um registro na tabela:

TGFITE – Itens da nota

---

Armazenamento

Campo	Descrição
Variável de armazenamento	Nome da variável que receberá o retorno da criação do pedido. Exemplo: pedidoCriado
Variável de escopo global	Quando ativada, permite acessar o pedido criado em qualquer ponto do fluxo

---

Integração técnica

A criação do pedido utiliza o serviço Sankhya:

POST incluimovimentos

Documentação oficial:

https://developer.sankhya.com.br/reference/post_incluimovimentos

Esse serviço cria a movimentação comercial nas tabelas:

Tabela	Descrição
TGFCAB	Cabeçalho do pedido
TGFITE	Itens do pedido

---

Estrutura do retorno

Exemplo de resposta

{
  "orderCode": 3723169,
  "items": [
    {
      "product": {
        "code": 1185,
        "referenceCode": 91185,
        "defaultUnit": {
          "code": "UN",
          "description": "Unidade"
        },
        "description": "BALAS SORTIDAS",
        "complementaryDescription": null,
        "characteristics": null,
        "brand": "ERLAN"
      },
      "quantity": 5,
      "locationCode": 0,
      "unitCode": "UN",
      "controlCode": "MACA VERDE",
      "price": 4.3
    }
  ],
  "error": null
}

---

Descrição dos campos retornados

Campo	Descrição
orderCode	Número único do pedido criado (NUNOTA)
items	Lista de itens registrados no pedido
items[].product.code	Código do produto
items[].product.description	Descrição do produto
items[].quantity	Quantidade do item
items[].unitCode	Unidade de venda
items[].controlCode	Controle do produto (variação)
items[].price	Preço unitário aplicado
error	Informações de erro quando a criação falhar

---

Onde visualizar o pedido no Sankhya

Após a criação, o pedido pode ser visualizado na tela:

Portal de vendas

Para localizar o pedido:

1. Acesse portal de vendas

2. Utilize o filtro número único

3. Informe o valor retornado em orderCode

---

Exemplos de uso no bot

Confirmar criação do pedido

Seu pedido foi criado com sucesso!

Número do pedido: {{pedidoCriado.orderCode}}

---

Mostrar resumo do pedido

Pedido {{pedidoCriado.orderCode}} criado com sucesso.
Itens adicionados ao pedido:
{{pedidoCriado.items[0].product.description}}

---

Tratamento de erros

Situação	Comportamento
Cliente inválido	erro retornado pelo serviço
Produto inexistente	erro na inclusão dos itens
TOP incompatível	erro na validação da operação
Preço inválido	erro na criação da movimentação

---

Boas práticas

• Validar os dados do cliente antes de criar o pedido

• Garantir que o carrinho esteja estruturado corretamente

• Validar preço e tabela de preço antes da criação

• Utilizar TOP compatível com vendas digitais

• Dados do Cliente

• Obter pedidos

• Itens do Pedido

• Criar Pedido

• Preço do Produto

• Estoque do Produto

• Locais de Estoque

• Volumes Alternativos

• Obter Preferência

• Tabela de Preço

• Tipo de Operação

• Tipos de Negociação

• Detalhe do Produto

• Busca de Produto

• Adicionar ao Carrinho

• Alterar Quantidade no Carrinho

• Obter Itens do Carrinho