Manual de usuario para el uso de la plataforma
abierta (API)
Pasos para realizar la integración con la API
Ingresar al siguiente link para comenzar con el proceso de registro/inicio de sesión
para la integración: [Link]
1.- Log in / register. Es necesario registrarse si no se ha creado una cuenta
anteriormente, se puede usar un correo electrónico cómo nombre de usuario.
Log in/ Iniciar sesión
Register / Registrarse
Al dar clic sobre el botón de “send” el sistema enviará un código de verificación al
correo electrónico ingresado anteriormente, el cual deberemos ingresar en el cuadro
de texto, esto para la validación de la cuenta.
1
2.- Console – Autenticación y llenado de la información de la empresa y del
desarrollador.
Una vez realizado el registro de manera exitosa se deberá llenar la información tanto
de la empresa y del contacto principal o del desarrollador.
Nota: Considerar lo siguiente:
a) Si el código postal y la dirección no se encuentra en México debido a que la
compañía se encuentra en otro país, se puede ingresar el código postal
“03810” u otro código postal; y en el campo de dirección se puede ingresar
la dirección de la empresa que se ubica en dicho país extranjero.
b) El nombre de contacto para la “interfaz” (conexión) se refiere a una persona
del área de TI quien estará a cargo de realizar dicha conexión, hay que
llenar la información de acuerdo con la situación actual de la empresa.
Al finalizar se deberá guardar el registro y posteriormente contactar al personal de
J&T Express México (preferentemente a su ejecutivo comercial) para que se realice
la revisión.
2
3.- Administración de Sandbox - Suscripción
Para cada Web Service (WS) / endpoint al que requiera conectarse es necesario
realizar 3 pruebas de comunicación. (Se pueden usar las herramientas del “Help
Center” para realizar dichas pruebas).
Las credenciales de prueba para el uso del entorno “Sandbox” son las siguientes:
apiAccount de prueba: 292508153084379141
privateKey de prueba: a0a1047cce70493c9d5d29704f05d0d9
Código de cliente de prueba: J0086024119
Contraseña en texto plano de prueba: W261smo0
Contraseña encriptada: C9FA4CEE03DFD55BF3543FD055AD0877
3
Nota: 1) Es necesario que se apruebe/audite la cuenta para que se genere un “uuid”
al final de las ligas de sandbox, debido a que si no se aprueba y se usan las ligas
“demo” sin “uuid” estas pruebas no serán consideradas válidas y no estarán ligadas
a la cuenta. Estas pruebas se deben realiza una vez aprobada la cuenta por parte
de J&T.
Los endpoints disponible se encuentran en:
3.1) Gestión del Sandbox – Registro de las clases
Para usar la interfaz de retorno del rastreo de logística se necesitarán hacer 3
pruebas exitosas para poder aplicar a este endpoint.
4
Si ya se han realizado 3 veces las pruebas de comunicación de manera exitosa,
puede dar clic en Console> Release online> Interface management. Al dar clic en
"Application" cambiara el estado a "Applying"
De esta manera se podrán visualizar los servicios que están en línea y listos para
entrar en producción
5
Las credenciales para el entorno oficial apiAccount y privateKey se encuentran en
su perfil del link del registro de la cuenta para la API. Contacte al ejecutivo comercial
de J&T para el código de cliente y la contraseña.
4. ¿Cómo se generan los parámetros “Business” y “Header”?
Se debe consultar en la siguiente ruta: Help Center> Signature Tool. En la página
se explica cómo son las reglas para generar dichos parámetros para el “Header” y
para el “Business”.
6
Además, no es necesario generar las reglas, dentro de la URL proporcionamos
ejemplos SDK de códigos relevantes que puede usar directamente en su plataforma.
Vaya a la página de descripción siguiendo la ruta Help Center> API-SDK y verifique
el lenguaje de programación que necesita para desarrollar el código. En la pá gina,
descargue el SDK. Si no encuentra el SDK de idioma para su desarrollo de código
actual, puede comunicarse con el personal técnico de J&T para el soporte.
([Link]
