Introducción
Documentación del SDK de Factus para JavaScript y TypeScript. Integra Factus API v2 con un cliente tipado, autenticación automática y módulos listos para usar.
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 más.
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 v2 de Factus, asegúrate de que tus credenciales estén habilitadas para usar este entorno — Si lo necesitas puedes encontrar la versión anterior 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 v2 utilizando JavaScript/TypeScript.
- Centralizar autenticación, refresh de tokens, timeouts, cancelación y manejo de errores.
- Proveer constantes tipadas para los códigos estables del API.
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.
Documentos
Descarga XML genérico por track ID, CUFE, CUDE o CUDS.
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.
Adquirientes
Consultar nombre y correo del adquiriente por tipo y número de documento.
Tablas de referencia
Constantes tipadas del SDK y enlaces oficiales para países, municipios y unidades de medida.