Documentación Integración habbiles
    • Generación Factura Electrónica
      POST
    • Habilitación Factura Electrónica
      POST
    • Generación Nomina
      POST
    • Nomina habilitación
      POST
    • Obtener Numeración
      GET
    • Guardar Numeración
      POST
    • Obtener Recepciones
      GET
    • Generación Documento Equivalente POS (Archivo)
      POST
    • Generación Documento Equivalente POS (Body)
      POST
    • Habilitación Documento Equivalente POS
      POST
    • Generación Documento Soporte
      POST
    • Generación Nota Documento Soporte
      POST
    • Schemas
      • Petición Generación FE, NC, ND
      • Response General
      • NominaElectronica
      • Nómina de Eliminación
      • Nómina de Ajuste
      • GetNumeracion
      • Documentos Recibidos
      • Response POS
      • Petición POS Body
      • Documento Equivalente POS (estructura ERP)
      • Petición Documento Soporte

      Obtener Numeración

      GET
      /public/api/numeraciones/by-nit
      Última modificación:2026-08-04 18:57:52

      Descripción#

      Consulta las numeraciones (resoluciones de facturación) activas de una compañía. Se valida que
      el NIT enviado corresponda a la compañía indicada y se devuelve el listado de rangos
      autorizados con su resolución, clave técnica y vigencia.
      Autenticación por API Key mediante los headers x-api-key y x-company-id.

      Método y ruta#

      GET /public/api/numeraciones/by-nit

      Headers#

      HeaderTipoRequeridoDescripción
      x-api-keystringSíClave de acceso (API Key) de tu compañía.
      x-company-idintegerSíIdentificador de la compañía.

      Query params#

      ParamTipoRequeridoDescripción
      nitstringSíNIT de la compañía. Debe coincidir con el registrado para x-company-id.

      Ejemplo de petición#

      GET /public/api/numeraciones/by-nit?nit=123456789
x-api-key: <tu-api-key>
x-company-id: 1

      Respuesta#

      CampoTipoDescripción
      Errorsarray<string>Mensajes de error cuando la consulta no fue exitosa.
      IsValidbooleantrue si la consulta fue exitosa.
      ResultCodeintegerCódigo de resultado (ver tabla).
      Warningarray<string>Advertencias no bloqueantes.
      ResultDataarray<object>Listado de numeraciones activas (ver detalle).

      Detalle de ResultData#

      CampoTipoDescripción
      FromNumberstringNúmero inicial del rango autorizado.
      ToNumberstringNúmero final del rango autorizado.
      PrefixstringPrefijo de la numeración.
      ResolutionNumberstringNúmero de la resolución DIAN.
      ResolutionDatestringFecha de la resolución (yyyy-MM-dd).
      ResolutionTypestringCódigo DIAN del tipo de documento.
      TechnicalKeystringClave técnica asociada a la resolución.
      ValidDateFromstringInicio de vigencia (yyyy-MM-dd).
      ValidDateTostringFin de vigencia (yyyy-MM-dd).

      Códigos de resultado#

      ResultCodeHTTPIsValidSignificado
      200200trueConsulta exitosa. Devuelve las numeraciones activas.
      400400falseEl NIT no fue enviado.
      403403falseAPI Key inválida, o el NIT no corresponde a la compañía indicada.
      404404falseLa compañía no existe.
      500500falseError al procesar la solicitud.

      Ejemplos de respuesta#

      200 · Consulta exitosa#

      {
  "Errors": [],
  "IsValid": true,
  "ResultCode": 200,
  "Warning": [],
  "ResultData": [
    {
      "FromNumber": "1",
      "ToNumber": "5000",
      "Prefix": "SETP",
      "ResolutionNumber": "18760000001",
      "ResolutionDate": "2026-01-15",
      "ResolutionType": "01",
      "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
      "ValidDateFrom": "2026-01-15",
      "ValidDateTo": "2027-01-15"
    }
  ]
}

      400 · NIT no enviado#

      { "Errors": ["El NIT es requerido."], "IsValid": false, "ResultCode": 400, "Warning": [], "ResultData": [] }

      403 · API Key inválida#

      { "Errors": ["x-api-key inválida para la compañía indicada."], "IsValid": false, "ResultCode": 403, "Warning": [], "ResultData": [] }

      403 · NIT no corresponde a la compañía#

      { "Errors": ["El NIT enviado no corresponde con la compañía indicada."], "IsValid": false, "ResultCode": 403, "Warning": [], "ResultData": [] }

      404 · Compañía no existe#

      { "Errors": ["La compañía no existe."], "IsValid": false, "ResultCode": 404, "Warning": [], "ResultData": [] }

      500 · Error interno#

      { "Errors": ["Ocurrió un error al procesar la solicitud."], "IsValid": false, "ResultCode": 500, "Warning": [], "ResultData": [] }

      Solicitud

      Parámetros de consulta

      Parámetros de Header

      Respuestas

      🟢200Éxito
      application/json
      Bodyapplication/json

      Solicitud Ejemplo de Solicitud
      Shell
      JavaScript
      Java
      Swift
      curl --location --globoff 'https://{{ur_basel}}/public/api/numeraciones/by-nit?nit=901666341' \
--header 'x-api-key: {{api_key}}' \
--header 'x-company-id: {{company_id}}'
      Respuesta Ejemplo de Respuesta
      {
    "Errors": [],
    "IsValid": true,
    "ResultCode": 200,
    "Warning": [],
    "ResultData": [
        {
            "FromNumber": "1",
            "ToNumber": "60000",
            "Prefix": "FCUT",
            "ResolutionNumber": "18764051679459",
            "ResolutionDate": "2023-07-11",
            "ResolutionType": "01",
            "TechnicalKey": "36a880ee9921a592406bd1c8041248fe8cbfd5b42f9e701526a250eaefa90821",
            "ValidDateFrom": "2023-07-11",
            "ValidDateTo": "2024-07-11"
        },
        {
            "FromNumber": "1",
            "ToNumber": "99999999",
            "Prefix": "FEVR",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": null,
            "ResolutionType": "030",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "0",
            "ToNumber": "999999999",
            "Prefix": "FELI",
            "ResolutionNumber": "9999999999",
            "ResolutionDate": null,
            "ResolutionType": "032",
            "TechnicalKey": null,
            "ValidDateFrom": "2022-01-01",
            "ValidDateTo": "1999-12-31"
        },
        {
            "FromNumber": "0",
            "ToNumber": "999999999",
            "Prefix": "FELU",
            "ResolutionNumber": "9999999999",
            "ResolutionDate": null,
            "ResolutionType": "031",
            "TechnicalKey": null,
            "ValidDateFrom": "2022-01-01",
            "ValidDateTo": "1999-12-31"
        },
        {
            "FromNumber": "7",
            "ToNumber": "5000",
            "Prefix": "DS",
            "ResolutionNumber": "18764042743898",
            "ResolutionDate": "2023-01-11",
            "ResolutionType": "01",
            "TechnicalKey": null,
            "ValidDateFrom": "2023-01-11",
            "ValidDateTo": "2024-01-11"
        },
        {
            "FromNumber": "1",
            "ToNumber": "5000000",
            "Prefix": "SETT",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2019-01-18",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "990000000",
            "ToNumber": "999999999",
            "Prefix": "NCBU",
            "ResolutionNumber": "000000000",
            "ResolutionDate": null,
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "990000000",
            "ToNumber": "999999999",
            "Prefix": "NDBU",
            "ResolutionNumber": "000000000",
            "ResolutionDate": null,
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "8000",
            "Prefix": "FBAR",
            "ResolutionNumber": "18764051679799",
            "ResolutionDate": "2023-07-11",
            "ResolutionType": "01",
            "TechnicalKey": "1c3381e603d77a573fd58f29ac1e7cf2a730694ec6ea45c7c7a24ac32f2e3097",
            "ValidDateFrom": "2023-07-11",
            "ValidDateTo": "2024-07-11"
        },
        {
            "FromNumber": "1",
            "ToNumber": "40000",
            "Prefix": "FBMG",
            "ResolutionNumber": "18764051679158",
            "ResolutionDate": "2023-07-11",
            "ResolutionType": "01",
            "TechnicalKey": "9ae055af5b3be793b384712017cf696ce2df5b851e6dc2369de6a4cd956a762d",
            "ValidDateFrom": "2023-07-11",
            "ValidDateTo": "2024-07-11"
        },
        {
            "FromNumber": "1",
            "ToNumber": "200",
            "Prefix": "FINV",
            "ResolutionNumber": "18764042410970",
            "ResolutionDate": "2023-01-03",
            "ResolutionType": "01",
            "TechnicalKey": "2b28e666bc646cad3b914b942bddb09bc9083c9f42a81c43fe794b9685d5fd66",
            "ValidDateFrom": "2023-01-03",
            "ValidDateTo": "2024-01-03"
        },
        {
            "FromNumber": "873",
            "ToNumber": "1000",
            "Prefix": "BS",
            "ResolutionNumber": "18764051856658",
            "ResolutionDate": "2023-07-14",
            "ResolutionType": "01",
            "TechnicalKey": "0bf53f40641d26271b254046fd9459b47e55076b77e8fc3dada53a25025e5334",
            "ValidDateFrom": "2023-07-14",
            "ValidDateTo": "2024-01-14"
        },
        {
            "FromNumber": "0",
            "ToNumber": "999999999",
            "Prefix": "FELA",
            "ResolutionNumber": "9999999999",
            "ResolutionDate": "1969-12-31",
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2021-12-31",
            "ValidDateTo": "1999-12-30"
        },
        {
            "FromNumber": "1",
            "ToNumber": "985000000",
            "Prefix": "SEDS",
            "ResolutionNumber": "18760000002",
            "ResolutionDate": "2022-12-31",
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2022-12-31",
            "ValidDateTo": "2025-12-30"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTNC",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2024-09-25",
            "ResolutionType": "91",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "5000000",
            "Prefix": "SETT",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-01-13",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "57675",
            "ToNumber": "500000",
            "Prefix": "CLFE",
            "ResolutionNumber": "999999999999",
            "ResolutionDate": "2022-06-22",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2022-06-22",
            "ValidDateTo": "2026-06-22"
        },
        {
            "FromNumber": "1",
            "ToNumber": "14276",
            "Prefix": "GENA",
            "ResolutionNumber": "18764073939730",
            "ResolutionDate": "2026-01-16",
            "ResolutionType": "01",
            "TechnicalKey": "db6806cd02f0e58e32dbfd241a428421632d878f8a5197740a361af1c39ca4ff",
            "ValidDateFrom": "2025-01-16",
            "ValidDateTo": "2026-01-16"
        },
        {
            "FromNumber": "1",
            "ToNumber": "50000000",
            "Prefix": "K286",
            "ResolutionNumber": "18764074413516",
            "ResolutionDate": "2023-07-11",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTSP",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "60",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTNE",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTSP",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "60",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTSC",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "94",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTSD",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "93",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTDA",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTEA",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "033",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTND",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-10",
            "ResolutionType": "92",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "9999999999",
            "Prefix": "FTNA",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2025-02-09",
            "ResolutionType": null,
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-18",
            "ValidDateTo": "2030-01-18"
        },
        {
            "FromNumber": "1",
            "ToNumber": "50000000",
            "Prefix": "K172",
            "ResolutionNumber": "18764071143277",
            "ResolutionDate": "2023-07-11",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "5000000",
            "Prefix": "CONT",
            "ResolutionNumber": "187600000011",
            "ResolutionDate": "2025-01-13",
            "ResolutionType": "03",
            "TechnicalKey": null,
            "ValidDateFrom": "2019-01-18",
            "ValidDateTo": "2030-01-18"
        },
        {
            "FromNumber": "1",
            "ToNumber": "500000",
            "Prefix": "C617",
            "ResolutionNumber": "999999999999",
            "ResolutionDate": "2025-01-13",
            "ResolutionType": "01",
            "TechnicalKey": null,
            "ValidDateFrom": "2025-01-16",
            "ValidDateTo": "2026-01-16"
        },
        {
            "FromNumber": "1",
            "ToNumber": "5000000",
            "Prefix": "SETT",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2019-01-18",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        },
        {
            "FromNumber": "1",
            "ToNumber": "5000000",
            "Prefix": "SETT",
            "ResolutionNumber": "18760000001",
            "ResolutionDate": "2019-01-18",
            "ResolutionType": "01",
            "TechnicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
            "ValidDateFrom": "2019-01-19",
            "ValidDateTo": "2030-01-19"
        }
    ]
}
      Modificado en 2026-08-04 18:57:52
      Anterior
      Nomina habilitación
      Siguiente
      Guardar Numeración
      Built with