Agora no Bluesoft ERP, é possível consultar informações completas das notas fiscais de origem diretamente pelo endpoint público de notas fiscais, além de realizar filtragens precisas utilizando o identificador numérico do tipo da nota.

Como Irá Funcionar a Partir de Agora?

A API pública foi otimizada para expor a chave do tipo da nota e suas referências de origem estruturadas, preservando as regras de validação atuais e o comportamento padrão para os cenários que não envolvem devolução.

1. Novo Filtro e Parâmetro de Retorno:

  • tipoNotaKey: Incluído como parâmetro opcional na requisição GET /api/estoques/notas-fiscais. Ele permite filtrar pelo tipo numérico exato registrado no ERP (coexistindo com os filtros atuais) e passa a ser retornado no payload de todas as notas consultadas.

2. Regras de Retorno da Origem em Devoluções:

O sistema expõe os vínculos já existentes no ERP de acordo com a classificação técnica da nota:

  • Para tipoNotaKey = 6 (Devolução de Compra) e 5 (Devolução de Troca): Retorna a nota fiscal de origem mapeada de forma individualizada no nível de cada item, permitindo reconciliar devoluções que reúnam produtos de compras diferentes.

3. Estrutura Mínima Obrigatória:

Para qualquer nota de origem retornada (notaFiscalOrigem), os sistemas integrados receberão os campos:

  • nfKey (identificador interno)
  • chave (chave de acesso da NF-e)
  • numero
  • notaFiscalItemKey
  • serie

Observações / Validações

  • Endpoint de Apoio: Foi disponibilizado o endpoint auxiliar GET /api/estoques/notas-fiscais/tipos para que os integradores listem os tipos de notas fiscais elegíveis para o filtro.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

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

Disponível a partir da versão r368.53