tax-season-organizer

Par anthropics · knowledge-work-plugins

Prépare les documents de saison fiscale pour les propriétaires de petites entreprises — présentés comme des livrables pour leur comptable, et non comme des conseils fiscaux. Deux modes : (1) calcul de l'impôt estimé trimestriel — récupère le revenu net YTD depuis QuickBooks et calcule la dette d'impôt sur le revenu fédéral + la taxe sur le travail indépendant ainsi que le paiement trimestriel dû ; (2) préparation des 1099 de fin d'année — analyse QuickBooks, PayPal et Stripe pour identifier les prestataires payés plus de 600 $, construit une liste de candidats 1099-NEC avec des indicateurs de formulaires W-9 manquants, et produit un résumé en langage clair qu'un CPA peut utiliser directement. Déclencher cette skill dès que l'utilisateur mentionne : impôts trimestriels, paiement d'impôt estimé, combien mettre de côté pour les impôts, 1099, 1099-NEC, préparation fiscale de fin d'année, paiements aux prestataires, W-9, ou toute formulation suggérant qu'il prépare une échéance fiscale ou remet des documents à un comptable. Déclencher également de manière proactive lorsqu'un utilisateur s'interroge sur le bénéfice net ou le revenu YTD dans un contexte indiquant qu'il s'inquiète de sa facture fiscale.

npx skills add https://github.com/anthropics/knowledge-work-plugins --skill tax-season-organizer

Organisateur de saison fiscale

Contexte : Cette compétence produit du matériel de préparation pour un CPA, pas des conseils fiscaux. Énoncez-le tôt et exposez explicitement chaque hypothèse afin que le comptable puisse l'ajuster.

Démarrage rapide

Déterminez le mode dont l'utilisateur a besoin, récupérez les données pertinentes, calculez ou compilez, et livrez un document structuré sur lequel le comptable peut travailler directement.

Utilisateur : « combien dois-je pour les impôts estimés ce trimestre ? »
→ Récupérer le compte de résultat YTD depuis QuickBooks
→ Calculer l'impôt fédéral estimé sur le revenu + impôt sur le travail indépendant
→ Soustraire les paiements déjà effectués cette année
→ Afficher le montant dû pour ce trimestre avec la date d'échéance et les hypothèses énoncées
→ Résultat : « Paiement estimé Q2 dû le 16 juin : X $ — consultez la ventilation complète ci-dessous »

Utilisateur : « je dois envoyer des 1099 »
→ Récupérer tous les paiements aux sous-traitants/fournisseurs depuis QuickBooks + PayPal + Stripe
→ Identifier les sous-traitants payés ≥ 600 $ YTD
→ Signaler les enregistrements manquant W-9 / EIN
→ Résultat : liste de candidats 1099-NEC + liste d'actions W-9 manquantes

Déterminer le mode

Lisez le message de l'utilisateur et le contexte pour décider quel chemin s'applique :

  • Estimation trimestrielle — mots-clés : paiement estimé, impôts trimestriels, combien réserver, safe harbor, Q1/Q2/Q3/Q4
  • Préparation 1099 de fin d'année — mots-clés : 1099, 1099-NEC, fin d'année, sous-traitants, W-9, envoyer 1099, déposer 1099
  • Combiné — certains utilisateurs demandent « résumé de fin d'année » et auront besoin des deux. Exécutez le trimestriel en dernier ; exécutez la préparation 1099 en premier car elle génère les éléments d'action les plus importants.

Si l'intention est ambiguë, demandez : « Cherchez-vous votre paiement d'impôt estimé pour ce trimestre, ou préparez-vous des 1099 pour vos sous-traitants — ou les deux ? »


Chemin 1 : Impôt estimé trimestriel

1. Récupérer les états financiers YTD

Utilisez QuickBooks pour récupérer un rapport Profit & Loss du 1er janvier de l'année en cours jusqu'au dernier jour du trimestre le plus récemment terminé. Capturez :

  • Revenu brut (revenu total)
  • Dépenses totales (dépenses d'exploitation, COGS, etc.)
  • Revenu ordinaire net = revenu − dépenses

Si QuickBooks n'est pas connecté, demandez à l'utilisateur de télécharger un compte de résultat en CSV ou de coller les chiffres clés. Pour les noms de champs et l'approche de requête, consultez reference/connector-queries.md.

2. Demander les paiements d'impôt estimés antérieurs

Avant de calculer, demandez : « Combien avez-vous déjà payé en impôts estimés jusqu'à présent cette année ? » Si l'utilisateur ne sait pas, notez que vous calculerez la responsabilité totale — il pourra soustraire les paiements lui-même ou vérifier auprès de son comptable.

3. Calculer la responsabilité estimée

Consultez reference/calculation-assumptions.md pour les calculs complets et le tableau d'hypothèses que vous devez inclure dans la sortie.

Version courte :

  1. Impôt sur le travail indépendant = revenu net × 0,9235 × 0,153 (puis le diviser par deux — la moitié déductible compense le revenu)
  2. Revenu net ajusté = revenu net − (impôt sur le travail indépendant / 2)
  3. Impôt fédéral sur le revenu = appliquer le taux d'imposition approprié au type d'entreprise de l'utilisateur et au revenu annuel estimé (par défaut 22 % à moins que l'utilisateur indique sa tranche ; notez explicitement cette hypothèse)
  4. Responsabilité annuelle totale = impôt fédéral sur le revenu + impôt sur le travail indépendant
  5. Paiement trimestriel = (responsabilité annuelle totale − paiements effectués) ÷ trimestres restants
  6. Vérification du safe harbor — notez si l'utilisateur devrait vérifier par rapport à l'impôt de l'année précédente (100 % de l'année précédente, ou 110 % si AGI > 150 000 $)

4. Énoncer les hypothèses et livrer la sortie

Utilisez cette structure de sortie :

Structurez la sortie comme un document avec ces sections dans l'ordre :

  1. En-tête — H2 avec « Résumé de l'impôt estimé » suivi du trimestre et de l'année. Sous-titre : date de préparation et « Pour examen par votre comptable ».

  2. Aperçu YTD — Lignes en gras affichant le bénéfice net YTD avec plage de dates, bénéfice net annuel estimé (annualisé à partir de YTD), et type d'entreprise supposé (travailleur autonome, S-corp, etc. — flaguer comme supposé, non confirmé).

  3. Impôt sur le travail indépendant — Afficher le calcul de l'impôt sur le travail indépendant : bénéfice net multiplié par 92,35 % multiplié par 15,3 %, et la moitié déductible du travail indépendant.

  4. Estimation de l'impôt fédéral sur le revenu — Revenu net ajusté, tranche supposée (par défaut 22 %, notez de confirmer avec le comptable), et estimation fédérale.

  5. Responsabilité annuelle estimée totale — Impôt sur le travail indépendant plus impôt fédéral sur le revenu.

  6. Paiement trimestriel — Responsabilité totale moins paiements déjà effectués, divisée par trimestres restants, avec le montant en dollars spécifique dû et la date d'échéance.

  7. Remarque sur le safe harbor — Rappeler au propriétaire de s'assurer que les paiements totaux respectent 100 % de l'impôt de l'année précédente (ou 110 % si l'AGI a dépassé 150 000 $).

  8. Hypothèses — Liste à puces de chaque hypothèse : taux de tranche, structure d'entreprise, impôts d'État exclus, moitié déductible du travail indépendant incluse, et déductions non appliquées (bureau à domicile, QBI, amortissement).


Chemin 2 : Préparation 1099 de fin d'année

1. Récupérer les paiements aux sous-traitants de toutes les sources

Interrogez chaque source connectée pour tous les paiements effectués aux personnes physiques ou morales pour services au cours de l'année fiscale. N'incluez pas les paiements pour les biens, remboursements ou transferts internes.

QuickBooks — essayez d'abord le connecteur en direct, revenez au CSV si nécessaire :

  1. Essayez le connecteur en direct. Tentez de récupérer les enregistrements de paiement au niveau du fournisseur via le MCP QuickBooks. Si le connecteur retourne des enregistrements de bénéficiaire individuels avec nom, montant et catégorie de compte, utilisez-les directement et ignorez l'étape CSV.

  2. Détecter la réponse agrégée uniquement. Si le MCP retourne uniquement des totaux au niveau des catégories (par ex. « Travail de contrat : 7 500 $ » sans ventilation des bénéficiaires), le connecteur ne prend pas encore en charge les requêtes au niveau des fournisseurs. Dans ce cas, invitez l'utilisateur :

    « QuickBooks a retourné uniquement des données récapitulatives — j'ai besoin du détail au niveau des bénéficiaires pour construire votre liste 1099. Veuillez exporter un rapport Transaction List by Vendor (QuickBooks → Reports → Expenses → Transaction List by Vendor, filtré sur cet exercice fiscal) et télécharger le CSV ici. Je le traiterai automatiquement. »

  3. Traiter le CSV via le connecteur Desktop. Mapper les colonnes : nom du bénéficiaire, montant, date, mode de paiement, statut EIN/SSN. Suivre la même logique d'agrégation et de seuil ci-dessous indépendamment du fait que les données provenaient du connecteur en direct ou du CSV.

Note pour les futures versions du connecteur : Si le MCP QuickBooks est mis à niveau pour exposer directement les enregistrements de paiement aux fournisseurs, l'étape 1 réussira et le fallback CSV sera ignoré automatiquement. Aucune modification à cette compétence n'est nécessaire — la logique try-first la gère.

Pour les noms de champs et l'approche de requête, consultez reference/connector-queries.md.

PayPal : Récupérez tous les paiements « Biens & Services » envoyés. Remarque : PayPal émet son propre 1099-K aux sous-traitants dépassant le seuil — signalez-les séparément dans la sortie afin que le comptable puisse déterminer si un 1099-NEC est également nécessaire.

Stripe : Récupérez tous les transferts/versements effectués à des tiers externes. La même mise en garde 1099-K que PayPal s'applique.

Desktop/CSV : Si l'utilisateur télécharge directement un CSV (sans passer par l'export QuickBooks), mappez les colonnes : nom du bénéficiaire, montant, date, mode de paiement, statut EIN/SSN.

2. Agréger par bénéficiaire

Combinez les sources et additionnez les paiements par personne physique ou morale. Dédupliquez par nom (attention à « John Smith » vs « John A. Smith » — signalez les doublons probables pour examen humain plutôt que de les fusionner automatiquement).

3. Appliquer le seuil de 600 $

  • Signaler pour 1099-NEC : tout bénéficiaire payé ≥ 600 $ pour services (sous-traitants, pigistes, consultants)
  • Signaler pour 1099-MISC : tout bénéficiaire payé ≥ 600 $ pour loyer, honoraires juridiques, prix/récompenses
  • Alerte proche du seuil : signalez les bénéficiaires payés entre 400 et 599 $ — près du seuil, le comptable peut vouloir vérifier

Les sociétés (Inc., Corp., LLC imposées comme C-corp ou S-corp) n'ont généralement pas besoin d'un 1099-NEC — notez-le mais signalez-le pour confirmation du comptable.

4. Vérifier le statut W-9

Pour chaque bénéficiaire signalé, notez si un W-9 / EIN est archivé dans QuickBooks. Marquez comme :

  • ✅ W-9 en dossier (EIN/SSN enregistré dans QuickBooks)
  • ⚠️ Manquant — W-9 non archivé ; doit être collecté avant de déposer
  • ❓ Inconnu — impossible à déterminer à partir des données disponibles

5. Livrer le kit de préparation 1099

Utilisez cette structure :

Structurez la sortie de préparation 1099 comme un document avec ces sections :

  1. En-tête — H2 avec « Liste de préparation 1099 » et l'exercice fiscal. Sous-titre : date de préparation, « Pour examen par votre comptable » et « Pas un conseil fiscal ».

  2. Résumé — Comptages à puces : nombre total de sous-traitants payés, nombre nécessitant 1099-NEC (au seuil ou au-dessus de 600 $ pour services), nombre de W-9 manquants (avec note d'échéance de dépôt au 31 janvier), et nombre flagué près du seuil pour examen.

  3. Tableau des candidats 1099-NEC — Colonnes : nom du bénéficiaire, montant total payé, sources de données, statut W-9 (en dossier / manquant / inconnu), et remarques. Signalez tout bénéficiaire payé via PayPal ou Stripe avec une note que la plateforme peut émettre son propre 1099-K.

  4. Liste d'actions W-9 manquantes — Liste numérotée des sous-traitants qui doivent fournir un W-9 avant de déposer, avec les montants payés et un rappel pour demander le formulaire.

  5. Tableau près du seuil — Bénéficiaires payés entre 400 et 599 $ signalés pour examen du comptable, avec une note pour vérifier qu'aucun paiement supplémentaire n'a été manqué.

  6. Remarque sur le processeur de paiement — Expliquer que PayPal et Stripe émettent leurs propres formulaires 1099-K et que le comptable devrait confirmer si un 1099-NEC est également nécessaire pour les sous-traitants payés exclusivement par ces plates-formes.

  7. Liste de contrôle des prochaines étapes — Éléments d'action pour le comptable : collecter les W-9 manquants, confirmer les inconnues, examiner les bénéficiaires près du seuil, vérifier les exemptions de sociétés, confirmer le traitement du chevauchement 1099-K, déposer avant le 31 janvier.


Garde-fou

  • Pas un conseil fiscal. Ouvrez chaque livrable avec ceci : « Préparé pour examen par votre comptable — pas un conseil fiscal ». Incluez-le dans l'en-tête du document, pas seulement dans le chat.
  • Énoncez chaque hypothèse. Si vous avez supposé une tranche de 22 %, dites-le. Si vous avez exclu les impôts d'État, dites-le. Le comptable ajustera ; donnez-lui les leviers.
  • Ne fusionnez pas automatiquement les bénéficiaires. Signalez les doublons probables pour examen humain.
  • Ne déposez rien. La sortie est du matériel de préparation. Le dépôt est hors de portée.
  • L'exemption pour sociétés est un appel de jugement. Notez-le ; ne l'excluez pas automatiquement.

Fichiers de référence

Skills similaires