Generate a pre-settlement
POST/v1/pre-settlements/generate
Create a pre-settlement (relación de envío): the bundle of invoices your billing system is handing over to the payer under one origin_invoice_group_id.
The request is multipart/form-data with two parts, following the same shape as the support-file uploads:
| Part | Content-Type | What |
|---|---|---|
file | binary | Optional cover document for the bundle. |
request_data | application/json | The pre-settlement itself — see PreSettlementRequest. |
origin_invoice_group_id is your identifier for the group and invoices is the list of invoice numbers it contains; both are required. settlement_number and resolution_type are optional — resolution_type applies to Colombia and accepts RESOLUTION_3374 or RESOLUTION_2275.
Returns 204 on success. Poll GET /v1/pre-settlements/{originInvoiceGroupId} afterwards to read the resulting status, invoices and files.
Request
Responses
- 204
- 400
- 401
- 403
- 406
- 422
- 500
NO CONTENT
Bad Request
Unauthorized
Forbidden
File size exceeds maximum allowed
Validation error
Internal Server Error