Agora no Bluesoft ERP, é possível obter o codigo do beneficio fiscal (cBenef) diretamente no retorno da API de regras de tributação de saída para o PDV.


Objetivo: O objetivo desta melhoria é centralizar as informações fiscais necessárias para o PDV em um único endpoint


O Que Mudou?

  • Antes: Os dados de benefício fiscal eram retornados apenas na API de produtos. Para obter o resumo completo da tributação de saída com os detalhes do benefício, era necessário consultar diferentes fontes ou endpoints, o que fragmentava a integração.
  • Agora: A API de consulta de regras fiscais de saída para o PDV foi atualizada para incluir o objeto beneficioFiscal.
  • Benefícios: Maior agilidade na integração com PDVs de terceiros, integridade dos dados fiscais e conformidade com as exigências de desoneração de ICMS diretamente na regra de venda.

Como Irá Funcionar a Partir de Agora?

A API de Regras Fiscais de Saída (PDV) recebeu uma atualização em seu contrato de dados:
Novo Atributo: Foi adicionado o campo retornarBeneficioFiscal como parâmetro de consulta (Query Param).
Objeto de Retorno: Quando o parâmetro for definido como true, o sistema incluirá o objeto beneficioFiscal, contendo:
codigoBeneficioFiscal: Codigo configurado no produto para a UF em vigencia.
vigenciaInicialBeneficio: Data inicial da vigendia do beneficio.

Endpoints afetados:

/api/modulos/fiscal/regra-fiscal/pdv/sat-nfces

/api/modulos/fiscal/regra-fiscal/pdv/nfes


Sincronismo: O sistema foi parametrizado para listar as alterações através do parâmetro de consulta dataHoraGeracao sempre que houver alteração nos dados de benefício fiscal vinculados às regras de tributação.


Observações / Validações:

  • Para que os dados sejam retornados, é necessário que o produto e a regra fiscal estejam devidamente configurados com um benefício fiscal ativo.
  • O novo parâmetro de filtro é opcional na chamada da API para manter a compatibilidade com integrações que não utilizam essa informação.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r366.45