La API de FactuColombia está diseñada para facilitar la integración de soluciones de
facturación electrónica en Colombia. Proporciona a los desarrolladores las herramientas
necesarias para crear, validar y gestionar documentos electrónicos como facturas y notas crédito,
cumpliendo con las normativas establecidas por la DIAN.
Es necesario el envío del token de acceso <access_token> para hacer uso de este endpoint.
Para ver cómo generar el token, consulte Cómo generar un token de acceso. Recuerde: El token de acceso caduca cada hora.
Encabezados de la solicitud
Encabezado
Tipo
Descripción
AuthorizationstringBearer <access_token> — Token de acceso OAuth2. Requerido
Content-Typestringapplication/json. Requerido
Acceptstringapplication/json. Opcional
Estructura para crear la factura
Para crear una factura, el cuerpo de la solicitud debe organizarse en 3 secciones:
1Datos generales de la factura
2Datos del adquiriente (customer)
3Items del producto o servicio (items)
A continuación se detallan los campos para cada sección:
Este endpoint permite crear y validar una factura electrónica. La factura se valida contra las reglas de la DIAN
y, si es correcta, se genera el CUFE y se envía a la DIAN para su validación.
La API de FactuColombia utiliza el estándar OAuth2 para la autenticación. Este sistema permite obtener tokens de acceso
que deben incluirse en el header Authorization de cada solicitud.
Flujo de autenticación
Flujo Password Grant
Utilizamos el flujo de concesión de contraseña (Password Grant) de OAuth2, que es adecuado para aplicaciones de confianza
donde el usuario proporciona sus credenciales directamente a la aplicación.
Obtención de credenciales
Para obtener tus credenciales OAuth2 (client_id y client_secret), debes registrarte en el portal de desarrolladores
de FactuColombia y crear una aplicación.
Los tokens de acceso caducan después de 1 hora. Puedes usar el refresh_token para obtener un nuevo token de acceso
sin que el usuario tenga que volver a autenticarse.