Documentation Index
Fetch the complete documentation index at: https://docs.clevis.dev/llms.txt
Use this file to discover all available pages before exploring further.
Available schemes
| Scheme | Description | Years |
|---|
ordinario | Full employee: salud, pension, ARL, parafiscales, retencion | 2025,2026 |
integral | Salario integral (>= 13 SMMLV): retencion, aportes sobre 70% | 2025, 2026 |
Ordinario
The ordinario scheme covers standard employees under Colombian labor law (Codigo Sustantivo del Trabajo). Includes all mandatory social security contributions and income tax withholding.
What it calculates
Employee deductions:
- Salud — Health contribution (4% employee share)
- Pension — Pension contribution (4% employee share)
- Fondo de Solidaridad Pensional — Solidarity fund for salaries >= 4 SMMLV
- Retencion en la fuente — Income tax withholding using UVT-based progressive brackets
Employer contributions:
- Salud patronal — Employer health (8.5%)
- Pension patronal — Employer pension (12%)
- ARL — Occupational risk insurance
- Parafiscales — SENA, ICBF, Caja de Compensacion
| Field | Type | Required | Default | Description |
|---|
monthly_salary | number | Yes | — | Salario mensual |
daily_salary | number | Yes | — | Salario diario (monthly / 30) |
Key reference values
| Value | 2025 | 2026 |
|---|
| SMMLV | $1,423,500 | $1,423,500 |
| UVT | $49,799 | $49,799 |
| Auxilio de transporte | $200,000 | $200,000 |
Example request
curl -X POST https://api.clevis.dev/v1/payroll/calculate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "CO",
"scheme": "ordinario",
"year": 2025,
"period": {
"type": "monthly",
"start_date": "2025-03-01",
"end_date": "2025-03-31",
"days": 30
},
"employee": {
"id": "emp_001",
"daily_salary": 100000,
"monthly_salary": 3000000
},
"employer": { "id": "employer_001" }
}'
Integral
The integral scheme applies to employees earning >= 13 SMMLV (salario integral). Social security contributions are calculated on 70% of the salary, and the remaining 30% is considered a prestational component.
What it calculates
- Salud and pension — Calculated on 70% of salary (IBC)
- Fondo de Solidaridad Pensional — Progressive rates based on salary in SMMLV
- Retencion en la fuente — UVT-based progressive brackets (Procedimiento 1)
Key differences from ordinario
| Aspect | Ordinario | Integral |
|---|
| Minimum salary | 1 SMMLV | 13 SMMLV |
| SS contribution base | 100% salary | 70% salary |
| Prestaciones sociales | Separate (prima, cesantias) | Included in salary |
Example request
curl -X POST https://api.clevis.dev/v1/payroll/calculate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "CO",
"scheme": "integral",
"year": 2025,
"period": {
"type": "monthly",
"start_date": "2025-03-01",
"end_date": "2025-03-31",
"days": 30
},
"employee": {
"id": "emp_001",
"daily_salary": 700000,
"monthly_salary": 21000000
},
"employer": { "id": "employer_001" }
}'
