Aller au contenu

Calculateurs

Les calculateurs de vitef (salaire, préavis, indemnités, TVA, frais…) s’appellent par API : 2 000 calculs gratuits par mois, puis 0,01 € HT le calcul. Leurs champs et valeurs par défaut sont dans GET /v1/catalogue ; les valeurs absentes sont complétées. Le résultat est prêt à afficher (montants formatés en français).

POST/v1/calculators/{slug}/compute

Corps : values et today (facultatif, date de référence au format AAAA-MM-JJ, par défaut aujourd’hui à Paris).

Requête
curl -X POST "https://app.vitef.com/v1/calculators/salaire-brut-net/compute" \
  -H "Authorization: Bearer $VITEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "values": {
    "amount": "3000"
  }
}'
Réponse 200
{
  "calculator": "salaire-brut-net",
  "values": {
    "amount": "3000",
    "period": "Mensuel",
    "status": "Non-cadre",
    "workTime": "100",
    "months": "12",
    "pas": "0"
  },
  "result": {
    "label": "Salaire net mensuel",
    "value": "2 340",
    "unit": "€",
    "caption": "avant impôt sur le revenu",
    "rows": [
      {
        "label": "Brut horaire",
        "value": "19,78 €"
      },
      {
        "label": "Brut mensuel",
        "value": "3 000 €"
      },
      {
        "label": "Brut annuel (12 mois)",
        "value": "36 000 €"
      },
      {
        "label": "Net horaire",
        "value": "15,43 €"
      },
      {
        "label": "Net mensuel",
        "value": "2 340 €"
      },
      {
        "label": "Net annuel (12 mois)",
        "value": "28 080 €"
      },
      {
        "label": "Charges retenues",
        "value": "22 % (660 € / mois)"
      }
    ]
  }
}

Les calculateurs avec itinéraire ou carburant calculent eux-mêmes la distance et le prix moyen du jour. Vous voulez plutôt afficher notre calculateur sur votre site, sans clé ? Intégrez-le en deux lignes.

Estimations de devis : POST /v1/quotes/{slug}/estimate (même quota). Recherche dans le catalogue, en mots-clés ou en langage naturel, gratuite : GET /v1/search?q=…. Schémas dans la référence.

Partage de dépenses

POST/v1/expenses/settlequi doit combien à qui

Participants désignés par leur index, montants en centimes. Répartition equal (entre among, tous si absent) ou exact (montant de chacun dans amounts). La réponse donne l’avancé, la part et le solde de chacun, et les remboursements en nombre minimal. Compté comme un calcul.

Requête
curl -X POST "https://app.vitef.com/v1/expenses/settle" \
  -H "Authorization: Bearer $VITEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "people": [
    "Camille",
    "Léo",
    "Inès"
  ],
  "expenses": [
    {
      "label": "Location",
      "amount": 90000,
      "payer": 0,
      "split": {
        "kind": "equal"
      }
    },
    {
      "label": "Courses",
      "amount": 12000,
      "payer": 1,
      "split": {
        "kind": "equal",
        "among": [
          0,
          1
        ]
      }
    }
  ]
}'
Réponse 200
{
  "total": 102000,
  "paid": [
    90000,
    12000,
    0
  ],
  "share": [
    36000,
    36000,
    30000
  ],
  "balance": [
    54000,
    -24000,
    -30000
  ],
  "transfers": [
    {
      "from": 2,
      "to": 0,
      "amount": 30000
    },
    {
      "from": 1,
      "to": 0,
      "amount": 24000
    }
  ],
  "gaps": []
}