Configurar UPS Unlock
- 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.
- Habilite UPS Unlock en Dashboard - Vaya a Zonos Dashboard → Settings → Rates → UPS y active UPS Unlock en Enable
- Configure sus números de referencia - Al menos un número de referencia debe comenzar con
zxozx-. Siempre que al menos una referencia comience conzx(incluso si el valor es solozx), 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:
zxORDER123ozx-ORDER123(formato combinado con número de pedido del comerciante)zxorder_0jy1vh6gygcksozx-order_0jy1vh6gygcks(formato combinado con ID de pedido de Zonos)- Referencia 1:
zx, Referencia 2:ORDER123(dividido en dos campos de referencia)
- Ejemplos:
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:
- UPS llama automáticamente a Zonos para validar el pedido con los campos de referencia proporcionados
- Zonos valida y devuelve detalles aduaneros actualizados a UPS - Zonos valida que el envío coincida con la cotización original comprobando:
- Los artículos del envío coinciden con los de la cotización
- Las cantidades son menores o iguales a las cantidades cotizadas
- Los números de parte coinciden con los product IDs o SKUs de la cotización
- Los detalles de destino (país/provincia) coinciden con la cotización
- UPS procesa su envío con información de cumplimiento
- UPS llama a Zonos para crear el registro de envío con número de seguimiento
- 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:
| Campo↕ | Descripción↕ | Ejemplo↕ |
|---|---|---|
| Order ID | El UUID del pedido de Zonos | order_0jy1vh6gygcks |
| Account order number | Su número de pedido del comerciante | ORD-12345, #1001 |
| Zonos order ID | Identificador corto de Zonos | zo-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ódigo↕ | Mensaje↕ | Causa↕ |
|---|---|---|
| 10001 | Shipper number not found | El número de remitente de UPS no está registrado con Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Ningún pedido coincide con ninguna referencia (después de eliminar el prefijo) |
| 10003 | Invalid reference IDs. No prefix of zx- found | Ninguna de las referencias tiene el prefijo zx o zx- |
| 10006 | The requested order is not guaranteed | El pedido existe pero no tiene Landed Cost Guarantee |
| 10010 | ShipFrom.CountryCode mismatch | El país de origen no coincide con el origen cotizado |
| 10011 | ShipTo.CountryCode mismatch | El país de destino no coincide con el destino cotizado |
| 10012 | ShipTo.StateProvinceCode mismatch | Para envíos CA/BR, la provincia no coincide |
| 10013 | No matching Product on quote with PartNumber | El SKU/productId del producto no se encuentra en el pedido |
| 10015 | Quantity exceeds the quoted quantity | La 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
- Acceda a la configuración de Label Messages: Vaya a Settings → Printing → Printing Setup, luego haga clic en Document Options para Label
- 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.
- Configure sus Messages para usar Order Number: Configure Message #1 en
[Order #]. Si ya tiene un #1, agregue un #2 o #3 - 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:
- Acceda a la configuración de Label Messages: Vaya a Settings → Printing → Printing Setup, luego haga clic en Document Options para Label
- 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.
- 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)
- Configure Message #1 en
- 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 Settings → Automation → Automation Rules y haga clic en Create a Rule.
Regla para pedidos UPS de Zonos:
- Nombre: "Zonos UPS Unlock"
- Asegúrese de que Active Rule esté activado
- Seleccione Orders match these specific criteria
- 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.
- Establezca acciones:
- Action Type: Seleccione "Set Custom Field 1..."
- Custom Field 1:
zx(esto establece el prefijo)
- 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.
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.