ES | EN

Ejemplos por país

➕ Autorización de documento

Mediante este endpoint puede crear y cargar fácilmente nuevas autorizaciones de documentos electrónicos (Timbraje CAF), especificando la resolución del SII, el período de vigencia y los rangos de folio para los documentos que necesita emitir.

Paso 1 - Listar autorizaciones de documentos (Timbraje CAF)

Lista todas las autorizaciones de documentos (Timbraje CAF) o recupera un tipo específico usando el parámetro document_type_id para obtener una vista del rango de autorización de documentos (Timbraje CAF) actualmente en uso. Una vez que tenga esta información, proceda al siguiente paso.

Respuesta:

{
   "document_authorization_id": 2,
   "document_type_id": 2,
   "document_type_name": "Factura electrónica emitida",
   "range_from": 1,
   "range_to": 1000,
   "issue_date": "2025-07-01"
}

Paso 2 - Verificar disponibilidad de una nueva autorización de documentos (Timbraje CAF)

Para verificar la disponibilidad de una nueva autorización de documentos (Timbraje CAF), primero debe realizar una solicitud POST solo con el campo document_type_id, y devolverá el número máximo de rangos de folio (document_authorization_maximum) que se pueden solicitar.

{
   "document_type_id": 2
}

Respuesta:

{
   "document_type_id": 2,
   "document_type_name": "Factura electrónica emitida",
   "document_authorization_maximum": 100,
   "document_authorization_unused": 50
}

Paso 3 - Crear y cargar una nueva autorización de documentos (Timbraje CAF)

Una vez obtenida la información anterior, debe realizar una nueva solicitud POST con ambos campos: document_type_id y document_authorization_quantity. Esto activará una conexión con el SII, recuperará la cantidad especificada del tipo de documento y los cargará automáticamente en su cuenta.

{
   "document_type_id": 2,
   "document_authorization_quantity": 100
}

Respuesta:

{
   "document_type_id": 2,
   "document_type_name": "Factura electrónica emitida",
   "document_authorization_quantity": 100,
   "message": "Document authorizations loaded successfully"
}

Una vez completados correctamente estos pasos, tendrá las autorizaciones de documentos (CAF Timbraje) cargadas y listas para continuar sus operaciones con normalidad.

Referencia de API POST /accounts

Documentación detallada del endpoint: /english/billing/api-reference/billing-api/accounts/create-a-new-account