# Integración con UPS

> Reserva envíos de UPS desde tus envíos con etiquetas, números de seguimiento y facturas comerciales, y sigue cualquier número de UPS: las entregas cierran las paradas.

**Category:** Paquetería y mensajería urgente

## ¿Qué es UPS?

UPS (United Parcel Service) es una de las mayores empresas de paquetería del mundo, con servicios terrestres, aéreos urgentes e internacionales. El software se conecta mediante las API de UPS en developer.ups.com: Transportial usa la Shipping API para reservar y anular envíos y la Tracking API para seguirlos.

## Qué datos se intercambian entre UPS y Transportial

- **Envíos → envíos de UPS** (Hacia UPS): Cuando se confirma un Trip subcontratado con un contrato de capacidad que usa la integración de UPS, cada envío se reserva con tu número de remitente de UPS. Cada paquete de las mercancías se convierte en un bulto de UPS con su peso y medidas, y el número del envío es la referencia.
- **Etiquetas y números de seguimiento** (Hacia Transportial): Se guarda una etiqueta por bulto en el envío —en PDF de 4×6 pulgadas, o en ZPL para impresoras térmicas— junto con los números de seguimiento del envío.
- **Factura comercial para envíos internacionales** (Hacia UPS): Los envíos internacionales llevan datos de aduana de las mercancías: descripción, cantidad, valor, peso, código HS y origen. La factura comercial de UPS se guarda en el envío y, con el incoterm DDP, los aranceles e impuestos se cargan a tu propia cuenta de UPS.
- **Anulación antes de la recogida** (Hacia UPS): Al cancelar el Trip se anulan (void) sus envíos de UPS que aún no se han recogido; los planificadores también pueden anular un solo envío desde el envío.
- **Seguimiento, ETA y cierre de paradas** (Hacia Transportial): El estado, la actividad, la entrega programada y quién firmó la recepción del paquete vuelven al envío. El primer escaneo de recogida completa la parada de carga y la entrega completa la de descarga.
- **Números de UPS reservados en otro lugar** (Hacia Transportial): Añade cualquier número de seguimiento de UPS a un envío —por ejemplo, de un envío creado en el portal de UPS— y Transportial lo sigue del mismo modo.

## Cómo conectar UPS

1. Los transportistas de paquetería se activan por plataforma: pídenos que los habilitemos en tu cuenta de Transportial.
2. Crea una app en el UPS Developer Portal (developer.ups.com) con las API Shipping y Tracking, vinculada a tu cuenta de UPS, y anota su ID de cliente y su secreto.
3. Añade la integración de UPS en Transportial: ID de cliente y secreto, tu número de remitente de UPS, el servicio por defecto y el formato de etiqueta (PDF o ZPL). Puedes empezar en el entorno de pruebas de UPS.
4. Elige esta integración como método de comunicación de un contrato de capacidad. Los Trips subcontratados con ese contrato se reservan en UPS en cuanto los confirmas.

## Frecuencia de sincronización y límites

- Los envíos se reservan al confirmar el Trip; los que se añaden después se reservan en la siguiente actualización del Trip, nunca dos veces con la misma integración.
- Los números de seguimiento abiertos se consultan cada 60 minutos por defecto —configurable por integración— hasta que el envío se entrega, se devuelve o se cancela.
- La Tracking API de UPS admite un número por llamada.
- UPS entrega las etiquetas como imagen; Transportial convierte cada una en una página PDF de 4×6 pulgadas o guarda el ZPL tal cual.
- Un envío solo se puede anular mientras UPS no lo haya recogido.

## Caso de uso típico

Un mayorista de Venlo envía repuestos a talleres de toda Europa y a algunos clientes en Estados Unidos. Los pedidos en palé van en sus propios camiones; los paquetes se planifican en un Trip con un contrato de capacidad de UPS, con UPS Standard por defecto y Express Saver para pedidos urgentes. Al confirmar el Trip se reserva cada envío, y el almacén imprime las etiquetas y facturas comerciales desde el envío. El escaneo de recogida cierra la parada de carga, atención al cliente ve la entrega programada y la parada de descarga se cierra cuando UPS comunica la entrega.


## Preguntas frecuentes

### ¿Qué servicios de UPS puedo reservar?

UPS Standard, Express Saver, Express, Express Plus, Express 12:00, Expedited, Worldwide Economy, Worldwide Express Freight y Access Point Economy, además de servicios nacionales de EE. UU. como UPS Ground, 3 Day Select, 2nd Day Air y Next Day Air. Define uno por defecto en la integración o elige por envío.

### ¿Puedo anular un envío de UPS desde Transportial?

Sí, mientras UPS no lo haya recogido. Al cancelar el Trip se anulan sus envíos de UPS abiertos, y un planificador puede anular un solo envío desde el envío.

### ¿Programa Transportial recogidas de UPS?

No. Entrega los paquetes en tu recogida habitual de UPS o en un UPS Access Point. La integración reserva, genera etiquetas, anula y hace el seguimiento; no reserva recogidas, no compara tarifas ni crea etiquetas de devolución.

### ¿Puedo seguir paquetes de UPS que no reservé con Transportial?

Sí. Añade el número de seguimiento en la pestaña Envíos de paquetería del envío y Transportial lo sigue como sus propias reservas, incluido el cierre de las paradas.


---
Canonical page: https://transportial.com/es/integration/ups
