Conecta Jumia a AskBiz: pedidos, pagos y stock para marketplaces africanos
Cómo vincular tu cuenta de Jumia Vendor Center a AskBiz usando un Client ID y un Refresh Token, qué se sincroniza realmente y qué todavía queda fuera de alcance.
Key Takeaways
- Jumia vive bajo Sources > E-Commerce junto a Shopify, Amazon FBA, eBay, Etsy, WooCommerce y Walmart — pero a diferencia de esas, no usa una redirección OAuth de un clic.
- Lo conectas manualmente, pegando un Client ID y un Refresh Token que generas tú mismo en Jumia Vendor Center > Settings > Applications (Self Authorisation).
- Cada sincronización trae los pedidos recientes y los niveles de stock actuales de tus tiendas de Jumia; la cifra de pago mostrada por pedido es una estimación a partir de los ingresos del pedido, no el estado de liquidación oficial de Jumia.
- El stock de Jumia alimenta directamente tu vista de inventario del CFO y las alertas de stock bajo etiquetadas por canal — los envíos y el seguimiento de entregas de Jumia quedan deliberadamente fuera del alcance de este conector.
- Este es un conector recién construido, revisado internamente contra la API de Jumia pero aún no verificado de principio a fin en una cuenta de vendedor en vivo — vale la pena revisar tu primera sincronización contra los propios números de Vendor Center.
Qué hace el conector de Jumia
Jumia es una de las fuentes de E-Commerce bajo Sources en AskBiz, junto a Shopify, Amazon FBA, eBay, Etsy, WooCommerce y Walmart. Una vez conectado, es una sincronización de solo lectura: AskBiz lee tus pedidos recientes y niveles de stock actuales de Jumia Vendor Center y los incorpora a tus datos de negocio unificados, el mismo lugar donde llega cada otro canal —tu caja física, tu tienda de Shopify, tus listados de Amazon. Ese es el punto de conectarlo en absoluto: en lugar de iniciar sesión en Vendor Center por separado para ver cómo va tu tienda de Jumia, sus pedidos y stock aparecen junto a todo lo demás, en un solo panel, en tu moneda local.
Por qué no hay un botón "Conectar" de un clic
Shopify, Amazon FBA, eBay y Etsy usan todos OAuth estándar —haces clic en Conectar, te redirigen a iniciar sesión en esa plataforma, apruebas el acceso, y vuelves a AskBiz ya conectado. El Vendor Center de Jumia no ofrece eso para aplicaciones de terceros. En su lugar, funciona con lo que Jumia llama Self Authorization: creas tu propia Application dentro de tu propia cuenta de Vendor Center, y eso genera un Client ID y un Refresh Token limitados a tu tienda. No hay ninguna app propiedad de AskBiz que estés aprobando y ninguna contraseña se transmite entre las dos —estás generando un par de credenciales que solo controla tu cuenta de Jumia, y luego entregando esos dos valores directamente a AskBiz.
Cómo conectar tu cuenta, paso a paso
Inicia sesión en Jumia Vendor Center y ve a Settings, luego Applications. Haz clic en Create Application y elige Self Authorisation como tipo. Jumia te mostrará un Client ID —cópialo— y te dejará generar un Refresh Token —cópialo también. De vuelta en AskBiz, ve a Sources, busca Jumia bajo E-Commerce, y pega el Client ID en el campo Client ID y el Refresh Token en el campo Refresh Token (este está enmascarado, como una contraseña). AskBiz verifica las credenciales de inmediato solicitando un token de acceso a Jumia y confirmando que puede leer la lista de tu tienda antes de guardar la conexión. Si esa verificación falla, la causa más común es que la Application no tenga habilitados los permisos de Order o Product en Vendor Center —vuelve y confirma que esos roles estén marcados, y vuelve a intentarlo.
Qué se sincroniza realmente — y qué no
Cada sincronización trae tus pedidos recientes (una ventana móvil, los más recientes primero) y, para cada uno, las líneas de artículo individuales —el modelo de Jumia devuelve una fila por unidad vendida en lugar de un campo de cantidad, así que una línea de 3 unidades en tu tienda vuelve como tres artículos separados, cada uno con su propio precio, descuento, impuesto y cifra de envío. Los niveles de stock provienen de un endpoint de catálogo separado, indexado por SKU. Vale la pena saber: el monto de pago que verás contra un pedido de Jumia en AskBiz se calcula a partir de los ingresos netos de ese pedido después de descuentos, no se trae del informe de liquidación oficial de Jumia —Jumia solo expone las deducciones reales de comisión y tarifas en un endpoint de informe de pagos separado que este conector actualmente no lee. Trata la cifra de pago como una estimación útil para seguir tendencias, no como un sustituto del informe de pagos dentro del propio Vendor Center cuando necesites el número exacto. El conector también es de solo lectura en ambas direcciones de alcance: nunca escribe de vuelta a tus listados, precios o stock de Jumia, y deliberadamente no toca los datos de envío o seguimiento de entrega de Jumia —este conector trata sobre visibilidad de ventas y stock, no logística de cumplimiento.
Dónde lo verás en AskBiz
Los pedidos de Jumia cuentan hacia tus totales combinados de ingresos y pedidos en todos los canales conectados, cada uno valorado en la moneda local propia de la tienda. Los niveles de stock alimentan tu vista de Inventario del CFO, fusionados con el mismo producto donde sea posible —ten en cuenta que el feed de stock de Jumia no incluye un nombre de producto, así que hasta que se empareje con un listado nombrado de otro canal, AskBiz muestra el SKU en su lugar. Las alertas de stock bajo están etiquetadas por canal, así que una advertencia de que un SKU de Jumia está bajo no se confundirá con el mismo SKU funcionando bien en tu tienda física. Y en el filtro de canal de la pestaña Intelligence, Jumia es una opción seleccionable, así que puedes ver el rendimiento de Jumia de forma aislada del resto de lo que vendes.
Vale la pena saber antes de confiar en él
Este conector se agregó recientemente. Ha sido construido y revisado internamente contra la API documentada del Vendor Center de Jumia, pero aún no se ha ejecutado de principio a fin contra una cuenta de vendedor de Jumia real y activa —así que trata tu primera sincronización como algo que hay que revisar contra las propias cifras de pedidos y stock de Vendor Center en lugar de asumir que es exacta desde el primer día. Si una sincronización deja de funcionar con un error sobre el refresh token, eso casi siempre significa que fue revocado o expiró en Vendor Center —genera un nuevo Client ID y Refresh Token y reconecta desde Sources. Detrás de escena, AskBiz también genera un token de acceso fresco a partir de tu refresh token en cada sincronización en lugar de intentar reutilizar uno, ya que los tokens de acceso de Jumia son de corta duración, y deliberadamente ritma sus solicitudes para mantenerse por debajo del límite de tasa de Jumia en lugar de dispararlas todas de una vez. Como cada sincronización trae un lote limitado de tus pedidos más recientes, una tienda de muy alto volumen puede ver que su historial reciente completo se completa en un par de sincronizaciones en lugar de todo de una vez en la primera ejecución.