Conector Amazon para Dolibarr: pedidos, FBA, stock, seguimiento y liquidaciones

Conecte Dolibarr con la API Selling Partner de Amazon y haga circular la información en los dos sentidos. Los pedidos enviados por usted o por Amazon se convierten en pedidos, expediciones y facturas; el stock y los números de seguimiento vuelven hacia Amazon; las liquidaciones y las devoluciones se recuperan línea a línea. Cada intercambio deja una cola cuyas líneas con error se reprocesan solas. Un modo simulación permite configurarlo y demostrarlo todo sin cuenta de Amazon. 

¿Para quién? Vendedores de Amazon que gestionan su actividad en Dolibarr: marcas, distribuidores, revendedores multipaís, comercios electrónicos tanto en FBM como en FBA, y los integradores que los acompañan. Un marketplace o veinte, una cuenta de vendedor o varias, el principio es el mismo.

Cuentas de vendedor e instancias

• Una cuenta de vendedor contiene las credenciales de una aplicación Amazon, la región de la API y los valores por defecto: cliente de reserva, comercial, almacén, banco, producto de portes.
• Una instancia enlaza esa cuenta con un marketplace: es ella la que lleva la divisa, los almacenes, el flujo de trabajo, la política de stock y el IVA.
• 23 marketplaces instalados con su identificador real, en las tres regiones: América del Norte, Europa, Extremo Oriente.
• Varias cuentas de vendedor y tantas instancias como haga falta, cada una con sus propios ajustes.
• Una prueba de conexión solicita un token y luego lee los marketplaces de la cuenta, y distingue un problema de credenciales de un problema de rol o de región.

Importación de pedidos

• Importación de los pedidos enviados por el vendedor (FBM) y de los pedidos enviados por Amazon (FBA), para que la facturación esté completa.
• El comprador, la dirección de entrega, las líneas, los importes, el IVA, los portes y la ventana de expedición se recuperan íntegramente.
• El conector parte siempre de la última sincronización. Un pedido modificado en Amazon se vuelve a recuperar.
• Un pedido cancelado se cierra sin crear nada; un pedido pendiente en Amazon se deja aparte y se recupera automáticamente después.
• Búsqueda y filtros por número de pedido, comprador, ciudad, seguimiento, estado, canal de expedición y estado del flujo de trabajo.
• La ficha muestra enfrentados lo que viene de Amazon y lo que existe en Dolibarr, con enlaces directos al pedido, a la expedición y a la factura.

Un flujo de trabajo en diez interruptores

• Diez interruptores deciden, instancia por instancia, lo que se crea: crear el cliente, validar el pedido, crear la expedición, validarla, crear la factura, validarla, registrar el cobro, enviar el stock, enviar el seguimiento.
• Una etapa desactivada simplemente se omite: el pedido se queda en la fase alcanzada y se termina a mano.
• Cada etapa superada se guarda de inmediato: una ejecución interrumpida continúa donde se detuvo, nunca desde el principio.
• Un comprador desconocido se convierte en un cliente, o recae en el cliente de reserva de la cuenta, a su elección.
• Un pedido con una línea que lleva una oferta sin asociar se marca en error en lugar de crearse mal: se asocia, se relanza y sigue adelante.
• El cobro se registra en la cuenta bancaria de la cuenta de vendedor, con el número de pedido de Amazon como referencia.

Ofertas y asociación con los productos

• Importación de las ofertas del vendedor: SKU, ASIN, título, marca, código de barras, precio, cantidad, canal de expedición y estado.
• Asociación automática con el producto de Dolibarr por referencia, código de barras, campo adicional Amazon SKU y luego etiqueta.
• Una correspondencia encontrada solo por la etiqueta se marca como dudosa en lugar de aplicarse en silencio; varios productos homónimos no asocian nada.
• Asociación manual directamente en la lista, sin salir de la pantalla, y botón para asociar todo lo que se pueda asociar.
• Una oferta que no debe tratarse nunca se pone en ignorada; creación automática de los productos que falten como opción.
• La ficha de producto de Dolibarr recuerda las ofertas de Amazon asociadas a él.

Stock en los dos sentidos

• Envío del stock a Amazon con cinco métodos: cantidad fija, stock real, stock virtual, stock real menos un margen, porcentaje del stock real.
• Un tope opcional y un plazo de preparación declarado acompañan cada envío.
• Una vista previa muestra, oferta por oferta, la cantidad que se enviaría: la regla se comprueba antes de activarse.
• En el otro sentido, el inventario en poder de Amazon se lee y se copia en un almacén dedicado, mediante movimientos de stock: el stock de Dolibarr queda completo.
• Los números de seguimiento de las expediciones validadas vuelven hacia Amazon, lo que marca el pedido como enviado y desencadena el pago al vendedor.

Liquidaciones y devoluciones

• Importación de los movimientos financieros de Amazon, agrupados por periodo: ventas, IVA, comisiones, gastos FBA, reembolsos y suscripción.
• Cinco totales por liquidación — saldo, ventas, gastos, reembolsos, otros — y el detalle línea a línea, enlazado con los pedidos conocidos.
• La respuesta a la pregunta de los contables: por qué la transferencia de Amazon no coincide con la facturación.
• Importación de las devoluciones de clientes gestionadas por Amazon: identificador, pedido, SKU, estado de la mercancía, motivo, centro logístico.
• Una devolución revendible vuelve al stock con un clic, mediante un movimiento en el almacén de Amazon.

Colas y reprocesamiento

• Cada intercambio abre una cola con una línea por registro recuperado y su contenido útil.
• Una línea con error conserva su contenido y su motivo: se corrige la causa y luego se reprocesan los errores sin volver a pedir nada a Amazon.
• Estados claros: en curso, terminada, parcial, en error, nada que hacer. Avance, duración y origen — manual, planificada, automática, reprocesamiento.
• Nueve tareas programadas instaladas: pedidos, flujo de trabajo, seguimiento, stock, inventario de Amazon, ofertas, liquidaciones, devoluciones, mantenimiento.
• Un script de línea de comandos lanza los mismos tratamientos para un planificador externo o para una recuperación.
• Un registro de llamadas conserva la operación, el código HTTP, la duración y un extracto de la petición y de la respuesta.

Seguridad y datos personales

• Las tres credenciales de Amazon se almacenan cifradas y nunca se vuelven a mostrar en claro.
• Nunca aparecen en el registro: la llamada que intercambia el token solo anota su naturaleza. El registro puede abrirse a un soporte técnico.
• Una credencial dejada vacía durante una modificación conserva el valor guardado; cualquier cambio invalida el token en caché.
• Los datos de los compradores se borran automáticamente tras un plazo que usted fija, como exige Amazon. Los importes y los documentos contables se conservan.
• Siete permisos separados: consultar, crear, eliminar, sincronizar, ejecutar el flujo de trabajo, consultar el registro, configurar.
• El modo simulación genera en local pedidos, ofertas, inventario, movimientos financieros y devoluciones a partir de sus propios productos: nada sale del servidor y el resultado es reproducible.

Información técnica

• Compatible con Dolibarr 16 y superior (probado en 23.x), PHP 7.4 a 8.4, MySQL/MariaDB, multiempresa.
• Módulos necesarios: Productos, Pedidos, Facturas, Terceros. Stock, Expediciones, Bancos y Proyectos se utilizan si están activos.
• Instalación mediante el envío de módulo estándar, sin ninguna modificación del núcleo de Dolibarr.
• 13 tablas dedicadas, cliente SP-API completo con paginación, recuperación ante limitación de caudal, flujos e informes comprimidos.
• 5 idiomas: francés, inglés, español, alemán, italiano. Documentación PDF incluida, soporte NextGestion.

Demo del módulo Amazon Connector
Usuario : demo
Contraseña : demo