Introducción
Documentación del SDK de Factus para JavaScript y TypeScript. Aprende a integrar la API de Factus en Node.js para facturación electrónica DIAN en Colombia.
factus-js
factus-js es un SDK para JavaScript y TypeScript que simplifica la integración de la API de Factus en aplicaciones Node.js. El SDK proporciona autenticación OAuth2 automática, tipado estricto y una capa consistente para trabajar con facturas electrónicas, notas crédito, documentos soporte y catálogos DIAN.
Este no es un producto oficial de Factus. Para más información visita la documentación oficial.
Esta versión del SDK utiliza la API v1 de Factus, asegúrate de que tus credenciales estén habilitadas para usar este entorno — Encuentra la ultima versión del SDK aquí.
Paquete
El SDK se distribuye como un único paquete en npm:
| Paquete | Descripción |
|---|---|
factus-js | Cliente principal (FactusClient) + tipos TypeScript + constantes tipadas DIAN |
Qué resuelve este SDK
- Integrar Factus API desde Node.js con JavaScript o TypeScript.
- Emitir facturas electrónicas, notas crédito y documentos soporte.
- Usar constantes y tablas DIAN tipadas para reducir errores de validación.
- Centralizar autenticación, refresh de tokens y manejo de errores.
Recursos disponibles
Facturas
Crear, consultar, descargar y enviar facturas electrónicas de venta.
Notas crédito
Emitir notas crédito referenciadas o sin referencia a una factura.
Documentos soporte
Gestionar documentos soporte para compras a no obligados a facturar.
Notas de ajuste
Notas de ajuste para corregir documentos soporte.
Empresa
Consultar y actualizar el perfil de la empresa.
Rangos de numeración
Crear y gestionar rangos de numeración autorizados.
Recepción de documentos
Facturas recibidas y eventos del ciclo de vida RADIAN.
Suscripción
Consultar el estado de la suscripción y los documentos disponibles.
Catálogo
Municipios, países, tributos, unidades de medida y adquirentes.