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
| Coluna | O que exibe |
|---|---|
| Número | O número da fatura (clicável -- abre a visualização de detalhes) |
| Pedido | O número do pedido WooCommerce ao qual esta fatura pertence (clicável) |
| Organização | A organização do cliente (link clicável para detalhes da Organização) |
| Valor | Valor total com moeda (BRL ou USD) |
| Status | Rascunho (cinza), Emitida (azul), Paga (verde), Vencida (vermelho) ou Cancelada (vermelho) |
| Data de Emissão | Quando a fatura foi emitida |
| Data de Vencimento | Prazo de pagamento. Faturas vencidas destacam esta coluna em vermelho. |
| Data de Pagamento | Quando 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:
| Campo | Descrição |
|---|---|
| Número | Número da fatura |
| Status | Status atual com badge colorido |
| Organização | Nome do cliente (clicável) |
| Pedido | Número do pedido WooCommerce vinculado (clicável) |
| Valor | Total na moeda da fatura |
| Data de Emissão | Quando a fatura foi criada |
| Data de Vencimento | Prazo de pagamento |
| Data de Pagamento | Quando o pagamento foi recebido |
| Método de Pagamento | Stripe Card, Pix, Boleto ou manual |
| Entidade de Cobrança | MIDDAG BR ou MIDDAG GLOBAL |
| Stripe ID | ID externo da fatura no Stripe (se a origem for Stripe) |
| Link do PDF | Link 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 --
EmitidaouCancelada - 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ção | Quando utilizar |
|---|---|
| Editar | Atualizar notas, data de vencimento ou método de pagamento |
| Regenerar PDF | Gerar novamente o documento PDF (útil após editar detalhes da fatura) |
| Emitir NFSe | Solicitar emissão de NFSe via ISSNet para esta fatura (somente MIDDAG BR) |
| Marcar como Paga | Registrar manualmente o pagamento quando confirmado fora do Stripe/Inter |
| Cancelar | Cancelar 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
- Pedidos -- as compras que geram faturas
- Organizações -- o cliente que foi cobrado
- Entitlements -- o que o cliente recebeu
- Dashboard -- faturas vencidas aparecem nos itens de ação
- Como os Conceitos se Conectam -- o diagrama completo de relacionamentos