Detalhes

Este evento é publicado para solicitar a geração de nota fiscal para um pedido de venda. Contém todas as informações necessárias para o serviço bravalara gerar uma nota fiscal brasileira (NF-e) via plataforma Avalara.

Quando este evento é produzido?

Este evento é produzido quando:

• Um pedido foi atendido e requer uma nota fiscal
• Uma nota fiscal precisa ser regenerada (cenário de reexecução)
• O pagamento de um pedido foi confirmado e a geração de nota fiscal é acionada

Estrutura do Payload do Evento

O payload do evento contém:

• Informações do Pedido: ID do pedido, ID do hub, ID do hub de localização
• Solicitação de Transação: Formato completo de solicitação de transação Avalara incluindo:
  • Header: Metadados da transação, datas, números de notas fiscais, dados fiscais do cliente e hub
  • Lines: Array de itens da linha com detalhes do produto, quantidades, preços e informações fiscais
  • Version: Versão da transação (atualmente “3”)

Campos Principais

• order_id: Identificador único do pedido
• hub_id: Identificador do hub onde o pedido foi atendido
• location_hub_id: Identificador do hub de localização (pode diferir do hub_id para food trucks)
• transactionRequest: Objeto completo de solicitação de transação Avalara
  • header: Contém endereços do cliente e hub, IDs fiscais, números de notas fiscais
  • lines: Array de itens da linha com SKUs de produtos, preços, quantidades e códigos fiscais

Fluxo de Processamento

1. Evento é publicado no canal bravalara-invoice-generation
2. Serviço bravalara consome o evento
3. Serviço enriquece dados com informações fiscais de hub e produto do banco de dados
4. Serviço valida prontidão fiscal para todos os produtos
5. Serviço gera nota fiscal via API Avalara
6. Detalhes da nota fiscal são armazenados no banco de dados
7. Dados da nota fiscal são exportados para o data warehouse

Requisitos de Dados Fiscais

Para geração bem-sucedida de nota fiscal, os seguintes dados fiscais devem estar disponíveis:

Dados Fiscais do Hub:

• ID de Imposto Federal (CNPJ)
• ID de Imposto Estadual (IE)
• Razão social
• Endereço completo com código da cidade

Dados Fiscais do Produto:

• Código HS (NCM)
• Tipo de Receita PIS/COFINS
• Origem Fiscal (Source)
• CEST (se aplicável)
• Código EX (se aplicável)
• Contas de Ativo, Despesa e Receita

Tratamento de Erros

Se a geração da nota fiscal falhar:

• Erro é registrado com ID do pedido e mensagem de erro
• Nota fiscal falhada pode ser consultada via query GraphQL getInvoiceErrors
• Mecanismo de tentativa disponível para notas fiscais inválidas
• Fila de dead letter trata mensagens permanentemente falhadas