➕ Create a new document authorization

Within this endpoint, you can easily create and upload new electronic document authorizations (Timbraje CAF), specifying the SII resolution, validity period, and folio ranges for the documents you need to issue..

🟢 Step 1 - List document authorizations (Timbraje CAF)

Lists all document authorizations (Timbraje CAF) or retrieves a specific document type using the document_type_id parameter to get a view of the document authorization (Timbraje CAF) range currently in use. Once you have this information, proceed to the next step.

• Endpoint: https://api-billing.koywe.com/V1/document_authorizations
• Method: GET
• Required headers:
  • Content-Type: application/json
  • Authorization: Bearer <token>
  • Accept: */*

Response:

1
{
2
   "document_authorization_id": 2,
3
   "document_type_id": 2,
4
   "document_type_name": "Factura electrónica emitida",
5
   "range_from": 1,
6
   "range_to": 1000,
7
   "issue_date": "2025-07-01"
8
}

🟢 Step 2 - Create a new document authorization (Timbraje CAF)

To create a new document authorization (Timbraje CAF), you must first make a POST request with only the document_type_id field, and it will return the maximum number of folio ranges (document_authorization_maximum) that can be requested.

• Endpoint: https://api-billing.koywe.com/V1/document_authorizations
• Method: POST
• Required headers:
  • Content-Type: application/json
  • Authorization: Bearer <token>
  • Accept: */*

1
{
2
   "document_type_id": 2
3
}

Response:

1
{
2
   "document_type_id": 2,
3
   "document_type_name": "Factura electrónica emitida",
4
   "document_authorization_maximum": 100,
5
   "document_authorization_unused": 50
6
}

🟢 Step 3 - Load a new document authorization (Timbraje CAF)

Once you have obtained the previous information, you must make a new POST request with both fields: document_type_id and document_authorization_quantity. This will trigger a connection with the SII, retrieve the specified quantity of the document type, and automatically load them into your account.

• Endpoint: https://api-billing.koywe.com/V1/document_authorizations
• Method: POST
• Required headers:
  • Content-Type: application/json
  • Authorization: Bearer <token>
  • Accept: */*

1
{
2
   "document_type_id": 2,
3
   "document_authorization_quantity": 100
4
}

Response:

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

Once these steps have been completed correctly, you will have document authorizations (CAF Timbraje) loaded and ready to continue your operations as normal.