Mise en place livraison vers UK en une journée : ce que Claude Code change vraiment

Semaine du 13 au 17 avril 2026 — Journal d'une équipe AgentOps 

Cette semaine en 3 lignes

• 🎯 Livrable phare : la stack UK VAT + HMRC Making Tax Digital + Delivengo shippée en 1 journée sur Table Indienne (projet e-commerce d'un membre de l'équipe)
• 📊 L'impact mesuré : 20 contributions, 1 journée de dev vs. 2 à 3 semaines en dev classique sans IA
• 🧩 Le pattern réutilisable : découper une compliance réglementaire en micro-livrables pilotés par Claude Code, chaque commit = un sous-problème auto-portant

🚀 Le héro de la semaine : livraison vers UK en une journée

Le contexte

Un de nos associés fait tourner Table Indienne, un e-commerce de produits artisanaux indiens monté sous Sylius. La marchandise part désormais régulièrement vers le Royaume-Uni. Conséquence : il fallait immatriculer la structure à la TVA UK, se brancher sur l'API HMRC Making Tax Digital (MTD) pour automatiser les déclarations trimestrielles de TVA UK, sortir des factures avec le bon régime fiscal selon le pays de l'acheteur, et avoir un transporteur + calculateur d'expédition fonctionnel pour les zones britanniques.

Vendredi matin, zéro ligne de code. Vendredi soir, tout shippé en production. En dev classique, on aurait bloqué 2 à 3 semaines pour cette stack — entre la lecture de la doc HMRC, la mise en place de l'OAuth 2.0, le calculateur des 9 boxes de la déclaration TVA, les headers anti-fraude obligatoires et l'intégration Delivengo pour les expéditions.

Ce qu'on a construit

20 commits, tous dans la journée du vendredi, regroupables en 5 blocs :

1. OAuth 2.0 HMRC MTD — scaffolding complet, controller de callback admin, scopes gérés.
2. Calculateur TVA UK — conversion des commandes Sylius vers les 9 boxes du formulaire HMRC, avec auto-fetch des taux EUR→GBP au taux mensuel officiel HMRC.
3. Headers anti-fraude — HMRC impose des Gov-Client- et Gov-Vendor- sur toute soumission BATCH_PROCESS_DIRECT (identification navigateur, IP, OS). On a écrit un middleware qui les pose automatiquement.
4. Pipeline de soumission + UI admin — écran de consentement OAuth, suivi des déclarations, boutons "soumettre" / "re-soumettre".
5. Delivengo (transporteur) — API client + façade Symfony, calculateur de frais de port zones 1/2, génération de shipments + étiquettes, webhook track_updated pour passer automatiquement les commandes en "livrées" à la prise en charge du colis.

À côté, on a remis à plat la taxonomie produits (catégories food / non-food) pour bien différencier les catégories de TVA appliquée en UK.

Le pattern Claude Code qu'on a utilisé : un prompt = un commit. Pas de "refais-moi toute la conformité UK", mais 20 demandes atomiques du type "implémente la façade Symfony pour l'API Delivengo", "écris le controller OAuth callback HMRC", "ajoute la zone GB au calculateur de taxes". Chaque commit est auto-portant, revu séparément, et déploie un incrément utile.

La métrique

• 20 commits en une journée.
• Estimation "dev classique sans IA" : 2 à 3 semaines, soit 10 à 15× plus lent.
• Coût en tokens API Anthropic : ~15€ sur la journée (mesuré).
• Ratio coût/gain : 15€ investis contre environ 80 heures de dev évitées (soit ~4000€ à un taux moyen de facturation). Ratio 260×.

Ce qu'on a appris

Ce qui a raté : on s'est d'abord pris les pieds dans les headers anti-fraude HMRC. La documentation est piégeuse — certaines valeurs paraissent optionnelles mais déclenchent un 403 silencieux. Nous avons trouvé un wrapper Ruby open-source qui nous avons analysé pour comprendre qu'il fallait aussi le Gov-Client-Browser-JS-User-Agent même sur un appel purement serveur-à-serveur. Leçon : sur les APIs réglementaires à forte contrainte, faire valider le premier call par un échantillon "qui marche" avant de coder quoi que ce soit. Claude Code accélère le code, pas la conformité — il faut toujours un humain pour vérifier l'échantillon.

Deuxième surprise : le pattern "1 prompt = 1 commit" tient très bien la revue de code. Chaque diff fait 50-300 lignes, testé en isolation, relu en quelques minutes. On a évité le piège classique du prompt "fais-moi toute la feature" qui produit 2000 lignes impossibles à relire. C'est probablement le point le plus important pour nos clients : l'IA accélère le dev, mais ne pardonne pas le manque de découpage en amont.

Nous testons également à chaque étape par des tests unitaires/fonctionnels et/ou des tests automatiques exécutés par l'IA via le MCP Playwright ou l'extension Chrome de Claude Code qui agit de manière similaire.

📦 Aussi cette semaine

• MCP Pappers pour l'auto-TVA/SIRET chez Askara — on a branché le MCP Pappers sur Askara pour remplir automatiquement les numéros de TVA à partir du SIRET pour les organisations françaises qui n'avaient pas ces champs. Résultat : toutes les orgaisations françaises enrichies automatiquement, plus de TVA manquante sur les factures.
• Infra QA — notre produit SaaS BeHome a désormais à nouveau un environnement de QA dédié et documenté. Nous avons en effet migré de AWS vers OVH cette année et nous avons dû déplacer tous nos serveurs, sites et apps. Claude Code et Docker nous permettent de livrer des nouveaux environnements en un temps record. Résultat : serveur de QA reconfiguré en moins d'une heure.
• Agent de soumission de demandes cadastrales (un side-project citoyen) — sur un projet d'engagement citoyen utilisant la recherche documentaire automatisée, on a écrit un agent qui envoie des demandes de cadastre en batch via un service public en ligne : coordonnées saisies, soumission par JS, suppression des confirmations manuelles. Résultat : automatisation hebdomadaire des demandes cadastrales, temps gagné.

🔧 L'outil / la trouvaille de la semaine

Le MCP Pappers pour l'enrichissement automatique de données d'entreprise (SIREN, SIRET, TVA, dirigeants, bilans) directement depuis Claude Code, sans quitter le terminal. Branché sur Askara cette semaine, nous envisageons déjà de l'utiliser pour 3 autres projets clients. Si vos clients sont des PME/ETI françaises et que vous avez des champs d'identification d'entreprise qui traînent à moitié remplis dans votre base, c'est un game-changer. 

💡 Reproduire chez vous

Vous voulez déployer la livraison au Royaume-Unis (UK) et le support réglementaire sans y passer 3 semaines ?

1. Découpez avant de prompter — listez 15-20 micro-livrables auto-portants avant d'écrire la première ligne. Claude accélère le code, pas l'architecture.
2. Validez vos échantillons réels — sur une API tierce complexe (fiscale, bancaire, santé), obtenez un call qui marche avant de coder le wrapper. L'IA code vite dans la mauvaise direction aussi vite que dans la bonne.
3. Un prompt = un commit — chaque diff doit être relisable en 5 minutes. Si Claude vous pond 1500 lignes, arrêtez et redécoupez.

👉 Envie d'aller plus loin ? Contactez-nous — on accompagne les équipes qui veulent structurer leur pratique AgentOps.