Recuperar un pedido

Este punto final de la API "Recuperar un pedido" se utiliza para obtener datos de un pedido completado dentro del Sistema de Zonos. La respuesta contendrá un objeto JSON que representa toda la información disponible para el pedido, incluidas las direcciones de facturación y envío, el método de envío, los totales del pedido y el estado.

Puntos finales 

Números de pedido

Recupera una lista de números de pedido.

Detalles del pedido

Recupera información detallada sobre un pedido.

Uso del punto final de la API "Recuperar un pedido"

Hay dos formas comunes de utilizar estos puntos finales.

1. (Parte 1 + Parte 2) – Utilice una página de confirmación de pedido personalizada en su dominio para que su sistema llame al punto final orderDetail e importe un pedido completado. Además, llame regularmente al punto final orderNumbers para conciliar cualquier pedido en el Sistema de Zonos que no haya sido importado a su sistema.
2. (Solo Parte 2) – Utilice la página de confirmación de pedido básica de Zonos o una página estática en su dominio para indicar la finalización del pedido al cliente. Programe su sistema para llamar regularmente al punto final orderNumbers para determinar cuándo un nuevo pedido está listo para ser importado en su sistema. Cuando se encuentre un pedido pendiente, llame al punto final orderDetail para obtener los datos de esos pedidos.

Parte 1: Página de éxito en su dominio

Cada vez que un comprador completa un pedido en el Zonos Checkout, es redirigido inmediatamente a una URL de página de éxito de pedido. El ID del pedido completado se agregará a la URL de redirección como una cadena de consulta. La URL de la página de éxito del pedido debe ser proporcionada a Zonos. La URL también se puede pasar como parámetro en el punto final createTempCart al crear el carrito temporal en el Sistema de Zonos.

Ejemplo: http://www.ejemplotienda.com/agradecimientointernacional?orderId=999-99999

Cuando un cliente es redirigido a esta página, su sistema deberá analizar el valor de orderId de la URL. Luego, utilizará orderId para llamar al punto final orderDetail y recuperar los datos del pedido.

Parte 2: Utilice una tarea programada

Además de llamar a los detalles del pedido cuando se activa la página de éxito, le recomendamos configurar una llamada programada para todos los pedidos y sus detalles como un recurso de respaldo. De esta manera, puede recuperar cualquier pedido completado en el Sistema de Zonos que aún no se haya importado a su sistema.

Este proceso debe ser una tarea programada/script, como una tarea Cron, que se ejecute una vez por hora/turno/día, etc. (programar tan a menudo como lo requieran los procesos comerciales). El script debe llamar a todos los pedidos y sus detalles que hayan ocurrido desde la última llamada de pedidos. El punto final orderNumbers le permite recuperar pedidos sinceOrderId o sinceDate, como se muestra en la GUI de prueba de la API ubicada aquí. Todos los pedidos recuperados a través de esta llamada programada deben ser conciliados con los pedidos insertados en su sistema cada vez que se activó la página de éxito. Cualquier pedido que aún no esté en su sistema debe ser insertado en su sistema y tratado como pedidos legítimos.

Estado inicial del pedido

IGLOBAL_ORDER_IN_PROCESS o IGLOBAL_FRAUD_REVIEW

Al llamar al punto final orderDetail, recomendamos que su sistema primero verifique la propiedad orderStatus de los datos del pedido.

Los pedidos que no requieren revisión de fraude se inicializarán con orderStatus : IGLOBAL_ORDER_IN_PROCESS. Un pedido en este estado está listo para ser procesado y enviado.

Los pedidos que requieren revisión de fraude se inicializarán en orderStatus : IGLOBAL_FRAUD_REVIEW. Un pedido en este estado está siendo examinado y revisado por sospecha de fraude. Le recomendamos que coloque este pedido en un estado de revisión o retención en su sistema y continúe llamando al punto final orderDetail hasta que el pedido avance en el proceso de revisión de fraude de Zonos.

Una vez que se complete el proceso de revisión de fraude de Zonos, el pedido pasará a uno de los siguientes estados:

• El pedido pasa la revisión de fraude

  • El pedido pasará a orderStatus : IGLOBAL_ORDER_IN_PROCESS y podrá continuar hacia el envío.

• El pedido no pasa la revisión de fraude

  • El pedido pasará a orderStatus : IGLOBAL_ORDER_CANCELLED y deberá cancelarse en su sistema.

GUI de prueba de la API

Por favor, contacte al soporte para obtener sus credenciales de cuenta.