Los folios son números autorizados por el SII para emitir documentos tributarios. Antes de emitir cualquier DTE, necesitas solicitar folios para ese tipo de documento.
Solicitar folios
curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/folios/request \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"tipoDte": 33, "cantidad": 50}'
| Parámetro | Tipo | Descripción |
|---|
tipoDte | integer | Código del tipo de DTE (ver tipos de DTE) |
cantidad | integer | Cantidad de folios a solicitar (1-100) |
Consultar inventario
curl https://api.example.com/api/v1/tenants/{tenantId}/folios \
-H "Authorization: Bearer sk_live_..."
Respuesta:
[
{
"tipoDte": 33,
"total": 500,
"disponibles": 350,
"estado": "activo",
"porcentaje": 70
},
{
"tipoDte": 61,
"total": 100,
"disponibles": 5,
"estado": "activo",
"porcentaje": 5
}
]
Anular folios
Si necesitas anular un rango de folios no utilizados:
curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/folios/void \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"tipoDte": 33, "desde": 100, "hasta": 150}'
Configura un webhook folio.low para recibir alertas cuando los folios estén por agotarse. Así puedes solicitar más automáticamente.