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.
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.