Cree un checkout

Explore los pares clave/valor involucrados en la creación de un checkout.

Este punto final de la API se utiliza para enviar información del carrito y elementos del carrito del cliente a la API de Zonos.

Recibirá una respuesta JSON que contiene un tempCartUUID, un identificador único de carrito en el Sistema de Zonos. Esto se utilizará para redirigir al cliente al Zonos Checkout para completar el pedido.

Atributos

Pares clave/valor JSON en el cuerpo de la solicitud

POST https://api.iglobalstores.com/v1/createTempCart

campo	notas
`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, por 15 pulgadas de ancho, por 15 pulgadas de alto. Solo se utilizará una caja de ese tamaño. Habrá dos cajas del tamaño: 8x8x4 pulgadas. Es aceptable pasar la misma dimensión de caja varias veces si es fácil para usted, como esto: "22x15x15(1),22x15x15(1)", lo que significa 2 cajas del 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, se puede pasar en formato `string`.
`contShoppingURL`	Este campo se utiliza para pasar una URL para anular el HREF del botón "Continuar comprando" dentro del Zonos Checkout. `string`
`domesticShippingCharge`	Este campo se utiliza para pasar un cargo de envío nacional al Zonos Checkout, y la cantidad se agregará al envío. Esto se puede configurar para agregar el total del envío o desglosarlo como un elemento separado. `punto flotante positivo, dos decimales`
`externalConfirmationPageURL`	Este campo se utiliza para pasar una URL de su página de confirmación de pedido / agradecimiento. Después de que un cliente complete el pago dentro del Zonos Checkout, será redirigido a esta URL para la confirmación del pedido. Esta URL se utiliza con frecuencia para activar una llamada al punto final del servicio de API "orderDetail" de Zonos para recuperar los detalles del pedido e importar el pedido 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 cuerpo en la página de checkout. Comúnmente utilizado para pasar código para remarketing, análisis, etc. `cadena codificada en URL`
`items` REQUERIDO	Este campo es una lista de mapas de elementos. `cadena JSON`
`items[index].countryOfOrigin`	Este campo se utiliza para pasar el país de origen del artículo. El parámetro debe ser el país código ISO de dos letras. `string`
`items[index].description` REQUERIDO	Este campo se utiliza para pasar una descripción completa del artículo del carrito, incluidas las opciones del artículo, 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 REQUERIDAS en pulgadas. `cadena - punto flotante positivo, dos decimales / entero (pulgadas)`
`items[index].imageURL` REQUERIDO	Este campo se utiliza para pasar la URL de la imagen del producto del artículo. La URL debe ser HTTPS para mostrarse dentro del Zonos Checkout. `string / URL de HTTPS`
`items[index]itemBrand`	Este campo se utiliza para pasar la marca del artículo`string`
`items[index]itemCategory`	Este campo se utiliza para pasar la categoría del artículo y puede pasarse delimitada por tuberías si el artículo tiene más de una categoría. Valores de ejemplo: "zapatos" o "zapatos\|zapatos-deportivos\|zapatos-en-descuento"`cadena`
`items[index]itemCustomization`	Este campo se utiliza para pasar detalles adicionales sobre el artículo que no se muestran en el Zonos Checkout; sin embargo, esto se puede recuperar a través del punto final del servicio API "orderDetail".
`items[index]itemHSCode`	Este campo se utiliza para pasar el código HS del artículo y puede ser con o sin puntos. Valores de ejemplo: "3926901000" o "3926.90.1000"`cadena`
`items[index].itemURL`	Este campo se utiliza para pasar la URL a la página del producto del artículo. `cadena / URL`
`items[index].length`	Este campo se utiliza para pasar la longitud del artículo y es muy recomendable para cotizaciones de envío precisas. Las unidades de longitud son REQUERIDAS en pulgadas. `cadena - punto flotante positivo, dos decimales / entero (pulgadas)`
`items[index].nonShippable`	Este campo se utiliza para indicar si el artículo debe incluirse en los cálculos de envío, impuestos y aranceles. Descargas digitales, códigos de descuento, tarifas de manipulación, etc. deben pasarse con un valor de "true". `booleano: true o false`
`items[index].productId`	Este campo se utiliza para pasar la cantidad de la línea de artículo. `cadena`
`items[index].quantity` REQUERIDO	Este campo se utiliza para pasar la cantidad de la línea de artículo. `cadena`
`items[index].sku`	Este campo se utiliza para pasar el SKU / UPC / etc. del artículo. `cadena`
`items[index].unitPrice` REQUERIDO	Este campo se utiliza para pasar el precio unitario de la línea de artículo. `punto flotante positivo, dos decimales / entero`
`items[index].weight`	Este campo se utiliza para pasar el peso del artículo y es muy recomendable 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``cadena - punto flotante positivo, dos decimales / entero
`items[index].weightUnits`	Este campo se utiliza para anular las unidades de peso del artículo por defecto. 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. `cadena - "LB", "OZ", "KG" o "G”`
`items[index].width`	Este campo se utiliza para pasar el ancho del artículo y es muy recomendable para cotizaciones de envío precisas. El ancho se establece como REQUERIDO en pulgadas. `cadena - punto flotante positivo, dos decimales / entero (pulgadas)`
`misc1 - misc6`	Este campo se utiliza para pasar datos diversos asociados con el pedido a través del API de Zonos para ser recuperados junto con los datos del pedido devueltos desde el punto final del servicio API "orderDetail" de Zonos. `cadena`
`referenceId`	Este campo se utiliza para pasar un valor de identificación de referencia único para el carrito/sesión/etc. en su sistema. Esto se puede utilizar para buscar el ID de pedido de Zonos a través del punto final del servicio API "orderDetail" de Zonos. `cadena`
`storeId` REQUERIDO	ID de tienda proporcionado por Zonos. `entero`

Tipos de datos de cadena adicionales

items[index].itemDescriptionLong
items[index].itemDescriptionDetailed
items[index].itemFabricContent
items[index].itemColor
items[index].itemLtlClass
items[index].status
items[index].itemMaterial

Descuentos, cupones y códigos promocionales

Para enviar descuentos, cupones y códigos promocionales a Zonos a través del servidor post, deben pasarse como un artículo separado con un valor negativo para los parámetros: “unitPrice” y “nonShippable”:true.

EJEMPLO DE MAPA DE ARTÍCULO DE DESCUENTO

{
  "description": "Discount (10OFF) - 10% OFF",
  "unitPrice": -15.5,
  "quantity": 1,
  "nonShippable": true
}

Respuesta HTTPS

Respuesta HTTP exitosa

Formato del mensaje: JSON

EJEMPLO DE RESPUESTA EXITOSA

{
  "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"
}

Definiciones de respuesta JSON

campo	notas
`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á a través de un parámetro de cadena de consulta de URL al redirigir el navegador del usuario al Zonos Checkout.

Respuestas de error HTTP

Código de error	significado
400	Carácter inesperado en el cuerpo de la solicitud.
406	No aceptable. El encabezado HTTP para "Accept" no es válido.
415	Tipo de medio no soportado. El encabezado HTTP para "Content-Type" no es válido.
422	Entidad no procesable.
500	"storeId" era incorrecto o el cuerpo JSON no se pudo analizar.

EJEMPLO DE RESPUESTA DE ERROR

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <title>Error 422 Unprocessable Entity</title>
  </head>
  <body>
    <h2>HTTP ERROR 422</h2>
    <p>
      Problem accessing /v2/createTempCart. Reason:
      <pre>Unprocessable Entity</pre>
    </p>
    <h2>The request entity had the following errors:</h2>
    <ul>
      <li>items may not be empty (was null)</li>
      <li>items may not be null (was null)</li>
    </ul>
  </body>
</html>

Redirigiendo al Zonos Checkout

Después de recibir una respuesta exitosa que contiene el tempCartUUID, su servidor enviará una redirección desde el navegador del cliente al Zonos Checkout con los parámetros adecuados de la cadena de consulta de URL que se detallan a continuación.

Ejemplo de URL de redirección: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

Nota: [yourassignedsubdomain] - Contacte a un miembro de su equipo de implementación de Zonos para recibir su subdominio Zonos.com.

Parámetros de solicitud de URL

campo	notas
`tempCartUUID` REQUERIDO	Este valor se obtiene llamando al punto final del 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 mejorar la experiencia del usuario. El parámetro `country` preseleccionará el país de destino dentro del Zonos Checkout. Al utilizar Zonos Hello JS (JavaScript) en el sitio, puede obtener este valor llamando al método JavaScript: `zonos.country()`. `string` (Longitud: 2)

Tipos de datos de cadena adicionales

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

¿Fue útil esta página?

¿Preguntas?

Contáctenos.

Ver Zonos

políticas y acuerdos