Visión general
Finanzas de NexLog OS es la capa contable de la operación logística. Reúne seis capacidades: provisión (Accrual Engine), prorrateo de costos (Cost Allocation), siniestros y chargebacks (Claims & Chargebacks), rentabilidad por dimensión (Profitability Lens), liquidación con transportistas (Settlement) y facturación al cliente (Billing Engine).
Las entidades freightInvoices, costAllocations, claims y billingEntries viven en el mismo modelo canónico de WMS, TMS y OMS, y cada paso emite un evento canónico en el ledger.
Entidades principales
Cada entidad tiene un nombre descriptivo y un código en inglés (la colección en MongoDB), igual en toda la plataforma.
| Entidad | Código | Descripción |
|---|---|---|
| Factura de flete | freightInvoices | Documento de cobro del transportista. Se concilia en la auditoría de fletes, se provisiona y se paga en la liquidación. |
| Prorrateo de costos | costAllocations | Distribución de los costos logísticos por pedido, SKU, cliente, canal, CD, ruta o proyecto. |
| Siniestro | claims | Indemnización por avería, extravío o retraso, con impacto en la liquidación y en la facturación al cliente. |
| Registro de facturación | billingEntries | Emisión de facturas al cliente (B2B y marketplaces) con reglas versionadas por contrato. |
Capacidades
Control financiero nativo de la operación, alimentado por los mismos eventos que mueven almacén, transporte y pedidos.
Provisión (Accrual Engine)
Contabilización diaria del costo esperado y del realizado, que alimenta el cierre y el estado de resultados en tiempo real.
Prorrateo de costos (Cost Allocation)
Prorrateo determinista y configurable por pedido, SKU, cliente, canal, CD, ruta y centro de costos.
Siniestros y chargebacks (Claims & Chargebacks)
Ciclo completo de siniestro y chargeback, integrado con transitIncidents, freightInvoices y la facturación.
Rentabilidad (Profitability Lens)
Margen por cualquier dimensión (pedido, SKU, cliente, canal, región), con drill-down.
Liquidación (Settlement)
Liquidación automatizada de las facturas de transportistas, con ajustes y netting.
Facturación (Billing Engine)
Emisión de billingEntries con reglas de contrato, niveles de servicio, recargos y descuentos.
De la auditoría a la liquidación
El motor de auditoría de fletes (freight audit) verifica cada factura frente al tarifario contratado, los recargos, el peso volumétrico real y las rutas efectivamente recorridas.
Las discrepancias generan una excepción en el Control Tower, bloquean el pago en la liquidación y alimentan el carrier risk score, un puntaje continuo por transportista que combina puntualidad (OTD), averías, siniestros y cumplimiento documental. Sin discrepancias, la factura sigue a prorrateo, provisión y liquidación.
Endpoints REST
Las entidades financieras se exponen a través de la API del TMS, versionada en /api/v1/.
| Endpoint | Método | Entidad |
|---|---|---|
/api/v1/freight-invoices | GET | freightInvoices |
/api/v1/freight-audit/run | POST | Auditoría de fletes |
/api/v1/cost-allocations | GET | costAllocations |
/api/v1/claims | POST | claims |
/api/v1/transit-incidents | GET | transitIncidents |
Convención: endpoints en kebab-case, versionados en /api/v1/, y colecciones en camelCase. Todos los eventos financieros también se pueden exportar por webhooks.
KPIs que entrega Finanzas
Costo de servir (cost to serve)
Costo total de flete por pedido, SKU, canal y cliente, con prorrateo auditado en costAllocations.
Exactitud de la auditoría de fletes
Porcentaje de facturas (freightInvoices) auditadas sin discrepancias.
Margen por dimensión
Margen por cliente, canal, SKU y región, calculado a partir del ledger financiero.
Integración con ERPs
Finanzas de NexLog OS no sustituye a SAP, Oracle ni Totvs: los complementa. Los eventos financieros se pueden exportar vía API REST y webhooks, en el mismo MDM compartido con WMS, TMS y OMS.
Los ERPs reciben solo hechos consolidados (provisión, cuentas por pagar y cuentas por cobrar), mientras NexLog OS se encarga del detalle operativo. Esa separación de responsabilidades permite modernizar la cadena de suministro sin cambiar de ERP.
Las finanzas como capa contable del supply chain OS
Por qué el costo logístico no cuadra con las finanzas
En las operaciones tradicionales, el equipo de transporte aprueba facturas (freightInvoices) en hojas de cálculo, finanzas paga a los transportistas por lote y el cierre contable descubre discrepancias semanas después. La previsibilidad y el margen se pierden en ese intervalo.
En NexLog OS, cada factura pasa por la auditoría de fletes, se convierte en costAllocations prorrateadas entre los objetos de costo relevantes, se provisiona diariamente y se paga en la liquidación con netting y ajustes. Todo auditable, con eventos canónicos en el ledger.
Rentabilidad y facturación
Profitability Lens calcula el margen por cualquier dimensión (cliente, canal, SKU, región) en tiempo real, porque consume el ledger financiero directamente. El Billing Engine emite facturas al cliente B2B con reglas de contrato versionadas: recargos, descuentos, niveles de servicio y bonificaciones.
Los siniestros y chargebacks también viven aquí, conectados a los incidentes del TMS y a las devoluciones del OMS. Las finanzas dejan de ser un módulo reactivo y pasan a ser una capa estratégica.