> ## Documentation Index
> Fetch the complete documentation index at: https://www.failfast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Worked examples

> Four sales with the accountant's figures, a partial return in receivables and at the point of sale, and a purchase with its withholdings.

These examples show what Fail Fast settles with the complete configuration. The figures for the four sales match an accountant's calculation, to the peso. The sales are by a technology company in Bogotá, November 2026, with the line location in Bogotá.

**The selling company:**

* VAT-responsible company, legal entity, and income tax filer.
* Principal CIIU 6201, with 6202 and 6311.
* Its principal CIIU is in a 1.1 % self-withholding group.
* It has an account map with VAT, income withholding, ReteICA, ReteIVA, and self-withholding, the latter with a counter account.

**The customers** are companies that are income withholding and ICA withholding agents in Bogotá. The fourth customer is also a VAT withholding agent.

## Sale 1: consulting for 20,000,000

A company customer. Product: consulting, with VAT at the general rate and fees withholding. The customer has a ReteICA exception at 6.9 per thousand registered. See [Tax rule override](https://www.failfast.ai/docs/finance/tax-rule-exceptions.md).

| Item | Rate | Amount |
| - | - | - |
| VAT | 19 % | **3,800,000** (adds to the total) |
| Income withholding (fees, legal entity) | 11 % | **2,200,000** (subtracts from the total) |
| Bogotá ReteICA | 6.9 per thousand | **138,000** (subtracts from the total) |
| Special income self-withholding | 1.1 % | **220,000** (not in the total) |

Total to collect: `20,000,000 + 3,800,000 − 2,200,000 − 138,000 = 21,462,000`.

## Sale 2: consulting for 5,000,000

Another company customer, with the same 6.9 per thousand exception.

| Item | Rate | Amount |
| - | - | - |
| VAT | 19 % | **950,000** |
| Income withholding | 11 % | **550,000** |
| Bogotá ReteICA | 6.9 per thousand | **34,500** |
| Special income self-withholding | 1.1 % | **55,000** |

Total to collect: `5,000,000 + 950,000 − 550,000 − 34,500 = 5,365,500`.

## Sale 3: cloud software for 1,750,000

Product: cloud software. The tax category is **VAT excluded** and the withholding category is data processing.

| Item | Rate | Amount |
| - | - | - |
| VAT | 0 % (excluded) | **0** |
| Income withholding (data processing) | 3.5 % | **61,250** |
| Bogotá ReteICA (services, no exception) | 9.66 per thousand | **16,905** |
| Special income self-withholding | 1.1 % | **19,250** |

Total to collect: `1,750,000 − 61,250 − 16,905 = 1,671,845`.

## Sale 4: development for 2,538,000

The customer is a company, an income, VAT, and ICA withholding agent in Bogotá.

| Item | Rate | Amount |
| - | - | - |
| VAT | 19 % | **482,220** |
| ReteIVA (on the VAT) | 15 % | **72,333** |
| Income withholding (fees) | 11 % | **279,180** |
| Bogotá ReteICA (services) | 9.66 per thousand | **24,517** (24,517.08 before rounding) |
| Special income self-withholding | 1.1 % | **27,918** |

Total to collect: `2,538,000 + 482,220 − 72,333 − 279,180 − 24,517 = 2,644,190`.

> [!NOTE]
>
> The self-withholding is a cost of your own: it goes to the map's accounts, outside the total you collect. And the system rounds each tax to the peso.

### Why the figures change if you change a piece of data

| If… | What changes |
| - | - |
| The customer is not listed as an income withholding agent | There is no income withholding |
| The customer is not listed as a ReteICA agent in Bogotá | There is no ReteICA |
| There is no 6.9 per thousand exception | ReteICA on sales 1 and 2 is 193,200 and 48,300 (9.66 per thousand) |
| Your company has no principal CIIU | There is no self-withholding |

## Partial return in receivables

A return **does not recalculate** taxes: it takes the returned proportion of each line (returned quantity divided by sold quantity) and applies it to what the original invoice settled. All values are positive; what changes is the accounting side.

To return, the invoice has to be **processed**, the return date cannot be earlier than the invoice's, and the quantity cannot exceed the sold one.

40 % of the quantity of sale 1 is returned with a credit note:

| Item | Invoice | 40 % returned |
| - | - | - |
| Subtotal | 20,000,000 | **8,000,000** |
| VAT | 3,800,000 | **1,520,000** |
| Income withholding | 2,200,000 | **880,000** |
| ReteICA | 138,000 | **55,200** |
| Self-withholding | 220,000 | **88,000** |
| Credit note total | 21,462,000 | **8,584,800** |

The entry reverses the revenue, the receivable, and each tax. The self-withholding is reversed through the return account of its map row. If a return account of the product type or of the map is missing, the return tells you. See [Tax account map](https://www.failfast.ai/docs/finance/tax-account-map.md).

## Partial return at the point of sale

A point-of-sale return also prorates the original sale.

Illustration: a sale of 3 units at 100,000 with 19 % VAT settled `300,000 + 57,000 = 357,000`. One unit is returned: a third of each amount.

| Item | Sale | 1 of 3 returned |
| - | - | - |
| Subtotal | 300,000 | **100,000** |
| VAT | 57,000 | **19,000** |
| Total | 357,000 | **119,000** |

The return is rejected if the product type lacks the sales return, cost, and inventory accounts, or if a tax's map row has no return account. The refund comes out of cash or bank.

## A purchase: a commerce product from a Bogotá supplier

Your company is an income and ICA withholding agent in Bogotá. The supplier files income tax, is VAT responsible, and is not a self-withholder. Product: goods taxed at the general rate, with the purchase-of-goods withholding. Amount 2,000,000, with the line location in Bogotá.

| Item | Rate | Amount |
| - | - | - |
| VAT | 19 % | **380,000** (deductible or to cost, according to the map) |
| Income withholding (purchases, filer) | 2.5 % | **50,000** (the minimum is 10 UVT = 523,740) |
| ReteIVA | — | **0** (your company is not a VAT withholding agent) |
| Bogotá ReteICA (commerce, group) | 6.9 per thousand | **13,800** (the minimum is 27 UVT = 1,414,098) |

You pay the supplier `2,000,000 + 380,000 − 50,000 − 13,800 = 2,316,200`.

Variants with the same purchase:

| Variant | Result |
| - | - |
| The supplier is an income self-withholder | Income withholding 0. You pay 2,366,200 |
| The purchase is for 1,000,000 | ReteICA 0, because it does not reach 27 UVT. Income withholding is 25,000 |
| The supplier declared its ICA activity and is bimonthly, and its activity rate is 4 per thousand | ReteICA of 8,000 instead of 13,800, once the activity rate is in force. See [CIIU, ICA activity, and ReteICA](https://www.failfast.ai/docs/finance/tax-ica-activity.md) |
| The supplier self-withholds ICA in Bogotá | ReteICA 0 |
| The supplier has no data on whether it files income tax | It is treated as a non-filer: income withholding is 3.5 %, 70,000 |

2026 UVT: 52,374.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.