API FIZ · disponible maintenant
Oui, FIZ a une API.
Une API REST pour émettre des factures certifiées, créer vos clients et vos articles, et synchroniser avec l’AT (l’administration fiscale portugaise) — depuis votre propre logiciel, votre boutique ou votre plateforme. Et un connecteur MCP pour brancher Claude ou ChatGPT directement sur votre facturation, sans une ligne de code. Pour connecter les entreprises de vos clients, créez une application OAuth.
Créez un brouillon de facture en quelques lignes
Pour votre propre entreprise, utilisez une clé API dans l’en-tête x-api-key. Cette requête crée un brouillon : remplacez le CAE et les identifiants par ceux de votre entreprise. L’émission est une action distincte, décrite dans la référence API.
# Créer un brouillon sans l’émettre
curl -X POST https://api.fiz.co/invoices \
-H "x-api-key: $FIZ_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042-draft" \
-d '{
"type": "INVOICE",
"cae": "62010",
"customerId": "aaaaaaaaaaaaaaaaaaaaaaaa",
"items": [{ "id": "bbbbbbbbbbbbbbbbbbbbbbbb", "quantity": 1 }]
}'Plateformes & intégrateurs
Connectez vos clients à FIZ
Ajoutez la facturation portugaise à votre produit. Votre client choisit une entreprise et autorise les accès dans FIZ ; votre serveur reçoit les jetons OAuth de cette connexion.
Modèles de partenariat et white-label →
1. Créez votre application
Dans Paramètres → Intégrations, indiquez le nom, les URL et les permissions. FIZ génère un client ID et un secret, affiché une seule fois, à conserver sur votre serveur.
2. Connectez un client
Les utilisateurs de FIZ choisissent leur entreprise et les permissions. Les nouveaux clients créent un compte et peuvent connecter l’AT avant de revenir à votre application.
3. Créez le premier brouillon
Lancez l’exemple Node.js avec le nom et les identifiants de votre application. Il enregistre un vrai brouillon de facture dans l’entreprise connectée, sans émettre le document. Code ouvert, licence MIT.
Testez, puis demandez la validation
Les applications Development fonctionnent sur FIZ en production pour vous et jusqu’à 20 testeurs indiqués par email. Vous pouvez ajouter un email avant la création du compte. Les données des entreprises sont réelles : ce n’est pas un environnement fiscal simulé.
Pour connecter d’autres clients, créez une application Production distincte et soumettez-la à FIZ. Les connexions Production nécessitent un forfait d’entreprise incluant l’accès à l’API.
Nouveau · connecteur MCP
Connectez Claude ou ChatGPT à votre facturation
FIZ est un serveur MCP (Model Context Protocol). Connectez-le une fois et votre assistant consulte vos documents, vos clients et vos mouvements bancaires, prépare des factures en brouillon et — seulement après votre confirmation de chacune — les émet. Sans clé API : c’est une connexion OAuth que vous révoquez quand vous voulez.
https://api.fiz.co/mcp Claude
Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Collez l’URL, connectez-vous à FIZ et choisissez la société et les permissions.
ChatGPT
Paramètres → Apps et connecteurs → Créer. Collez l’URL, choisissez l’authentification OAuth et connectez-vous à FIZ quand c’est demandé.
Claude Code
Lancez claude mcp add --transport http fiz https://api.fiz.co/mcp, puis dans la session /mcp → fiz → Authenticate.
L’émission demande toujours votre confirmation
Émettre, enregistrer des paiements, annuler et établir des notes de crédit sont des actes juridiques déclarés à l’AT. L’assistant vous montre toujours un aperçu et n’agit qu’après votre confirmation — et si le document a changé entre-temps, l’opération est refusée. Sur l’écran d’autorisation, vous choisissez une société et décochez les permissions que vous préférez ne pas accorder.
Ce que les équipes construisent avec
Les intégrations les plus courantes des équipes qui utilisent déjà FIZ.
Boutique en ligne → facture automatique
Connectez votre boutique (Shopify, WooCommerce et similaires) et émettez la facture certifiée dès qu’une vente est conclue — sans aucune manipulation manuelle.
Facture quand le client paie
Une fois le paiement confirmé par votre passerelle (Stripe, ifthenpay, easypay…), appelez FIZ pour émettre le document et l’envoyer au client par e-mail.
Intégrez FIZ dans votre SaaS
Vous gérez une plateforme, une marketplace ou un logiciel de gestion ? Laissez vos propres clients facturer directement depuis votre produit, et FIZ s’occupe de la conformité fiscale.
Migrez depuis un autre outil de facturation
Sur Moloni, InvoiceXpress, Sage ou Vendus juste pour l’API ? Vous retrouvez tout ce qu’il vous faut sur FIZ — avec la synchro AT déjà intégrée.
Ce que vous pouvez faire
Factures, clients, articles et PDF via les endpoints REST documentés.
Factures & reçus
Créez des brouillons et émettez Facture, Facture-reçu, Facture simplifiée, Note de débit et Note de crédit — avec remises, modes de paiement et retenue à la source.
Clients & articles
Créez, mettez à jour et recherchez vos clients avec NIF validé, et gérez votre catalogue de produits et services avec les taux de TVA et les exonérations par territoire.
PDF, ATCUD & QR code
Téléchargez le PDF de chaque document avec vos propres modèles, l’ATCUD et le QR code — prêt à envoyer au client.
Synchro avec l’AT
Chaque document émis est automatiquement déclaré à l’AT, l’administration fiscale portugaise. Suivez l’état de la synchro à chaque appel.
Réessais sans doublons
Utilisez Idempotency-Key pour les écritures. Les requêtes terminées renvoient la réponse enregistrée. Si le résultat est inconnu, vérifiez le document avant de lancer une nouvelle opération.
Agents avec accès au shell
Vous préférez une skill au connecteur ?
Pour les agents de code qui exécutent déjà des commandes — Claude Code, Cursor et compagnie — on publie une skill open-source qui pilote directement cette API REST, avec les connaissances fiscales portugaises intégrées : taux de TVA, codes d’exonération, validation du NIF et une confirmation obligatoire avant l’émission, qui est irréversible. Pour le Claude et le ChatGPT du quotidien, le connecteur MCP ci-dessus est plus simple.
Prêt à intégrer ?
Utilisez une clé API pour votre entreprise ou créez une application OAuth pour connecter vos clients. Le guide contient un exemple prêt à lancer.
Obtenir une clé API Guide d’intégration (EN) →
Certificat AT n° 3041
NIPC 517696835
1200-082, Lisbonne, Cais do Tojo 24