DOCS

UPS Unlock

UPS Unlock

Automatice la facturación de aranceles e impuestos a Zonos para envíos de UPS procesados fuera de Dashboard.

UPS Unlock le permite generar envíos compatibles con Zonos desde su propia plataforma de envío, en lugar de utilizar Zonos Dashboard. Al agregar un número de referencia específico al procesar envíos de UPS, UPS valida y actualiza automáticamente los datos del envío a través de Zonos, incluidas descripciones aduaneras, HS codes, números de cuenta de aranceles, tax IDs y valores de mercancías. Esto elimina la necesidad de configurar reglas o integraciones complejas para pasar esta información a su plataforma de envío. En su lugar, UPS recupera los datos directamente de Zonos, reduciendo el riesgo de discrepancias o información faltante y minimizando el tiempo de configuración y mantenimiento manual.

Configurar UPS Unlock 

  1. Contacte a soporte de Zonos - Antes de habilitar UPS Unlock, comuníquese con Zonos Support para asegurarse de que su cuenta de UPS esté configurada correctamente. Este proceso normalmente tarda 24-48 horas en completarse.
  2. Habilite UPS Unlock en Dashboard - Vaya a Zonos Dashboard → Settings → Rates → UPS y active UPS Unlock en Enable
  3. Configure sus números de referencia - Al menos un número de referencia debe comenzar con zx o zx-. Siempre que al menos una referencia comience con zx (incluso si el valor es solo zx), Zonos escaneará todos los números de referencia para encontrar un ID de pedido de Zonos o número de pedido de cuenta coincidente.
    • Ejemplos:
      • zxORDER123 o zx-ORDER123 (formato combinado con número de pedido del comerciante)
      • zxorder_0jy1vh6gygcks o zx-order_0jy1vh6gygcks (formato combinado con ID de pedido de Zonos)
      • Referencia 1: zx, Referencia 2: ORDER123 (dividido en dos campos de referencia)

Cómo funciona 

Una vez que tenga UPS Unlock configurado, los envíos de UPS harán referencia a los datos del pedido de Zonos. Así funciona ese proceso:

  1. UPS llama automáticamente a Zonos para validar el pedido con los campos de referencia proporcionados
  2. Zonos valida y devuelve detalles aduaneros actualizados a UPS - Zonos valida que el envío coincida con la cotización original comprobando:
    1. Los artículos del envío coinciden con los de la cotización
    2. Las cantidades son menores o iguales a las cantidades cotizadas
    3. Los números de parte coinciden con los product IDs o SKUs de la cotización
    4. Los detalles de destino (país/provincia) coinciden con la cotización
  3. UPS procesa su envío con información de cumplimiento
  4. UPS llama a Zonos para crear el registro de envío con número de seguimiento
  5. Zonos registra el envío en el pedido

Coincidencia de referencias 

Cuando UPS llama a Zonos con una referencia como zx-ORDER123, Zonos elimina el prefijo y busca el pedido. El valor después del prefijo (ORDER123 en este ejemplo) se compara con tres campos en el pedido de Zonos:

CampoDescripciónEjemplo
Order IDEl UUID del pedido de Zonosorder_0jy1vh6gygcks
Account order numberSu número de pedido del comercianteORD-12345, #1001
Zonos order IDIdentificador corto de Zonoszo-1232423

Zonos devuelve el pedido coincidente más reciente. Si no se encuentra coincidencia, se devuelve un error.

Requisitos

Para que UPS Unlock tenga éxito, el pedido debe cumplir estos requisitos:

  • Landed Cost Guarantee (LCG) - El pedido debe haberse creado a través del flujo de Checkout de Zonos con un landed cost garantizado. Los pedidos creados fuera de Zonos no pueden utilizarse con UPS Unlock.
  • Origen/destino coincidentes - Los países de envío y destino deben coincidir con la cotización original. Para envíos a Canadá o Brasil, la provincia también debe coincidir.
  • Productos coincidentes - Los números de parte deben coincidir con los product IDs o SKUs de la cotización, y las cantidades no pueden exceder las cantidades cotizadas.

Códigos de error 

Si la validación falla, UPS recibe una respuesta de error de Zonos. Los códigos de error comunes incluyen:

CódigoMensajeCausa
10001Shipper number not foundEl número de remitente de UPS no está registrado con Zonos
10002No Zonos order found for any of the provided reference IDsNingún pedido coincide con ninguna referencia (después de eliminar el prefijo)
10003Invalid reference IDs. No prefix of zx- foundNinguna de las referencias tiene el prefijo zx o zx-
10006The requested order is not guaranteedEl pedido existe pero no tiene Landed Cost Guarantee
10010ShipFrom.CountryCode mismatchEl país de origen no coincide con el origen cotizado
10011ShipTo.CountryCode mismatchEl país de destino no coincide con el destino cotizado
10012ShipTo.StateProvinceCode mismatchPara envíos CA/BR, la provincia no coincide
10013No matching Product on quote with PartNumberEl SKU/productId del producto no se encuentra en el pedido
10015Quantity exceeds the quoted quantityLa cantidad solicitada es mayor que la cotizada

Integración con ShipStation 

Los usuarios de ShipStation pueden configurar UPS Unlock agregando el prefijo zx upstream (mediante API antes de que los pedidos lleguen a ShipStation) o dentro de ShipStation utilizando configuraciones de Label Messages y Automation Rules. Esto permite que el prefijo zx y el ID del pedido se incluyan en envíos de UPS procesados a través de ShipStation, activando UPS Unlock. Después de completar los pasos de configuración iniciales, puede comenzar a configurar ShipStation para que funcione con UPS Unlock.

Agregar zx upstream

Si puede agregar el prefijo zx upstream (antes de que los pedidos lleguen a ShipStation), solo necesita configurar sus Label Messages para mostrar el número de pedido zx:

Configuración de Label Messages

  1. Acceda a la configuración de Label Messages: Vaya a SettingsPrintingPrinting Setup, luego haga clic en Document Options para Label
  2. Configure Label Messages: En la sección Label Messages, puede definir hasta 3 mensajes personalizados que aparecerán como números de referencia en las etiquetas de UPS. Label Messages solo aceptan valores preestablecidos como "Custom Field 1", "Order #", etc.
  3. Configure sus Messages para usar Order Number: Configure Message #1 en [Order #]. Si ya tiene un #1, agregue un #2 o #3
  4. Guarde la configuración para aplicar su configuración

Una vez completado, ShipStation colocará automáticamente su número de pedido en su etiqueta, que incluye su prefijo zx configurado.

Agregar zx en ShipStation

Si no puede agregar el prefijo zx upstream (antes de que los pedidos lleguen a ShipStation), deberá configurar sus Label Messages y Automation Rules para mostrar el prefijo zx y el número de pedido utilizando dos Label Messages separados:

Paso 1: Configuración de Label Messages

Configure sus Label Messages para mostrar tanto el prefijo como el número de pedido:

  1. Acceda a la configuración de Label Messages: Vaya a SettingsPrintingPrinting Setup, luego haga clic en Document Options para Label
  2. Configure Label Messages: En la sección Label Messages, puede definir hasta 3 mensajes personalizados que aparecerán como números de referencia en las etiquetas de UPS.
  3. Configure sus Messages:
    • Configure Message #1 en [Custom Field 1] (esto se completará con "zx" mediante regla de automatización)
    • Configure Message #2 en [Order #] (seleccione del menú desplegable)
  4. Guarde la configuración para aplicar su configuración

Paso 2: Configuración de Automation Rules

Después de configurar sus Label Messages, cree una regla de automatización para completar Custom Field 1 con el prefijo zx. Vaya a SettingsAutomationAutomation Rules y haga clic en Create a Rule.

Regla para pedidos UPS de Zonos:

  1. Nombre: "Zonos UPS Unlock"
  2. Asegúrese de que Active Rule esté activado
  3. Seleccione Orders match these specific criteria
  4. Establezca criterios: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Nota: Sus criterios de activación pueden variar según su configuración de ShipStation. Este es un punto de partida recomendado: personalice las condiciones según su flujo de trabajo y preferencias específicos para asegurarse de que UPS Unlock se aplique solo a los pedidos apropiados.

  1. Establezca acciones:
    • Action Type: Seleccione "Set Custom Field 1..."
    • Custom Field 1: zx (esto establece el prefijo)
  2. Haga clic en Save Rule

Una vez completado, ShipStation completará automáticamente Custom Field 1 con zx y Message #2 con el número de pedido para pedidos internacionales de UPS. Estos aparecerán en sus etiquetas de UPS como dos líneas de referencia separadas.

Importante: La configuración de Label Message en ShipStation es un cambio global que afecta a todos los transportistas. El enfoque de reglas de automatización permite que UPS Unlock funcione sin problemas para pedidos de Zonos mientras mantiene sus Label Messages preferidos para otros envíos.

¿Fue útil esta página?