Componente Sankhya - Tipo de Operação

O componente Tipo de Operação (TOP) consulta no Sankhya os dados de um tipo de operação comercial (ex.: Orçamento, Pedido de Venda, Nota Fiscal), a partir do código único da TOP.

A TOP é um dos pilares do processo comercial no Sankhya, pois define como a operação se comporta: tipo de movimento, regras fiscais, integração com NF-e, estoque, financeiro e faturamento.

Esse componente é utilizado para:

• Validar se uma TOP é compatível com o fluxo de venda

• Obter metadados da operação antes de criar pedidos

• Direcionar regras de negócio no bot (ex.: orçamento x venda)

• Garantir consistência com a configuração do ERP

• Objetivo do componente
• Contextualização de negócio
• Integração técnica
• Interface do componente (leitura da tela)
• Estrutura do retorno (Neppo)
• Mapeamento técnico dos campos
• Descrição dos campos retornados
• Exemplos de uso no bot
• Tratamento de erros
• Boas práticas
• Onde validar no Sankhya

• 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

Disponibilizar no fluxo do bot as informações oficiais da TOP configurada no Sankhya, garantindo que o comportamento do atendimento esteja alinhado ao processo comercial real.

Contextualização de negócio

No Sankhya, a TOP (Tipo de Operação) define:

• Se a operação é pedido, orçamento, devolução, transferência, etc.

• O tipo de movimento (ex.: Pedido, Entrada, Saída)

• A relação com NF-e

• Regras fiscais, contábeis e de estoque

As TOPs podem ser visualizadas e mantidas no Sankhya OM na tela:

Comercial → Tipos de Operação (TOP)

Integração técnica

A consulta do tipo de operação é feita a partir da tabela:

• TGFTOP – Tipos de Operação

A Neppo retorna os dados normalizados no formato de lista (content), mesmo quando a consulta é por uma única TOP.

Interface do componente (leitura da tela)

Configuração de consulta

Exemplo: 1001

Armazenamento

Estrutura do retorno (Neppo)

Exemplo de resposta

{
  "hasMore": false,
  "size": 1,
  "content": [
    {
      "code": 1,
      "updatedAt": "13/05/2024 17:37:02",
      "description": "ORÇAMENTO",
      "movementType": "P",
      "nfeTypeCode": "M"
    }
  ],
  "error": null
}

Mapeamento técnico dos campos

Descrição dos campos retornados

Exemplos de uso no bot

Validar tipo de operação antes de criar pedido

Se {{tipoOperacao.content[0].movementType}} = "P"
→ Permitir fluxo de pedido/orçamento

Exibir tipo de operação aplicado

A operação selecionada é: {{tipoOperacao.content[0].description}}

Tratamento de erros

Boas práticas

• Sempre valide a TOP antes de criar pedidos

• Use TOP coerente com o tipo de venda (orçamento x venda)

• Centralize a definição da TOP via preferência quando aplicável

• Utilize escopo global quando a TOP for reutilizada no fluxo

Onde validar no Sankhya

No ERP Sankhya OM:

• Comercial → Tipos de Operação (TOP)

• 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