Conectar USPS: tarifas en vivo, etiquetas y rastreo
Obtenga su Consumer Key y Consumer Secret en USPS Developer Portal, péguelos en Integration, pruebe, mapee servicios y empiece a cotizar y enviar.
El conector de USPS obtiene tarifas, compra etiquetas y rastrea envíos mediante las API de USPS. Un par de credenciales OAuth —Consumer Key y Consumer Secret— cubre tarifas y rastreo; comprar etiquetas además necesita sus identificadores de cuenta de pago de USPS.
Requisitos previos#
- Acceso a USPS Developer Portal (developers.usps.com) y una app en Apps: su Consumer Key y Consumer Secret están en esa página de la app.
- Decida primero el entorno: empiece con el entorno de prueba (TEM) antes de producción.
- Tarifas y rastreo solo necesitan el par OAuth: no hace falta ningún campo de cuenta.
- Antes de comprar etiquetas, tenga listos sus identificadores de cuenta de pago de USPS: CRID, MID y EPS. Se necesitan al comprar una etiqueta, no al crear esta conexión.
Obtener credenciales#
- Vaya a USPS Developer Portal (developers.usps.com) → Apps → abra su app.
- En la página de la app, copie el Consumer Key. Se usa como OAuth client_id.
- En la misma página de la app, copie el Consumer Secret. Se usa como OAuth client_secret.
- Guarde el Consumer Secret en un lugar seguro de inmediato. Si lo pierde, genere uno nuevo en USPS Developer Portal.
Completar en Integration#
- Abra Integration → Marketplace → USPS → Nueva conexión.
- Consumer Key (client_id), obligatorio: pegue el Consumer Key de la página de su app en USPS Developer Portal. En el asistente, el campo se etiqueta «Consumer Key».
- Consumer Secret (client_secret), obligatorio: pegue el Consumer Secret de la misma página de la app. Se cifra en reposo y nunca se muestra.
- Use sandbox (sandbox), opcional: escriba «true» para usar el entorno de prueba TEM (apis-tem.usps.com). Déjelo vacío para producción (apis.usps.com).
- CRID / MID / EPS: no los busque aquí; son identificadores de cuenta de pago para comprar etiquetas, no campos de este asistente de conexión. Téngalos listos antes de comprar etiquetas.
Probar la conexión#
Haga clic en Probar la conexión. La prueba solo intercambia su Consumer Key y Consumer Secret por un token OAuth para comprobar que las credenciales funcionan: no cotiza tarifas, no compra etiquetas ni comprueba el rastreo. Si pasa, clave, secreto y entorno coinciden; si falla, anote el error y revise la FAQ antes de cambiar otra cosa.
Mapping / elegir plantilla#
USPS no necesita mapping de pedidos: trabaja con paquetes, no con pedidos. Lo que se mapea aquí son los servicios del transportista: en la configuración de la conexión, vincule cada servicio de envío que usa internamente con el servicio USPS correspondiente y deje activos solo los servicios con los que realmente envía, para que la comparación de tarifas solo cotice servicios que sí ofrece.
Activar#
Tras activar, la conexión sirve para comparar tarifas y comprar etiquetas al enviar, y las actualizaciones de rastreo vuelven y se aplican al envío. Antes de su primera etiqueta real, asegúrese de que sus identificadores de cuenta de pago (CRID / MID / EPS) estén listos: la prueba de conexión no los comprueba. Vigile los primeros envíos en Runs / Logs antes de dejarlo sin supervisión.
Preguntas frecuentes#
La prueba falla con 401
El Consumer Key o el Consumer Secret son incorrectos: los dos valores están intercambiados, o uno se copió incompleto o con un espacio extra, y USPS rechaza el intercambio de token.
Vuelva a USPS Developer Portal (developers.usps.com) → Apps → su app, copie el Consumer Key en el campo Consumer Key y el Consumer Secret en el campo Consumer Secret tal cual, y pruebe de nuevo.
Entorno de prueba y producción están mezclados
El entorno y lo esperado no coinciden: Use sandbox está en «true» y las llamadas van al entorno de prueba TEM, pero se está probando como si fuera producción; o Use sandbox está vacío para producción y se sigue esperando comportamiento de prueba.
Haga que el ajuste coincida con el entorno que quiere probar y pruebe de nuevo: para el entorno de prueba escriba «true» en Use sandbox; para producción déjelo vacío. Si usa ambos, manténgalos como conexiones separadas.
La prueba pasa pero comprar una etiqueta falla
Esto ocurre cuando la parte de pago no está lista: la prueba solo comprueba el intercambio OAuth para tarifas y rastreo, mientras que comprar una etiqueta además necesita sus identificadores de cuenta de pago de USPS: CRID, MID y EPS.
Prepare su CRID, MID y EPS antes de comprar etiquetas: no son campos del asistente de conexión, así que una prueba aprobada no los cubre. Cuando estén listos, intente comprar la etiqueta de nuevo y, si sigue fallando, revise el error en Runs / Logs.
Etiqueta comprada pero el rastreo nunca se actualiza
Las actualizaciones de rastreo llegan al ritmo de USPS, no al instante, y una etiqueta que aún no se ha entregado a USPS no tiene movimientos que mostrar.
Confirme que el paquete se entregó realmente, espere y vuelva a comprobar. Si tras 24 horas no llega nada, revise en Runs / Logs los errores de rastreo de ese envío.