Índice.
6. Integraciones externas en ventas.
6.1. ¿Cómo registrar procesos externos y botones de reintento?
6.3. Definición de botones en la interfaz.
1. ¿Cómo funciona?
Desde Yuju podrás administrar tus ventas para llevar tu proceso con el marketplace lo
lo más completo posible.
Entre las funcionalidades que tendrás a disposición están:
Búsqueda de pedidos por marketplace y fecha de creación.
Obtener el detalle del pedido.
Cambio de estado.
Descarga de guías.
Nota: Algunas funcionalidades podrían no estar disponibles en algunos marketplaces.
2. Términos generales.
shop_pk – El id de la tienda a la que pertenece la orden.
markplace_pk – El id del marketplace a la que pertenece la orden.
order_pk – El id del pedido.
items_pk - El id del item de la orden que se envía a actualizar.
3. Búsqueda de pedidos.
GET /shops/{shop_pk}/marketplace/{marketplace_pk}/orders/
● Filtro de fecha de creación.
○ created_at__gt - mayor que.
○ created_at__gte - mayor o igual que.
○ created_at__lt - menor que.
○ created_at__lte - menor o igual que.
● Filtro por status.
Las ventas se consideran abiertas siempre que no estén entregadas o canceladas.
○ Open - Abierto.
○ Close - Cerrado.
● Paginado.
○ page - número de página.
○ page_size - Número de elementos a regresar (30 predeterminado, máximo 100).
Documentación:
Conoce más aquí.
4. Confirmación de pedidos.
POST.
/shops/(shop_pk)/marketplace/(marketplace_pk)/orders/(order_pk)/ready_to_ship/
Si en el pedido tiene la acción set ready to ship significa que se puede confirmar la venta.
Se permite hacer confirmaciones por ítem, para esto se deberá mandar en el body de la petición un objeto con los ITEM_PK que se quieran confirmar.
Marketplaces que requieren confirmación por ítem:
Linio - Esto determina la agrupación en guías.
Liverpool - Deshabilitado hasta tener la separación de guías.
Coppel.
Consulta más aquí.
5. Descarga de envíos.
POST /shops/(shop_pk)/marketplace/(marketplace_pk)/orders/(order_pk)/label/
Si en el pedido tiene la acción print delivery label significa que se puede descargar la guía de envío.
Se permite hacer la descarga de guías por ítem, para esto se deberá mandar en el body de la petición un objeto con los ITEM_PK.
Se debe de enviar en los headers el formato del archivo requerido.
Accept – El formato de la etiqueta depende del header Accept los opciones de etiqueta son application/pdf y application/zpl.
Marketplaces que permiten la descarga por ítem:
Linio (Depende de la agrupación que se hizo durante la confirmación), sólo acepta PDF.
Walmart (Siempre genera 1 guía por ítem).
Liverpool - En desarrollo.
Coppel - Pendiente de liberación por parte de Coppel.
Consulta más aquí.
6. Integraciones externas.
6.1. ¿Cómo registrar procesos externos y botones de reintento?
Con el objetivo de relacionar flujos y procesos de sistemas externos, Yuju da la posibilidad de almacenar información personalizada de estas integraciones.
Además de esto es posible agregar acciones que tengan impacto en el procesado de una venta en el sistema del cliente.
6.2. Descripción de pagos.
module_name: Nombre del módulo externo que realizó el registro (int_external).
● created_at: Fecha de creación del registro.
● updated_at: Fecha de actualización del registro.
● status: El status de la integración.
● type: Tipo de documento/registro.
● reference: ID y/o código (puede ser alfanumérico) que hace referencia en el sistema creado.
● id_shop, id_channel, id_order: Son los valores de la orden en Yuju.
● extra: Información no estandarizada que se agrega como informativa.
Actions: Son las acciones que se permiten ejecutar para ese registro.
6.3. Definición de botones en la interfaz.
Dentro del objeto de int_external se encuentran las listas de acciones, los campos importantes son:
● name: Nombre de la acción a ejecutar (action).
● message: Texto que aparece en el botón (describe la acción que se va a ejecutar).
● params: Parámetros que se deben de mandar en la petición (payload).
Response:
Codes:
200: success!
400: algún error en el envío de información
{
“message”: “texto de error o lo que devolvió el servicio externo”
}
Consulta más aquí.
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.