API de N1
Integra tu sistema con N1: consulta documentos electrónicos, administra contactos, carga archivos, causa en tu software contable, envía eventos DIAN y recibe webhooks. Todas las rutas viven bajo https://api.n1.app/v1.
Guías
Autenticación, documentos, causación, archivos, webhooks y buenas prácticas.
Referencia de la API
Todos los endpoints con sus parámetros, esquemas y ejemplos, listos para probar.
Registro de cambios
Novedades de la API y cambios publicados en cada versión.
Tu primera solicitud
Crea una clave en Configuración → API del panel de N1 y comprueba a qué empresas tiene acceso:
curl https://api.n1.app/v1/me \
-H "Authorization: Bearer n1_live_<id>_<secreto>"Todas las guías
Introducción
Qué permite la API de N1, dónde viven las rutas y en qué formato viajan los datos.
Autenticación
Claves de API, scopes, acceso a empresas y errores de autenticación.
Inicio rápido
De la clave de API a la primera consulta de facturas y la descarga de sus archivos.
Empresas y permisos
Cómo se verifica el acceso a cada empresa, scopes disponibles y roles mínimos.
Documentos y causación
Recursos disponibles en la API y cómo leer el estado de causación de cada documento.
Archivos de los documentos
Qué archivos tiene N1 para cada documento y cómo descargarlos con URLs firmadas.
Paginación
Listas con cursor, parámetros, forma de la respuesta y orden garantizado.
Errores
Formato RFC 9457 de los errores y la tabla de códigos estables.
Idempotencia
Cómo repetir solicitudes sin ejecutarlas dos veces con el encabezado Idempotency-Key.
Límites de tasa
Cupos por clave, encabezados RateLimit y qué hacer ante un 429.
Webhooks
Eventos disponibles, formato de entrega, verificación de la firma, reintentos y desactivación automática.
Versionado
Qué cambios son compatibles dentro de /v1 y cómo se publican los incompatibles.
Soporte
Cómo contactarnos y qué datos incluir para rastrear una solicitud.