Actualizar rango de numeración

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

Método: PUT

Endpoint

Pruebas

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

Producción

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

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

Campo	Descripción
prefix	Prefijo del rango.
from	Número de inicio del rango.
to	Número final del rango.
current	Número actual del consecutivo.
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.
is_active	Estado del rango: 1 = Activo 0 = Inactivo

---

Response

Campo	Descripción
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.

---

Variables de Ruta (Path Variables)

• numbering_range_id ID del rango de numeracion

---

Ejemplo de respuesta

status 200

{
  "status": "OK",
  "message": "Rango de numeración actualizado con éxito",
  "data": {
    "id": 59,
    "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": 1,
    "created_at": "2024-09-10T15:56:22Z",
    "updated_at": "2024-09-10T17:35:56Z"
  }
}