MIDDAG Account

Portugues

English

Portugues

English

Appearance

Gerar uma Fatura ​

Esta receita cobre a geração de uma fatura para um pedido concluído, o download do PDF e -- para operações brasileiras -- a emissão de NFSe (nota fiscal de serviço) via ISSNet.

Pré-requisitos ​

  • Acesso de admin ao WordPress.
  • Um pedido WooCommerce com status completed ou processing.
  • Para NFSe: a entidade de faturamento da Organização deve ser MIDDAG BR e a integração com ISSNet deve estar configurada nas definições do plugin.

Passos ​

Parte A: Verificar a fatura do Stripe ​

Passo 1. Vá em MIDDAG Account > Invoices na barra lateral do admin.

Passo 2. Pesquise pelo nome da Organização ou número do pedido.

Passo 3. A fatura já deve existir. Faturas no MIDDAG Account são sincronizadas automaticamente do Stripe via webhooks -- o sistema não gera faturas independentemente.

Passo 4. Abra a fatura e verifique:

  • Status é paid.
  • Amount corresponde ao total do pedido.
  • Stripe Account mostra a entidade correta (middag_br ou middag_global).
  • Organization está correta.

Passo 5. Se a fatura não aparecer:

  1. Verifique o dashboard do Stripe para a fatura na conta correta (BR ou GLOBAL).
  2. Vá em MIDDAG Account > Logs e pesquise por eventos de webhook. Procure por eventos invoice.created ou invoice.paid.
  3. Se o webhook falhou, você pode acionar uma re-sincronização a partir do dashboard do Stripe reenviando o evento, ou aguardar o cron de reconciliação (executado a cada 15 minutos).

Parte B: Baixar o PDF da fatura ​

Passo 6. Na página de detalhes da fatura, clique em Download PDF.

Passo 7. O sistema redireciona para o PDF da fatura hospedado no Stripe. Se o PDF do Stripe não estiver disponível, o sistema gera um PDF personalizado e o armazena no Cloudflare R2.

Passo 8. O cliente também pode baixar o PDF pelo portal em Invoices. Tanto as faturas do Stripe quanto as NFSe são exibidas em uma lista unificada com um indicador visual para cada tipo.

Parte C: Emitir NFSe (apenas para operações brasileiras) ​

Esta seção se aplica somente quando a entidade de faturamento é MIDDAG BR. Transações internacionais (GLOBAL) não requerem NFSe.

Passo 9. Vá em MIDDAG Account > Tax Invoices na barra lateral do admin.

Passo 10. Verifique se uma NFSe já foi criada automaticamente. Quando um pagamento BR é confirmado, o sistema tenta a emissão automática de NFSe:

  1. Extrai detalhes do serviço e valores do pedido.
  2. Lê as informações fiscais do cliente (CNPJ, endereço) da Organização.
  3. Envia uma requisição XML ao web service do ISSNet (Brasília/DF).
  4. A NFSe é registrada como pending ou issued.

Passo 11. Se o status da NFSe for pending:

  • Um cron job verifica o ISSNet a cada 5 minutos para atualizações de status.
  • Após aprovação, o status transita para issued com o número oficial da NFSe e o código de verificação.
  • Se permanecer pendente por mais de 24 horas, uma notificação para o admin é acionada.

Passo 12. Se a emissão automática falhou ou a NFSe não foi criada:

  1. Clique em Issue NFSe Manually na página de detalhes do pedido ou da fatura.
  2. Revise e ajuste os dados pré-preenchidos: descrição do serviço, código tributário municipal (CNAE), valor, informações fiscais do cliente.
  3. Clique em Submit to ISSNet.
  4. O sistema envia a requisição e registra o resultado.

Passo 13. Verifique a NFSe:

  • Status deve ser issued.
  • NFSe Number e Verification Code estão preenchidos (atribuídos pela autoridade municipal).
  • O cliente pode ver e baixar a NFSe (XML e PDF) pelo portal em Invoices.

Parte D: Experiência do cliente ​

Passo 14. O cliente vê tanto as faturas do Stripe quanto as NFSe em uma lista unificada no portal em Invoices. Cada entrada tem um rótulo visual:

  • Commercial Invoice -- do Stripe.
  • Tax Invoice (NFSe) -- do ISSNet (apenas BR).

Passo 15. O cliente pode filtrar por tipo, status, período e baixar PDFs ou XML diretamente.

Resultado esperado ​

  • Uma fatura do Stripe com status paid existe e está vinculada ao pedido e à Organização.
  • O cliente pode baixar o PDF da fatura pelo portal.
  • Para transações MIDDAG BR: uma NFSe foi emitida via ISSNet com número oficial e código de verificação. O cliente pode baixar tanto o XML quanto o PDF.

Leitura complementar ​