ForHosting KIT · Finances et argent

Calcul de l'aguinaldo au Costa Rica

L'aguinaldo vaut un douzième de ce que vous avez gagné du 1er décembre au 30 novembre : 12 mois à 600 000 ₡ donnent 600 000 ₡. Indiquez salaire brut, mois travaillés et heures supplémentaires pour connaître la somme due d'ici le 20 décembre. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Salaire mensuel brut: 600 000
Mois travaillés (1 déc – 30 nov): 12

Vous obtenez

Heures sup., commissions et primes: 0
Total perçu sur la période: 7 200 000
Aguinaldo: 600 000

Au Costa Rica, les salariés du secteur privé ont droit à l'aguinaldo, une sorte de treizième mois versé en décembre : la loi 2412 le fixe à un douzième de tout ce que vous avez gagné entre le 1er décembre de l'année précédente et le 30 novembre de l'année en cours. Ce calculateur vous demande trois données — votre salaire mensuel brut, les mois travaillés sur cette période et ce que vous avez touché en plus en heures supplémentaires ou autres paiements salariaux — et vous indique le total perçu et l'aguinaldo dû, à deux décimales, en colones (₡), la monnaie du pays. Il sert au salarié qui veut savoir ce qu'il recevra au plus tard le 20 décembre comme à l'employeur qui vérifie sa paie. Il s'agit d'une estimation selon les règles générales de la loi ; si votre situation présente des particularités, faites-la confirmer par le ministère du Travail et de la Sécurité sociale (MTSS) ou par un avocat en droit du travail.

Ce qu'est l'aguinaldo et quelle période compte

L'aguinaldo — en espagnol courant, le mot désigne un cadeau de Noël — n'est pas une faveur de l'employeur mais un droit prévu par la loi. La loi 2412 le définit comme un salaire annuel supplémentaire égal à la moyenne des salaires ordinaires et extraordinaires perçus au cours des douze mois précédant le 1er décembre. En pratique, la période va du 1er décembre de l'année précédente au 30 novembre de l'année en cours : pour l'aguinaldo 2026, du 1er décembre 2025 au 30 novembre 2026.

Ce qui compte, c'est ce que vous avez gagné sur cette période, pas ce que vous gagnerez en décembre. Le calculateur suit la loi 2412, celle du secteur privé ; si vous travaillez pour un organisme public, vérifiez les règles auprès de votre service des ressources humaines.

Le calcul, étape par étape

On additionne tout ce qui a été gagné sur la période et on divise par 12. Le calculateur multiplie votre salaire mensuel brut — avant les cotisations à la CCSS (Caja Costarricense de Seguro Social, la sécurité sociale du pays) et l'impôt sur le revenu — par les mois travaillés, ajoute les heures supplémentaires et les autres paiements salariaux de la même période, puis divise le total par 12.

Une personne payée 600 000 colones par mois pendant douze mois a perçu 7 200 000 colones et reçoit 600 000 colones d'aguinaldo, soit un mois de salaire complet. Une personne embauchée à la mi-mai à 385 000 colones par mois compte 6,5 mois au 30 novembre : 2 502 500 colones perçus et 208 541,67 colones d'aguinaldo. C'est ainsi qu'une année incomplète donne un aguinaldo proportionnel, que la loi reconnaît dès un mois travaillé.

Les mois peuvent comporter des fractions, et la période ne dépasse jamais douze mois.

Ce qui entre dans le calcul et ce qui n'y entre pas

Entrent le salaire ordinaire et les paiements extraordinaires : les heures supplémentaires et, selon les termes du MTSS, « tout autre paiement salarial », y compris le salaire en nature (salario en especie). Le congé de maternité compte : ne le retirez pas. Les arrêts pour maladie ou accident (les incapacidades) ne comptent pas : si vous avez été en arrêt pendant une partie de la période, retirez ce temps des mois travaillés.

Les commissions et les primes se saisissent dans le champ des heures supplémentaires, commissions et primes lorsqu'elles font partie de votre salaire ; en cas de doute, renseignez-vous auprès du MTSS. Si votre salaire a changé pendant la période, indiquez l'ancien salaire et ajoutez dans ce champ ce que vous avez gagné en plus depuis l'augmentation, ou indiquez directement votre moyenne mensuelle.

Quand il est versé et ce qui peut être retenu

L'employeur doit verser l'aguinaldo dans les 20 premiers jours de décembre. Aucune cotisation à la CCSS n'est prélevée dessus (article 7 de la loi 2412) et il n'est pas soumis à l'impôt sur le revenu (article 9 de la même loi et article 35, alinéa b, de la loi relative à l'impôt sur le revenu, qui l'exonère jusqu'à un douzième des sommes perçues).

Le montant calculé est donc, en principe, celui que vous devez recevoir en entier ; selon le MTSS, la seule retenue autorisée est celle d'une pension alimentaire (pensión alimentaria). L'aguinaldo ne fait pas non plus partie des indemnités de fin de contrat : la cesantía (indemnité de l'article 29 du Code du travail) et le preaviso (indemnité de préavis de l'article 28) se calculent à part.

Une convention collective, un salaire en nature difficile à évaluer ou des arrêts maladie se confirment auprès du MTSS ou d'un avocat en droit du travail.

Cas d’usage

Un salaire fixe toute l'année

Vous avez travaillé de décembre à novembre pour 600 000 colones bruts par mois, sans heures supplémentaires. Vous avez perçu 7 200 000 colones sur la période et l'aguinaldo est de 600 000 colones : un mois de salaire complet, à recevoir au plus tard le 20 décembre.

Une embauche en cours d'année

Vous avez commencé à la mi-mai à 385 000 colones par mois. Au 30 novembre, vous comptez 6,5 mois sur la période et 2 502 500 colones perçus ; votre aguinaldo proportionnel est de 208 541,67 colones.

Avec des heures supplémentaires

Vous avez travaillé 7 mois de la période à 450 000 colones par mois et gagné en plus 50 000 colones d'heures supplémentaires. Le total perçu est de 3 200 000 colones et l'aguinaldo de 266 666,67 colones. Les heures supplémentaires comptent aussi : elles augmentent le montant.

L'employeur qui prépare la paie de décembre

Avant décembre, l'employeur peut calculer l'aguinaldo de chaque salarié à partir de son salaire, de ses mois sur la période et de ses heures supplémentaires, et provisionner la somme à temps. Comme il ne supporte ni cotisations sociales ni impôt sur le revenu, le montant affiché est celui qui sera versé, sauf pension alimentaire à retenir.

Questions fréquentes

Quand l'aguinaldo est-il versé au Costa Rica ?

Dans les 20 premiers jours de décembre, selon la loi 2412. Il couvre ce que vous avez gagné entre le 1er décembre de l'année précédente et le 30 novembre de l'année en cours.

L'aguinaldo est-il imposable au Costa Rica ?

Non. La loi 2412 l'exonère des cotisations sociales (article 7) et de l'impôt sur le revenu (article 9), et l'article 35, alinéa b, de la loi relative à l'impôt sur le revenu l'exonère jusqu'à un douzième des sommes perçues, ce qui correspond exactement à l'aguinaldo.

Comment calculer l'aguinaldo si je n'ai pas travaillé toute l'année ?

Additionnez ce que vous avez gagné pendant les mois travaillés sur la période et divisez par 12. Avec 385 000 colones par mois pendant 6,5 mois, le total est de 2 502 500 colones et l'aguinaldo de 208 541,67 colones. La loi reconnaît l'aguinaldo proportionnel dès un mois travaillé.

Les heures supplémentaires et les commissions comptent-elles pour l'aguinaldo ?

Les heures supplémentaires, oui : la loi vise les salaires ordinaires et extraordinaires, et le MTSS inclut « tout autre paiement salarial ». Pour les commissions, nous n'avons pas trouvé de mention expresse dans les sources officielles consultées ; si votre commission fait partie de votre salaire, ajoutez-la aux heures supplémentaires et, en cas de doute, interrogez le MTSS.

Un arrêt maladie ou un congé de maternité comptent-ils pour l'aguinaldo ?

Selon le MTSS, le congé de maternité compte et les incapacidades (arrêts pour maladie ou accident) ne comptent pas. Si vous avez été en arrêt pendant une partie de la période, retirez ce temps des mois travaillés et, si le montant est important pour vous, faites-le confirmer par le MTSS.

L'employeur peut-il retenir quelque chose sur l'aguinaldo ?

Selon le MTSS, seulement une pension alimentaire (pensión alimentaria). Ni cotisations à la CCSS ni impôt sur le revenu ne sont prélevés : le montant calculé est donc, en principe, celui que vous devez recevoir.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/fin/aguinaldo-costa-rica

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/fin/aguinaldo-costa-rica \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_salary":600000}'

const res = await fetch("https://api.kit.forhosting.com/fin/aguinaldo-costa-rica", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "monthly_salary": 600000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/aguinaldo-costa-rica",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "monthly_salary": 600000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/aguinaldo-costa-rica", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"monthly_salary":600000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"monthly_salary":600000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/aguinaldo-costa-rica", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "monthly_salary": 600000
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.aguinaldo_costa_rica",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →

Lancer gratuitement