Aplin Connector for Odoo - Entradas de mercancía
Cuando validas una recepción en el almacén de Aplin, el conector la declara como entrada en su sistema. No hay que pulsar nada más.
🔄 Cómo funciona
- Recibes la mercancía en Odoo como siempre y validas el albarán.
- Odoo confirma los movimientos de stock y cierra la operación.
- Ya con todo confirmado, el conector envía la entrada a Aplin.
- El albarán queda marcado como Sincronizado con su identificador, y el chatter recoge la confirmación.
Ese orden importa: la llamada a Aplin sale después de que la operación se haya guardado. Así una caída de la API nunca bloquea a quien está recibiendo mercancía, y un fallo posterior en Odoo no puede dejar una entrada en Aplin sin contraparte.
📋 Qué se envía
| Campo en Aplin | De dónde sale |
|---|---|
inboundNumber | Nombre del albarán (TSTN/IN/00009) |
supplier | Contacto del albarán; si no hay, el nombre de la compañía |
type | El tipo de entrada de los ajustes |
invoiceNumber | Documento origen del albarán |
lines | Una por movimiento, con la cantidad realmente recibida |
Cada línea identifica su producto con el identificador de Aplin si está vinculado, y con el SKU si todavía no lo está. Nunca los dos: la API los rechaza juntos.
📥 Qué recepciones cuentan
Cualquier albarán de tipo entrada en el almacén configurado:
- Recepciones de una orden de compra.
- Reabastecimientos que llegan desde otro almacén. La mercancía llega de verdad al operador logístico, así que declararla es lo correcto.
- Devoluciones de un cliente.
Las de cualquier otro almacén no se envían, ni se marcan, ni se reintentan.
❌ Cuando falla
El fallo más frecuente es un producto que Aplin no conoce:
500 {"success":false,"error":"Producto no encontrado para el sku: SIN-APLIN-001"}La entrada se rechaza entera, aunque el resto de líneas fuesen correctas. Es deliberado: una entrada a medias en el almacén es mucho peor que un error visible en Odoo.
Cuando pasa:
- El albarán sigue validado en Odoo. La mercancía está recibida.
- Queda en estado Error, con la razón textual en el chatter.
- Aparece en Inventario → Aplin → Albaranes con error.
- El botón Reintentar en Aplin lo relanza, y el proceso automático de reintentos lo intenta cada 30 minutos.
Para resolverlo, da de alta el SKU que falta en Aplin y reintenta.
💡 Tip: Si el fallo no es transitorio —un SKU que no existe, un dato que falta—, el reintento automático seguirá fallando indefinidamente. Revisa Albaranes con error de vez en cuando: el proceso recupera caídas, no corrige datos.
🛡️ Lo que no puede pasar
No se duplican entradas. Aplin obliga a que el número de entrada sea único, y el conector, antes de dar un alta por fallida, busca por número entre las entradas recientes. Si Aplin ya la tenía —porque la llamada expiró justo después de crearla—, adopta su identificador en lugar de intentarlo otra vez. En el chatter lo verás como «El documento ya existía en Aplin…».
No se pierde una recepción. Si el servidor se reinicia entre la validación y el envío, el albarán queda en Sin sincronizar y el proceso de reintentos lo recoge en la siguiente pasada.
🚫 Cancelar
Odoo no permite cancelar un albarán ya validado, así que el botón Cancelar en Aplin de la cabecera es la vía para anular la entrada en su sistema. Anula el documento remoto sin tocar el albarán de Odoo.
📦 Después de la entrada
La entrada nace en estado OPEN con la cantidad declarada y cero recibida. Es Aplin quien da entrada física a la mercancía en su almacén.
Hasta que eso ocurra, Aplin no tiene existencias reales y las órdenes de venta no se pueden liberar. Si ves órdenes bloqueadas con fulfillment is not OK, casi siempre es esto: la entrada sigue pendiente de recibir en el panel de Aplin.