Aplin Connector for Odoo - Seguimiento y errores
Todo lo que el conector hace con Aplin queda registrado, y todo lo que falla se puede relanzar. Este es el sitio al que ir cuando algo no cuadra.
📁 El menú Aplin
En Inventario → Aplin, visible para el grupo Aplin: Administrador:
Registros Cada llamada a la API con su petición, su respuesta, su código HTTP y el albarán o producto al que corresponde. Filtros por operación, por resultado y por fecha.
La cabecera de autorización nunca se guarda: la bitácora sirve para diagnosticar, no para filtrar credenciales.
Albaranes con error Lo que Aplin rechazó. Abre el albarán, lee la razón en el chatter y pulsa Reintentar en Aplin.
Albaranes en Aplin Todo lo que ya tiene identificador remoto.
Ajustes Atajo a la configuración del conector.
👀 Ver el estado de un vistazo
En el albarán: una cinta en el formulario (En Aplin, Error Aplin, Cancelado en Aplin) y la columna Aplin en la lista de transferencias, visible por defecto. Ambas aparecen sólo en los albaranes del almacén configurado.
En el producto: la cinta En Aplin o Parcial en Aplin, el campo Estado en Aplin de la pestaña Inventario y la columna en la lista.
En la lista de albaranes también tienes los filtros Error en Aplin y Sincronizado con Aplin, y dos acciones de servidor para trabajar sobre varios a la vez: Consultar estado en Aplin y Reintentar sincronización con Aplin.
💥 Qué pasa cuando falla
Lo primero: nada en Odoo se detiene. La validación del albarán se completa siempre, porque la llamada a Aplin sale después de que la operación esté guardada. Nunca vas a tener a alguien esperando en el almacén porque una API de terceros no responde.
Según el fallo:
| Fallo | Estado del albarán | Cómo se recupera |
|---|---|---|
| Aplin responde con un error | Error, con la razón textual | Botón Reintentar o el proceso automático |
| Red caída o tiempo agotado | Error — «No se pudo contactar con Aplin» | Ídem |
| Se agota el tiempo después de que Aplin lo creara | Sincronizado | Automático: se busca por número y se adopta |
| El servidor se reinicia antes de enviar | Sin sincronizar | El proceso de reintentos lo recoge |
🛡️ Lo que el conector garantiza
Nunca duplica un documento. Aplin obliga a que el número de entrada y el de orden sean únicos. Antes de dar un alta por fallida, el conector busca en Aplin si ya existe con ese número y adopta su identificador. En el chatter aparece como «El documento ya existía en Aplin con el identificador N; se vinculó sin volver a crearlo».
No dice que algo está sincronizado si no lo está. Si Aplin acepta el documento pero la respuesta no trae un identificador legible, el albarán queda en Error avisando de que puede existir ya en Aplin. Sin identificador no se puede liberar, consultar ni cancelar, así que llamarlo sincronizado sería mentir.
No pierde una operación. Si el proceso muere entre la validación y el envío, el proceso de reintentos recupera las entradas y el de órdenes recupera las salidas.
🔧 Errores frecuentes
Producto no encontrado para el sku: X
El SKU no existe en Aplin. Da el producto de alta en su panel, o revisa la sincronización de productos.
This endpoint requires extended access (403)
Tu clave de API no puede dar de alta productos. Usa el modo Aplin → Odoo o pide a Aplin una clave con acceso extendido.
NO_TRANSPORTER_ASSIGNED
La orden llegó sin guía y sin transportista. Ver Órdenes de venta.
fulfillment is not OK
Aplin no tiene existencias físicas. La entrada correspondiente sigue pendiente de recibir en su almacén.
Los siguientes couriers no existen en la organizacion…
El courierId de los ajustes no es válido. Pídeselo a Aplin: su API no ofrece ningún listado.
El albarán no tiene contacto…
Una entrega sin contacto no puede convertirse en orden, porque Aplin necesita comprador y dirección.
⚠️ Los reintentos no corrigen datos
El proceso automático recupera caídas: red, tiempos agotados, reinicios.
Un fallo que no es transitorio —un SKU que no existe, un transportista inválido, un albarán sin contacto— se reintentará cada 30 minutos y fallará siempre igual, hasta que alguien corrija el dato.
Por eso conviene revisar Albaranes con error con cierta regularidad. Si la lista está vacía, la operación está limpia.