Ofrezca a sus clientes la posibilidad de crear envíos y etiquetas de Zonos desde su plataforma.
Esta guía está diseñada para desarrolladores de plataformas de envío que desean integrar las capacidades de creación de envíos de Zonos en su plataforma para sus clientes. Si ya utiliza la API de Zonos y solo necesita crear envíos para pedidos existentes, consulte nuestra guía de creación de envíos.
Si es una plataforma de envío que admite a clientes de Zonos que envían internacionalmente, integrarse con Zonos para la creación de envíos debería ser una consideración prioritaria. Esto le permitirá ofrecer la experiencia más fluida para sus comerciantes y sus clientes, aprovechando las funciones existentes de su plataforma mientras Zonos gestiona la creación del envío, la etiqueta y la documentación aduanera de respaldo.
Las ventajas de usar Zonos para crear envíos incluyen:
Facturación de terceros de aranceles e impuestos - Nos aseguraremos de que se utilice el número de cuenta de transportista suyo o de su comerciante para los cargos de envío, mientras que las facturas de aranceles e impuestos llegan a Zonos.
Flexibilidad - En lugar de realizar trabajo de desarrollo para garantizar que pueda generar etiquetas conformes con su plataforma, intégrese con nuestra API y déjenos a nosotros el cumplimiento transfronterizo en constante cambio.
Documentación aduanera precisa - Cuando utiliza Zonos para generar etiquetas, nos aseguramos de que los detalles correctos se transmitan al transportista para que el paquete pase aduanas rápidamente.
Esta guía le guiará por los pasos para implementar una integración completa de extremo a extremo que le permitirá solicitar envíos a Zonos desde su plataforma.
Siga los pasos a continuación para permitir que sus clientes recuperen etiquetas de Zonos desde su plataforma.
1
Permitir credenciales de API
La API de Zonos es accesible mediante un credentialToken. Su plataforma deberá permitir que los clientes ingresen su credentialToken desde Zonos Dashboard en su plataforma. A partir de ahí, podrá realizar solicitudes a Zonos en su nombre.
2
Crear un envío
Para recuperar una label, debe crear un shipment al que se asociará la label. Zonos gestiona este proceso con un flujo de trabajo que crea shipments y labels en la misma solicitud. Al realizar esta mutación, no necesita pasar un serviceLevel, ya que utilizaremos el serviceLevel del landedCost vinculado al order. Para el orderId, puede usar el ID de pedido de Zonos o el accountOrderNumber que probablemente ya esté en su sistema.
Cuando un envío y las etiquetas se crean correctamente, devolveremos las etiquetas como labelImage, que es una BASE64_ENCODED_IMAGE, o como una url desde la que se puede obtener la etiqueta.
Utilice este flujo de trabajo cuando cree un envío para un pedido existente y no necesite modificar los detalles de artículos o partes. Admite números de seguimiento opcionales, centros de fulfillment, selección de nivel de servicio y seguro de valor declarado.
Comerciantes de Shopify
Shopify pasa un valor nulo para person en la parte de origen. Como resultado, orderId por sí solo no funcionará para comerciantes de Shopify; utilice la pestaña Creación avanzada de envíos en su lugar y proporcione los detalles completos de la parte, incluido person.
Con centro de fulfillment: Agregue "fulfillmentCenter": "fulfillment_center_12345" para especificar la ubicación de origen
Con seguimiento personalizado: Establezca "generateLabel": false y agregue "trackingNumbers": ["tracking_1", "tracking_2"]
Con nivel de servicio: Agregue "serviceLevel": "dhl.express_example" para seleccionar un servicio de transportista específico
Con seguro de valor declarado: Agregue "isDeclaredValue": true para habilitar la cobertura de valor declarado
Con servicios especiales: Consulte la guía de servicios especiales para baterías, hielo seco, mercancías peligrosas y opciones de firma.
Valor declarado
Establezca "isDeclaredValue": true para habilitar la cobertura de valor declarado para todos los artículos de su envío. Zonos reclama automáticamente el valor total de todos los artículos enviados en el pedido; los comerciantes no pueden modificar este monto. Esto establece la responsabilidad máxima que el transportista aceptará en caso de pérdida, daño o robo durante el tránsito. Esta función solo es compatible con envíos de UPS, FedEx y DHL. Zonos gestiona automáticamente la implementación específica del transportista cuando habilita el valor declarado, incluidos los parámetros apropiados en nuestras llamadas a la API a estos transportistas, por lo que no necesita gestionar distintos requisitos de transportistas.
Limitaciones de UPS: UPS solo cubre valores entre 100 y 50.000 USD y procesa el valor declarado a nivel de cartón. Para envíos de varios cartones, los comerciantes deben dividir el envío para designar la cobertura por cartón. UPS también genera un formulario de seguro adicional que debe imprimirse con las etiquetas.
FedEx y DHL: Procesan el valor declarado a nivel de envío sin restricciones adicionales.
Servicios especiales
Utilice specialServices en un cartón para indicar requisitos de manipulación especial para baterías, hielo seco, mercancías peligrosas o requisitos de firma. Consulte la guía de servicios especiales para obtener detalles y ejemplos completos.
ShipStation UPS Unlock: No se admiten envíos multipieza. Cuando un pedido se envía en varias cajas, el campo de referencia se duplica, lo que provoca que la coincidencia del número de pedido falle en el backend. Los comerciantes que necesiten envíos multipieza deben crear la etiqueta en Zonos Dashboard en su lugar. Los envíos de una sola caja no se ven afectados.
3
Anular un envío
En caso de que un cliente desee anular un shipment, puede usar la siguiente mutación que anulará todas las labels vinculadas al shipment.
Integración de envíos en plataforma
Crear envíos desde su plataforma
Ofrezca a sus clientes la posibilidad de crear envíos y etiquetas de Zonos desde su plataforma.
Esta guía está diseñada para desarrolladores de plataformas de envío que desean integrar las capacidades de creación de envíos de Zonos en su plataforma para sus clientes. Si ya utiliza la API de Zonos y solo necesita crear envíos para pedidos existentes, consulte nuestra guía de creación de envíos.
Si es una plataforma de envío que admite a clientes de Zonos que envían internacionalmente, integrarse con Zonos para la creación de envíos debería ser una consideración prioritaria. Esto le permitirá ofrecer la experiencia más fluida para sus comerciantes y sus clientes, aprovechando las funciones existentes de su plataforma mientras Zonos gestiona la creación del envío, la etiqueta y la documentación aduanera de respaldo.
Las ventajas de usar Zonos para crear envíos incluyen:
Esta guía le guiará por los pasos para implementar una integración completa de extremo a extremo que le permitirá solicitar envíos a Zonos desde su plataforma.
Habilitar la impresión de etiquetas
Siga los pasos a continuación para permitir que sus clientes recuperen etiquetas de Zonos desde su plataforma.
Permitir credenciales de API
La API de Zonos es accesible mediante un
credentialToken. Su plataforma deberá permitir que los clientes ingresen sucredentialTokendesde Zonos Dashboard en su plataforma. A partir de ahí, podrá realizar solicitudes a Zonos en su nombre.Crear un envío
Para recuperar una
label, debe crear unshipmental que se asociará lalabel. Zonos gestiona este proceso con un flujo de trabajo que creashipmentsylabelsen la misma solicitud. Al realizar esta mutación, no necesita pasar unserviceLevel, ya que utilizaremos elserviceLeveldellandedCostvinculado alorder. Para elorderId, puede usar el ID de pedido de Zonos o elaccountOrderNumberque probablemente ya esté en su sistema.Cuando un envío y las etiquetas se crean correctamente, devolveremos las etiquetas como
labelImage, que es unaBASE64_ENCODED_IMAGE, o como unaurldesde la que se puede obtener la etiqueta.Utilice este flujo de trabajo cuando cree un envío para un pedido existente y no necesite modificar los detalles de artículos o partes. Admite números de seguimiento opcionales, centros de fulfillment, selección de nivel de servicio y seguro de valor declarado.
Shopify pasa un valor nulo para
personen la parte de origen. Como resultado,orderIdpor sí solo no funcionará para comerciantes de Shopify; utilice la pestaña Creación avanzada de envíos en su lugar y proporcione los detalles completos de la parte, incluidoperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {itemidamountdescriptionlabelurltrackingNumberiddocumentFilingOpciones de variables:
"fulfillmentCenter": "fulfillment_center_12345"para especificar la ubicación de origen"generateLabel": falsey agregue"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"para seleccionar un servicio de transportista específico"isDeclaredValue": truepara habilitar la cobertura de valor declaradoValor declarado
Establezca
"isDeclaredValue": truepara habilitar la cobertura de valor declarado para todos los artículos de su envío. Zonos reclama automáticamente el valor total de todos los artículos enviados en el pedido; los comerciantes no pueden modificar este monto. Esto establece la responsabilidad máxima que el transportista aceptará en caso de pérdida, daño o robo durante el tránsito. Esta función solo es compatible con envíos de UPS, FedEx y DHL. Zonos gestiona automáticamente la implementación específica del transportista cuando habilita el valor declarado, incluidos los parámetros apropiados en nuestras llamadas a la API a estos transportistas, por lo que no necesita gestionar distintos requisitos de transportistas.Limitaciones de UPS: UPS solo cubre valores entre 100 y 50.000 USD y procesa el valor declarado a nivel de cartón. Para envíos de varios cartones, los comerciantes deben dividir el envío para designar la cobertura por cartón. UPS también genera un formulario de seguro adicional que debe imprimirse con las etiquetas.
FedEx y DHL: Procesan el valor declarado a nivel de envío sin restricciones adicionales.
Servicios especiales
Utilice
specialServicesen un cartón para indicar requisitos de manipulación especial para baterías, hielo seco, mercancías peligrosas o requisitos de firma. Consulte la guía de servicios especiales para obtener detalles y ejemplos completos.ShipStation UPS Unlock: No se admiten envíos multipieza. Cuando un pedido se envía en varias cajas, el campo de referencia se duplica, lo que provoca que la coincidencia del número de pedido falle en el backend. Los comerciantes que necesiten envíos multipieza deben crear la etiqueta en Zonos Dashboard en su lugar. Los envíos de una sola caja no se ven afectados.
Anular un envío
En caso de que un cliente desee anular un
shipment, puede usar la siguiente mutación que anulará todas laslabelsvinculadas alshipment.mutation {shipmentStatusUpdate(input: {shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"status: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
¿Fue útil esta página?