> ## 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.

# Colombia

> Colombian payroll schemes: ordinario and integral

## 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

```bash theme={null}
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

```bash theme={null}
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" }
  }'
```