Qué hace: te entrega el token de seguridad que necesitas para conectarte a la capa de servicio y ejecutar cualquier transacción de la vía JsonServiceCall. Es la puerta de entrada: sin token no puedes hacer nada más por esa vía.
Cuándo se usa: al iniciar la integración vía JsonServiceCall (y cada vez que el token caduca).
Cuándo no usarla: si consumes la vía RequestTransaction. Esa modalidad no usa token: envía las credenciales en el cuerpo de cada petición y no requiere autenticación previa.
| Si tu integración… | Tu artículo es... |
|---|---|
Necesita un token para consumir transacciones por JsonServiceCall |
Este artículo |
Envía Requestor, Entity, User, UserName, etc. en cada petición a /RequestTransaction |
No necesitas token. Ve directo al artículo de la transacción que vas a ejecutar vía Request Transaction |
| Consume el servicio por SOAP | No aplica: la modalidad SOAP no usa esta autenticación |
| Ya tiene token y va a cancelar un CFDI | CANCEL_XML_3 — CFDI + Timbrado (API REST) - JsonServiceCall |
| Ya tiene token y va a consultar el estado de un CFDI | CONSULT_DOCUMENT — CFDI + Timbrado (API REST) - JsonServiceCall |
taxID, user y pass./Authenticate.result.result = true te permite continuar; result = false te lleva a Solución de problemas.errorCode sea 0. Aquí el éxito es cero.token en memoria, en una variable que puedas sustituir.errorCode con valor 101, que indica token caducado.Si algo falla, ve a Solución de problemas.
| Protocolo | HTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON |
|---|---|
| Recurso | /Authenticate |
| Método | POST |
| Content-Type | application/json |
Campo Transaction |
No existe. El nombre de la transacción es el recurso mismo, no un valor dentro del cuerpo |
| Naturaleza | Autenticación. No consulta ni modifica comprobantes |
| Vía | JsonServiceCall únicamente. |
| Consumo |
No descuenta folio del paquete vigente
|
| Ambiente | URL |
|---|---|
| Pruebas | https://api.mysuitetest.com/Authenticate |
| Producción | https://api.mysuitecfdi.com/Authenticate |
Esta transacción no requiere autenticación previa: es la que la produce. Las tres credenciales viajan en el cuerpo de la petición.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
taxID |
string | Sí | RFC (12–13 caracteres) | RFC del emisor |
user |
string | Sí | Texto | Usuario que MYSuite proporcionó para ese RFC o el que hayas creado para la integración |
pass |
string | Sí | Texto | Contraseña del usuario proporcionado para ese RFC |
Un mismo RFC puede tener varios usuarios y cada uno obtiene sesiones independientes (sólo usuarios Admin).
Esta transacción no usa los campos Data1, Data2 y Data3 que estructuran todas las transacciones de la vía RequestTransaction. El cuerpo completo son los tres campos de credenciales del apartado anterior.
Un objeto JSON plano, sin estructuras anidadas ni codificación en Base64. Es la petición más simple de toda la plataforma.
{
"taxID": "string",
"user": "string",
"pass": "string"
}POST /Authenticate HTTP/1.1
Host: api.mysuitetest.com
Content-Type: application/json
{
"taxID": "[RFC del emisor]",
"user": "[usuario proporcionado por MYSuite]",
"pass": "[contraseña del usuario]"
}{
"result": true,
"payload": null,
"token": "OxbZPD1Gd9hUomWYNBUGWkzja54cEGlnz9LLPKZY+pI0+bfE1ldh8TKjBK02xvy5A24FmU2E41WMcccHnC2g0OV/xSikC4etzh4fbaQjSJk=",
"errorMsg": null,
"errorCode": 0
}{
"result": false,
"payload": null,
"token": null,
"errorMsg": "Transacción: Authenticate. Error: Datos Incorrectos. DateTimeStamp: 2026-10-08 12:48:01",
"errorCode": -10
}El cuerpo es un objeto JSON plano de cinco campos. No hay objetos anidados.
| Campo | Tipo | Contenido |
|---|---|---|
result |
booleano | Indica si la transacción fue exitosa: true o false |
token |
string | Token de seguridad para las siguientes conexiones con la capa de servicio. Tiene tiempo de expiración (10 minutos) |
errorCode |
entero | Código de error. 0 significa que no hubo error |
errorMsg |
string | Descripción del error cuando result es false. Llega null en caso exitoso |
payload |
— | Llega null en esta transacción. Sin embargo, en otras transacciones, se envía el contenido de la respuesta. |
errorCode = 0 significa que todo salió bien; en RequestTransaction, codeField = 1 es el éxito y el 0 no es un valor de éxito. Si tu integración consume ambas vías, no compartas la función que evalúa el código de resultado.| Aspecto del token | Qué se sabe |
|---|---|
| Dónde se obtiene | En esta transacción, y después en cada respuesta de cualquier transacción de la vía JsonServiceCall |
| Cuál usar | Siempre el último token devuelto |
| Caducidad | Existe, 10 minutos, se renueva con cada uso |
| Cómo se envía en las demás transacciones | En el elemento "transactionName" |
| Formato | Cadena |
| Concurrencia | «pendiente y prioritario: Desarrollo — ver advertencia siguiente» |
El cuerpo mantiene los cinco campos. Cambia su contenido.
| Campo | Contenido en error |
|---|---|
result |
false |
errorCode |
Código distinto de 0. Ver apartado 10 |
errorMsg |
Descripción del error |
token |
null cuando la autenticación falla |
payload |
null |
result = false. En una transacción de autenticación la diferencia importa, porque muchos clientes HTTP tratan el 401 de forma especialNo existe bloqueo por intentos fallidos repetidos. Si detectamos algún problema en la plataforma por transacciones erroneas de los clientes, los contactamos.
| Código | Significado | Causa | Remedio |
|---|---|---|---|
0 |
Sin error | La operación se ejecutó correctamente | — |
101 |
Token expirado | Venció el tiempo de vida del token | Autenticarte de nuevo con esta transacción y obtener un token nuevo |
102 |
Token inválido | Al desencriptar y analizar los valores que la llamada incluye como información de autenticación, la operación falla | Revisar que estés enviando el último token devuelto, completo y sin alterar. Si persiste, autenticarte de nuevo |
101 y 102 no los devuelve esta transacción: los recibes en las siguientes, cuando el token que enviaste ya no sirve. Se documentan aquí porque la respuesta a ambos es volver a autenticarte.| Aspecto | Valor |
|---|---|
| Alcance | Un RFC y un usuario por llamada |
| Efectos | Ninguno sobre comprobantes. Abre una sesión |
| Idempotencia | Cada llamada devuelve un token. Autenticarse de nuevo invalida el token anterior |
| Vida del token | 10 minutos |
| Concurrencia | Lo prudente es serializar las llamadas de una misma sesión y no paralelizarlas |
| Bloqueo por intentos fallidos | No se penaliza, sin embargo, en caso de algún caso especial, se le contacta al cliente |
| Timeout | 60 segundos en servidor front |
RequestTransaction: son dos conjuntos de accesos distintos sobre el mismo servicio.Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones nuevas.
Resolución. El token rota: cada transacción devuelve uno nuevo que sustituye al anterior. Tu integración tiene que leer el token de cada respuesta y usarlo en la llamada siguiente. Guarda el token en una variable que se sobrescriba, no en una constante de configuración.
Causa. Se trató el token como un valor fijo de sesión. En esta plataforma no lo es.
Problema. Un proceso que lanza varias transacciones a la vez produce rechazos intermitentes de token sin un patrón claro.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · timbrado masivo o procesos multihilo.
Resolución. Serializa las llamadas de una misma sesión: con un token que rota en cada respuesta, dos peticiones simultáneas que parten del mismo token dejan al menos una con un token ya sustituido.
Problema. Una transacción devuelve el código 101.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · sesiones de larga duración.
Resolución. El token caducó. Vuelve a ejecutar AUTHENTICATE, toma el token nuevo y reintenta la transacción que falló. No es un error de credenciales ni de datos: es el ciclo normal de una sesión. Conviene que tu integración lo contemple como un caso esperado y no como una excepción.
Causa. El token tiene tiempo de expiración.
Problema. Una transacción devuelve el código 102.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall.
Resolución. El token es inválido, lo que significa que la plataforma no pudo desencriptar ni analizar la información de autenticación que enviaste. Revisa que estés mandando el último token devuelto, completo y sin recortes: los caracteres finales se pierden con facilidad si el campo que lo almacena es más corto de lo necesario, o si algún proceso intermedio lo trunca o lo codifica otra vez. Si todo está correcto, autentícate de nuevo.
Causa. Token alterado, truncado, o de una sesión anterior.
Problema. Se obtuvo el token pero no queda claro cómo enviarlo en las llamadas siguientes.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones nuevas.
Problema. El intento de autenticar con el Requestor, Entity, UserName y el User que se usan en /RequestTransaction falla.
Entorno. CFDI + Timbrado · API REST · integraciones que migran entre las dos vías.
Resolución. Son dos modelos de credenciales independientes. Esta vía necesita RFC, usuario y contraseña; la otra necesita identificadores GUID. Si vas a usar JsonServiceCall necesitas RFC, Usuario y Contraseña.
Causa. Tener acceso a una vía no implica tenerlo a la otra.
Problema. La lógica que evalúa el resultado marca como error las respuestas exitosas, o al revés.
Entorno. CFDI + Timbrado · API REST · integraciones que consumen las dos vías.
Resolución. Las dos vías expresan el éxito con valores opuestos: aquí errorCode = 0 significa que no hubo error, y en RequestTransaction el éxito es codeField = 1. No compartas la función que evalúa el código de resultado entre ambas. Los nombres de los campos tampoco coinciden: aquí es result, allá es resultField.
Causa. Las dos vías del mismo servicio no comparten convención de respuesta.
La vía RequestTransaction envía las credenciales en cada petición: es más simple de implementar y no requiere mantener estado del lado del cliente, a cambio de repetir los identificadores en cada llamada. La vía JsonServiceCall intercambia credenciales una vez por un token de vida limitada, lo que reduce la exposición de la contraseña a una sola llamada por sesión. Son dos compromisos distintos entre simplicidad y resguardo, y conviven porque responden a preferencias distintas de integración.
La consecuencia práctica es que casi nada se traslada de una a otra: credenciales, nombres de campo, convención de éxito y forma de la respuesta son diferentes. Elegir la vía al inicio de la integración, y no a mitad, ahorra trabajo duplicado.
Un token fijo que viviera toda la sesión sería más cómodo, pero también más valioso para quien lo interceptara: serviría hasta su caducidad. Al sustituirlo en cada respuesta, el valor capturado en una llamada queda obsoleto en cuanto el cliente legítimo ejecuta la siguiente. Es un esquema más seguro y, a cambio, más exigente con la integración: obliga a tratar el token como estado vivo y no como configuración.
Si el token depende de la secuencia de llamadas, la secuencia importa.
El resto de la plataforma se apoya en GUID, que son identificadores largos y aleatorios pero que no se memorizan ni se rotan. Aquí aparece una contraseña, y eso cambia el tratamiento en tres sentidos: no debe quedar escrita en código ni en repositorios, no debe aparecer en bitácoras de la integración, y debería rotarse con alguna periodicidad. Lo primero y lo segundo dependen de ti.
Esta transacción entrega el token pero no explica cómo enviarlo después, para ello, debes dirigirte a la transacción que requieres implementar.
A diferencia del resto de la serie, aquí no hay un artículo equivalente para el otro transporte. La modalidad SOAP resuelve la identidad con los mismos campos que RequestTransaction dentro de cada sobre, sin sesión ni token. AUTHENTICATE es específica de JsonServiceCall y no tiene correspondencia fuera de esa vía.
Vía RequestTransaction