Skip to content

Solicitar token ​

POST /api/Invoice/create_token_authenticator

Genera el token JWT de acceso del negocio emisor. Es el único endpoint que no requiere token: el resto del API exige enviarlo en el encabezado Authorization. Devuelve el token en la clave token.

Autenticación: no requiere · Content-Type: application/json

Cuerpo de la solicitud ​

CampoTipoObligatorioDescripción y reglas
userNamestringSíUsuario de API del negocio (correo o nombre de usuario) que CG Imprenta Digital entrega al habilitar la integración. Se eliminan los espacios al inicio y al final.
userPasswordstringSíContraseña de API que CG Imprenta Digital entrega al habilitar la integración. Se eliminan los espacios al inicio y al final.

Los nombres de los campos distinguen mayúsculas y minúsculas (userName, userPassword).

Ejemplo de solicitud ​

http
POST {{host}}api/Invoice/create_token_authenticator
Content-Type: application/json
json
{
  "userName": "usuario@example.com",
  "userPassword": "<contraseña de API>"
}

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "message": "Token de Acceso",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}
ClaveDescripción
successtrue cuando el token se generó.
messageSiempre Token de Acceso.
tokenToken JWT. Envíalo en cada solicitud como Authorization: Bearer <token>.

Errores ​

HTTPMensaje (ejemplo)Causa
400El cuerpo de la solicitud está vacío o no es un JSON válido.No se envió cuerpo o no es JSON.
401No introdujo usuario y/o Contraseña.userName o userPassword llegaron vacíos (o solo con espacios).
401No existe coincidencia de usuario en la Base de Datos.Usuario o contraseña incorrectos.
500Error al procesar la solicitud. u otro texto técnicoError interno al generar el token (por ejemplo, el usuario no tiene un negocio asociado correctamente). Contacta a soporte.

Todas las respuestas de error tienen la forma {"success": false, "message": "..."}.

Notas ​

  • Vigencia: el token vence 3600 segundos (1 hora) después de emitido. Al vencer, cualquier endpoint responde 401 con {"status": false, "message": "Token expirado"}; pide entonces un token nuevo. Ver Autenticación.
  • Reutiliza el token mientras esté vigente; no es necesario pedir uno por cada solicitud.
  • El token identifica al negocio asociado al usuario de API: todas las operaciones que hagas con él se aplican a ese negocio.
  • Si envías la solicitud sin cuerpo, el código actual no devuelve ningún JSON (respuesta vacía). Envía siempre ambos campos.

API de Facturación · CG Imprenta Digital