Skip to main content

​
Available schemes

SchemeDescriptionYears
ordinarioFull employee: salud, pension, ARL, parafiscales, retencion2025
integralSalario 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

FieldTypeRequiredDefaultDescription
monthly_salarynumberYes—Salario mensual
daily_salarynumberYes—Salario diario (monthly / 30)

​
Key reference values

Value20252026
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

AspectOrdinarioIntegral
Minimum salary1 SMMLV13 SMMLV
SS contribution base100% salary70% salary
Prestaciones socialesSeparate (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" }
  }'