Visão geral
O Financeiro do NexLog OS é a camada contábil da operação logística. Reúne seis capacidades: provisão (Accrual Engine), rateio de custo (Cost Allocation), sinistros e chargebacks (Claims & Chargebacks), rentabilidade por recorte (Profitability Lens), liquidação com transportadoras (Settlement) e faturamento ao cliente (Billing Engine).
As entidades freightInvoices, costAllocations, claims e billingEntries vivem no mesmo modelo canônico de WMS, TMS e OMS, e cada passo emite um evento canônico no ledger.
Entidades principais
Nome em português e code em inglês (a collection no MongoDB), o mesmo em toda a plataforma.
| Entidade | Code | Descrição |
|---|---|---|
| Fatura de frete | freightInvoices | Documento de cobrança da transportadora. É conciliada na auditoria de frete, provisionada e paga na liquidação. |
| Rateio de custo | costAllocations | Distribuição dos custos logísticos por pedido, SKU, cliente, canal, CD, rota ou projeto. |
| Sinistro | claims | Indenização por avaria, extravio ou atraso, com impacto na liquidação e no faturamento ao cliente. |
| Lançamento de faturamento | billingEntries | Emissão de faturas ao cliente (B2B e marketplaces) com regras versionadas por contrato. |
Capacidades
Controle financeiro nativo da operação, alimentado pelos mesmos eventos que movem armazém, transporte e pedidos.
Provisão (Accrual Engine)
Contabilização diária do custo esperado e do realizado, alimentando o fechamento e a DRE em tempo real.
Rateio de custo (Cost Allocation)
Rateio determinístico e configurável por pedido, SKU, cliente, canal, CD, rota e centro de custo.
Sinistros e chargebacks (Claims & Chargebacks)
Ciclo completo de sinistro e chargeback, integrado a transitIncidents, freightInvoices e ao faturamento.
Rentabilidade (Profitability Lens)
Margem por qualquer recorte (pedido, SKU, cliente, canal, região), com drill-down.
Liquidação (Settlement)
Liquidação automatizada das faturas com transportadoras, com ajustes e netting.
Faturamento (Billing Engine)
Emissão de billingEntries com regras de contrato, níveis de serviço, surcharges e descontos.
Da auditoria à liquidação
O motor de auditoria de frete (freight audit) confere cada fatura contra o tarifário contratado, os surcharges, o peso cubado real e as rotas efetivamente percorridas.
Divergências geram exceção no Control Tower, bloqueiam o pagamento na liquidação e alimentam o carrier risk score, um score contínuo por transportadora que combina pontualidade (OTD), avarias, sinistros e compliance documental. Sem divergência, a fatura segue para rateio, provisão e liquidação.
Endpoints REST
As entidades financeiras são expostas pela API do TMS, versionada em /api/v1/.
| Endpoint | Método | Entidade |
|---|---|---|
/api/v1/freight-invoices | GET | freightInvoices |
/api/v1/freight-audit/run | POST | Auditoria de frete |
/api/v1/cost-allocations | GET | costAllocations |
/api/v1/claims | POST | claims |
/api/v1/transit-incidents | GET | transitIncidents |
Convenção: endpoints em kebab-case, versionados em /api/v1/, e collections em camelCase. Todos os eventos financeiros também são exportáveis por webhooks.
KPIs que o Financeiro entrega
Custo de servir (cost to serve)
Custo total de frete por pedido, SKU, canal e cliente, com rateio auditado em costAllocations.
Acurácia da auditoria de frete
Percentual de faturas (freightInvoices) auditadas sem divergência.
Margem por recorte
Margem por cliente, canal, SKU e região, calculada a partir do ledger financeiro.
Integração com ERPs
O Financeiro do NexLog OS não substitui SAP, Oracle ou Totvs: ele os complementa. Os eventos financeiros são exportáveis via API REST e webhooks, no mesmo MDM compartilhado com WMS, TMS e OMS.
Os ERPs recebem apenas fatos consolidados (provisão, contas a pagar e contas a receber), enquanto o NexLog OS cuida do detalhe operacional. Essa separação de responsabilidades permite modernizar o supply chain sem trocar de ERP.
O financeiro como camada contábil do supply chain OS
Por que o custo logístico não bate com o financeiro
Em operações tradicionais, o time de transporte aprova faturas (freightInvoices) em planilha, o financeiro paga as transportadoras por lote e o fechamento contábil descobre divergências semanas depois. Previsibilidade e margem se perdem nesse intervalo.
No NexLog OS, cada fatura passa pela auditoria de frete, vira costAllocations rateada pelos objetos de custo relevantes, é provisionada diariamente e paga na liquidação com netting e ajustes. Tudo auditável, com eventos canônicos no ledger.
Rentabilidade e faturamento
A Profitability Lens calcula a margem por qualquer recorte (cliente, canal, SKU, região) em tempo real, porque consome o ledger financeiro diretamente. O Billing Engine emite faturas ao cliente B2B com regras de contrato versionadas: surcharges, descontos, níveis de serviço e bonificações.
Sinistros e chargebacks também vivem aqui, conectados aos incidentes do TMS e às devoluções do OMS. O financeiro deixa de ser um módulo reativo e passa a ser uma camada estratégica.