Integrates Odoo inventory with the Booster 3PL warehouse API
Description
Integrates Odoo with the Booster/Solum WMS used by the Prosac 3PL operator, keeping product, inventory and shipment data synchronized in both directions.
Author
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
License
OPL-1
Version
18.0.1.6
Dependencies
sale_stock
purchase_stock
l10n_pe_edi_stock
l10n_pe_cs_edi_stock
cs_product_custom_categ
cs_product_approval
cs_stock_to_deliver
cs_sale_uom
1. Configuration
Booster API
Open Inventario → Configuración → Integración Odoo SAP → Config API Booster.
Fill Proyecto, Usuario, Token and URL Base with the values from the 3PL (do not publish them).
Keep the Puntos de Acceso unless Booster changes a path. The URLs block is computed and read-only.
Click Generar Token until the status is Autorizar.
Set Usuarios a Notificar for sync-failure mail.
Configuración de API Booster. Token is hidden here; URLs are built from Proyecto + URL Base + endpoints.
The scheduled action Master Sync Coordinator (every minute) drains the queue: products (PostMaster), inbound ASN (receipts and transfers to the Booster warehouse), outbound shipment orders (deliveries and transfers from the Booster warehouse), customer/vendor returns. Failed jobs retry, then go to dead letter.
Etiquetas Booster
Open Inventario → Configuración → Configuración Booster → Gestión de Etiquetas (Settings or Inventory administrators).
Create tags with Nombre de Etiqueta, Categoría and Índice de Color.
Categories: U_BZ_DOCUMENTOS, U_SL_PARTCLIE, U_BZ_COSTEMB, Requisitos de facturación (GRE PDF only, not sent to Booster).
Etiquetas Booster grouped by Categoría, filter Activo.
Unidad de medida and connected apps
On each UdM used in PostMaster, set Código de refuerzo (live example: UNIDAD → UND). Under Ajustes → Usuarios y compañías → Aplicaciones Conectadas, administrators issue ID de cliente / Client Secret for webhook callers (Booster/SAP). Do not paste those secrets into documents.
2. User instructions
Contact — tab API Booster
On the company (or a delivery address), open API Booster:
Enviar archivos de productos / Enviar archivos adjuntos de preparación de pedidos — company-level flags for fulfillment files (inherited by child contacts).
No acepta entregas parciales — CheckPicking rejects a partial delivery and notifies the API users plus the contact’s Backoffice salesperson.
Documentos Booster, Particularidades del Cliente Booster, Tipos de Empaque Booster (tags and the SIMPLE/COMPLEJO list, live SENCILLO).
Requisitos para las facturas de Booster — printed on the GRE PDF; not sent in the API payload.
AQUA GOCTA: Documentos Booster Doc prueba, Particularidades Particularidad Prueba, Requisitos para las facturas 1xFact and 3xGRE, empaque SENCILLO.
New delivery addresses copy empty Booster fields from the parent; you can then change each address.
Product
On the product, tab Ventas, set Tipo de Almacenamiento (e.g. General), Tipo de Empaque (e.g. Simple), Origen del Producto (e.g. Productos comprados) and optional Descripción Booster.
When the product is Válido, use Sincronización Manual (Validate Product group) or wait for the cron after validation.
Banners API Sync Error / Sync Failed offer Reintentar Sincronización or Sincronizar Ahora. Sync logs sit at the bottom of the form.
Producto 01, Ventas: Tipo de Almacenamiento General, Tipo de Empaque Simple, Origen del Producto Productos comprados, Descripción Booster.
Inventario → Integración Odoo SAP also has Verificar Productos Validados / Verificar Plantillas Validadas to queue anything that should have synced.
Transfers
On a picking you see Estado de Sincronización (e.g. Up To Date) and Sincronizado. If it is not current, use Reintentar Sincronización or the warning Sincronizar Ahora. Extra dates: Fecha Enviada, Fecha Recibida, Nombre SAP, Fecha de cumplimiento de entrega. Booster warehouse pickings can show a Booster tab with return codes. The customer portal shows Envío programado and prefers the fulfillment date.
ALW-C/OUT/00019: Estado de Sincronización Up To Date, Sincronizado checked.
Replenishment search adds filters ODT, Desde Almacén Principal and Hacia Almacén Principal.
Sincronización de Datos
Inventario → Integración Odoo SAP → Historial de Sincronización de Datos. Default filter Historial de Sincronización de API. Columns: Nombre de Método, Tipo de Sincronización, Estado, Registro Origen, HTTP, API. Green = success, red = HTTP error or business failure, yellow = pending. Procesar Cola de Sincronización runs pending jobs now.
Sincronización de Datos: GenerateToken, CustomerReturnAuthorization, PostShipmentOrder, AdvancedShipmentNotice, Fulfillment, CheckPicking.UdM UNIDAD with Código de refuerzo UND (next to the SUNAT unit code NIU).
Integración WMS Booster 3PL
Nombre técnico: cs_custom_prosac_booster_3pl
Nombre
Booster 3PL WMS Integration
Resumen
Integra el inventario de Odoo con la API de almacén Booster 3PL
Descripción
Integra Odoo con el WMS Booster/Solum del operador 3PL de Prosac y mantiene sincronizados productos, inventario y envíos.
Autor
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
Licencia
OPL-1
Versión
18.0.1.6
Dependencias
sale_stock
purchase_stock
l10n_pe_edi_stock
l10n_pe_cs_edi_stock
cs_product_custom_categ
cs_product_approval
cs_stock_to_deliver
cs_sale_uom
1. Configuración
API Booster
Abra Inventario → Configuración → Integración Odoo SAP → Config API Booster.
Complete Proyecto, Usuario, Token y URL Base con los datos del 3PL (no los publique).
Deje los Puntos de Acceso salvo que Booster cambie una ruta. El bloque URLs es calculado y de solo lectura.
Pulse Generar Token hasta que el estado sea Autorizar.
Defina Usuarios a Notificar para el correo de fallo de sincronización.
Configuración de API Booster. El token está oculto; las URL se arman con Proyecto + URL Base + puntos de acceso.
La acción programada Master Sync Coordinator (cada minuto) vacía la cola: productos (PostMaster), ASN de entrada (recepciones y transferencias hacia el almacén Booster), órdenes de envío de salida (entregas y transferencias desde el almacén Booster), devoluciones de cliente/proveedor. Los fallos se reintentan y luego pasan a dead letter.
Etiquetas Booster
Abra Inventario → Configuración → Configuración Booster → Gestión de Etiquetas (administradores de Ajustes o Inventario).
Cree etiquetas con Nombre de Etiqueta, Categoría e Índice de Color.
Categorías: U_BZ_DOCUMENTOS, U_SL_PARTCLIE, U_BZ_COSTEMB, Requisitos de facturación (solo PDF GRE; no se envían a Booster).
Etiquetas Booster agrupadas por Categoría, filtro Activo.
Unidad de medida y aplicaciones conectadas
En cada UdM usada en PostMaster, defina Código de refuerzo (ejemplo en vivo: UNIDAD → UND). En Ajustes → Usuarios y compañías → Aplicaciones Conectadas, los administradores emiten ID de cliente / Client Secret para quien llama a los webhooks (Booster/SAP). No copie esos secretos a documentos.
2. Instrucciones de usuario
Contacto — pestaña API Booster
En la compañía (o una dirección de entrega), abra API Booster:
Enviar archivos de productos / Enviar archivos adjuntos de preparación de pedidos — banderas de compañía para archivos de fulfillment (las heredan los contactos hijos).
No acepta entregas parciales — CheckPicking rechaza una entrega parcial y avisa a los usuarios de la API y al vendedor Backoffice del contacto.
Documentos Booster, Particularidades del Cliente Booster, Tipos de Empaque Booster (etiquetas y la lista SIMPLE/COMPLEJO, en vivo SENCILLO).
Requisitos para las facturas de Booster — se imprimen en el PDF GRE; no van en la API.
AQUA GOCTA: Documentos Booster Doc prueba, Particularidades Particularidad Prueba, Requisitos para las facturas 1xFact y 3xGRE, empaque SENCILLO.
Las direcciones de entrega nuevas copian los campos Booster vacíos del padre; luego puede cambiarlos por dirección.
Producto
En el producto, pestaña Ventas, defina Tipo de Almacenamiento (p. ej. General), Tipo de Empaque (p. ej. Simple), Origen del Producto (p. ej. Productos comprados) y, si aplica, Descripción Booster.
Cuando el producto está Válido, use Sincronización Manual (grupo Validar producto) o espere el cron tras validar.
Los avisos API Sync Error / Sync Failed ofrecen Reintentar Sincronización o Sincronizar Ahora. Los registros de sync están al pie del formulario.
Producto 01, Ventas: Tipo de Almacenamiento General, Tipo de Empaque Simple, Origen del Producto Productos comprados, Descripción Booster.
En Inventario → Integración Odoo SAP también están Verificar Productos Validados / Verificar Plantillas Validadas para encolar lo que debió sincronizarse.
Transferencias
En el albarán ve Estado de Sincronización (p. ej. Up To Date) y Sincronizado. Si no está al día, use Reintentar Sincronización o el aviso Sincronizar Ahora. Fechas extra: Fecha Enviada, Fecha Recibida, Nombre SAP, Fecha de cumplimiento de entrega. Los pickings del almacén Booster pueden mostrar la pestaña Booster con códigos de devolución. El portal del cliente muestra Envío programado y prefiere la fecha de fulfillment.
ALW-C/OUT/00019: Estado de Sincronización Up To Date, Sincronizado marcado.
En reabastecimiento se agregan los filtros ODT, Desde Almacén Principal y Hacia Almacén Principal.
Sincronización de Datos
Inventario → Integración Odoo SAP → Historial de Sincronización de Datos. Filtro por defecto Historial de Sincronización de API. Columnas: Nombre de Método, Tipo de Sincronización, Estado, Registro Origen, HTTP, API. Verde = éxito, rojo = error HTTP o de negocio, amarillo = pendiente. Procesar Cola de Sincronización ejecuta los trabajos ahora.
Sincronización de Datos: GenerateToken, CustomerReturnAuthorization, PostShipmentOrder, AdvancedShipmentNotice, Fulfillment, CheckPicking.UdM UNIDAD con Código de refuerzo UND (junto al código SUNAT NIU).
