Automatización · Marketplaces

Revisar los pedidos de Éxito por aceptar contra el stock de WooCommerce

Un agente de IA cruza los pedidos de Éxito que esperan aceptación con el stock de tu tienda WooCommerce y deja en cero la oferta de lo que ya se agotó.

Quiero verlo con mi operación Ver todas las automatizaciones

¿Cómo sé qué pedidos de Éxito puedo aceptar sin vender algo que ya no tengo en bodega?

Un Met conectado al marketplace de Éxito trae los pedidos que esperan aceptación, con cada línea y su referencia. Busca esas referencias en tu tienda WooCommerce, que es la fuente de verdad, y te dice cuáles tienen stock suficiente y cuáles no. Para lo que ya se agotó, lee la oferta publicada en Éxito y, si tú lo apruebas, la deja en cero unidades con el mismo precio, para que no entren más pedidos sobre algo que no hay. Aceptar o rechazar cada pedido sigue siendo tuyo: el conector no lo hace. Si un pedido que esperabas no aparece, revisa los avisos que Éxito envió y su validación antes de suponer dónde se cortó.

Dónde aplica: Colombia. El marketplace de Éxito opera en Colombia sobre la plataforma Mirakl, y la receta usa ese protocolo, no una API propia del retailer.

Qué la pone en marcha

Cuando alguien lo pide

Empieza cuando alguien del equipo le pide al Met dentro de Meteor revisar los pedidos de Éxito pendientes, o ejecuta la tarea manual guardada, por ejemplo al abrir la bodega. No lo dispara un mensaje de un cliente y no acepta nada en segundo plano.

Una tarea de ejecución manual: alguien del equipo la corre con un botón, o se la pide al Met por chat.

Quién la ejecuta

Igor, Administrador de bodegas

Es la parte diaria de su oficio: la tienda manda y el marketplace es espejo. Igor no acepta pedidos, porque aceptar es comprometer un despacho; lo que hace es decirte, con el stock real, cuáles puedes aceptar y apagar la oferta de lo que ya no tienes.

Lo ejecuta el Met de marketplaces

Qué hay que tener conectado

Éxito Operar tienda y pedidos
WooCommerce Operar tienda y pedidos

5 pasos · 7 herramientas

El procedimiento, paso a paso

Cada paso muestra la herramienta que se ejecuta. Son las del conector real: si una dejara de existir, esta página no compilaría.

1
Traer los pedidos que esperan aceptación

La consulta de pedidos devuelve por defecto los que están esperando aceptación, hasta cien por llamada. Cada pedido trae su número, su estado, la fecha, el total, la moneda, el nombre del cliente y sus líneas, con la referencia de la oferta, el producto, la cantidad y el precio. La consulta no modifica nada en Éxito.
- exito_get_orders Éxito
2
Cruzar cada línea con el stock de la tienda

Para cada referencia, el Met busca el producto en WooCommerce por su SKU exacto y lee las unidades disponibles; si necesita más detalle, abre el producto completo. Compara la cantidad pedida con el stock de la tienda y separa los pedidos en dos grupos: los que se pueden cumplir y los que tienen al menos una línea sin stock suficiente. No adivina unidades que la tienda no reporta.
- wc_list_products WooCommerce
- wc_get_product WooCommerce
3
Leer la oferta publicada antes de tocarla

Para cada producto agotado, el Met busca la oferta en Éxito por la misma referencia y lee el precio y la cantidad que están publicados. Si la oferta no aparece, lo dice: puede que esa referencia no coincida con la del marketplace, y entonces no hay nada que apagar desde aquí.
- exito_find_offer_by_sku Éxito
4
Dejar en cero lo que ya no hay, con tu aprobación

El Met te muestra la lista de ofertas que propone dejar en cero y espera tu sí; el conector no pide esa confirmación por su cuenta, así que la pide la receta. Con el sí, actualiza cada oferta con cantidad cero y el mismo precio y la misma condición que leyó, porque la actualización exige un precio mayor que cero aunque solo cambie el stock. Después vuelve a leer la oferta. Éxito procesa la actualización como una importación, así que si la oferta todavía muestra el valor anterior, el Met lo dice en vez de dar el cambio por hecho.
- exito_upsert_offer Éxito
- exito_get_offer Éxito
5
Revisar los avisos cuando un pedido no aparece

Si tu equipo esperaba un pedido que no está en la lista, el Met revisa los últimos avisos de pedido que Éxito envió a tu espacio de trabajo, con la fecha de llegada, la validación de la firma y el error de procesamiento si lo hubo. Así se sabe si el aviso nunca llegó o si llegó y falló, en vez de suponerlo. Que lleguen esos avisos depende de que Éxito los tenga habilitados para tu cuenta.
- exito_list_recent_events Éxito

Antes de empezar

Qué necesitas tener listo

Ninguno de estos puntos lo resuelve el Met. Si falta uno, la automatización se detiene ahí.

URL de tu instancia de Mirakl en Éxito y clave de API de vendedor

Éxito entrega la URL al habilitarte la API como vendedor, y la clave se genera en tu cuenta de vendedor, en la configuración de API. Se guardan cifradas por espacio de trabajo.
Tu tienda WooCommerce conectada

Con las claves de la API REST de tu tienda. Es la fuente de verdad del stock: sin ella el Met no tiene contra qué comparar los pedidos.
La misma referencia en los dos lados

El cruce es por SKU: el de tu oferta en Éxito tiene que ser el mismo de WooCommerce. Una referencia distinta no rompe nada, pero ese producto no se puede cruzar y el Met lo reporta aparte.

Los límites

Qué NO resuelve esta automatización

Preferimos decirlo aquí que descubrirlo en la implementación.

No acepta ni rechaza pedidos. Los lista con el stock real al lado para que decida una persona, porque aceptar un pedido es comprometer un despacho.
No descuenta el stock de la tienda por la venta de Éxito. La tienda es la fuente de verdad, y esta receta solo lee su inventario para comparar.
No crea productos en el catálogo del marketplace. Trabaja sobre ofertas de productos que ya existen allí; el alta de un producto nuevo sigue el proceso del retailer.
No gestiona la logística ni imprime etiquetas del marketplace. El despacho de lo aceptado sigue donde ya lo haces.
No valida la firma de un aviso de pedido si Éxito no entrega un secreto. En ese caso el aviso se registra igual, pero sin verificar su origen.
No está probado contra la instancia real de Éxito. El conector se construyó con la documentación de Mirakl, sin credenciales de Éxito, y el formato de sus avisos y de su firma está por confirmar. Por eso el Met lee la oferta antes y después de tocarla; revisa en el portal de vendedor la primera oferta que deje en cero.

Preguntas frecuentes

Preguntas sobre esta automatización

No. El conector no tiene una herramienta para aceptar ni rechazar pedidos. El Met te entrega la lista separada y la decisión se toma en el portal de vendedor de Éxito.

Porque la actualización de la oferta exige un precio mayor que cero. El Met usa el precio que ya estaba publicado, que leyó en el paso anterior, para no cambiarlo de paso.

No. La sincronización recurrente publica el precio con el margen del canal y el stock con colchón para todo el catálogo. Esta revisión ataja lo urgente: los pedidos que ya entraron sobre algo que se agotó.

Es la plataforma sobre la que corre el marketplace de Éxito. El conector habla su protocolo, así que la URL que pides a Éxito es la de tu instancia de Mirakl.

Sigue por aquí