Agora no Bluesoft ERP, é possível identificar quando uma nota fiscal de compra possui um ou mais Conhecimentos de Transporte Eletrônicos (CT-e) vinculados diretamente através do retorno da API de consulta de notas fiscais.

Como Irá Funcionar a Partir de Agora?

A partir desta atualização, o endpoint de consulta foi otimizado para conferir total rastreabilidade à operação de frete:

  1. Consulta da API: Ao consumir o endpoint GET api/estoques/notas-fiscais, o sistema processará a consulta mantendo inalterados todos os campos e estruturas de retorno atualmente existentes.
  2. Novo Objeto: Foi incluída no contrato de retorno da nota fiscal uma nova coleção denominada ctesVinculados.
  3. Retorno com Vínculo: Quando a nota fiscal de entrada consultada possuir um ou mais CT-es vinculados no fluxo de recebimento, a coleção exibirá um objeto para cada vínculo contendo exclusivamente o campo chave (preenchido com a chave de acesso de 44 dígitos do CT-e).
  4. Retorno sem Vínculo: Caso a nota fiscal de entrada não possua nenhum documento de transporte relacionado, o campo será obrigatoriamente retornado como uma lista vazia ("ctesVinculados": []), evitando valores nulos ou a omissão do campo.

Observações Importantes!

  • Escopo Informacional: A alteração proposta é estritamente informacional no contrato da API. Ela não gera lançamentos contábeis, não altera o custo dentro do ERP e não modifica a contabilização ou o recálculo do recebimento da nota fiscal.
  • Dados Limitados: Nesta entrega, a coleção retornará exclusivamente a chave de acesso do CT-e para permitir a rastreabilidade. Informações financeiras, tributárias ou dados detalhados de rateio do frete não serão expostos, visto que a consulta detalhada do CT-e por sua chave será disponibilizada em uma demanda futura.
  • Compatibilidade e Filtros: A estrutura legada da API, assim como as regras de paginação, ordenação, filtros por loja e períodos de recebimento permanecem funcionando normalmente e sem impactos de regressão.

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 r369.72