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_idyclient_secret: Servientrega USA se los envía de forma privada.usernameypassword: 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
notificationTypeymessagesen 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.