Apariencia
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
| Campo | Tipo | Obligatorio | Descripción y reglas |
|---|---|---|---|
userName | string | Sí | 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. |
userPassword | string | Sí | 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/jsonjson
{
"userName": "usuario@example.com",
"userPassword": "<contraseña de API>"
}Respuesta exitosa
HTTP 200
json
{
"success": true,
"message": "Token de Acceso",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}| Clave | Descripción |
|---|---|
success | true cuando el token se generó. |
message | Siempre Token de Acceso. |
token | Token JWT. Envíalo en cada solicitud como Authorization: Bearer <token>. |
Errores
| HTTP | Mensaje (ejemplo) | Causa |
|---|---|---|
| 400 | El cuerpo de la solicitud está vacío o no es un JSON válido. | No se envió cuerpo o no es JSON. |
| 401 | No introdujo usuario y/o Contraseña. | userName o userPassword llegaron vacíos (o solo con espacios). |
| 401 | No existe coincidencia de usuario en la Base de Datos. | Usuario o contraseña incorrectos. |
| 500 | Error al procesar la solicitud. u otro texto técnico | Error 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
401con{"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.
