Guía

Cupo del mes

Cada plan incluye una cantidad de documentos electrónicos al mes. Consulta cuántos quedan antes de quedarte sin cupo.

Consulta el cupo#

bash

curl https://app.conta360.co/api/v1/cupo -H "Authorization: Bearer $TOKEN"

Campo	Qué es
`mes`, `mes_nombre`	Mes consultado, p. ej. `2026-10` y `octubre`
`incluidos_en_plan`	Documentos que incluye el plan
`adicionales`	Documentos adicionales comprados
`limite`	Total del mes. `null` = sin tope
`usados`	Documentos emitidos en el mes
`disponibles`	Los que quedan
`porcentaje`	Porcentaje usado
`nivel`	`none`, `ok`, `warn` (desde el 80 %) o `full` (agotado)

Cada respuesta 201 de POST /facturas y POST /notas-credito también trae un resumen del cupo en cupo.

Avisa a tiempo#

Consúltalo al abrir caja y avisa en pantalla cuando esté en warn. Al llegar a full no se pueden emitir más facturas electrónicas ese mes: la API responde 409 quota_exceeded y la empresa debe comprar documentos adicionales o cambiar de plan.

Las ventas sin factura electrónica ("electronica": false) no consumen cupo.

Los documentos que incluye cada plan están en los planes de Conta360.