Componente Sankhya - Tabela de Preço

O componente Tabela de Preço identifica e retorna a tabela de preço aplicável para um contexto de venda (ex.: parceiro/cliente, vendedor, região, tipo de negociação), sendo a base para o cálculo correto do preço do produto no Sankhya.

Ele é usado principalmente para:

• Definir a tabela que será aplicada no Preço do Produto

• Respeitar regras de precificação configuradas no ERP

• Permitir cenários onde a tabela pode ser automática (por parceiro, perfil, região) ou selecionável (por tipo configurado)

Índice:

• Objetivo do componente
• Contextualização de negócio
• Integração técnica
• Interface do componente (leitura da tela)
• 🔧 Exemplo de requisição (Sankhya)
• Estrutura do retorno (Neppo)
• 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

Determinar, de forma dinâmica e segura, a tabela de preço correta que será utilizada no fluxo de venda, respeitando a configuração definida no Sankhya por meio da preferência TIPTABPRECOS.

Contextualização de negócio

No Sankhya, a tabela de preço pode ser definida de diferentes formas, conforme o tipo configurado na preferência TIPTABPRECOS, que é ajustada pelo time de implantação.

Essa preferência define qual regra será usada para encontrar a tabela de preço.

Tipos de regra possíveis

• ÚNICA

• REGIÃO DO VENDEDOR

• REGIÃO DO PARCEIRO

• PERFIL

• PARCEIRO

• TIPO DE NEGOCIAÇÃO

• LOCAL

• TIPO DE NEGOCIAÇÃO / VENDEDOR

• PARCEIRO / TIPO DE NEGOCIAÇÃO / VENDEDOR

• PARCEIRO / EMPRESA

Exemplo (Tipo = PARCEIRO)

Quando o tipo configurado é PARCEIRO, a tabela retornada será a que estiver vinculada diretamente no cadastro do parceiro (cliente) no Sankhya.

Integração técnica

A Neppo utiliza o serviço Sankhya:

ConsultaProdutosSP.contextualizarTabelaPreco

Esse serviço avalia a regra configurada (TIPTABPRECOS) e, com base nos parâmetros enviados, retorna a tabela de preço correta (TGFTAB).

Interface do componente (leitura da tela)

Parâmetros

Campo	Descrição
Código do parceiro*	Código do cliente/fornecedor no Sankhya (codParc). Obrigatório.
Código do vendedor (opcional)	Código do vendedor (codVend). Utilizado quando a regra de tabela depende de vendedor, região do vendedor ou combinações.

Armazenamento

🔧 Exemplo de requisição (Sankhya)

curl --location 'https://api.sankhya.com.br/gateway/v1/mgecom/service.sbr?serviceName=ConsultaProdutosSP.contextualizarTabelaPreco&outputType=json' \
--header 'Authorization: <TOKEN>' \
--header 'appkey: 3a51f41d-ebc4-429f-a888-55ff9fb48d34' \
--header 'Content-Type: application/json' \
--data '{
  "serviceName": "ConsultaProdutosSP.contextualizarTabelaPreco",
  "requestBody": {
    "criterio": {
      "tipTabPreco": "4",
      "codParc": "654",
      "codVend": null
    }
  }
}'

Estrutura do retorno (Neppo)

Exemplo de Resposta

{
  "found": true,
  "data": {
    "nuTab": 708,
    "codTab": 0,
    "name": "TABELA ZERO"
  },
  "error": null
}

Descrição dos campos retornados

Exemplos de uso no bot

Encadear com o componente preço do produto

O valor mais utilizado é o NUTAB:

{{tabelaPreco.data.nuTab}}

Esse valor deve ser informado no componente preço do produto para garantir o cálculo correto.

Exibir tabela aplicada (diagnóstico)

A tabela de preço aplicada é: {{tabelaPreco.data.name}}

Tratamento de erros

Boas práticas

• Sempre informe Código do parceiro

• Informe Código do vendedor quando a operação envolver vendedor ou região

• Use nuTab como identificador principal para precificação

• Evite hardcode de tabela quando TIPTABPRECOS estiver ativo

• Utilize escopo global quando a tabela for reutilizada em múltiplos produtos

Onde validar no sankhya

As tabelas de preço podem ser conferidas diretamente no ERP em:

• Comercial → Tabelas de preços

E a regra de definição da tabela em:

• Preferência: TIPTABPRECOS

• 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