---
title: "Facture proforma : modèle gratuit, définition et mentions"
canonical: https://luckpanda.app/fr/tools/proforma-invoice
language: fr
updated: 2026-10-09
content: full
---

# Facture proforma

**Qu’est-ce qu’une facture proforma ?** Une facture proforma est un document commercial qui présente à l’avance ce que sera la facture : parties, désignation, quantités, prix, TVA et conditions. Elle n’a pas la valeur d’une facture : elle ne se comptabilise pas, ne rend pas la TVA exigible et ne permet pas au client de la déduire. Elle sert à obtenir un acompte, un financement ou une validation interne, et à accompagner un envoi en douane sans vente.

- Titre sans ambiguïté, « Facture proforma », avec une durée de validité.
- Numérotation à part, hors de la séquence des factures.
- Un acompte reçu appelle une facture d’acompte, puis la facture définitive qui la rappelle.
- Acceptée par le client, la proforma l’engage comme un devis signé : c’est une offre de prix.

Free online tool: https://luckpanda.app/fr/tools/proforma-invoice (create on screen, no account needed).

## À quoi sert une facture proforma

« Pro forma » signifie « pour la forme » : le document a l’apparence d’une facture, mais il est établi avant la vente, quand rien n’est encore livré ni dû. Aucune loi ne l’impose ; on l’utilise parce qu’un client, une banque ou une administration a besoin d’un chiffrage aussi précis qu’une facture pour décider.

- **Obtenir un acompte** avant de lancer une fabrication, une commande fournisseur ou une réservation.
- **Faire valider une dépense** : beaucoup d’entreprises et d’organismes publics exigent un document chiffré pour émettre un bon de commande ou engager une dépense.
- **Monter un financement** : prêt bancaire, crédit-bail, demande de subvention ou de prise en charge, où le financeur veut le détail exact de ce qui sera acheté.
- **Préparer une exportation** : ouverture d’un crédit documentaire, demande de licence d’importation par l’acheteur, calcul des droits à l’arrivée.
- **Accompagner un envoi sans vente** : échantillons gratuits, marchandise envoyée en réparation ou pour une exposition, où il faut déclarer une valeur en douane alors qu’il n’y a pas de facture commerciale.

## Comment remplir cette facture proforma

1. **Indiquez le vendeur et le client** Dénomination, adresse, SIREN et numéro de TVA intracommunautaire des deux parties, comme sur une facture.
2. **Détaillez les lignes** Une ligne par article ou prestation, avec quantité et prix unitaire HT, plus la livraison ou le montage s’ils sont facturés.
3. **Réglez la TVA** Taux applicable par ligne (20 %, 10 %, 5,5 %), ou 0 % avec la mention d’exonération à l’export ou de franchise.
4. **Écrivez les conditions** Durée de validité, acompte demandé, échéance du solde, délai de livraison et la mention « Ce document ne constitue pas une facture ».
5. **Connectez-vous pour l’envoyer** La proforma est conservée dans votre entreprise, numérotée dans sa série et, une fois acceptée, se change en facture d’acompte puis en facture sans ressaisie. Le téléchargement du PDF est gratuit, avec un petit pied de page LuckPanda ; l’envoi et le PDF sans la marque LuckPanda nécessitent le module Ventes.

## Valeur juridique : ce que la proforma n’est pas

| Question | Facture proforma | Facture |
| --- | --- | --- |
| Pièce comptable ? | Non, elle ne s’enregistre pas en ventes | Oui |
| TVA exigible ? | Non, elle ne déclenche rien | Selon la nature de l’opération et l’encaissement |
| Le client peut-il déduire la TVA ? | Non | Oui, s’il est assujetti et la facture régulière |
| Numérotation imposée ? | Non ; une série propre est recommandée | Oui, chronologique et continue |
| Engage-t-elle ? | C’est une offre ; acceptée, elle lie les parties au prix indiqué | Constate une vente réalisée |
| Facturation électronique ? | Non concernée | Oui, entre entreprises, selon le calendrier 2026-2027 |

En droit civil, un contrat se forme par la rencontre d’une offre et d’une acceptation. Une proforma précise (objet, prix, conditions) est une offre : si le client la signe ou la confirme par écrit, il est engagé comme avec un devis signé. Si vous ne voulez pas être lié, indiquez une durée de validité courte et la mention « sous réserve de disponibilité ».

> **Ne faites pas payer « sur proforma » sans facture** Si le client verse une somme sur la base d’une proforma, cette somme est un acompte : vous devez émettre une facture d’acompte, et la TVA peut devenir exigible à l’encaissement (voir plus bas). La proforma ne remplace jamais cette facture.

## Exemple : proforma de mobilier pour un hôtel

Les Ateliers Verdier, fabricant de mobilier à Cholet, chiffrent pour l’Hôtel Les Tilleuls, à Annecy, 24 chaises et 6 tables pour sa salle de restaurant. L’hôtel a besoin d’un document chiffré pour son prêt d’équipement ; l’atelier demande 30 % d’acompte avant de lancer la fabrication.

![Exemple de facture proforma PF-2026-017 des Ateliers Verdier SAS, Cholet, à l’Hôtel Les Tilleuls SARL, Annecy : 24 chaises bistrot, 6 tables en chêne et la livraison, avec TVA à 20 %, validité de 30 jours et repères numérotés.](https://luckpanda.app/img/guide/fr--proforma-invoice--proforma-mobilier.svg)

*Une facture proforma : même présentation qu’une facture, mais un titre, une série et une validité qui disent clairement qu’il ne s’agit pas d’une facture.*

1. **« Facture proforma »** en titre, pour que personne ne la comptabilise comme une facture.
2. **Numéro dans une série propre** (PF-…), distincte de la séquence des factures.
3. **Durée de validité** : au-delà, l’offre tombe et le prix peut changer.
4. **Vendeur** identifié comme sur une facture : SIREN et numéro de TVA.
5. **Client** : la banque ou le service achats y retrouvera le nom exact de l’acheteur.
6. **Conditions de paiement** : acompte, solde, moyen de paiement.
7. **Désignation précise**, quantités et prix unitaires HT : ce sont eux qui passeront sur la facture.
8. **TVA indicative** au taux applicable : la proforma ne rend pas la TVA exigible.
9. **Mention « Ce document ne constitue pas une facture »**, recommandée.
10. **Acceptation** du client : signée, la proforma vaut commande au prix indiqué.

**Les montants de la proforma PF-2026-017**

| Désignation | Qté | Prix unitaire | Montant HT | TVA |
| --- | --- | --- | --- | --- |
| Chaise bistrot hêtre, assise cannée | 24 | 189,00 € | 4 536,00 € | 907,20 € |
| Table ronde chêne massif, Ø 80 cm | 6 | 640,00 € | 3 840,00 € | 768,00 € |
| Livraison et montage sur place | 1 | 180,00 € | 180,00 € | 36,00 € |
| Total HT |  |  | 8 556,00 € |  |
| TVA 20 % |  |  |  | 1 711,20 € |
| Total TTC |  |  |  | 10 267,20 € |

Le prix annoncé est de 10 267,20 € TTC. Aucune écriture n’est passée chez l’un ou l’autre : il ne s’est encore rien vendu.

### L’hôtel verse 30 % : la facture d’acompte

À la commande, l’hôtel verse 30 % du total. Les Ateliers Verdier émettent une facture d’acompte, numérotée dans la séquence des factures, qui rappelle la proforma :

**Facture d’acompte : 30 % de 8 556,00 € HT**

| Désignation | Qté | Prix unitaire | Montant HT | TVA |
| --- | --- | --- | --- | --- |
| Acompte de 30 % sur la commande (proforma PF-2026-017) | 1 | 2 566,80 € | 2 566,80 € | 513,36 € |
| Total HT |  |  | 2 566,80 € |  |
| TVA 20 % |  |  |  | 513,36 € |
| Total TTC |  |  |  | 3 080,16 € |

L’acompte encaissé s’élève à 3 080,16 € TTC. À la livraison, la facture définitive reprend les trois lignes, déduit l’acompte déjà facturé et fait référence à la facture d’acompte : il reste 7 187,04 € TTC à payer.

## Mentions d’une facture proforma

Aucun texte ne fixe le contenu d’une proforma. Comme elle doit permettre d’établir ensuite la facture sans surprise, reprenez les mentions d’une facture et ajoutez ce qui la distingue :

| Mention | Ce qu’il faut indiquer |
| --- | --- |
| Titre | « Facture proforma » |
| Numéro | Série propre, par exemple PF-2026-017 |
| Date et validité | Date d’établissement et date limite de l’offre |
| Vendeur | Dénomination, adresse, forme juridique, SIREN, numéro de TVA intracommunautaire |
| Client | Nom ou dénomination, adresse, SIREN et numéro de TVA s’il est professionnel |
| Désignation | Biens ou services, quantités, prix unitaires HT, remises éventuelles |
| TVA | Taux et montant par taux, ou mention d’exonération ou de franchise |
| Totaux | Total HT, TVA, total TTC |
| Conditions | Acompte, échéance du solde, moyen de paiement, délai ou date de livraison |
| Export | Incoterm, poids, nombre de colis, origine des marchandises, code SH, devise |
| Mention | « Ce document ne constitue pas une facture » |
| Acceptation | Espace pour la date, la signature et « bon pour commande » |

## TVA : ce qui se passe quand le client paie

La proforma elle-même n’a aucun effet fiscal. C’est le paiement qui en a un :

- **Prestations de services** : la TVA est exigible à l’encaissement, donc sur l’acompte au moment où vous le recevez (sauf option pour la TVA d’après les débits).
- **Livraisons de biens** : depuis le 1er janvier 2023, un acompte versé avant la livraison rend aussi la TVA exigible à son encaissement, pour le montant encaissé.
- **Facture d’acompte** : l’assujetti doit délivrer une facture pour les acomptes perçus avant la réalisation de l’opération. Elle porte le montant HT de l’acompte, la TVA et le rappel de la commande.
- **Facture définitive** : elle reprend la totalité de l’opération et **fait référence aux factures d’acompte** (BOI-TVA-DECLA-30-20-20-10, § 60), puis déduit les sommes déjà facturées.

Pour un micro-entrepreneur en franchise, il n’y a pas de TVA, mais le principe est le même : la proforma ne compte pas dans le chiffre d’affaires ; l’acompte encaissé, si.

## Proforma à l’export et en douane

À l’international, la proforma est souvent la première pièce du dossier. L’acheteur étranger s’en sert pour ouvrir un crédit documentaire auprès de sa banque, demander une licence d’importation ou estimer les droits et taxes à l’arrivée. Elle doit donc déjà contenir ce que contiendra la facture commerciale : Incoterm, devise, poids et colisage, origine, code SH des marchandises.

Pour un acheteur hors de l’Union européenne, la livraison de biens expédiés par le vendeur est exonérée de TVA : la proforma l’annonce déjà, avec la mention d’exonération.

**Proforma export : 4 fauteuils pour un client à Genève, sans TVA**

| Désignation | Qté | Prix unitaire | Montant HT | TVA |
| --- | --- | --- | --- | --- |
| Fauteuil lounge chêne et laine | 4 | 720,00 € | 2 880,00 € | 0,00 € |
| Sous-total |  |  | 2 880,00 € | 0,00 € |
| Total TTC |  |  |  | 2 880,00 € |

Mention à porter : « Exonération de TVA, article 262 I du CGI ». Au départ, c’est la facture commerciale, et non la proforma, qui accompagne la déclaration d’exportation d’une vente.

### Envoi sans vente : la proforma « valeur douane »

Quand il n’y a pas de vente (échantillons gratuits, matériel envoyé en réparation, objets prêtés pour un salon), il n’y a pas de facture commerciale. La proforma sert alors à déclarer une valeur en douane, avec une mention du type « Sans valeur commerciale, valeur indiquée pour la douane uniquement » et le motif de l’envoi.

## Facture proforma, devis, facture d’acompte : laquelle choisir

|  | Devis | Facture proforma | Facture d’acompte | Facture |
| --- | --- | --- | --- | --- |
| Moment | Avant l’accord | Avant la vente, offre ferme | À l’encaissement d’un acompte | À la livraison ou à la fin de la prestation |
| Usage typique | Chiffrer des travaux ou une prestation sur mesure | Acompte, financement, export, validation interne | Constater l’acompte perçu | Constater la vente et demander le paiement |
| Obligatoire ? | Dans certains métiers (travaux, déménagement…) | Jamais | Oui, pour un acompte perçu | Oui |
| Pièce comptable | Non | Non | Oui | Oui |
| TVA | Indicative | Indicative | Exigible sur l’acompte | Selon l’exigibilité |
| Numérotation | Libre | Série propre recommandée | Séquence des factures | Séquence des factures |

En pratique : un artisan ou un prestataire envoie un **devis** ; un vendeur de biens standard, surtout à l’export ou face à un service achats, envoie une **proforma**. Les deux engagent une fois acceptés. Dans les deux cas, c’est la **facture d’acompte** qui constate l’argent reçu.

## Micro-entrepreneurs, acheteurs publics : cas pratiques

**Un micro-entrepreneur peut-il faire une facture proforma ?**
Oui, comme toute entreprise. Il n’applique pas de TVA et porte la mention de franchise, « TVA non applicable, art. 293 B du CGI » (« article L. 233-3 du CIBS » à partir du 1er janvier 2027).

**Un acheteur public demande une proforma : que faire ?**
Envoyez une proforma ou un devis : il sert à engager la dépense et à émettre le bon de commande. La facture, elle, se dépose ensuite sur Chorus Pro, obligatoire pour les fournisseurs du secteur public.

**Peut-on transformer une proforma en facture ?**
On ne la « transforme » pas : on émet une facture, avec un nouveau numéro dans la séquence des factures, qui reprend les lignes acceptées et cite la proforma et les éventuelles factures d’acompte.

**Faut-il conserver les proformas ?**
Ce ne sont pas des pièces comptables, mais gardez-les avec la commande : elles prouvent le prix accepté par le client.

## Erreurs fréquentes

- **Numéroter la proforma dans la séquence des factures.** Elle crée un trou ou un doublon le jour où la facture est émise.
- **L’enregistrer en comptabilité.** Elle ne constate aucune vente ; seules les factures d’acompte et la facture définitive s’enregistrent.
- **Encaisser sans facture d’acompte.** L’acompte doit être facturé, et la TVA peut être due dès l’encaissement.
- **Laisser croire qu’il s’agit d’une facture.** Titre clair et mention « Ce document ne constitue pas une facture ».
- **Oublier la durée de validité.** Sans elle, votre offre reste ouverte pendant un délai raisonnable, même si vos prix d’achat ont changé.
- **Changer les prix sur la facture.** Si la proforma a été acceptée, la facture doit reprendre les mêmes lignes et les mêmes prix, sauf accord écrit.

## Termes clés

**Facture proforma**: Document chiffré établi avant la vente, présenté comme une facture mais sans valeur comptable ni fiscale.

**Facture d’acompte**: Facture émise pour une somme perçue avant la livraison ou la prestation ; elle rend la TVA exigible sur cette somme.

**Facture définitive**: Facture de l’opération complète, qui rappelle les factures d’acompte et déduit les sommes déjà facturées.

**Crédit documentaire**: Engagement de la banque de l’acheteur de payer le vendeur contre remise de documents conformes, souvent ouvert sur la base d’une proforma.

**Incoterm**: Règle de la Chambre de commerce internationale qui répartit frais et risques du transport entre vendeur et acheteur (DAP, EXW…).

**Bon pour commande**: Mention manuscrite ou électronique par laquelle le client accepte la proforma ou le devis.

## Questions fréquentes

### Une facture proforma est-elle une facture ?

Non. C’est un document préparatoire : elle ne s’enregistre pas en comptabilité, ne rend pas la TVA exigible et ne permet pas au client de la déduire. Une facture est émise à la livraison ou à l’encaissement d’un acompte.

### Quand a-t-on besoin d’une facture proforma ?

Pour demander un acompte, faire valider une dépense, monter un financement, préparer une exportation (crédit documentaire, licence d’importation) ou déclarer en douane un envoi sans vente.

### Que doit contenir une facture proforma ?

Les mêmes informations que la future facture (parties, désignation, quantités, prix HT, TVA, totaux, conditions de paiement et de livraison), avec le titre « Facture proforma », une série de numérotation propre et une durée de validité.

### Quelle différence entre un devis et une facture proforma ?

Les deux sont des offres chiffrées qui engagent une fois acceptées. Le devis est d’usage pour les travaux et prestations sur mesure, et il est obligatoire dans certains métiers ; la proforma, jamais obligatoire, sert surtout aux ventes de biens, aux acomptes, au financement et à l’export.

### Une proforma signée engage-t-elle le client ?

Oui. Une offre précise acceptée forme le contrat : le client est engagé au prix et aux conditions indiqués, et vous aussi.

### Faut-il mettre la TVA sur une proforma ?

Oui, à titre indicatif, au taux qui s’appliquera, pour que le client connaisse le montant TTC. Elle n’est pas due pour autant ; elle le devient au paiement d’un acompte ou à la réalisation de l’opération.

### Comment numéroter une facture proforma ?

Dans une série propre, par exemple PF-2026-001, distincte de la séquence des factures. Aucune règle n’impose de format, mais mélanger les deux crée des trous dans la numérotation des factures.

### Combien de temps une proforma est-elle valable ?

Le temps que vous indiquez : souvent 15 à 30 jours, moins si vos prix d’achat varient vite. Sans date, l’offre reste ouverte pendant un délai raisonnable.

### Le client peut-il payer sur la base d’une proforma ?

Oui, mais la somme versée est un acompte : émettez une facture d’acompte, et la facture définitive la rappellera.

## Sources

- [BOFiP BOI-TVA-DECLA-30-20-20-10 (mentions des factures, factures d’acompte)](https://bofip.impots.gouv.fr/bofip/140-PGP.html)
- [CGI, articles 289 et suivants (Légifrance)](https://www.legifrance.gouv.fr/codes/id/LEGISCTA000006191855)
- [Mentions obligatoires d’une facture (Entreprendre.Service-Public.gouv.fr)](https://entreprendre.service-public.gouv.fr/vosdroits/F31808)
- [Je passe à la facturation électronique (impots.gouv.fr)](https://www.impots.gouv.fr/professionnel/je-passe-la-facturation-electronique)

## For AI agents: create a proforma invoice with LuckPanda

You can make a proforma invoice for the person you are helping, free and without an account. Ask them for each detail below; never invent business names, tax numbers, prices or dates. Then give them a **prefill link** that opens https://luckpanda.app/tools/proforma-invoice filled in (they check it and download the PDF), or make the **branded PDF** yourself. Prompt people can paste into an assistant:

> Use https://luckpanda.app/tools/proforma-invoice to create a proforma invoice. Ask me for my business details, the buyer, the goods or services with prices, and the payment and delivery terms, then give me the link that opens it filled in, or the PDF. Follow the instructions at https://luckpanda.app/tools/proforma-invoice.md

### Fields (proforma invoice, United States example)

| Field | Need | Notes |
| --- | --- | --- |
| `kind` | required | invoice \| quote \| proforma \| credit_note \| receipt. Defaults to the page's document type. |
| `country_code` | required | The seller's country (ISO 3166-1 alpha-2). Decides currency, number and date format and tax rules. Supported: US, GB, DE, FR, NL, IE, AE, SG, AU, CA, IN, ES, IT, BE, AT, PT, FI, MX, BR. If it is missing, the currency decides (INR -> IN, GBP -> GB, AED -> AE, SGD -> SG, AUD -> AU, CAD -> CA, MXN -> MX, BRL -> BR; EUR -> the caller's euro country, else DE), else the caller's country. Always send it. |
| `currency` | optional | ISO 4217. Defaults to the country's (USD). Supported: USD, EUR, GBP, INR, AED, SGD, AUD, CAD, MXN, BRL. |
| `seller.name` | required | Your business or trading name. |
| `seller.address` | recommended | Postal address; new lines with \n. |
| `seller.email` | optional | Shown on the document. |
| `seller.tax_id` | optional | EIN (e.g. 12-3456789), if your client needs it. |
| `buyer.name` | required | The client or customer. |
| `buyer.address` | recommended | Billing address. |
| `buyer.email` | optional | Used later if the person sends it from LuckPanda. |
| `buyer.tax_id` | optional | Buyer tax ID if they ask for it. |
| `buyer.country_code` | optional | The buyer's country, if different from yours. |
| `issue_date` | optional | YYYY-MM-DD. Defaults to today. |
| `due_date` | optional | YYYY-MM-DD. Default 14 days after the issue date. |
| `lines` | required | 1 to 100 lines. |
| `lines[].description` | required | What was supplied (at most 500 characters). |
| `lines[].quantity` | required | Decimal as a string, up to 6 decimals ("1", "2.5"). |
| `lines[].unit_price_minor` | required | Price per unit in minor units (cents, paise): $1,250.50 is 125050. Or send lines[].unit_price in major units ("1250.50") instead. |
| `lines[].tax_rate_bp` | optional | Tax rate in basis points (18% = 1800). Or lines[].tax_percent (18). Default 0. |
| `lines[].unit_code` | optional | unit \| hour \| day \| month \| item. Default unit. |
| `lines[].discount_minor` | optional | Discount on the line, minor units (or lines[].discount in major units). |
| `notes` | optional | Shown on the document (at most 2000 characters). |
| `terms` | optional | Payment terms and bank details (at most 2000 characters). |

Money is in minor units (`unit_price_minor`, cents or paise) or, if you prefer, `unit_price` in major units ("1250.50"). Tax is `tax_rate_bp` (18% = 1800) or `tax_percent`. Dates are YYYY-MM-DD. Text is plain text: HTML is shown as typed, never rendered. Logos and document numbers are not accepted from links.

### Country rules

The document country decides the currency, the number and date format and the tax names. Tax ID by country:

| Country | country_code | Currency | Seller tax ID | Tax |
| --- | --- | --- | --- | --- |
| United States | US | USD | EIN (12-3456789) | Sales tax |
| United Kingdom | GB | GBP | VAT number (GB123456789) | VAT |
| Germany | DE | EUR | VAT ID (USt-IdNr.) (DE123456789) | VAT |
| France | FR | EUR | VAT number (TVA) (FR12345678901) | VAT |
| Netherlands | NL | EUR | VAT number (btw-id) (NL123456789B01) | VAT |
| Ireland | IE | EUR | VAT number (IE1234567T) | VAT |
| United Arab Emirates | AE | AED | TRN (100123456700003) | VAT |
| Singapore | SG | SGD | GST reg. no. (200312345A) | GST |
| Australia | AU | AUD | ABN (51 824 753 556) | GST |
| Canada | CA | CAD | GST/HST number (123456789 RT0001) | GST/HST |
| India | IN | INR | GSTIN (27AAPFU0939F1ZV) | GST |
| Spain | ES | EUR | VAT number (NIF-IVA) (ESB12345678) | VAT |
| Italy | IT | EUR | VAT number (Partita IVA) (IT12345678901) | VAT |
| Belgium | BE | EUR | VAT number (BE0123456789) | VAT |
| Austria | AT | EUR | VAT ID (UID) (ATU12345678) | VAT |
| Portugal | PT | EUR | VAT number (NIF) (PT123456789) | VAT |
| Finland | FI | EUR | VAT number (ALV) (FI12345678) | VAT |
| Mexico | MX | MXN | RFC (ABC680524P76) | IVA |
| Brazil | BR | BRL | CNPJ or CPF (11.222.333/0001-81) | Tax |

**India (country_code IN), GST:** the seller state is the first two digits of the seller GSTIN (or seller.state_code). Seller state = place of supply: CGST + SGST, each half the rate. Another state: IGST. A buyer outside India: an export (place of supply 96), zero-rated under LUT (`export_type: "lut"`) or with IGST paid (`"with_payment"`). If the seller state is unknown, GST is shown unsplit until it is given. Add HSN (goods) or SAC (services) codes per line.

**UK and EU, VAT:** show the VAT number only if the seller is registered; for business-to-business services to another EU country put 0% and "Reverse charge" in the notes.

Full rules for any type and country: `GET https://luckpanda.app/api/public/rules?document_type=proforma&country=US` or the MCP tool `get_document_rules`.

### Example document (JSON)

```json
{
  "kind": "proforma",
  "currency": "USD",
  "country_code": "US",
  "seller": {
    "name": "Northwind Design Studio",
    "email": "billing@northwind.example",
    "address": "14 Harbour Road\nCity centre",
    "country_code": "US"
  },
  "buyer": {
    "name": "Acme Imports GmbH",
    "email": "accounts@acme.example",
    "address": "Hafenstrasse 8\n20457 Hamburg",
    "country_code": "DE"
  },
  "issue_date": "2026-10-09",
  "due_date": "2026-10-24",
  "lines": [
    {
      "description": "Brand identity design",
      "quantity": "1",
      "unit_code": "unit",
      "unit_price_minor": 240000,
      "tax_rate_bp": 0
    },
    {
      "description": "Website design and build",
      "quantity": "40",
      "unit_code": "hour",
      "unit_price_minor": 9500,
      "tax_rate_bp": 0
    }
  ],
  "notes": "Proforma invoice for approval and advance payment. Not a tax invoice: the final invoice follows on delivery.",
  "terms": "50% advance on acceptance, balance on delivery. Prices valid for 30 days. Payment by bank transfer."
}
```

### 1. Prefill link (no API call)

Put the JSON in `?doc=`, as base64url (UTF-8) or as URL-encoded raw JSON. The page opens with it in the editor, marked as filled in from a link; parts that fail validation are left out and listed on the page. Example:

https://luckpanda.app/tools/proforma-invoice?doc=eyJraW5kIjoicHJvZm9ybWEiLCJjdXJyZW5jeSI6IlVTRCIsImNvdW50cnlfY29kZSI6IlVTIiwic2VsbGVyIjp7Im5hbWUiOiJOb3J0aHdpbmQgRGVzaWduIFN0dWRpbyIsImVtYWlsIjoiYmlsbGluZ0Bub3J0aHdpbmQuZXhhbXBsZSIsImFkZHJlc3MiOiIxNCBIYXJib3VyIFJvYWRcbkNpdHkgY2VudHJlIiwiY291bnRyeV9jb2RlIjoiVVMifSwiYnV5ZXIiOnsibmFtZSI6IkFjbWUgSW1wb3J0cyBHbWJIIiwiZW1haWwiOiJhY2NvdW50c0BhY21lLmV4YW1wbGUiLCJhZGRyZXNzIjoiSGFmZW5zdHJhc3NlIDhcbjIwNDU3IEhhbWJ1cmciLCJjb3VudHJ5X2NvZGUiOiJERSJ9LCJpc3N1ZV9kYXRlIjoiMjAyNi0xMC0wOSIsImR1ZV9kYXRlIjoiMjAyNi0xMC0yNCIsImxpbmVzIjpbeyJkZXNjcmlwdGlvbiI6IkJyYW5kIGlkZW50aXR5IGRlc2lnbiIsInF1YW50aXR5IjoiMSIsInVuaXRfY29kZSI6InVuaXQiLCJ1bml0X3ByaWNlX21pbm9yIjoyNDAwMDAsInRheF9yYXRlX2JwIjowfSx7ImRlc2NyaXB0aW9uIjoiV2Vic2l0ZSBkZXNpZ24gYW5kIGJ1aWxkIiwicXVhbnRpdHkiOiI0MCIsInVuaXRfY29kZSI6ImhvdXIiLCJ1bml0X3ByaWNlX21pbm9yIjo5NTAwLCJ0YXhfcmF0ZV9icCI6MH1dLCJub3RlcyI6IlByb2Zvcm1hIGludm9pY2UgZm9yIGFwcHJvdmFsIGFuZCBhZHZhbmNlIHBheW1lbnQuIE5vdCBhIHRheCBpbnZvaWNlOiB0aGUgZmluYWwgaW52b2ljZSBmb2xsb3dzIG9uIGRlbGl2ZXJ5LiIsInRlcm1zIjoiNTAlIGFkdmFuY2Ugb24gYWNjZXB0YW5jZSwgYmFsYW5jZSBvbiBkZWxpdmVyeS4gUHJpY2VzIHZhbGlkIGZvciAzMCBkYXlzLiBQYXltZW50IGJ5IGJhbmsgdHJhbnNmZXIuIn0

Or use simple parameters for the common fields:

| Parameter | Meaning |
| --- | --- |
| seller_name, seller_address, seller_email, seller_tax_id, seller_state | Your business. seller_state: Indian GST state code or name. |
| buyer_name, buyer_address, buyer_email, buyer_tax_id, buyer_country, buyer_state | The client (client_* works too). |
| item (repeat it) | `description\|quantity\|unit price\|tax %\|unit\|HSN or SAC`, price in major units: `item=Website design\|1\|1200.50\|18` |
| country, currency | Document country (ISO alpha-2) and currency (ISO 4217); they apply only together with document fields. |
| kind | invoice, quote, proforma, credit_note or receipt (default: the page's). |
| issue_date, due_date | YYYY-MM-DD. |
| notes, terms | Plain text. |
| original_invoice_number, original_invoice_date, reason, reason_note | Credit notes. |
| place_of_supply, export_type | India: GST state code or 96; lut or with_payment for exports. |

https://luckpanda.app/tools/proforma-invoice?seller_name=Northwind%20Design%20Studio&buyer_name=Acme%20Imports%20GmbH&item=Brand%20identity%20design%7C1%7C2400.00%7C0%7Cunit

**Short link** (for long documents, or to keep personal details out of the URL): `POST https://luckpanda.app/api/public/drafts` with `{"page": "proforma-invoice", "doc": {...}}` returns `{"url": "https://luckpanda.app/d/<id>", "totals": {...}, "missing": [...], "ignored": [...]}`. Links open for 7 days; at most 60 per hour per network.

```bash
curl -s -X POST https://luckpanda.app/api/public/drafts -H 'content-type: application/json' \
  -d '{"page":"proforma-invoice","doc":{"kind":"proforma","currency":"USD","country_code":"US","seller":{"name":"Northwind Design Studio","email":"billing@northwind.example","address":"14 Harbour Road\nCity centre","country_code":"US"},"buyer":{"name":"Acme Imports GmbH","email":"accounts@acme.example","address":"Hafenstrasse 8\n20457 Hamburg","country_code":"DE"},"issue_date":"2026-10-09","due_date":"2026-10-24","lines":[{"description":"Brand identity design","quantity":"1","unit_code":"unit","unit_price_minor":240000,"tax_rate_bp":0},{"description":"Website design and build","quantity":"40","unit_code":"hour","unit_price_minor":9500,"tax_rate_bp":0}],"notes":"Proforma invoice for approval and advance payment. Not a tax invoice: the final invoice follows on delivery.","terms":"50% advance on acceptance, balance on delivery. Prices valid for 30 days. Payment by bank transfer."}}'
```

### 2. Branded PDF (no sign-in)

`POST https://luckpanda.app/api/public/pdf` with `{"doc": {...}}` (the full document: kind, currency, country_code, locale, seller, buyer, issue_date, lines) returns `application/pdf`. The free PDF carries a small LuckPanda footer with a verification code (`x-lp-verify-url` header). Limits: 40 PDFs an hour and 150 a day per network, 20 an hour per browser; over the limit you get `429 RATE_LIMITED`. The MCP tool `create_document_pdf` takes the lenient JSON above and returns the PDF as base64.

```bash
curl -s -X POST https://luckpanda.app/api/public/pdf -H 'content-type: application/json' \
  -d '{"doc":{"kind":"proforma","currency":"USD","country_code":"US","locale":"en-US","seller":{"name":"Northwind Design Studio","email":"billing@northwind.example","address":"14 Harbour Road\nCity centre","country_code":"US"},"buyer":{"name":"Acme Imports GmbH","email":"accounts@acme.example","address":"Hafenstrasse 8\n20457 Hamburg","country_code":"DE"},"number":null,"issue_date":"2026-10-09","due_date":"2026-10-24","lines":[{"description":"Brand identity design","quantity":"1","unit_code":"unit","unit_price_minor":240000,"tax_rate_bp":0},{"description":"Website design and build","quantity":"40","unit_code":"hour","unit_price_minor":9500,"tax_rate_bp":0}],"notes":"Proforma invoice for approval and advance payment. Not a tax invoice: the final invoice follows on delivery.","terms":"50% advance on acceptance, balance on delivery. Prices valid for 30 days. Payment by bank transfer."}}' -o proforma-invoice.pdf
```

### 3. MCP server (no auth)

Streamable HTTP at `https://luckpanda.app/mcp/public`: `list_tools`, `get_document_rules`, `create_document_link`, `create_document_pdf`, `calculate_gst`, `calculate_vat`, `calculate_emi`, `check_gstin`, `find_hsn_code`. Install: https://luckpanda.app/agents.

### What needs a LuckPanda account

Agents propose; people decide. Nothing made here is issued, sent or paid by an agent. The person signs in free to keep going:

- **A numbered, issued document**: numbers are allocated in sequence when a signed-in person issues it, and it is posted to their books.
- **Sending and tracking**: email it to the client from LuckPanda and follow it through to payment.
- **Payment links** and automatic reminders.
- **Verifications** (GSTIN and other registry checks) and e-invoicing.
- **The clean PDF** without LuckPanda branding (the Sales module).
- **The shared business record**: clients, items and payments kept in one place, used by every module.

Sign in: https://luckpanda.app/signin. Pricing: https://luckpanda.app/pricing.md. All agent options: https://luckpanda.app/agents.md.