Obtener rangos de numeración

El endpoint Rangos de Numeración permite obtener los rangos de numeración disponibles en la API de Factus. Este recurso es útil para obtener información precisa sobre los rangos de numeración de documentos específicos, incluyendo su prefijo, rango de numeración, resolución, fecha de inicio y fin, entre otros.

Método: GET

https://api-sandbox.factus.com.co/v1/numbering-ranges?filter[id]&filter[document]&filter[resolution_number]&filter[technical_key]&filter[is_active]

https://api.factus.com.co/v1/numbering-ranges?filter[id]&filter[document]&filter[resolution_number]&filter[technical_key]&filter[is_active]

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Encabezado	Valor	Descripción
`Content-Type`	`application/json`	Indica que los datos se envían en formato JSON.
`Authorization`	`Bearer <token_de_acceso>`	Token de autenticación necesario para acceder al recurso. Ver Cómo generar token
`Accept`	`application/json`	Indica que la respuesta debe estar en formato JSON.

Nota: Reemplaza <token_de_acceso> con el token proporcionado tras autenticarte.

Query Params: Parámetros de Consulta

Parámetro	Descripción
`filter[id]`	ID del registro
`filter[document]`	Código de documento. Para ver los códigos de documento disponibles vea la tabla códigos de documentos
`filter[resolution_number]`	Número de resolución (solo para facturas y documentos soporte)
`filter[technical_key]`	Clave técnica (solo para facturas)
`filter[is_active]`	Estado del registro: `1` para activo, `0` para inactivo

Respuesta del Endpoint

Campo	Descripción
`id`	ID del rango de numeración
`document`	Nombre del documento
`prefix`	Prefijo del rango de numeración
`from`	Número de inicio del rango de numeración
`to`	Número del final del rango de numeración
`current`	Siguiente número dentro del rango de numeración
`resolution_number`	Número de resolución
`start_date`	Fecha en la que se expidió el rango de numeración
`end_date`	Fecha de vencimiento del rango de numeración
`technical_key`	Clave técnica
`is_expired`	El valor es `1` cuando el rango está vencido y `0` cuando está vigente
`is_active`	El valor es `1` cuando el rango está activo y `0` cuando está inactivo

Ejemplo de respuesta

status 200

{
  "data": [
    {
      "id": 4,
      "document": "Factura de Venta",
      "prefix": "SETP",
      "from": 990000000,
      "to": 995000000,
      "current": 990000295,
      "resolution_number": "18760000001",
      "start_date": "19-01-2030",
      "end_date": "19-01-2030",
      "technical_key": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-06-01T08:00:38Z",
      "updated_at": "2024-09-10T10:31:50Z"
    },
    {
      "id": 5,
      "document": "Nota Crédito",
      "prefix": "NC",
      "from": 0,
      "to": 16000000,
      "current": 71,
      "resolution_number": "123456789",
      "start_date": "19-01-2030",
      "end_date": "19-01-2030",
      "technical_key": null,
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-06-01T08:00:38Z",
      "updated_at": "2024-09-10T10:51:39Z"
    },
    {
      "id": 6,
      "document": "Nota Débito",
      "prefix": "ND",
      "from": 0,
      "to": 16000000,
      "current": 32,
      "resolution_number": "123456789",
      "start_date": "19-01-2030",
      "end_date": "19-01-2030",
      "technical_key": null,
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-06-01T08:00:38Z",
      "updated_at": "2024-09-09T10:40:59Z"
    },
    {
      "id": 8,
      "document": "Documento Soporte",
      "prefix": "SEDS",
      "from": 984000000,
      "to": 985000000,
      "current": 984000052,
      "resolution_number": "18760000007",
      "start_date": "31-12-2024",
      "end_date": "31-12-2024",
      "technical_key": null,
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-06-05T09:34:11Z",
      "updated_at": "2024-08-29T09:35:01Z"
    },
    {
      "id": 9,
      "document": "Nota de Ajuste Documento Soporte",
      "prefix": "NDA",
      "from": 1,
      "to": 16000000,
      "current": 21,
      "resolution_number": null,
      "start_date": "19-01-2030",
      "end_date": "19-01-2030",
      "technical_key": null,
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-06-07T14:07:06Z",
      "updated_at": "2024-08-16T08:41:25Z"
    },
    {
      "id": 12,
      "document": "Nómina",
      "prefix": "NEF",
      "from": 1,
      "to": 1000000,
      "current": 48,
      "resolution_number": null,
      "start_date": "31-12-2050",
      "end_date": "31-12-2050",
      "technical_key": null,
      "is_expired": false,
      "is_active": 1,
      "created_at": "2023-09-04T21:38:20Z",
      "updated_at": "2024-06-12T14:42:50Z"
    }
  ]
}