Conciliação de faturamento

Empresas com mais de uma conta de billing (por empresa do grupo, linha de produto ou subsidiária) empilham as contas numa tabela só, com uma coluna de origem. O id da fatura só é único dentro da conta: a chave é origem + id. Toda conta nova entra na mesma tabela no dia em que é conectada.

Gateways geram mais de um registro para a mesma cobrança (segunda via, reemissão, retentativa). Fique com um por cobrança pela ordem: paga, chargeback, reembolsada, em protesto, pendente, expirada; no empate, a mais recente. Assim uma segunda via paga não convive com a primeira expirada.

Cada tentativa de cartão vira uma linha de charge, e uma fatura pode ter várias recusas antes de ser paga. Faturamento e caixa contam o documento (fatura do billing, pedido no e-commerce), nunca a tentativa. As recusas vão para uma tabela própria, uma linha por tentativa, com o código de recusa padronizado.

Faturamento do mês = caixa bruto das faturas do mês + o que delas segue em aberto. Cada número tem a sua data: faturamento pela competência ou emissão, caixa pela data de pagamento, em aberto pelo vencimento. Se a identidade não fecha num mês, há duplicidade ou fatura perdida, e o relatório não sai.

O dinheiro do cartão cai no saldo semanas depois do pagamento e parcelado cai por parcela. Monte os recebíveis por transação x parcela com situação realizado ou a receber. Líquido = valor menos taxa, taxa de antecipação e taxa de antifraude. Na projeção, tire vendas com chargeback ou reembolso. Pix e boleto sem repasse registrado entram no dia útil bancário seguinte, com calendário de feriados bancários (os móveis calculados pela Páscoa).

O ERP guarda o id da fatura do billing num campo personalizado da transação e o id do cliente do billing no cadastro do cliente. A fatura do produto guarda o id da cobrança do gateway (external_id). Cruze por esses ids. Para achar vendido e não recebido, traga só o lado pago do gateway na junção e liste o que ficou sem par.

Gateways têm uma tabela de cobranças e outra de movimentações do saldo, que repete cada pagamento e acrescenta taxas e transferências. Receita vem da tabela de cobranças. No Stripe, ligue charge a assinatura pelas linhas da invoice: a tabela pronta de charges por assinatura só traz as que deram certo.

Stripe, Pagar.me e campos *_cents vêm em centavos: divida por 100 uma vez, na primeira camada. Linhas de pedido de venda em alguns ERPs vêm com sinal invertido e precisam ser negadas. Estornos e reembolsos entram negativos no caixa e positivos na tabela de reembolso, nunca os dois no mesmo total.

Quando a venda é emitida por mais de uma empresa do grupo, cada relatório vem de um token por empresa e leva a coluna empresa. Um código de venda global que aparece nas duas empresas é duplicidade. Se a empresa emissora mudou numa data, a regra de qual empresa vale é por data de corte, declarada.

A conciliação não apaga nem corrige linhas. Ela publica uma tabela por tipo de problema: aprovada fora do emissor de nota, aprovada sem nota emitida, produto fora do de-para, reembolsada com nota ativa, valor divergente entre billing e nota, duplicidade entre empresas. Tabela vazia é o objetivo.