Cambiar Estado

Este endpoint permite cambiar el estado de un rango de numeración en específico.

Método: PATCH

Endpoint

Sandbox

https://api-sandbox.factus.com.co/v2/numbering-ranges/:numbering_range_id/toggle-status

Producción

https://api.factus.com.co/v2/numbering-ranges/:numbering_range_id/toggle-status

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:

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.

---

Response

id ID del rango de numeración.
document Código del documento electrónico.
document_name Nombre del documento electrónico.
prefix Prefijo del rango de numeración.
from Número inicial del rango de numeración.
to Número final del rango de numeración.
current Número actual del rango de numeración.
resolution_number Número de resolución del rango de numeración.
start_date Fecha de inicio del rango de numeración.
end_date Fecha de fin del rango de numeración.
technical_key Clave técnica del rango de numeración.
is_expired Indica si el rango de numeración ha expirado.
is_active Indica si el rango de numeración está activo.
created_at Fecha de creación del rango de numeración.
updated_at Fecha de última actualización del rango de numeración.

Variables de Ruta, Path Variables

numbering_range_id string ID del rango de numeración. Se recomienda guardar el ID del rango de numeración para no hacer múltiples llamadas al endpoint al momento de realizar los documentos electrónicos.

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"
  }
}