Déclarations URSSAF

Les outils de déclaration permettent d'estimer et de déclarer votre chiffre d'affaires à l'URSSAF, et de payer les cotisations sociales directement depuis un assistant IA.

Ces outils effectuent de vraies actions auprès de l'URSSAF. L'utilisateur doit avoir un mandat URSSAF actif autorisant Abby à déclarer et payer en son nom.

get-turnover-estimations

Récupère les estimations de chiffre d'affaires et de cotisations pour la période de déclaration en cours, basées sur les factures enregistrées dans Abby.

Paramètres

Paramètre	Type	Requis	Description
period	string	Non	Période de déclaration (ex : 2025-Q1, 2025-01)

Réponse

{
  "success": true,
  "estimations": {
    "period": "2025-Q1",
    "turnover": 450000,
    "contributions": 99000,
    "details": {
      "servicesBIC": 0,
      "servicesBNC": 450000,
      "sales": 0
    }
  }
}

Les montants sont en centimes. Le champ contributions est une estimation des cotisations basée sur les taux en vigueur.

---

complete-urssaf-declaration

Complète la déclaration URSSAF pour la période en cours. Fonctionne en deux étapes :

1. Aperçu (execute: false) — affiche un résumé de la déclaration sans la soumettre

2. Exécution (execute: true) — soumet réellement la déclaration à l'URSSAF

Paramètres

Paramètre	Type	Requis	Description
turnover	number	Oui	Chiffre d'affaires à déclarer en centimes
execute	boolean	Oui	false pour un aperçu, true pour soumettre
pay	boolean	Non	true pour payer les cotisations après la déclaration (défaut : false)

Étape 1 : Aperçu

// Appel
{ "turnover": 450000, "execute": false }

// Réponse
{
  "success": true,
  "preview": true,
  "declaration": {
    "period": "2025-Q1",
    "turnover": 450000,
    "contributions": 99000,
    "breakdown": {
      "maladie": 4500,
      "retraite": 40500,
      "invalidite": 5850,
      "csg": 48150
    }
  }
}

Étape 2 : Exécution

// Appel
{ "turnover": 450000, "execute": true, "pay": true }

// Réponse
{
  "success": true,
  "preview": false,
  "declaration": {
    "period": "2025-Q1",
    "turnover": 450000,
    "contributions": 99000,
    "status": "submitted",
    "paymentStatus": "paid"
  }
}

Avec execute: true, la déclaration est réellement soumise à l'URSSAF. Cette action est irréversible.

---

Scopes requis

Outil	Scope
get-turnover-estimations	declaration:read
complete-urssaf-declaration	declaration:write