Crear Rango

Este endpoint permite crear un rango de numeración en específico. Es útil para crear un rango de numeración en particular.

Método: POST

Endpoint

Pruebas

https://api-sandbox.factus.com.co/v1/numbering-ranges

Producción

https://api.factus.com.co/v1/numbering-ranges

Nota

Es necesario el envío del token de acceso <access_token> para hacer uso de este endpoint. Para ver cómo generar el token, vea Cómo generar un token de acceso .
Recuerde: El token de acceso caduca cada hora.

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.

Request

ID	Value
document	Código de documento, para ver los codigos de documento que se pueden usar vea la siguiente tabla códigos de documentos
prefix	Prefijo del rango.
from	Número de inicio del rango.
to	Número final del rango.
current	Número actual del consecutivo. NOTA: - Si el consecutivo es nuevo, debe agregar el mismo número del campo from. - Si el consecutivo se ha usado, debe agregar el número del último consecutivo usado.
resolution_number	Número de resolución del rango. Solo es opcional si el campo document contiene el código 21 o 24.
start_date	Fecha de expedición del rango de numeración. Solo es opcional si el campo document contiene el código 21 o 24.
end_date	Fecha de expiración del rango de numeración. Solo es opcional si el campo document contiene el código 21 o 24.
technical_key	Clave técnica del rango. Solo es opcional si el campo document contiene el código 21.

---

Response

ID	Description
id	ID del rango de numeración.
document	Código del documento.
document_name	Nombre del documento.
prefix	Prefijo del rango de numeración.
from	Número de inicio del rango de numeración.
to	Número final del rango de numeración.
current	Siguiente número 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 de numeración está vencido y 0 cuando está vigente.
is_active	El valor es 1 cuando el rango de numeración está activo y 0 cuando no está activo.
created_at	Fecha de creación.
updated_at	Fecha de actualización.

---

Ejemplo de respuesta

status 200

{
  "status": "Created",
  "message": "Rango de numeración creado con éxito",
  "data": {
    "id": 51,
    "document": "21",
    "document_name": "Factura de Venta",
    "prefix": "FV",
    "from": 1,
    "to": 1000,
    "current": 1,
    "resolution_number": "d3kd93kd39jd92",
    "start_date": "01-10-2024",
    "end_date": "01-04-2025",
    "technical_key": "dfs3dfs334d8d8s96s8d",
    "is_expired": true,
    "is_active": 0,
    "created_at": "2024-09-10T15:30:26Z",
    "updated_at": "2024-09-10T15:30:26Z"
  }
}