Saltar a contenido

API de Servientrega USA para integradores

Este sitio documenta el API de Servientrega USA que usan nuestros clientes y aliados para crear guías, imprimir etiquetas, rastrear envíos y cotizar el costo de un envío desde sus propios sistemas.

Quién puede usarlo

El API está disponible para los clientes y aliados que tienen un acuerdo de integración con Servientrega USA. Cada integrador recibe sus propias credenciales.

Cómo obtener las credenciales

Escriba a developers@servientrega.us con el nombre de su empresa, el usuario de Kiwi que usará para la integración y un contacto técnico. Para pedir un token de acceso necesita:

  • client_id y client_secret: Servientrega USA se los envía de forma privada.
  • username y password: las mismas credenciales que usa en Kiwi.

Mantenga sus credenciales en reserva

Nunca comparta sus credenciales, ni las publique en un repositorio de código, ni las entregue a sus clientes finales. Si cree que quedaron expuestas, escriba a developers@servientrega.us para reemplazarlas.

Ambientes

Ambiente Gateway Para qué
Producción https://ocelot.servientrega.us Envíos reales
Pruebas https://ocelotkiwi.azurewebsites.net Desarrollar y probar su integración. Las guías creadas en pruebas no son envíos reales

Cada página de método muestra la URL y el ejemplo de petición de los dos ambientes: elija la pestaña Producción o Pruebas. El sitio recuerda su elección en las demás páginas.

Pruebas y Producción tienen credenciales distintas. Al pedirlas, indique si necesita las de pruebas, las de Producción o ambas.

Recomendaciones generales

  • Toda petición requiere un token de acceso. Pida uno nuevo cuando el actual venza.
  • Revise siempre notificationType y messages en cada respuesta, aunque la petición parezca exitosa.
  • Envíe fechas, pesos y valores exactamente en los formatos que se describen en cada método.
  • Consulte con frecuencia la página Bitácora de cambios: allí aparece cada cambio del API y si afecta su integración.

Soporte

Preguntas sobre la integración: developers@servientrega.us.