Una frontera, no un integrador.
cifraHQ gobierna el 'qué' financiero. P4W gobierna el 'dónde' físico. El contrato entre los dos está congelado y probado round-trip — no es un proyecto de integración, es el producto.
Quién gobierna qué
- cifraHQ gobierna el "qué". SKUs como entidad (
Productcon discriminator), costo unitario y valuación perpetua, órdenes de compra (PurchaseOrder), recibo como documento (GoodsReceiptNote), GRNI accrual, cuenta por pagar, documentos de ajuste contable. - P4W gobierna el "dónde". Bins, zonas, ubicaciones físicas dentro del warehouse, picks, packs, movimientos entre bins, FIFO/FEFO por pick, handheld scan, etiquetado. Todo lo que ocurre debajo del nivel
Warehouse. - Sin sub-warehouses en cifraHQ. Permanente. El único nivel es
Warehouse— bajar del warehouse es el espacio de P4W. Evita que ambos productos traten de ser la autoridad del bin. - Sin product variants en cifraHQ. Permanente. Cada combinación de atributos es su propio SKU. El modelo de variante es conflicto directo con la forma en que P4W modela físicamente — se excluye por diseño.
- Sin hard kits en cifraHQ. Permanente. Solo bundles suaves (explotados en la factura). Los kits físicos vivos pertenecen al shop floor — eso es P4W.
Qué cruza la frontera
cifraHQ → P4W
Catálogo de SKUs, recepciones por postear, órdenes de venta a picar, transferencias aprobadas. cifraHQ genera la obligación de trabajo; P4W la ejecuta.
P4W → cifraHQ
Confirmaciones de pick completo, actualizaciones de cantidad disponible, ajustes físicos con razón (daño, diferencia de conteo), completions de recepción con lot/serial resueltos.
Round-trip probado
Phase 1c incluye WMS sync round-trip verification a escala de 5,000 tenants. No se ship hasta que la reconciliación esté limpia.
Los cinco happy paths
- Compra y recepción. PO posteada en cifraHQ; expected receipt a P4W. P4W confirma recepción física con lot/serial. cifraHQ genera
GoodsReceiptNote, acumulaGRNI, espera la factura del proveedor. - Venta y pick. SO aprobada en cifraHQ; pick instruction a P4W. P4W ejecuta pick físico, confirma cantidad y lot. cifraHQ genera
DeliveryNote, factura, postea AR y actualiza inventario. - Transferencia entre bodegas.
WarehouseTransferposteado en cifraHQ comoShipment; P4W ejecuta el envío físico. ElReceiptllega cuando P4W confirma llegada a destino — ventana de en-tránsito visible. - Physical count. cifraHQ prepara la lista de conteo; P4W ejecuta el count físico con handheld. La variance regresa a cifraHQ, genera auto-ajuste con razón.
- Ensamble (producción). Assembly order release en cifraHQ; P4W reserva componentes en bins, ejecuta el ensamble físico, confirma finish. cifraHQ postea varianza planeado vs. actual y actualiza costo del producto terminado.
El producto funciona sin la integración
No todo cliente necesita P4 Warehouse. Para distribuidores mid-market con un solo warehouse y flujo simple, cifraHQ opera standalone con su propio modelo de inventario — ajustes, transferencias, counts y producción se ejecutan completamente en cifraHQ.
- Mismo modelo, sin bins.
InboundAdjustment,OutboundAdjustment,WarehouseTransferyPhysicalCountexisten y funcionan — sin detalle de bin. - Upgrade path limpio. Activar P4W en un tenant standalone no requiere migración de datos — el contrato de sync frena los movimientos locales y la autoridad del
dóndepasa a P4W. - Sin penalty. La decisión de usar P4W es operacional, no de licencia. El producto está completo en ambos modos.
El contrato técnico
- Contrato congelado en Phase 1a. El contrato P4W se congela como primera entrega de módulo — ambiguedad en el contrato cascada en retrasos de todos los otros módulos. Cero cambios de contrato después de Phase 1a.
- Mensajería asincrónica con reintento. Hangfire jobs dispatchan mensajes al P4W endpoint; política de retry con backoff exponencial. Falla dura solo después de reintentos agotados — y en ese caso, dashboard alerta.
- Idempotencia en ambos lados. Cada mensaje lleva identificador único; reaplicación del mismo mensaje no genera efecto duplicado. Permite replay sin corrupción.
- Reconciliación diaria. Job Hangfire nocturno compara balances de inventario cifraHQ vs. P4W por SKU y warehouse. Discrepancias van a un dashboard dedicado con drill-down al mensaje responsable. (Detalles de formato de payload y endpoints específicos: ver guía de integración.)
Cómo se ve sin esta frontera
| cifraHQ + P4W | ERP con WMS propio | |
|---|---|---|
| Autoridad del bin | P4W explícito | ERP lo intenta, mal |
| Contrato de sync | Congelado, round-trip probado | Ad-hoc, propenso a drift |
| Pick físico | Handheld de P4W, rápido | UI de ERP, lento |
| Valuación contable | Siempre en cifraHQ | Disputa entre módulos |
| Reconciliación | Job diario con alertas | Proyecto de cierre anual |
Demo de la frontera cifraHQ + P4W
Si ya tiene P4W o lo está evaluando, le mostramos el contrato completo en una sesión técnica de 60 minutos.