AUTHENTICATE — SERVICIO CFDI + Timbrado (API REST) - JsonServiceCall

AUTHENTICATE — SERVICIO CFDI + Timbrado (API REST) - JsonServiceCall

Estado Transacción: Vigente · Compatibilidad: CFDI + Timbrado API REST, vía JsonServiceCall · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · Responsable: Jan Martínez


De un vistazo


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.


El token no es fijo: se va rotando en cada llamada. Cada transacción que ejecutes devuelve un token nuevo, y, en la siguiente llamada, debes usar el último token devuelto, no el que obtuviste aquí por primera vez. Si tu integración guarda el token inicial y lo reutiliza siempre, dejará de funcionar en cuanto ejecutes la primera transacción.
Esta transacción recibe una contraseña. Es la única de la plataforma que lo hace: todas las demás usan identificadores GUID. Trátala como tal: no la registres en bitácoras, no la dejes en código fuente, ni en repositorios, y no la escribas en tickets de soporte.


Cómo saber si este es tu artículo

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


Requisitos previos

  • El RFC del emisor.
  • El usuario que MYSuite creó para ese RFC (o el usuario que el Administrador de tu cuenta haya creado posteriormente en el portal web de MYSuite para la integración).
  • La contraseña de ese usuario.
  • Para pruebas, un usuario de ambiente de test. Si no cuentas con uno, solicitalo al correo: soporte.especializado@mysuitemex.com
  • Un lugar seguro donde conservar la contraseña, y un lugar en memoria donde mantener el token vigente.


Cómo hacerlo

  1. Reúne las tres credenciales: RFC del Emisor, Usuario y Contraseña.
    Resultado: los datos de la petición.
  2. Arma el cuerpo JSON con los tres campos taxID, user y pass.
    Resultado: un JSON de tres campos, sin credenciales de tipo GUID ni campo de transacción.
  3. Envía la petición al recurso /Authenticate.
    Resultado: respuesta con un cuerpo JSON de cinco campos.
  4. Lee result.
    Resultado: result = true te permite continuar; result = false te lleva a Solución de problemas.
  5. Comprueba que errorCode sea 0. Aquí el éxito es cero.
    Resultado: confirmación de que la autenticación fue correcta.
  6. Guarda el valor de token en memoria, en una variable que puedas sustituir.
    Resultado: el token con el que vas a ejecutar la siguiente transacción.
  7. Sustituye ese token por el que devuelva cada transacción que ejecutes después. La continuidad de la sesión depende de usar siempre el último.
    Resultado: sesión viva, sin necesidad de volver a autenticarte.
  8. Vuelve a ejecutar esta transacción cuando recibas errorCode con valor 101, que indica token caducado.
    Resultado: token nuevo y sesión reanudada.

Si algo falla, ve a Solución de problemas.


Contrato técnico

1. Endpoint y operación

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


2. Ambientes

Ambiente URL
Pruebas https://api.mysuitetest.com/Authenticate
Producción https://api.mysuitecfdi.com/Authenticate
El usuario de pruebas se solicita. Para probar en el ambiente de test necesitas que MYSuite cree un usuario para tu RFC, pídelo al correo soporte.especializado@mysuitemex.com


3. Autenticación

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).


4. Parámetros de entrada

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.


5. Estructura de lo que se envía

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"
}


6. Ejemplo de request

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]"
}


7. Ejemplo de response

{
"result": true,
"payload": null,
"token": "OxbZPD1Gd9hUomWYNBUGWkzja54cEGlnz9LLPKZY+pI0+bfE1ldh8TKjBK02xvy5A24FmU2E41WMcccHnC2g0OV/xSikC4etzh4fbaQjSJk=",
"errorMsg": null,
"errorCode": 0
}


Ejemplo de response con notificación de error:

{
"result": false,
"payload": null,
"token": null,
"errorMsg": "Transacción: Authenticate. Error: Datos Incorrectos. DateTimeStamp: 2026-10-08 12:48:01",
"errorCode": -10
}

8. Estructura de respuesta — éxito

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.
Aquí 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.


El token y su rotación

Esto es lo que más integraciones rompe. El token que obtienes aquí sirve para la siguiente llamada. A partir de ahí, cada transacción que ejecutes devuelve un token nuevo, y la llamada posterior debe usar ese último token, no el original. Mantener la sesión viva consiste en ir sustituyendo el token en cada respuesta.
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»
Concurrencia: Lo prudente es serializar las llamadas de una misma sesión y no paralelizarlas.


9. Estructura de respuesta — error

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
Idea
Una autenticación fallida devuelve HTTP 200 con result = false. En una transacción de autenticación la diferencia importa, porque muchos clientes HTTP tratan el 401 de forma especial

No existe bloqueo por intentos fallidos repetidos. Si detectamos algún problema en la plataforma por transacciones erroneas de los clientes, los contactamos.


10. Códigos de Error

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
Los códigos 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.


11. Límites y comportamiento

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


12. Versionado y cumplimiento

  • Esta transacción no interviene en la emisión ni en la cancelación de comprobantes: no tiene efectos fiscales ni está sujeta al Anexo 20.
  • La contraseña y el token son credenciales de acceso a un servicio que emite comprobantes con efectos fiscales. Su resguardo es responsabilidad del cliente: no deben registrarse en bitácoras, ni quedar en código fuente, ni compartirse en tickets de soporte.
  • El modelo de credenciales de esta vía es independiente del de RequestTransaction: son dos conjuntos de accesos distintos sobre el mismo servicio.

Solución de problemas

"Me autentiqué bien pero la segunda transacción falla"


Problema. La autenticación devuelve token y la primera transacción funciona, pero a partir de la segunda empiezan los rechazos.

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.

"Mi proceso en paralelo falla de forma aleatoria"


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.

Causa. El comportamiento del token ante llamadas concurrentes no está declarado. Mientras tanto, la recomendación prudente es no paralelizar.

"Recibo errorCode 101"


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.

"Recibo errorCode 102"


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.

"No sé dónde poner el token en las demás transacciones"


Problema. Se obtuvo el token pero no queda claro cómo enviarlo en las llamadas siguientes.

Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones nuevas.

Resolución. Revisa el artículo de la transacción que vas a ejecutar: cada una documenta la forma de su petición. El token viaja como parámetro.
Causa. El artículo fuente explica cómo obtener el token pero no cómo usarlo.

"Mis credenciales de la otra vía no funcionan aquí"


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.

"Mi código de manejo de errores da falsos positivos"


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.


Para entender más

Por qué existen dos modelos de autenticación

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.

Por qué el token rota

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.

Una contraseña entre identificadores

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.

Lo que este artículo cubre

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.

Por qué esta transacción no tiene hermana en SOAP

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.


Transacciones del servicio CFDI + Timbrado (API REST)


Vía RequestTransaction


      Emisión
      Consulta y Recuperación
      Validación y Recepción
      CFDI de Retenciones


Vía JsonServiceCall

      Autenticación (obtención de token)
      Emisión
      Consulta y Recuperación
      Esquema de cancelación