Resumen
APIs de UPS para transportistas: rastrea paquetes por número de seguimiento o referencia, valida direcciones en EE. UU., compara tarifas y tiempos de tránsito, encuentra ubicaciones de entrega y puntos de acceso, estima el costo total, recupera etiquetas y solicita recogidas. La creación de envíos, anulaciones y recogidas están incluidas pero desactivadas. ID de cliente OAuth y secreto del Portal de Desarrolladores de UPS.
Configuración guiada
Conecta UPS a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta UPS con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para UPS
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → UPS, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
UPS
APIs de UPS para transportistas: rastrea paquetes por número de seguimiento o referencia, valida direcciones en EE. UU., compara tarifas y tiempos de tránsito, encuentra ubicaciones de entrega y puntos de acceso, estima el costo total, recupera etiquetas y solicita recogidas. La creación de envíos, anulaciones y recogidas están incluidas pero desactivadas. ID de cliente OAuth y secreto del Portal de Desarrolladores de UPS.
Configuración
Configurar toma aproximadamente 10 minutos.
- Inicia sesión en https://developer.ups.com con el perfil de ups.com que posee tu cuenta de transportista (registra uno primero si es necesario) y abre la página para crear una aplicación.
- Indica que deseas integrar la tecnología de UPS en tu propio negocio, elige el número de cuenta de UPS al que la aplicación debe facturar y nombra la aplicación.
- Agrega los productos que utiliza el conector: Seguimiento, Validación de Direcciones, Tarificación, Tiempo en Tránsito, Localizador, y, para las herramientas desactivadas, Envío, Recogida y Cotización de Costo Total. Un producto que falta responde 401 o 403 solo para sus herramientas.
- Copia el ID de Cliente en
UPS_CLIENT_IDy el Secreto de Cliente enUPS_CLIENT_SECRET. - Coloca tu número de cuenta de UPS de 6 caracteres (número de transportista) en
UPS_ACCOUNT_NUMBER.
El conector intercambia el ID de cliente y el secreto en https://onlinetools.ups.com/security/v1/oauth/token (credenciales de cliente, HTTP Basic) por un token de portador de corta duración y lo renueva por sí mismo. Estas son credenciales de producción; no se utiliza el sistema de prueba de UPS (wwwcie.ups.com).
Por dónde empezar: ups_track_package con un número de seguimiento. Para un precio, ups_shop_rates compara todos los servicios entre dos direcciones y ups_get_rate tarifa un servicio; ups_get_time_in_transit proporciona fechas de entrega sin precios.
Seguimiento: ups_track_package (cualquier número de seguimiento), ups_track_by_reference (tu propia referencia, por ejemplo, un número de pedido, dentro de tu cuenta) y ups_track_shipment_packages (todos los paquetes de un envío de múltiples paquetes). Las fechas son YYYYMMDD y las horas HHMMSS en la hora local del escaneo; gmtDate, gmtTime y gmtOffset dan el mismo momento en UTC. Lee el estado de currentStatus.description y los escaneos de activity, el más reciente primero.
Direcciones y ubicaciones: ups_validate_address cubre direcciones en EE. UU. y Puerto Rico solamente. ups_find_locations encuentra lugares de entrega y ubicaciones de puntos de acceso de UPS cerca de una dirección en cualquier país que UPS sirva.
Tarifas: ups_shop_rates y ups_get_rate envían tu número de cuenta como el número de transportista. Las tarifas publicadas regresan por defecto; pasa rating_options con NegotiatedRatesIndicator para ver las tarifas de contrato de tu cuenta en NegotiatedRateCharges. Los montos son cadenas en la moneda nombrada junto a ellos. Los pesos son LBS o KGS y las dimensiones IN o CM: usa las unidades del país de origen. ups_quote_landed_cost estima derechos e impuestos para un envío transfronterizo y funciona mejor con un código HS por artículo.
Etiquetas y envíos: ups_recover_label devuelve la etiqueta de un envío existente nuevamente y no cuesta nada. ups_create_shipment crea un envío que UPS factura a la cuenta, y ups_void_shipment cancela uno antes de la recogida; ambos están instalados desactivados. Actívalos en el conector solo si el asistente debe crear envíos reales. Los nombres de campo de UPS difieren entre llamadas: las herramientas de tarifas llaman al embalaje PackagingType, la herramienta de envío Packaging.
Recogidas: ups_get_pickup_rate cotiza una recogida a demanda y ups_get_pending_pickups lista las reservadas. ups_create_pickup reserva un conductor por una tarifa y ups_cancel_pickup cancela por PRN; ambos están instalados desactivados.
Errores: UPS responde con response.errors, una lista de code y message. 401 significa que las credenciales o el token fueron rechazados, 403 que la aplicación no tiene acceso a ese producto o que UPS bloqueó la cuenta, 404 en seguimiento que UPS no tiene datos para el número aún (las etiquetas aparecen después del primer escaneo o algunas horas después de la creación), 429 que la cuota de la aplicación se ha agotado.
Límites: UPS establece una cuota por aplicación y producto y no publica los números en sus archivos API; un 429 significa esperar y reintentar más tarde. Rastrear un número por llamada es el uso documentado: no hagas bucles sobre listas largas rápidamente.
Requisitos previos: UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
Instala el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige UPS y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
ups_track_package | Rastrear un paquete de UPS por número de seguimiento: estado actual con código y descripción, cada escaneo (fecha como YYYYMMDD, hora local como HHMMSS… |
ups_track_by_reference | Encontrar y rastrear envíos de tu cuenta de UPS por un número de referencia que colocas en el envío (número de pedido, número de factura). Devuelve lo mismo… |
ups_track_shipment_packages | Rastrear cada paquete de un envío de múltiples paquetes de UPS desde uno de sus números de seguimiento: por paquete el número de seguimiento, estado actual, último… |
ups_validate_address | Verificar una dirección en EE. UU. o Puerto Rico contra los datos de UPS. Devuelve ValidAddressIndicator, AmbiguousAddressIndicator… |
ups_get_rate | Tarifar un servicio de UPS para un envío. Devuelve RateResponse.RatedShipment con el código de servicio, peso de facturación, transporte, servicio… |
ups_shop_rates | Comparar cada servicio de UPS disponible entre dos direcciones para un envío. Devuelve un RatedShipment por servicio con su código, facturación… |
ups_get_time_in_transit | Listar los servicios de UPS disponibles entre dos lugares bajo emsResponse.services: serviceLevel y serviceLevelDescription… |
ups_find_locations | Encontrar lugares de entrega de UPS cerca de una dirección: ubicaciones de puntos de acceso de UPS, The UPS Store, centros de atención al cliente y buzones. Devuelve… |
ups_quote_landed_cost | Estimar derechos, impuestos y tarifas de corretaje para un envío internacional antes de que se envíe (Cotización de Costo Total de UPS). Devuelve por mercancía el… |
ups_recover_label | Obtener la etiqueta de un envío que ya existe nuevamente, por número de seguimiento. Devuelve LabelRecoveryResponse.LabelResults con la etiqueta como un… |
ups_get_pickup_rate | Cotizar cuánto costaría una recogida a demanda de UPS en una dirección, sin reservarla. Devuelve PickupRateResponse.RateResult con el tipo de tarifa… |
ups_get_pending_pickups | Listar las recogidas reservadas en tu cuenta de UPS que aún no han ocurrido. Devuelve PickupPendingStatusResponse.PendingStatus con la recogida… |
ups_create_shipment | Crear un envío de UPS y su etiqueta. UPS factura el envío a tu cuenta tan pronto como esta llamada tiene éxito, así que la herramienta está instalada… |
ups_void_shipment | Anular (cancelar) un envío de UPS que fue creado pero aún no recogido, o paquetes individuales de él. No se puede deshacer: las etiquetas se vuelven… |
ups_create_pickup | Reservar una recogida a demanda de UPS: un conductor viene a la dirección en el día dado. UPS cobra una tarifa de recogida a tu cuenta, así que la herramienta está… |
ups_cancel_pickup | Cancelar una recogida de UPS reservada por su número de solicitud de recogida (PRN). No se puede deshacer; se debe reservar una nueva recogida. Devuelve… |
Ejemplos de solicitudes
- "¿Dónde está el paquete de UPS 1Z999AA10123456784?"
- "Compara las tarifas de UPS desde Chicago 60601 a Austin 78701 para una caja de 5 lb."
- "¿Es 1600 Amphitheatre Pkwy, Mountain View, CA 94043 una dirección válida?"
- "¿Cuándo llegaría un paquete de UPS Ground desde Atlanta a Seattle si se envía hoy?"
- "Encuentra ubicaciones de puntos de acceso de UPS cerca de 10115 Berlín."
Próximos pasos
¿Te ha sido útil esta guía?