Skip to content

Faturas

As telas de Faturas exibem todos os registros financeiros gerados a partir de pedidos e assinaturas. Uma fatura rastreia o que foi cobrado, quando o pagamento vence, se já foi pago, e vincula à nota fiscal de serviço (NFSe) correspondente quando aplicável. As faturas originam-se do Stripe (para pagamentos por cartão) ou do Banco Inter (para pagamentos via Pix e Boleto processados pela MIDDAG BR).

Visualização de lista

Abra MIDDAG Account > Faturas para ver todas as faturas de todas as organizações.

Colunas

ColunaO que exibe
NúmeroO número da fatura (clicável -- abre a visualização de detalhes)
PedidoO número do pedido WooCommerce ao qual esta fatura pertence (clicável)
OrganizaçãoA organização do cliente (link clicável para detalhes da Organização)
ValorValor total com moeda (BRL ou USD)
StatusRascunho (cinza), Emitida (azul), Paga (verde), Vencida (vermelho) ou Cancelada (vermelho)
Data de EmissãoQuando a fatura foi emitida
Data de VencimentoPrazo de pagamento. Faturas vencidas destacam esta coluna em vermelho.
Data de PagamentoQuando o pagamento foi recebido (em branco se não paga)

Filtros e busca

Acima da tabela você pode refinar a lista:

  • Busca -- digite um número de fatura, número de pedido ou nome da organização
  • Status -- filtrar por Rascunho, Emitida, Paga, Vencida, Cancelada ou Todos
  • Entidade de Cobrança -- filtrar por MIDDAG BR, MIDDAG GLOBAL ou Todos
  • Período -- filtrar por data de emissão ou data de vencimento
  • Método de pagamento -- filtrar por Stripe Card, Pix, Boleto ou Todos

A barra de filtros exibe a contagem total ("Exibindo 1-25 de 318").

Ações em lote

Selecione múltiplas faturas usando as caixas de seleção e use o dropdown de ações em lote:

  • Exportar CSV -- baixar as faturas selecionadas como planilha
  • Marcar como Paga -- marcar manualmente as faturas selecionadas como pagas (requer confirmação)

Visualização de detalhes

Clique em qualquer número de fatura na lista para abrir a visualização de detalhes.

Cabeçalho

O cabeçalho exibe:

  • Número da fatura com um badge de status (codificado por cores)
  • Nome da organização (link clicável para detalhes da Organização)
  • Botões de ação: Editar, Regenerar PDF, Emitir NFSe, Marcar como Paga (quando aplicável)

Dados da fatura

Uma grade de metadados exibe as informações principais:

CampoDescrição
NúmeroNúmero da fatura
StatusStatus atual com badge colorido
OrganizaçãoNome do cliente (clicável)
PedidoNúmero do pedido WooCommerce vinculado (clicável)
ValorTotal na moeda da fatura
Data de EmissãoQuando a fatura foi criada
Data de VencimentoPrazo de pagamento
Data de PagamentoQuando o pagamento foi recebido
Método de PagamentoStripe Card, Pix, Boleto ou manual
Entidade de CobrançaMIDDAG BR ou MIDDAG GLOBAL
Stripe IDID externo da fatura no Stripe (se a origem for Stripe)
Link do PDFLink para o documento PDF da fatura

Status da NFSe

Abaixo dos dados da fatura, a seção de NFSe (Nota Fiscal de Serviço) exibe:

  • Número da NFSe -- o número da nota fiscal emitida pelo ISSNet (município de Brasília/DF)
  • Status da NFSe -- Emitida ou Cancelada
  • Link da NFSe -- link para o PDF da nota fiscal no portal do município
  • Não aplicável -- exibido quando a fatura pertence à MIDDAG GLOBAL (NFSe brasileira não é necessária)

Registros vinculados

Links para registros relacionados aparecem abaixo da seção de NFSe:

  • Pedido -- o pedido WooCommerce que gerou esta fatura
  • Organização -- o cliente
  • Entitlement -- o entitlement vinculado através do pipeline de pedidos
  • Nota Fiscal -- o registro de NFSe correspondente (se emitido)

Ações

AçãoQuando utilizar
EditarAtualizar notas, data de vencimento ou método de pagamento
Regenerar PDFGerar novamente o documento PDF (útil após editar detalhes da fatura)
Emitir NFSeSolicitar emissão de NFSe via ISSNet para esta fatura (somente MIDDAG BR)
Marcar como PagaRegistrar manualmente o pagamento quando confirmado fora do Stripe/Inter
CancelarCancelar a fatura. Também cancela a NFSe vinculada, se houver uma emitida.

A emissão de NFSe envia uma requisição SOAP ao sistema ISSNet de Brasília/DF. Um cron job em segundo plano verifica o status da emissão a cada 5 minutos até que a NFSe seja confirmada ou rejeitada pelo município.

Páginas relacionadas