Colombia

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

Employee inputs

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" }
  }'

Get Started

Countries

Payouts

Guides

Available schemes

Ordinario

What it calculates

Employee inputs

Key reference values

Example request

Integral

What it calculates

Key differences from ordinario

Example request

​Available schemes

​Ordinario

​What it calculates

​Employee inputs

​Key reference values

​Example request

​Integral

​What it calculates

​Key differences from ordinario

​Example request

Available schemes

Ordinario

What it calculates

Employee inputs

Key reference values

Example request

Integral

What it calculates

Key differences from ordinario

Example request