API de N1

Inicio rápido

De la clave de API a la primera consulta de facturas y la descarga de sus archivos.

  1. Entra a Configuración → API en el panel de N1, crea una clave con los scopes que necesitas (y, si quieres, restringida a algunas empresas) y copia el valor completo (solo se muestra una vez).
  2. Comprueba la clave y mira a qué empresas tiene acceso:
curl https://api.n1.app/v1/me \
  -H "Authorization: Bearer n1_live_<id>_<secreto>"
  1. Lista las empresas autorizadas y toma el id de la que vas a consultar:
curl https://api.n1.app/v1/companies \
  -H "Authorization: Bearer n1_live_<id>_<secreto>"

[
  { "id": 12, "name": "Comercial Andina S.A.S.", "nit": "900123456", "dv": "7", "person_type": "LEGAL", "created_at": "2025-03-10T14:22:31Z" }
]
  1. Consulta las últimas facturas electrónicas de esa empresa:
curl "https://api.n1.app/v1/companies/12/invoices?limit=5" \
  -H "Authorization: Bearer n1_live_<id>_<secreto>"

{
  "data": [
    {
      "id": 48213,
      "number": "FE-10422",
      "cufe": "a1b2c3…",
      "kind": "purchase",
      "issued_at": "2026-01-31T15:04:05Z",
      "due_date": "2026-03-02",
      "contact": { "id": 731, "id_number": 800987654, "name": "Distribuidora del Valle S.A.S." },
      "sub_total": "1050000.00",
      "vat": "199500.00",
      "total": "1249500.00",
      "currency": "COP",
      "synced": true,
      "synced_at": "2026-02-01T09:12:00Z",
      "export": { "integration": "siigo", "external_id": "77341", "external_number": "FC-1-2044", "external_name": null, "exported_at": "2026-02-01T09:12:00Z", "marked_manually": false },
      "imported_file_id": 9107,
      "files": {
        "original": { "available": true, "file_name": "FE-10422.zip", "extension": "zip", "content_type": "application/zip", "size": 48213 },
        "pdf": { "status": "on_demand", "source": "n1" }
      },
      "created_at": "2026-01-31T16:10:44Z",
      "updated_at": "2026-01-31T16:10:44Z"
    }
  ],
  "next_cursor": "MjAyNi0wMS0zMVQx…",
  "has_more": true
}

Sigue con cursor=<next_cursor> para la siguiente página (ver Paginación).

  1. Descarga los archivos de la factura. Cada ruta responde 302 a una URL firmada válida por una hora:
curl -L -o FE-10422.zip "https://api.n1.app/v1/companies/12/invoices/48213/original" \
  -H "Authorization: Bearer n1_live_<id>_<secreto>"
curl -L -o FE-10422.pdf "https://api.n1.app/v1/companies/12/invoices/48213/pdf" \
  -H "Authorization: Bearer n1_live_<id>_<secreto>"
AnteriorAutenticaciónSiguienteEmpresas y permisos