Autenticación
Bearer Token
Section titled “Bearer Token”Casi todos los endpoints de negocio requieren el token de la empresa:
Authorization: Bearer {api_token}El token se obtiene desde el panel admin de Facttec (usuario de la empresa / API token).
Ejemplo
Section titled “Ejemplo”curl -X POST 'https://api.facttec.co/api/ubl2.1/invoice' \ -H 'Authorization: Bearer {api_token}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -d '{ ...payload UBL JSON... }'Buenas prácticas
Section titled “Buenas prácticas”- No compartas el token en repositorios públicos.
- Usa un token por empresa.
- Rota el token si se filtra.
- En producción fuerza HTTPS (
https://api.facttec.co).
Errores comunes
Section titled “Errores comunes”| Código | Significado típico |
|---|---|
401 |
Token ausente o inválido |
403 |
Sin permiso sobre el recurso |
422 |
Validación del payload |
500 |
Error interno / DIAN / configuración incompleta |
Si recibes errores de configuración (certificado, software, resolución), revisa primero la sección Configuraciones básicas.