As novas consultas em tempo real ao Sankhya pela integração são uma modernização no procedimento de consulta pela integração nativa, garantindo maior segurança e disponibilidade nas consultas. As consultas atualmente disponíveis pela integração continuam as mesmas, no entanto, com uma alteração nas API's de consulta de preço e de imposto no Sankhya.

As novas consultas de preço e imposto Sankhya permitem que o cálculo em tempo real de valores para produtos siga a lógica completa do ERP Sankhya, sem depender exclusivamente do parâmetro TIPTABPRECOS para valor unitário e também contempla todos os casos de uso de cálculos de impostos existentes no Sankhya.

A nova consulta amplia consideravelmente os casos de uso atendidos - passando a contemplar todos os cenários de configuração no Sankhya, elimina a necessidade de customizações manuais e contribui diretamente para a redução de erros e do tempo de configuração.

Ao editar a integração o usuário administrador receberá um aviso informando que as novas consultas estão disponíveis para serem ativadas.

Caso a conta não possua algum requisito, será apresentada a informação nessa notificação.

No entanto, caso a conta possua todos os requisitos para a habilitação da nova consulta, será apresentada a opção de ativar as novas consultas na conta como no exemplo abaixo.

Ao ativar as novas consultas, será habilitada uma nova seção de configuração além das seções de Configurar cadastros base da integração e Configurar cadastros de operação, que será a nova seção Configurar consultas em tempo real.

Após a seção Configurar consultas em tempo real aparecer na tela de configuração da integração, teremos concluído a habilitação da nova consulta na conta.

No painel de “Consultas em tempo real”, defina separadamente quais consultas em tempo real habilitar para Propostas e Vendas, que estarão nas abas "Orçamentos" e "Pedidos de venda" respectivamente.

Para ativar as consultas é necessário que o gatilho de consulta para cada tipo de consulta em cada tipo de documento (Proposta e Venda) esteja habilitado.

As consultas disponíveis para Proposta e Venda são as mesmas:

Para a configuração das consultas de Limite de crédito, Restrições da TOP e Estoque do Produto é necessário apenas ativar o gatilho das consultas que a integração criará os campos que recebem o retorno das consultas, conforme exemplo abaixo:

Com os gatilhos ativos, é necessário salvar a configuração da seção de consultas em tempo real e aplicar a edição da integração para que a ativação das consultas sejam efetivada na conta.

As consultas retornam os dados conforme o comportamento atual, desde que os campos sejam configurados nos modelos de documento.

Para a consulta preço é necessário realizar configurações adicionais além de ativar o gatilho da consulta.

Com o gatilho da consulta habilitado, serão carregadas mais informações para realizar a configuração da consulta:

A primeira configuração possível é a flag de customizações não nativas no Sankhya para precificação. Esse parâmetro deve ser utilizado apenas como último recurso, caso exista alguma customização no Sankhya que não seja atendida pela engine padrão de cálculo de preço dinâmico do Sankhya.

Ao ativar esse parâmetro, durante a consulta de preço será realizada uma operação de simulação de inclusão no Sankhya, de modo que qualquer procedure ou rotina configurada no Sankhya seja executada e retorne o preço conforme a configuração do Sankhya. No entanto, essa operação tende a ser mais lenta do que a consulta sem a utilização do processo de simulação.

Caso o Sankhya integrado utilize as funcionalidades de cálculo de preço nativas do Sankhya, esse parâmetro não deve ser marcado.

Logo abaixo estão as informações do payload de envio para a consulta de preços.

O payload é o conjunto de dados efetivamente enviados ou recebidos, ou seja, o corpo da mensagem que requisita uma informação entre sistemas, que neste caso são Ploomes e Sankhya.

Considerando que o cálculo de preços no Sankhya pode ser influenciado por informações de CabecalhoNota quanto de ItemNota, é necessário selecionar quais informações devem ser enviadas ao Sankhya para que o sistema calcule o preço e retorne a informação ao Ploomes.

Portanto, considerando as entidades do Ploomes, configuramos separadamente os payloads para Proposta ou Venda e Produto da Proposta ou da Venda. Abaixo temos um exemplo de configuração para consulta de preço de Proposta:

Por padrão, é obrigatório enviar as seguintes informações mínimas para consulta:

Proposta/Venda:

Produto da Proposta/Venda:

Os valores enviados do Ploomes para o Sankhya são os valores preenchidos nos campos mapeados com os respectivos campos do Sankhya na entidade integrada. Por esse motivo, os dados mínimos obrigatórios acima citados já possuem o DE-PARA de campos do payload fixos, que são os campos correspondentes do mapeamento da entidade integrada.

Nessas subseções é possível realizar duas configurações.

A primeira é a definição da obrigatoriedade ou não de um campo para que a consulta seja engatilhada. Essa configuração é feita com base no modal de ativação/desativação de engatilhamento ao lado direito do campo, conforme exemplo abaixo:

Todos os campos incluídos na seção de envio para consulta são enviados no pacote de dados do payload, mas somente os campos configurados como obrigatórios para o engatilhamento é que determinam se uma consulta será enviada ou não.

A segunda configuração possível é a inclusão de mais campos no payload de consulta, tanto para Proposta/Venda quanto para Produto da Proposta/Venda.

Considerando que existem campos além dos mínimos obrigatórios que podem influenciar no cálculo de preço configurado no Sankhya, é possível adicionar mais campos no payload.

Ao acionar o botão "Novo campo" para Proposta/Venda ou Produto da Proposta/Venda, serão exibidos os campos mapeados para a respectiva entidade integrada, para que possam ser incluídos no payload de configuração.

Após a inclusão dos novos campos é possível configurar também a obrigatoriedade ou não de preenchimento do campo para engatilhamento.

Com o payload de envio da consulta configurado, é preciso configurar o payload de recebimento.

Para a consulta de preço o retorno é apenas do valor unitário do Produto da Proposta ou da Venda.

Neste caso, é possível alterar o campo que receberá o retorno da consulta para o campo de preferência do usuário administrador. Após essa configuração, finalizamos a configuração da consulta de preços.

Para a consulta impostos também é necessário realizar configurações adicionais além de ativar o gatilho da consulta.

Com o gatilho da consulta habilitado, serão carregadas mais informações para realizar a configuração da consulta:

A primeira configuração é a definição do Nro. Único do Sankhya do CabecalhoNota que será utilizado como Modelo nas consultas de impostos.

No Sankhya é possível realizar diversas parametrizações que influenciam diretamente no cálculo de impostos, a fim de atender a necessidade fiscal do negócio. Para simplificar o processo de cálculo via API, é necessário então que um CabecalhoNota seja utilizado como modelo de parametrização dos cálculos de impostos.

Portanto, informamos aqui o NUNOTA referente à Nota Modelo do Sankhya para o cálculo de impostos.

Só é possível utilizar um único NotaModelo para as consultas de impostos.

Logo abaixo estão as informações do payload de envio para a consulta de impostos.

O payload é o conjunto de dados efetivamente enviados ou recebidos, ou seja, o corpo da mensagem que requisita uma informação entre sistemas, que neste caso são Ploomes e Sankhya.

Para a consulta de impostos, além da NotaModelo, são enviadas na requisição informações da Proposta/Venda e do Produto da Proposta/Venda, conforme exemplo abaixo:

Por padrão, é obrigatório enviar as seguintes informações para consulta:

Proposta/Venda:

Produto da Proposta/Venda:

Diferentemente da consulta de preços, no caso da consulta de impostos não é possível configurar obrigatoriedade de campos para engatilhamento (pois todos os campos listados são obrigatórios) e nem é possível incluir mais campos no payload de envio.

Logo, a consulta enviará todos os campos listados acima no payload de consulta de impostos e também será engatilhada somente se todos os campos estiverem preenchidos.

Com o payload de envio da consulta configurado, é preciso configurar o payload de recebimento.

Para a consulta de impostos o retorno pode ser de N campos, conforme os impostos configurados no Sankhya.

Os valores referente aos cálculos de impostos possíveis de retorno na consulta via API são:

É possível selecionar quais campos receber como retorno da consulta de impostos, bem como em quais campos os valores serão recebidos.

Após essa configuração, finalizamos a configuração da consulta de impostos.

Com todas as consultas configuradas, para que as configurações sejam efetivamente aplicadas à conta e estejam disponíveis é necessário realizar o salvamento da seção Configurar consultas em tempo real e aplicar a edição da integração.

É importante se atentar a necessidade de realizar a configuração para Propostas e para Vendas separadamente para que estejam disponíveis as consultas tanto para Propostas quanto para Vendas.

Nos modelos de proposta utilizados no CPQ, é necessário configurar:

A correta configuração desses campos garante que os valores retornados pela API sejam exibidos na proposta.

Para os Parceiros do Sankhya que estão integrados ao Ploomes como um Cliente, é possível realizar a consulta de detalhes financeiros na tela de Proposta/Venda. É possível engatilhar a consulta de detalhes financeiro do Cliente ao selecionar um Cliente e uma TOP.

Essa consulta retorna os dados em uma tabela resumo com os seguintes totais do Parceiro no Sankhya:

Para que essa consulta seja possível na tela de edição de Proposta/Venda, é necessário que o campo “Detalhes Financeiros (Sankhya)” - ou o campo utilizado no seu lugar na configuração - seja inserido no modelo de documento da Proposta/Venda. O campo pode ficar oculto que a consulta ainda irá funcionar.

Para as TOP’s do Sankhya que estão configuradas no Ploomes para utilização nas Propostas/Vendas é possível realizar a consulta das restrições/exceções da TOP na tela de edição da Proposta/Venda.

Essa consulta retorna os dados em uma tabela resumo com os seguintes dados:

Para que essa consulta seja possível na tela de edição de Proposta/Venda, é necessário que o campo “Detalhes de Restrições da TOP (Sankhya)” - ou o campo utilizado no seu lugar na configuração - seja inserido no modelo de documento da Proposta/Venda. O campo pode ficar oculto que a consulta ainda irá funcionar.

Para os Produtos da Proposta/Venda que são inseridos no formulário de CPQ é possível realizar uma consulta em tempo real ao Sankhya para exibir uma tabela resumo com as informações de estoque disponível do Produto.

Essa consulta retorna uma tabela resumo com os dados de estoque do Produto/Serviço no Sankhya conforme os campos preenchidos no Ploomes.

Nessa tabela, vão ser exibidos em linhas os estoques por:

E serão exibidos os totais das colunas de:

As quantidades exibidas são convertidas em função da unidade de medida selecionada. A conversão é feita pelo Sankhya, com base nos dados das entidades TGFEST (Estoque) e TGFVOA (Volume Alternativo) do Sankhya.

Para que essa consulta seja possível no formulário de CPQ, é necessário que o campo “Detalhes de Estoque (Sankhya)” - ou o campo utilizado no seu lugar na configuração - seja inserido no modelo de documento dentro do bloco de Produto da Proposta/Venda. O campo “Detalhes de Estoque (Sankhya)” não pode ficar oculto.

Ao preencher uma Proposta ou Venda no CPQ, o Ploomes executa automaticamente a consulta de preço para cada Produto da Proposta/Venda, conforme as obrigatoriedades definidas na configuração e também nos campos configurados para envio no payload.

A nova API retorna o valor conforme regras de precificação do Sankhya, sem a necessidade de ajustes ou configurações adicionais. O resultado é exibido nos campos configurados no modelo do documento.

Ao preencher uma Proposta ou Venda no CPQ, o Ploomes executa automaticamente a consulta de impostos para cada Produto da Proposta/Venda, conforme as obrigatoriedades estabelecidas na configuração e também nos campos definidos para envio no payload.

A nova API retorna o valor conforme regras de precificação do Sankhya, sem a necessidade de ajustes ou configurações adicionais. O resultado é exibido nos campos configurados no modelo do documento.

1. Posso usar a nova consulta apenas para preço ou apenas para imposto?

Sim. A tela de configuração permite ativar separadamente a nova API para preço e para imposto.

2. O que acontece se a consulta falhar?

Se houver erro na comunicação com a API ou se os dados obrigatórios estiverem ausentes (como código do parceiro ou do produto), o sistema pode não retornar os valores esperados. Nesse caso, uma mensagem de erro será exibida e os campos ficarão em branco.

3. É possível editar os valores calculados para preço e imposto?

Sim, desde que o modelo de documento permita edição dos campos de preço e imposto, o usuário poderá ajustá-los manualmente.

4. As consultas são executadas automaticamente?

Sim. Uma vez configuradas, as consultas ocorrem de forma automática durante o preenchimento dos campos definidos no payload e configurados no modelo de documento, sem necessidade de ações manuais adicionais.