Invoice Requests Channel (v1.0.0)

Canal para solicitações de geração de notas fiscais. Usado para enviar dados de pedidos ao serviço bravalara para geração de notas fiscais via Avalara.

Visão Geral

Canal onde são publicadas solicitações de notas fiscais de pedidos de vendas. O serviço bravalara consome eventos deste canal para gerar notas fiscais para pedidos entregues no Brasil.

Propósito

Este canal serve como ponto de entrada para solicitações de geração de notas fiscais. Quando um pedido é atendido e requer uma nota fiscal, os dados do pedido são publicados neste canal, acionando o serviço bravalara para:

  1. Enriquecer dados do pedido com informações fiscais de hub e produto
  2. Mapear dados do pedido para o formato de transação Avalara
  3. Gerar nota fiscal via API Avalara
  4. Armazenar detalhes da nota fiscal no banco de dados
  5. Exportar dados da nota fiscal para o data warehouse

Fluxo de Eventos

  1. Produtor: Serviço de pedidos (ordr) publica eventos invoice_generation
  2. Consumidor: Serviço bravalara assina este canal
  3. Processamento: bravalara processa o evento e gera a nota fiscal
  4. Resultado: Detalhes da nota fiscal armazenados e exportados para o data warehouse

Formato da Mensagem

As mensagens seguem o formato padrão de evento com:

  • Tipo de Evento: bravalara_invoice_generation_event
  • Payload: Contém dados do pedido, informações do hub e itens da linha
  • Tags: Tags padrão de evento (id, event_type, service_name, country_code, at)

Configuração

  • Tópico: bravalara-invoice-generation
  • Assinatura: bravalara-invoice-generation
  • Tópico Dead Letter: bravalara-invoice-generation-dead-letter
  • Protocolo: Google Cloud Pub/Sub
  • Ordenação de Mensagens: Habilitada

Eventos Relacionados

  • invoice_generation: O evento publicado neste canal

Serviços Relacionados

  • bravalara: Consome eventos deste canal
  • ordr: Produz eventos para este canal

Channel information

Address: bravalara-invoice-generation
Protocol:
  • google pubsub