---
title: Faturas e razão
description: Onde o dinheiro é registrado no NexCMP — o razão da carteira, faturas, pagamentos de recarga, reembolsos e repasses, vales e relatórios de receita.
url: https://nexcmp.com/pt/docs/billing/invoices-and-ledger/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Faturas e razão {#invoices-and-ledger}

> **Onde no admin:** Finance › Billing (`/billing`) com as abas Overview, Transactions (`/billing/ledger`), Invoices (`/billing/invoices`), Top-ups (`/billing/deposits`), Payouts (`/billing/payouts`), Vouchers (`/billing/vouchers`) e Reports (`/billing/reports`). **Onde no portal:** Billing (`/billing`).

## O que faz {#what-it-does}

Cada valor no NexCMP é armazenado em centavos de USD e registrado uma vez. A ideia principal: o **wallet ledger** é a fonte de verdade para os saldos; faturas, pagamentos de recarga e relatórios são visualizações construídas a partir dele. O registro é **somente anexação** — um erro é corrigido adicionando uma entrada de estorno, nunca editando o histórico.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Função | Um administrador. |
| Detalhes do vendedor | Defina o nome legal, ID fiscal, endereço, e-mail de contato e o prefixo do número da fatura em **System › Settings › General**, aba **Seller & invoicing** (`/settings?tab=seller`), cartão **Seller details (printed on invoices)**. |
| Dependências | [Payment channels](https://nexcmp.com/pt/docs/billing/payment-channels/) para entrada de dinheiro. |

## As peças {#the-pieces}

| Aba de admin | O que lista | Uso típico |
|---|---|---|
| **Overview** | Receita hoje e neste mês, totais do razão por tipo (depósito, cobrança, reembolso, ajuste, voucher), faturas por status, reembolsos pendentes, atalhos, gastos por serviço nos últimos 30 dias | Verificação diária |
| **Transactions** | O razão da carteira, uma linha por movimento | Explicar o saldo de um cliente |
| **Invoices** | Faturas e uma segunda visualização **Orders** com cada compra de cada serviço | Encontrar um documento, reenviar, marcar como pago |
| **Top-ups** | Pagamentos recebidos através dos gateways | Verificar um pagamento, reembolsá-lo |
| **Payouts** | Reembolsos de cartão, pagamentos de afiliados, saques de revendedores | Aprovar saída de dinheiro |
| **Vouchers** | Códigos de recarga | Ver [Promotions](https://nexcmp.com/pt/docs/billing/promotions/) |
| **Reports** | Receita, por serviço, por revendedor | Contabilidade |

### Transactions (ledger) {#transactions-ledger}

Colunas: horário, cliente, **tipo**, serviço, valor (com sinal), VM, referência, ator, nota. Filtros: tipo, serviço, ID do cliente, site (quando você tiver revendedores), intervalo de datas e um link de VM.

| Tipo | Significado |
|---|---|
| `deposit` | Recarga de um gateway |
| `charge` | Dinheiro retirado por um serviço (pedido, renovação, uso por hora...) |
| `refund` | Dinheiro devolvido à carteira |
| `adjust` | Crédito ou débito do administrador e também códigos de recarga (referência começando com `vch:`) — a visão geral mostra os vouchers em sua própria linha |

Cada linha tem uma referência como `dep:stripe:<payment-id>`; a mesma referência nunca pode ser gravada duas vezes, por isso um webhook repetido não pode creditar duas vezes. Use **Customers › List › customer › Credit / debit** para adicionar um ajuste manual: um motivo é obrigatório, um valor positivo também tenta desbloquear VMs bloqueadas por falta de fundos e a ação é confirmada em duas etapas.

![Aba Transactions exibindo as linhas do razão da carteira com tipo, serviço, valor e referência](https://nexcmp.com/pt/docs/images/billing/invoices-and-ledger-01-ledger.webp)

### Invoices {#invoices}

Uma fatura é criada automaticamente quando um cliente compra ou renova algo pago com a carteira, ou para uma recarga. Os números parecem com `<prefix><YYYYMM>-<000001>` (por exemplo, `NX202610-000042`); sites de revendedores usam seu próprio prefixo e sequência. Números existentes nunca mudam quando você altera o prefixo.

| Campo | Valores |
|---|---|
| Tipo | Receipt, Renewal, Top-up, Manual, Refund |
| Status | Unpaid, Paid, Overdue, Cancelled, Refunded |

Ações em uma linha:

| Ação | Efeito |
|---|---|
| **View** / **Print** | Abre a fatura; o portal também pode imprimir ou salvar como PDF. |
| **Mark paid** (apenas não paga ou vencida) | Marca como paga **sem movimentar dinheiro da carteira** — use quando o cliente pagou fora do NexCMP. Um motivo é obrigatório. Para uma fatura de renovação, também estende e desbloqueia a VM bloqueada. |
| **Cancel** (apenas não paga ou vencida) | Cancela a fatura. Um motivo é obrigatório. |
| **Resend** | Envia a fatura por e-mail novamente. |

**Create manual invoice** (botão no topo da aba): ID do cliente, 1 a 50 linhas (descrição, quantidade, preço unitário), ID de VM opcional, dias para vencimento opcionais (0 a 365, padrão 7), nota opcional. É criado como não pago; o cliente vê em **Billing › Invoice History**.

Faturas não pagas de serviços são **quitadas automaticamente a partir da carteira** assim que houver saldo, portanto a ação do cliente é simplesmente fazer uma recarga.


### Recargas (pagamentos) {#top-ups-payments}

Uma linha por tentativa: hora, cliente, **gateway e método**, tipo (recarga ou recarga automática), status (pendente, concluído, falhou, reembolsado, contestado, cancelado), o que o cliente pagou, a taxa, o que foi para a carteira, a referência do gateway e a hora de conclusão. Pagamentos concluídos do Stripe e PayPal têm uma ação de **Refund**. Use as páginas de eventos do Gateway para ver webhooks ([Payment channels](https://nexcmp.com/pt/docs/billing/payment-channels/)).

### Pagamentos de saída {#payouts}

Três sub-abas: **Card refunds** (aprovar ou rejeitar solicitações de reembolso; a solicitação é criada a partir de um pagamento concluído), **Affiliate payouts** (saques de comissão) e **Reseller withdrawals**. Cada decisão é auditada.

### Reports {#reports}

**Revenue** (tendência de 30 dias, mês a mês, principais clientes), **By service** e **By reseller**.

![Aba Reports mostrando KPIs de receita e a tendência de trinta dias](https://nexcmp.com/pt/docs/images/billing/invoices-and-ledger-03-reports.webp)

## O que o cliente vê {#what-the-customer-sees}

Em **Billing**, o cliente tem **Balance**, **Deposit**, **Redeem code**, **Settings** (recarga automática) e um histórico com as abas **Invoice History**, **Payment Order**, **Ledger** e **Orders** (cada serviço em uma lista com filtros por serviço e tipo). Cada fatura possui **View**, **Print** e **Save as PDF**; os valores estão em USD, exibidos opcionalmente na moeda de exibição.

## Verificar {#verify}

1. Faça uma pequena recarga como cliente de teste.
2. **Transactions** exibe uma linha `deposit`, **Top-ups** mostra o pagamento como *Completed* e a receita em **Overview** aumenta.
3. Compre algo: uma linha `charge` aparece e **Invoices** exibe uma fatura do tipo *Receipt* ou *Renewal* com os detalhes do vendedor que você configurou.

## Limites e notas {#limits-notes}

- **Somente adição.** Não é possível editar ou excluir uma linha do razão; adicione um ajuste com um motivo.
- **Moeda.** Os valores são em USD; a moeda de exibição é cosmética (consulte [Currency and exchange rates](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/)).
- **Reembolso para o cartão** é feito em duas etapas (solicitação e, em seguida, aprovação em Payouts); USDT e transferências bancárias não são reembolsados para a origem.
- **Tudo é auditado** em System › Logs › Admin actions com o motivo que você informou.
- **Pedidos vs faturas.** O uso por hora não é faturado por hora; a visualização Orders o agrupa por dia para que você ainda possa vê-lo.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| O saldo do cliente parece incorreto | Uma cobrança, ajuste ou voucher inesperado | Filtre **Transactions** pelo ID do cliente e leia as referências e notas. |
| "A fatura já está paga" (409) | Marcar como paga em uma fatura paga | Nada a fazer. |
| Não é possível cancelar uma fatura | Apenas faturas não pagas ou vencidas podem ser canceladas | Para as pagas, use um reembolso ou um ajuste. |
| Detalhes do vendedor ausentes nas faturas | Não preenchido | Preencha **Seller details** em System › Settings › General › Seller & invoicing. |
| Crédito / débito recusado | O valor é zero ou superior a $100,000 | Use um valor entre 1 cent e $100,000. |
| Um pagamento mostra *Pending* por muito tempo | Webhook ausente | Consulte **Gateway events** e reexecute. |