Atributos
Pares clave/valor JSON en el cuerpo de la solicitud
POST https://api.iglobalstores.com/v1/createTempCart
| field↕ | notes↕ |
|---|---|
boxCount | Valor de ejemplo: 22x15x15(1),8x8x4(2),32x22x14(1) Formato: Lista separada por comas de dimensiones de caja y cantidad. En el ejemplo anterior, hay un total de 4 cajas. La primera caja de la lista tendrá 22 pulgadas de largo, 15 de ancho y 15 de alto. Solo se utilizará una caja de ese tamaño. Habrá dos cajas de tamaño 8x8x4 pulgadas. Es aceptable pasar la misma dimensión de caja varias veces si le resulta más sencillo, como: "22x15x15(1),22x15x15(1)", lo que significa 2 cajas de tamaño 22x15x15 pulgadas. Este campo describe las cajas que se utilizarán para enviar el pedido. No se espera que un comerciante conozca esto en el momento del pedido; sin embargo, si se conoce, puede pasarse en formato string. |
contShoppingURL | Este campo se utiliza para pasar una URL que anule el HREF del botón "Continue Shopping" dentro de Zonos Checkout. string |
domesticShippingCharge | Este campo se utiliza para pasar un cargo de envío nacional a Zonos Checkout, y el importe se añadirá al envío. Puede configurarse para añadir el total de envío o desglosarse como una línea independiente. positive floating point, two decimal places |
externalConfirmationPageURL | Este campo se utiliza para pasar la URL de su página de confirmación de pedido / agradecimiento. Después de que un cliente complete el pago en Zonos Checkout, se le redirigirá a esta URL para la confirmación del pedido. Esta URL se utiliza con frecuencia para activar una llamada al endpoint de servicio API "orderDetail" de Zonos para recuperar el detalle del pedido e importarlo al sistema. string |
footerHTML | Este campo se utiliza para pasar una cadena HTML codificada en URL. Esta cadena HTML se decodificará y se colocará antes de la etiqueta de cierre del body en la página de checkout. Se utiliza habitualmente para pasar código de remarketing, analítica, etc. URL encoded string |
items REQUIRED | Este campo es una lista de mapas de artículos. JSON string |
items[index].countryOfOrigin | Este campo se utiliza para pasar el país de origen del artículo. El parámetro debe ser el código ISO de dos letras del país. string |
items[index].description REQUIRED | Este campo se utiliza para pasar una descripción completa del artículo de la línea del carrito, incluidas opciones, colores, etc. string |
items[index].height | Este campo se utiliza para pasar la altura del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de altura son REQUIRED string - positive floating point, two decimal places / integer (inches) |
items[index].imageURL REQUIRED | Este campo se utiliza para pasar la URL de la imagen del producto. La URL debe ser HTTPS para mostrarse dentro de Zonos Checkout. string / HTTPS URL |
items[index]itemBrand | Este campo se utiliza para pasar la marca del artículostring |
items[index]itemCategory | Este campo se utiliza para pasar la categoría del artículo y puede pasarse delimitada por barras verticales si el artículo tiene más de una categoría. Valores de ejemplo: "shoes" o "shoes|sport-shoes|discount-shoes" string |
items[index]itemCustomization | Este campo se utiliza para pasar detalles adicionales sobre el artículo que no se muestran en Zonos Checkout; sin embargo, pueden recuperarse a través del endpoint de servicio API "orderDetail". |
items[index]itemHSCode | Este campo se utiliza para pasar el código HS del artículo, con o sin puntos. Valores de ejemplo: "3926901000" o "3926.90.1000" string |
items[index].itemURL | Este campo se utiliza para pasar la URL de la página del producto. string / URL |
items[index].length | Este campo se utiliza para pasar la longitud del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de longitud son REQUIRED string - positive floating point, two decimal places / integer (inches) |
items[index].nonShippable | Este campo se utiliza para indicar si el artículo debe incluirse en los cálculos de envío, aranceles e impuestos. Las descargas digitales, códigos de descuento, cargos de manipulación, etc. deben pasarse con un valor de "true". boolean: true or false |
items[index].productId | Este campo se utiliza para pasar la cantidad de la línea de artículo. string |
items[index].quantity REQUIRED | Este campo se utiliza para pasar la cantidad de la línea de artículo. string |
items[index].sku | Este campo se utiliza para pasar el SKU / UPC / etc. del artículo. string |
items[index].unitPrice REQUIRED | Este campo se utiliza para pasar el precio unitario de la línea de artículo. positive floating point, two decimal places / integer |
items[index].weight | Este campo se utiliza para pasar el peso del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de peso se establecen por defecto en "LBS" a menos que se pase otra unidad de peso en items[index].itemWeightUnits``string - positive floating point, two decimal places / integer |
items[index].weightUnits | Este campo se utiliza para anular las unidades de peso predeterminadas del artículo. Las unidades de peso del artículo se establecen por defecto en "LBS" a menos que se pase otra unidad de peso en este campo. string - "LB", "OZ", "KG", or "G” |
items[index].width | Este campo se utiliza para pasar el ancho del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de ancho son REQUIRED string - positive floating point, two decimal places / integer (inches) |
misc1 - misc6 | Este campo se utiliza para pasar datos misceláneos asociados al pedido a través de la API de Zonos para recuperarlos junto con los datos del pedido devueltos por el endpoint de servicio API "orderDetail" de Zonos. string |
referenceId | Este campo se utiliza para pasar un valor de identificación de referencia único para el carrito/sesión/etc. en su sistema. Puede utilizarse para buscar el ID de pedido de Zonos a través del endpoint de servicio API "orderDetail" de Zonos. string |
storeId REQUIRED | ID de tienda proporcionado por Zonos. integer |
Tipos de datos de cadena adicionales
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterial
Descuentos, cupones y códigos promocionales
Para enviar descuentos, cupones y códigos promocionales a Zonos mediante el envío desde el servidor, deben pasarse como un artículo independiente con un valor negativo en los parámetros: "unitPrice" y "nonShippable":true.
1
{2
"description": "Discount (10OFF) - 10% OFF",3
"unitPrice": -15.5,4
"quantity": 1,5
"nonShippable": true6
}Respuesta HTTPS
Respuesta HTTP de éxito
Formato del mensaje: JSON
1
{2
"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"3
}Definiciones JSON de la respuesta
| field↕ | notes↕ |
|---|---|
tempCartUUID | Este parámetro contendrá un GUID asignado al carrito internacional de su cliente y creado en el sistema de Zonos. Este campo se pasará como parámetro de consulta de URL string al redirigir el navegador del usuario a Zonos Checkout. |
Respuestas HTTP de error
| Error code↕ | meaning↕ |
|---|---|
| 400 | Carácter inesperado en el cuerpo de la solicitud. |
| 406 | No aceptable. La cabecera HTTP "Accept" no es válida. |
| 415 | Tipo de medio no compatible. La cabecera HTTP "Content-Type" no es válida. |
| 422 | Entidad no procesable. |
| 500 | "storeId" era incorrecto o no se pudo analizar el cuerpo JSON. |
1
2
3
4
5
6
7
Error 422 Unprocessable Entity 8
9
10
11
12
13
HTTP ERROR 422
14
15
16
Problem accessing /v2/createTempCart. Reason:17
Unprocessable Entity
18
19
20
21
The request entity had the following errors:
22
23
24
25
items may not be empty (was null) 26
27
items may not be null (was null) 28
29
30
31
32
33
Redirigir a Zonos Checkout
Después de recibir una respuesta correcta que contenga el tempCartUUID, su servidor enviará una redirección desde el navegador del cliente a Zonos Checkout con los parámetros de cadena de consulta de URL apropiados que se describen a continuación.
URL de redirección de ejemplo: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA
Nota: [yourassignedsubdomain] - Póngase en contacto con el miembro de su equipo de implementación de Zonos para recibir su subdominio de Zonos.com.
Parámetros de solicitud de URL
| field↕ | notes↕ |
|---|---|
tempCartUUID REQUIRED | Este valor se obtiene llamando al endpoint de servicio API createTempCart de Zonos. string / GUID |
country | Código ISO de dos letras del país de destino. Recomendamos encarecidamente pasar este parámetro para la experiencia del usuario. El parámetro country preseleccionará el país de destino dentro de Zonos Checkout. Cuando utilice Zonos Hello JS (JavaScript) en el sitio, puede obtener este valor llamando al método JavaScript: zonos.country(). string (Length: 2) |
Tipos de datos de cadena adicionales
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZip
Crear un checkout
Explore los pares clave/valor implicados en la creación de un checkout.
Este endpoint de API se utiliza para enviar información del carrito y artículos desde el carrito del cliente a la API de Zonos.
Recibirá una respuesta JSON que contiene un
tempCartUUID, un identificador único del carrito en el sistema de Zonos. Se utilizará para redirigir al cliente a Zonos Checkout y completar el pedido.