API de facturation. FIZ émet les factures et les transmet à l’AT.
Votre système envoie les données de la vente et reçoit la facture prête, avec son numéro et le PDF. Claude et ChatGPT se connectent à FIZ sans code et préparent des factures à votre demande.
Pour les indépendants et les entreprises, dans tous les forfaits payants de FIZ. Un développeur connecte l’API à votre système une seule fois.
- Client
- Ana Costa
- Total
- 61,50 €
- Brouillon créé
POST /invoices - Numéro et ATCUD attribués
POST /invoices/{id}/issue - PDF prêt
GET /invoices/{id}/pdf
Émise et transmise à l’AT
Comment FIZ émet les factures de votre système
Si vous vendez via une boutique en ligne, un CRM ou votre application, l’API supprime la facturation manuelle : FIZ émet une facture pour chaque vente et la communique à l’AT.
FIZ reçoit les données de la vente
Votre boutique en ligne, votre CRM ou un autre système indique le client, les articles et le type de document. FIZ enregistre un brouillon ; seule la facture émise parvient à l’AT.
FIZ émet la facture et la transmet à l’AT
À la demande de votre système, FIZ numérote la facture dans la série, ajoute l’ATCUD et le code QR et transmet la facture à l’AT. La réponse indique le numéro et le statut auprès de l’AT.
FIZ prépare le PDF
En A4 avec le modèle que vous choisissez dans FIZ, ou sur papier ticket de 80 ou 58 mm. Votre système reçoit le PDF et l’envoie au client.
Ce que votre système peut demander à FIZ
Votre système utilise une clé API, que le titulaire, un administrateur ou un éditeur crée sur la page Intégrations de FIZ. Chaque clé vaut pour un profil (indépendant ou entreprise).
- Factures, reçus et avoirs
- Facture, fatura‑recibo, facture simplifiée et reçu, avec remises et retenue à la source. Paiements partiels, chacun avec son reçu, et avoirs sur le montant total.
- Clients et articles
- Chaque article porte le taux d’IVA du continent, de Madère ou des Açores, ou le motif d’exonération. FIZ vérifie que chaque NIF portugais est bien saisi.
- Factures programmées
- FIZ les émet à la fréquence que vous définissez, par exemple chaque mois, les transmet à l’AT et peut les envoyer au client par e‑mail.
- Requêtes répétées sans doublons
- Si votre système répète une requête avec la même
Idempotency-Key, comme dans l’exemple, FIZ renvoie la première réponse et ne crée pas d’autre document.
POST /invoicesx-api-key: fiz_api_••••••••Idempotency-Key: order-1042{ "type": "INVOICE_RECEIPT", "cae": "47711", "customerId": "66f2c1a9e4b0a1d2c3e4f5a6", "items": [ { "id": "66f2c1b7d3a1b2c3d4e5f6a7", "quantity": 2 } ], "payment": { "method": "mbWay", "date": "2026-10-09T10:15:00Z" }}Claude et ChatGPT préparent vos factures
Avec le connecteur FIZ, l’assistant retrouve factures, clients et articles et prépare des brouillons à votre demande. Avant d’émettre, il affiche l’aperçu et attend votre confirmation.
La connexion se fait sans code, avec un connecteur personnalisé dans Claude ou ChatGPT. Dans FIZ, vous choisissez le profil et les autorisations accordés à l’assistant, et vous pouvez le déconnecter quand vous voulez.
Que peut faire l’assistant ?
Consulter les clients, les articles, les documents avec leur statut auprès de l’AT, les opérations des banques connectées à FIZ et les dépenses issues d’e‑Fatura. Créer des clients, des articles, des brouillons et des pro forma.
Émettre des factures, enregistrer des paiements avec reçu, annuler des documents et émettre des avoirs sur le montant total, toujours après votre confirmation.
- Demande à l’assistant
- Facturez 2 heures de conseil à Norte Studio.
- Client
- Norte Studio, Lda
- Conseil · 2 h
- 120,00 €
- IVA 23 %
- 27,60 €
- Total
- 147,60 €
- Votre réponse
- Je confirme. Vous pouvez l’émettre.
Émise et transmise à l’AT
Applications partenaires : factures au nom de chaque client
Votre application se connecte à FIZ par l’API. Chaque client a un profil, indépendant ou entreprise, et son titulaire autorise la connexion. À la demande de l’application, FIZ émet les factures au nom du client.
Chaque client paie son propre forfait FIZ, ou votre plateforme paie l’accès des clients, par accord avec FIZ.
- Dans votre application
- Nom et domaineInterfacePaiements de votre produit
- Hors de votre application
- Compte du clientConnexion à l’ATGestion de la connexion
Pour tester, l’application se connecte sans forfait payant à votre profil et à ceux de 20 personnes au plus que vous indiquez. Vos clients se connectent à une application de production approuvée par FIZ.
Choisissez un forfait pour votre activité
Questions fréquentes sur l’API FIZ
Quels forfaits incluent l’API ?
Tous les forfaits payants de FIZ, y compris pendant l’essai gratuit : Auto, Prime, Auto Pro et Prime Pro pour les indépendants, et FIZ Pro et FIZ Max pour les entreprises. Le connecteur pour Claude et ChatGPT fait partie des mêmes forfaits.
Ai-je besoin d’un développeur ?
Oui, pour connecter l’API à votre système ou créer une application : le développeur s’appuie sur le guide de démarrage rapide et la documentation de l’API. Pour Claude et ChatGPT, non : ils se connectent sans code, avec un connecteur personnalisé.
Les factures émises via l’API sont‑elles certifiées et transmises à l’AT ?
Oui, comme celles que vous émettez dans FIZ. FIZ est un logiciel certifié par l’AT (n° 3041) et transmet chaque document à l’AT au moment de l’émission.
Pour cela, le profil FIZ a besoin de la connexion à l’AT, de la transmission automatique des factures activée et d’une série de factures de cette année. L’API indique ce qui manque avant l’émission.
Comment mon système sait‑il que l’AT a reçu la facture ?
Par la réponse à l’émission : elle indique le numéro, l’ATCUD et le statut de la transmission à l’AT (en cours, transmise ou en erreur), avec le message de l’AT. Si elle reste en cours, votre système consulte à nouveau le document et reçoit le statut final.
Quels documents et données puis-je gérer via l’API ?
Avec une clé API : factures, faturas‑recibo, factures simplifiées, reçus, avoirs sur le montant total, clients, articles et PDF, ainsi que factures programmées, documents de transport, pro forma et, en consultation seule, les opérations des banques connectées.
Une application partenaire gère les factures, les clients, les articles et les PDF. Les déclarations et les dépenses se gèrent dans FIZ même.
Comment tester l’intégration ?
Avec des brouillons : FIZ les conserve, votre système peut les modifier, les supprimer et générer le PDF, et seuls les documents émis parviennent à l’AT. Chaque émission, même lors d’un test, crée un vrai document fiscal.
Sur un profil d’entreprise, les factures demandées par une application partenaire de test ne sont émises que pendant l’essai gratuit ou avec un forfait payant.
Puis-je facturer automatiquement quand une commande est payée ?
Oui. Quand votre boutique en ligne ou votre système enregistre le paiement, il appelle l’API : il crée le brouillon d’une fatura‑recibo et en demande l’émission. FIZ la transmet à l’AT et prépare le PDF, que votre système envoie au client.
Mon application peut‑elle facturer au nom de chacun de mes clients ?
Oui, avec une application approuvée par FIZ. Le titulaire de chaque profil autorise la connexion et peut la couper dans FIZ quand il le souhaite.
Comment Claude ou ChatGPT émettent‑ils une facture ?
Avec votre confirmation explicite, après vous avoir montré l’aperçu dans la conversation. Si le document change entre-temps, FIZ refuse l’émission jusqu’à ce que vous confirmiez le nouvel aperçu.
Comment connecter Claude ou ChatGPT à FIZ ?
Il suffit d’ajouter un connecteur personnalisé dans Claude ou ChatGPT, avec l’adresse https://api.fiz.co/mcp, puis de vous connecter à FIZ quand l’assistant le demande. Sur la page Intégrations de FIZ, dans « Connecter un assistant », vous trouvez les étapes pour chaque assistant.
Les connecteurs personnalisés dépendent de votre forfait Claude ou ChatGPT.
Comment mes données sont‑elles protégées ?
Une clé API donne accès à un seul profil. Un assistant ou une application accède seulement au profil autorisé, avec les autorisations que vous lui avez données. Sur la page Intégrations, vous pouvez révoquer vos clés et déconnecter vos assistants et les applications, avec effet immédiat.
Dans Claude ou ChatGPT, les données que l’assistant reçoit de FIZ suivent les règles de confidentialité de cet assistant.
Où trouver la documentation de l’API ?
Sur api.fiz.co, en portugais et en anglais : le guide de démarrage rapide, la référence de l’API, le guide d’intégration et le guide pour connecter Claude et ChatGPT.
Sur GitHub, vous trouvez aussi un exemple d’application en Node.js et des instructions FIZ pour les assistants de programmation, tous deux en open source.
Mon comptable voit‑il ce que l’API émet ?
Oui. Les documents émis via l’API restent dans le même profil FIZ, avec les autres, et figurent dans le SAF‑T (PT) de facturation, que FIZ envoie chaque mois à l’adresse e‑mail du comptable si le titulaire active cet envoi. Si le comptable a accès au profil, il les voit aussi dans FIZ.