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

      Guardar Numeración

      POST
      /public/api/numeraciones/create
      CRUD
      Última modificación:2026-07-31 13:10:06

      Descripción#

      Registra una nueva numeración (resolución de facturación) para una compañía. Valida los datos
      enviados, que el NIT corresponda a la compañía y que no exista ya una numeración con el mismo
      prefijo y número de autorización. La numeración queda registrada en estado activo.
      Autenticación por API Key mediante los headers x-api-key y x-company-id.

      Método y ruta#

      POST /public/api/numeraciones/create

      Headers#

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

      Body#

      CampoTipoRequeridoDescripción
      PrefixstringSíPrefijo de la numeración.
      AuthorizationNumberstringSíNúmero de la resolución DIAN.
      ValidFromstringSíInicio de vigencia, formato yyyy-MM-ddTHH:mm:ss.
      ValidTostringSíFin de vigencia, formato yyyy-MM-ddTHH:mm:ss.
      StartValueintegerSíNúmero inicial del rango autorizado.
      EndValueintegerSíNúmero final del rango autorizado.
      DocumentTypestringSíTipo de documento (ver valores admitidos).
      NitstringNoNIT de la compañía. Si se envía, debe coincidir con el registrado para x-company-id.
      EfectiveValueintegerNoConsecutivo actual. Si no se envía, se inicializa con StartValue.
      NamestringNoNombre de referencia. No incide en el registro.
      AutoIncrementbooleanNoNo incide en el registro.

      Valores admitidos en DocumentType#

      ValorDocumento
      InvoiceFactura de venta
      CreditNoteNota crédito
      DebitNoteNota débito
      ContingencyInvoiceFactura de contingencia
      SupportDocumentDocumento soporte
      PosDocumento POS

      Reglas de validación#

      StartValue no puede ser mayor que EndValue.
      ValidFrom no puede ser posterior a ValidTo.
      No puede existir otra numeración con el mismo Prefix y AuthorizationNumber para la compañía.

      Ejemplo de body#

      {
  "Nit": "900123456",
  "AuthorizationNumber": "18760000001",
  "Prefix": "SETP",
  "ValidFrom": "2026-01-15T00:00:00",
  "ValidTo": "2027-01-15T00:00:00",
  "StartValue": 1,
  "EndValue": 5000,
  "EfectiveValue": 1,
  "DocumentType": "Invoice"
}

      Respuesta#

      CampoTipoDescripción
      Errorsarray<string>Mensajes de error. Puede contener varios cuando hay múltiples validaciones fallidas.
      IsValidbooleantrue si la numeración fue registrada.
      ResultCodeintegerCódigo de resultado (ver tabla).
      Warningarray<string>Advertencias no bloqueantes.
      ResultDataarray<object>Numeración registrada (ver detalle).

      Detalle de ResultData#

      CampoTipoDescripción
      FromNumberstringNúmero inicial del rango registrado.
      ToNumberstringNúmero final del rango registrado.
      PrefixstringPrefijo de la numeración.
      ResolutionNumberstringNúmero de la resolución.
      ResolutionTypestringTipo de documento enviado.
      ValidDateFromstringInicio de vigencia.
      ValidDateTostringFin de vigencia.
      ResolutionDatestringNo se retorna en esta operación (null).
      TechnicalKeystringNo se retorna en esta operación (null).

      Códigos de resultado#

      ResultCodeHTTPIsValidSignificado
      200200trueNumeración registrada correctamente.
      400400falseDatos inválidos: campos obligatorios ausentes, formato de fecha incorrecto, rangos incoherentes, NIT que no coincide, compañía inexistente o numeración duplicada.
      403403falseAPI Key inválida para la compañía indicada.
      500500falseError al guardar la numeración.

      Ejemplos de respuesta#

      200 · Registrada#

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

      400 · Datos inválidos (varios errores acumulados)#

      {
  "Errors": [
    "El campo Prefix es requerido.",
    "El campo ValidFrom no tiene un formato de fecha válido (yyyy-MM-dd'T'HH:mm:ss).",
    "StartValue no puede ser mayor que EndValue."
  ],
  "IsValid": false,
  "ResultCode": 400,
  "Warning": [],
  "ResultData": []
}

      400 · Numeración duplicada#

      {
  "Errors": ["Ya existe una numeración con el mismo prefijo y número de autorización para esta compañía."],
  "IsValid": false,
  "ResultCode": 400,
  "Warning": [],
  "ResultData": []
}

      400 · NIT no coincide#

      {
  "Errors": ["El Nit enviado (900999999) no coincide con el registrado para la compañía (1)."],
  "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": [] }

      500 · Error al guardar#

      { "Errors": ["Error interno al guardar la numeración: <detalle>"], "IsValid": false, "ResultCode": 500, "Warning": [], "ResultData": [] }

      Solicitud

      Parámetros de Header

      Parámetros del Body application/jsonRequerido

      Ejemplos

      Respuestas

      🟢200Éxito
      application/json
      Bodyapplication/json

      Solicitud Ejemplo de Solicitud
      Shell
      JavaScript
      Java
      Swift
      curl --location --globoff 'https://{{ur_basel}}/public/api/numeraciones/create' \
--header 'x-api-key: {{api-key}}' \
--header 'x-company-id: {{company_id}}' \
--header 'Content-Type: application/json' \
--data '{
  "Nit": "804002599",
  "Name": "A",
  "AuthorizationNumber": "187600000011",
  "Prefix": "EPOS",
  "ValidFrom": "2019-01-19T15:00:00",
  "ValidTo": "2030-01-19T05:00:00",
  "StartValue": 1,
  "EndValue": 1000000,
  "EfectiveValue": null,
  "DocumentType": "Pos",
  "AutoIncrement": false
}
/* "SupportDocument", "Invoice", "CreditNote","DebitNote""ContingencyInvoice","Pos" */'
      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-07-31 13:10:06
      Anterior
      Obtener Numeración
      Siguiente
      Obtener Recepciones
      Built with