Crear Rango para facturación

Esta sección describe cómo crear un rango de numeración para facturación.

Método: POST

Endpoint

Sandbox

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

Producción

https://api.factus.com.co/v2/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:

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.

---

Parámetros del Cuerpo (Body)

El cuerpo (Body) de la solicitud debe enviarse en formato JSON y debe incluir los siguientes parámetros:

Parámetros
document string Código de documento, para ver los códigos de documento que se pueden usar vea la siguiente tabla. 21 para crear un rango de facturación electrónica. Códigos de documentos
prefix Máx.4 caracteres Prefijo alfanumérico del rango de numeración.
resolution_number string Número de resolución.
current string Número actual del consecutivo. El número del siguiente factura electrónica que se generará. NOTA: Si el consecutivo se ha usado, debe agregar el número del último consecutivo usado.

Ejemplo de Solicitud

Factura de venta

{
  "document": "21",
  "prefix": "SETP",
  "resolution_number": "18760000009",
  "current": 984000000
}

Response

201 - Created

{
  "status": "Created",
  "message": "Rango de numeración creado con éxito",
  "data": {
    "id": 51,
    "document": "21",
    "document_name": "Factura de Venta",
    "prefix": "SETP",
    "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"
  }
}