forked from seb_vallee/BillManager
Compare commits
11 Commits
8e79796781
...
devel
| Author | SHA1 | Date | |
|---|---|---|---|
| baa3827a20 | |||
| 87e78314c6 | |||
| dbb5a29863 | |||
| f25cf02660 | |||
| bb12b3777f | |||
| b403efd056 | |||
| 40c05f7860 | |||
| bc82603f96 | |||
| b1029d10d3 | |||
| ab3bf493d2 | |||
| 31cf8054cd |
@@ -1,6 +1,6 @@
|
||||
# Facturation Association
|
||||
|
||||
Application de facturation légale française pour associations (loi 1901),
|
||||
Application de facturation légale française pour associations (loi 1901) ou micro-entrepreneur,
|
||||
non assujetties à la TVA (art. 293B du CGI).
|
||||
|
||||
## Fonctionnalités
|
||||
@@ -9,7 +9,7 @@ non assujetties à la TVA (art. 293B du CGI).
|
||||
- Devis avec numérotation automatique (DEV-AAAA-XXXX)
|
||||
- Factures avec numérotation chronologique (AAAA-XXXX)
|
||||
- Conversion devis → facture
|
||||
- Génération PDF avec toutes les mentions légales françaises
|
||||
- Génération PDF avec toutes les mentions légales françaises et conforme aux normes de facturation electronique Factur-X
|
||||
- Suivi des statuts (émise / payée / annulée)
|
||||
|
||||
## Stack
|
||||
|
||||
@@ -1,345 +0,0 @@
|
||||
"""
|
||||
Usage
|
||||
pip install lxml
|
||||
python generate_facturx_basic.py
|
||||
"""
|
||||
|
||||
"""
|
||||
Générateur de XML Factur-X - Profil BASIC
|
||||
Conforme à la norme EN 16931, syntaxe CII (Cross Industry Invoice)
|
||||
Factur-X 1.0 / ZUGFeRD 2.x
|
||||
"""
|
||||
|
||||
from lxml import etree
|
||||
from datetime import date
|
||||
from dataclasses import dataclass, field
|
||||
from typing import List, Optional
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Namespaces CII obligatoires
|
||||
# ─────────────────────────────────────────────
|
||||
NSMAP = {
|
||||
"rsm": "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100",
|
||||
"ram": "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100",
|
||||
"udt": "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100",
|
||||
"qdt": "urn:un:unece:uncefact:data:standard:QualifiedDataType:100",
|
||||
"xsi": "http://www.w3.org/2001/XMLSchema-instance",
|
||||
}
|
||||
RSM = NSMAP["rsm"]
|
||||
RAM = NSMAP["ram"]
|
||||
UDT = NSMAP["udt"]
|
||||
|
||||
PROFILE_BASIC = "urn:factur-x.eu:1p0:basic"
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Structures de données
|
||||
# ─────────────────────────────────────────────
|
||||
@dataclass
|
||||
class Address:
|
||||
line1: str
|
||||
city: str
|
||||
postcode: str
|
||||
country_code: str # ISO 3166-1 alpha-2, ex: "FR"
|
||||
line2: Optional[str] = None
|
||||
|
||||
|
||||
@dataclass
|
||||
class Party:
|
||||
name: str
|
||||
vat_id: Optional[str] = None # ex: "FR12345678901"
|
||||
siret: Optional[str] = None # schemeID="0002"
|
||||
address: Optional[Address] = None
|
||||
|
||||
|
||||
@dataclass
|
||||
class TaxLine:
|
||||
base_amount: float
|
||||
rate: float # ex: 20.0 pour 20%
|
||||
amount: float
|
||||
category: str = "E" # S=standard, Z=zéro, E=exonéré, AE=autoliquidation
|
||||
|
||||
|
||||
@dataclass
|
||||
class InvoiceLine:
|
||||
line_id: str
|
||||
description: str
|
||||
quantity: float
|
||||
unit_code: str # ex: "C62"=unité, "HUR"=heure, "KGM"=kg
|
||||
unit_price: float # prix HT unitaire
|
||||
vat_rate: float # ex: 20.0
|
||||
vat_category: str = "S"
|
||||
# Le montant HT de la ligne est calculé automatiquement
|
||||
|
||||
|
||||
@dataclass
|
||||
class Invoice:
|
||||
# En-tête
|
||||
number: str
|
||||
issue_date: date
|
||||
due_date: Optional[date]
|
||||
currency: str # ex: "EUR"
|
||||
type_code: str = "380" # 380=facture, 381=avoir, 384=facture rectificative
|
||||
|
||||
# Parties
|
||||
seller: Party = None
|
||||
buyer: Party = None
|
||||
|
||||
# Lignes
|
||||
lines: List[InvoiceLine] = field(default_factory=list)
|
||||
|
||||
# Paiement
|
||||
payment_means_code: str = "30" # 30=virement
|
||||
iban: Optional[str] = None
|
||||
bic: Optional[str] = None
|
||||
payment_reference: Optional[str] = None
|
||||
|
||||
# Note (champ libre)
|
||||
note: Optional[str] = None
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Helpers XML
|
||||
# ─────────────────────────────────────────────
|
||||
def sub(parent, ns, tag, text=None, **attribs):
|
||||
el = etree.SubElement(parent, f"{{{ns}}}{tag}", **attribs)
|
||||
if text is not None:
|
||||
el.text = str(text)
|
||||
return el
|
||||
|
||||
|
||||
def date_str(d: date) -> str:
|
||||
return d.strftime("%Y%m%d")
|
||||
|
||||
|
||||
def amount_str(v: float) -> str:
|
||||
return f"{v:.2f}"
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Construction du XML
|
||||
# ─────────────────────────────────────────────
|
||||
def build_facturx(inv: Invoice) -> etree._ElementTree:
|
||||
|
||||
root = etree.Element(f"{{{RSM}}}CrossIndustryInvoice", nsmap=NSMAP)
|
||||
|
||||
# ── 1. ExchangedDocumentContext ──────────────
|
||||
ctx = sub(root, RSM, "ExchangedDocumentContext")
|
||||
gp = sub(ctx, RAM, "GuidelineSpecifiedDocumentContextParameter")
|
||||
sub(gp, RAM, "ID", PROFILE_BASIC)
|
||||
|
||||
# ── 2. ExchangedDocument ────────────────────
|
||||
doc = sub(root, RSM, "ExchangedDocument")
|
||||
sub(doc, RAM, "ID", inv.number)
|
||||
sub(doc, RAM, "TypeCode", inv.type_code)
|
||||
idt = sub(doc, RAM, "IssueDateTime")
|
||||
sub(idt, UDT, "DateTimeString", date_str(inv.issue_date), format="102")
|
||||
if inv.note:
|
||||
sub(doc, RAM, "IncludedNote").append(
|
||||
etree.fromstring(f'<ram:Content xmlns:ram="{RAM}">{inv.note}</ram:Content>')
|
||||
)
|
||||
|
||||
# ── 3. SupplyChainTradeTransaction ──────────
|
||||
tx = sub(root, RSM, "SupplyChainTradeTransaction")
|
||||
|
||||
# ── 3a. Lignes de facture (BASIC = lignes obligatoires) ──
|
||||
for ln in inv.lines:
|
||||
net = round(ln.quantity * ln.unit_price, 2)
|
||||
ili = sub(tx, RAM, "IncludedSupplyChainTradeLineItem")
|
||||
assoc = sub(ili, RAM, "AssociatedDocumentLineDocument")
|
||||
sub(assoc, RAM, "LineID", ln.line_id)
|
||||
|
||||
prod = sub(ili, RAM, "SpecifiedTradeProduct")
|
||||
sub(prod, RAM, "Name", ln.description)
|
||||
|
||||
la = sub(ili, RAM, "SpecifiedLineTradeAgreement")
|
||||
gpp = sub(la, RAM, "GrossPriceProductTradePrice")
|
||||
sub(gpp, RAM, "ChargeAmount", amount_str(ln.unit_price), currencyID=inv.currency)
|
||||
npp = sub(la, RAM, "NetPriceProductTradePrice")
|
||||
sub(npp, RAM, "ChargeAmount", amount_str(ln.unit_price), currencyID=inv.currency)
|
||||
|
||||
ld = sub(ili, RAM, "SpecifiedLineTradeDelivery")
|
||||
sub(ld, RAM, "BilledQuantity", amount_str(ln.quantity), unitCode=ln.unit_code)
|
||||
|
||||
ls = sub(ili, RAM, "SpecifiedLineTradeSettlement")
|
||||
tax = sub(ls, RAM, "ApplicableTradeTax")
|
||||
sub(tax, RAM, "TypeCode", "VAT")
|
||||
sub(tax, RAM, "CategoryCode", ln.vat_category)
|
||||
sub(tax, RAM, "RateApplicablePercent", amount_str(ln.vat_rate))
|
||||
|
||||
smls = sub(ls, RAM, "SpecifiedTradeSettlementLineMonetarySummation")
|
||||
sub(smls, RAM, "LineTotalAmount", amount_str(net), currencyID=inv.currency)
|
||||
|
||||
# ── 3b. ApplicableHeaderTradeAgreement ──────
|
||||
agr = sub(tx, RAM, "ApplicableHeaderTradeAgreement")
|
||||
|
||||
def _party(parent_el, tag, party: Party):
|
||||
p = sub(parent_el, RAM, tag)
|
||||
sub(p, RAM, "Name", party.name)
|
||||
if party.siret:
|
||||
sr = sub(p, RAM, "SpecifiedLegalOrganization")
|
||||
sub(sr, RAM, "ID", party.siret, schemeID="0002")
|
||||
if party.vat_id:
|
||||
tr = sub(p, RAM, "SpecifiedTaxRegistration")
|
||||
sub(tr, RAM, "ID", party.vat_id, schemeID="VA")
|
||||
if party.address:
|
||||
addr = sub(p, RAM, "PostalTradeAddress")
|
||||
sub(addr, RAM, "PostcodeCode", party.address.postcode)
|
||||
sub(addr, RAM, "LineOne", party.address.line1)
|
||||
if party.address.line2:
|
||||
sub(addr, RAM, "LineTwo", party.address.line2)
|
||||
sub(addr, RAM, "CityName", party.address.city)
|
||||
sub(addr, RAM, "CountryID", party.address.country_code)
|
||||
return p
|
||||
|
||||
_party(agr, "SellerTradeParty", inv.seller)
|
||||
_party(agr, "BuyerTradeParty", inv.buyer)
|
||||
|
||||
if inv.payment_reference:
|
||||
bor = sub(agr, RAM, "BuyerOrderReferencedDocument")
|
||||
sub(bor, RAM, "IssuerAssignedID", inv.payment_reference)
|
||||
|
||||
# ── 3c. ApplicableHeaderTradeDelivery ───────
|
||||
sub(tx, RAM, "ApplicableHeaderTradeDelivery")
|
||||
|
||||
# ── 3d. ApplicableHeaderTradeSettlement ─────
|
||||
stl = sub(tx, RAM, "ApplicableHeaderTradeSettlement")
|
||||
sub(stl, RAM, "InvoiceCurrencyCode", inv.currency)
|
||||
|
||||
# Moyens de paiement
|
||||
pm = sub(stl, RAM, "SpecifiedTradeSettlementPaymentMeans")
|
||||
sub(pm, RAM, "TypeCode", inv.payment_means_code)
|
||||
if inv.iban:
|
||||
acc = sub(pm, RAM, "PayeePartyCreditorFinancialAccount")
|
||||
sub(acc, RAM, "IBANID", inv.iban)
|
||||
if inv.bic:
|
||||
fi = sub(pm, RAM, "PayeeSpecifiedCreditorFinancialInstitution")
|
||||
sub(fi, RAM, "BICID", inv.bic)
|
||||
|
||||
# TVA par taux (calcul à partir des lignes)
|
||||
tax_totals: dict[tuple, list] = {}
|
||||
for ln in inv.lines:
|
||||
key = (ln.vat_rate, ln.vat_category)
|
||||
tax_totals.setdefault(key, []).append(round(ln.quantity * ln.unit_price, 2))
|
||||
|
||||
total_ht = 0.0
|
||||
total_tva = 0.0
|
||||
for (rate, cat), bases in tax_totals.items():
|
||||
base = round(sum(bases), 2)
|
||||
tva = round(base * rate / 100, 2)
|
||||
total_ht += base
|
||||
total_tva += tva
|
||||
tax = sub(stl, RAM, "ApplicableTradeTax")
|
||||
sub(tax, RAM, "CalculatedAmount", amount_str(tva), currencyID=inv.currency)
|
||||
sub(tax, RAM, "TypeCode", "VAT")
|
||||
sub(tax, RAM, "BasisAmount", amount_str(base), currencyID=inv.currency)
|
||||
sub(tax, RAM, "CategoryCode", cat)
|
||||
sub(tax, RAM, "RateApplicablePercent", amount_str(rate))
|
||||
|
||||
total_ht = round(total_ht, 2)
|
||||
total_tva = round(total_tva, 2)
|
||||
total_ttc = round(total_ht + total_tva, 2)
|
||||
|
||||
# Échéance
|
||||
if inv.due_date:
|
||||
stp = sub(stl, RAM, "SpecifiedTradePaymentTerms")
|
||||
ddt = sub(stp, RAM, "DueDateDateTime")
|
||||
sub(ddt, UDT, "DateTimeString", date_str(inv.due_date), format="102")
|
||||
|
||||
# Totaux
|
||||
sums = sub(stl, RAM, "SpecifiedTradeSettlementHeaderMonetarySummation")
|
||||
sub(sums, RAM, "LineTotalAmount", amount_str(total_ht), currencyID=inv.currency)
|
||||
sub(sums, RAM, "TaxBasisTotalAmount",amount_str(total_ht), currencyID=inv.currency)
|
||||
sub(sums, RAM, "TaxTotalAmount", amount_str(total_tva), currencyID=inv.currency)
|
||||
sub(sums, RAM, "GrandTotalAmount", amount_str(total_ttc), currencyID=inv.currency)
|
||||
sub(sums, RAM, "DuePayableAmount", amount_str(total_ttc), currencyID=inv.currency)
|
||||
|
||||
return etree.ElementTree(root)
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Exemple d'utilisation
|
||||
# ─────────────────────────────────────────────
|
||||
if __name__ == "__main__":
|
||||
|
||||
invoice = Invoice(
|
||||
number="FA-2024-00123",
|
||||
issue_date=date(2024, 3, 15),
|
||||
due_date=date(2024, 4, 14),
|
||||
currency="EUR",
|
||||
type_code="380",
|
||||
note="Facture relative au contrat n°CTR-2024-01",
|
||||
|
||||
seller=Party(
|
||||
name="Ma Société SAS",
|
||||
vat_id="FR12345678901",
|
||||
siret="12345678900012",
|
||||
address=Address(
|
||||
line1="10 rue de la Paix",
|
||||
city="Paris",
|
||||
postcode="75001",
|
||||
country_code="FR",
|
||||
),
|
||||
),
|
||||
|
||||
buyer=Party(
|
||||
name="Client SARL",
|
||||
vat_id="FR98765432100",
|
||||
siret="98765432100011",
|
||||
address=Address(
|
||||
line1="5 avenue des Fleurs",
|
||||
city="Lyon",
|
||||
postcode="69001",
|
||||
country_code="FR",
|
||||
),
|
||||
),
|
||||
|
||||
lines=[
|
||||
InvoiceLine(
|
||||
line_id="1",
|
||||
description="Développement logiciel - Sprint 1",
|
||||
quantity=10,
|
||||
unit_code="HUR", # heures
|
||||
unit_price=150.00,
|
||||
vat_rate=0.0,
|
||||
),
|
||||
InvoiceLine(
|
||||
line_id="2",
|
||||
description="Licence logicielle annuelle",
|
||||
quantity=1,
|
||||
unit_code="C62", # unité
|
||||
unit_price=500.00,
|
||||
vat_rate=0.0,
|
||||
),
|
||||
InvoiceLine(
|
||||
line_id="3",
|
||||
description="Formation utilisateurs",
|
||||
quantity=2,
|
||||
unit_code="HUR",
|
||||
unit_price=200.00,
|
||||
vat_rate=0.0,
|
||||
),
|
||||
],
|
||||
|
||||
payment_means_code="30", # 30 = virement bancaire
|
||||
iban="FR7612345678901234567890189",
|
||||
bic="BNPAFRPPXXX",
|
||||
payment_reference="CTR-2024-01",
|
||||
)
|
||||
|
||||
tree = build_facturx(invoice)
|
||||
output_file = "factur-x.xml"
|
||||
tree.write(output_file, xml_declaration=True, encoding="UTF-8", pretty_print=True)
|
||||
|
||||
print(f"✅ Fichier généré : {output_file}")
|
||||
print(f" Facture : {invoice.number}")
|
||||
print(f" Émetteur : {invoice.seller.name}")
|
||||
print(f" Destinataire : {invoice.buyer.name}")
|
||||
|
||||
# Calcul récapitulatif
|
||||
total_ht = sum(round(l.quantity * l.unit_price, 2) for l in invoice.lines)
|
||||
total_tva = round(total_ht * 0.20, 2)
|
||||
print(f" Total HT : {total_ht:.2f} €")
|
||||
print(f" TVA 20% : {total_tva:.2f} €")
|
||||
print(f" Total TTC : {total_ht + total_tva:.2f} €")
|
||||
225
generate_facturx_jinja2.py
Normal file
225
generate_facturx_jinja2.py
Normal file
@@ -0,0 +1,225 @@
|
||||
"""
|
||||
Générateur Factur-X BASIC via template Jinja2
|
||||
"""
|
||||
|
||||
from jinja2 import Environment, FileSystemLoader
|
||||
from dataclasses import dataclass, field
|
||||
from typing import List, Optional
|
||||
from datetime import date
|
||||
from collections import defaultdict
|
||||
|
||||
from fastapi.templating import Jinja2Templates
|
||||
|
||||
templates = Jinja2Templates(directory="templates")
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Structures de données (identiques au générateur lxml)
|
||||
# ─────────────────────────────────────────────
|
||||
@dataclass
|
||||
class Address:
|
||||
line1: str
|
||||
city: str
|
||||
postcode: str
|
||||
country_code: str
|
||||
line2: Optional[str] = None
|
||||
|
||||
|
||||
@dataclass
|
||||
class Party:
|
||||
name: str
|
||||
vat_id: Optional[str] = None
|
||||
siret: Optional[str] = None
|
||||
address: Optional[Address] = None
|
||||
|
||||
|
||||
@dataclass
|
||||
class InvoiceLine:
|
||||
line_id: str
|
||||
description: str
|
||||
quantity: float
|
||||
unit_code: str
|
||||
unit_price: float
|
||||
vat_rate: float
|
||||
vat_category: str = "S"
|
||||
|
||||
# Raison d'exonération par catégorie TVA
|
||||
EXEMPTION_REASONS = {
|
||||
"E": "TVA non applicable, art. 293 B du CGI",
|
||||
"Z": "Taux zéro",
|
||||
"AE": "Autoliquidation",
|
||||
"K": "Exonération intracommunautaire",
|
||||
"G": "Exportation hors UE",
|
||||
}
|
||||
|
||||
@dataclass
|
||||
class TaxLine:
|
||||
rate: float
|
||||
category: str
|
||||
base_amount: float
|
||||
amount: float
|
||||
exemption_reason: Optional[str] = None
|
||||
|
||||
@dataclass
|
||||
class Invoice:
|
||||
number: str
|
||||
issue_date: date
|
||||
currency: str
|
||||
seller: Party
|
||||
buyer: Party
|
||||
lines: List[InvoiceLine] = field(default_factory=list)
|
||||
due_date: Optional[date] = None
|
||||
type_code: str = "380"
|
||||
payment_means_code: str = "30"
|
||||
iban: Optional[str] = None
|
||||
payment_reference: Optional[str] = None
|
||||
note: Optional[str] = None
|
||||
|
||||
# Calculés automatiquement (voir compute())
|
||||
tax_lines: List[TaxLine] = field(default_factory=list)
|
||||
total_ht: float = 0.0
|
||||
total_tva: float = 0.0
|
||||
total_ttc: float = 0.0
|
||||
|
||||
def compute(self):
|
||||
"""Calcule les totaux et les lignes de TVA depuis les lignes de facture."""
|
||||
tax_groups = defaultdict(float)
|
||||
self.total_ht = 0.0
|
||||
|
||||
for ln in self.lines:
|
||||
net = round(ln.quantity * ln.unit_price, 2)
|
||||
self.total_ht += net
|
||||
tax_groups[(ln.vat_rate, ln.vat_category)] += net
|
||||
|
||||
self.total_ht = round(self.total_ht, 2)
|
||||
self.tax_lines = []
|
||||
self.total_tva = 0.0
|
||||
|
||||
for (rate, category), base in tax_groups.items():
|
||||
base = round(base, 2)
|
||||
amount = round(base * rate / 100, 2)
|
||||
self.total_tva += amount
|
||||
self.tax_lines.append(TaxLine(
|
||||
rate=rate,
|
||||
category=category,
|
||||
base_amount=base,
|
||||
amount=amount,
|
||||
# Raison d'exonération automatique si catégorie != "S" (standard)
|
||||
exemption_reason=EXEMPTION_REASONS.get(category) if category != "S" else None,
|
||||
))
|
||||
|
||||
self.total_tva = round(self.total_tva, 2)
|
||||
self.total_ttc = round(self.total_ht + self.total_tva, 2)
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Filtres Jinja2 personnalisés
|
||||
# ─────────────────────────────────────────────
|
||||
def filter_amount(value: float) -> str:
|
||||
return f"{float(value):.2f}"
|
||||
|
||||
|
||||
def filter_datefmt(value: date) -> str:
|
||||
return value.strftime("%Y%m%d")
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Générateur
|
||||
# ─────────────────────────────────────────────
|
||||
def generate_facturx_xml(invoice: Invoice, template_dir: str = ".", output_file: str = "factur-x.xml") -> str:
|
||||
"""
|
||||
Génère le XML Factur-X BASIC depuis le template Jinja2.
|
||||
Retourne le XML sous forme de chaîne et l'écrit dans output_file.
|
||||
"""
|
||||
# Calcul des totaux
|
||||
invoice.compute()
|
||||
|
||||
# Environnement Jinja2
|
||||
env = Environment(
|
||||
loader=FileSystemLoader(template_dir),
|
||||
autoescape=False, # XML géré manuellement
|
||||
trim_blocks=True, # supprime le \n après les blocs {% %}
|
||||
lstrip_blocks=True, # supprime les espaces avant {% %}
|
||||
)
|
||||
env.filters["amount"] = filter_amount
|
||||
env.filters["datefmt"] = filter_datefmt
|
||||
|
||||
template = env.get_template("templates/xml/factur-x-basic.xml.j2")
|
||||
xml_str = template.render(
|
||||
invoice=invoice,
|
||||
seller=invoice.seller,
|
||||
buyer=invoice.buyer,
|
||||
)
|
||||
|
||||
with open(output_file, "w", encoding="utf-8") as f:
|
||||
f.write(xml_str)
|
||||
|
||||
return xml_str
|
||||
|
||||
|
||||
# ─────────────────────────────────────────────
|
||||
# Exemple d'utilisation
|
||||
# ─────────────────────────────────────────────
|
||||
if __name__ == "__main__":
|
||||
|
||||
invoice = Invoice(
|
||||
number="FA-2024-00123",
|
||||
issue_date=date(2024, 3, 15),
|
||||
due_date=date(2024, 4, 14),
|
||||
currency="EUR",
|
||||
type_code="380",
|
||||
note="Facture relative au contrat n°CTR-2024-01",
|
||||
|
||||
seller=Party(
|
||||
name="Ma Société SAS",
|
||||
# vat_id absent : pas de numéro TVA en franchise (art. 293 B CGI)
|
||||
siret="12345678900012",
|
||||
address=Address(
|
||||
line1="10 rue de la Paix",
|
||||
city="Paris",
|
||||
postcode="75001",
|
||||
country_code="FR",
|
||||
),
|
||||
),
|
||||
|
||||
buyer=Party(
|
||||
name="Client SARL",
|
||||
vat_id="FR98765432100",
|
||||
siret="98765432100011",
|
||||
address=Address(
|
||||
line1="5 avenue des Fleurs",
|
||||
city="Lyon",
|
||||
postcode="69001",
|
||||
country_code="FR",
|
||||
),
|
||||
),
|
||||
|
||||
payment_means_code="30",
|
||||
iban="FR7612345678901234567890189",
|
||||
payment_reference="CTR-2024-01",
|
||||
)
|
||||
|
||||
# Ajout des lignes — franchise de TVA (art. 293 B du CGI)
|
||||
# Utiliser vat_category="E" et vat_rate=0.0
|
||||
articles = [
|
||||
{"desc": "Développement logiciel - Sprint 1", "qty": 10, "unit": "HUR", "prix": 150.0, "tva": 0.0, "cat": "E"},
|
||||
{"desc": "Licence logicielle annuelle", "qty": 1, "unit": "C62", "prix": 500.0, "tva": 0.0, "cat": "E"},
|
||||
{"desc": "Formation utilisateurs", "qty": 2, "unit": "HUR", "prix": 200.0, "tva": 0.0, "cat": "E"},
|
||||
]
|
||||
|
||||
for i, art in enumerate(articles, start=1):
|
||||
invoice.lines.append(InvoiceLine(
|
||||
line_id=str(i),
|
||||
description=art["desc"],
|
||||
quantity=art["qty"],
|
||||
unit_code=art["unit"],
|
||||
unit_price=art["prix"],
|
||||
vat_rate=art["tva"],
|
||||
vat_category=art["cat"], # "E" = exonéré (franchise TVA)
|
||||
))
|
||||
|
||||
xml = generate_facturx_xml(invoice, template_dir=".", output_file="factur-x.xml")
|
||||
|
||||
print(f"✅ Fichier généré : factur-x.xml")
|
||||
print(f" Total HT : {invoice.total_ht:.2f} €")
|
||||
print(f" TVA 20% : {invoice.total_tva:.2f} €")
|
||||
print(f" Total TTC : {invoice.total_ttc:.2f} €")
|
||||
@@ -8,3 +8,5 @@ pydantic==2.9.2
|
||||
pydantic-settings==2.5.2
|
||||
bcrypt==4.2.0
|
||||
itsdangerous==2.2.0
|
||||
factur-x==3.16
|
||||
pikepdf==10.5.0
|
||||
|
||||
@@ -11,7 +11,8 @@ from numerotation import generer_numero_facture
|
||||
from config import settings
|
||||
from auth import get_current_user
|
||||
from template_helper import render
|
||||
from generate_facturx_basic import Address, Party, Invoice, InvoiceLine, build_facturx
|
||||
from generate_facturx_jinja2 import Address, Party, Invoice, InvoiceLine, generate_facturx_xml
|
||||
from facturx import generate_from_binary
|
||||
|
||||
router = APIRouter(prefix="/factures", tags=["factures"], dependencies=[Depends(get_current_user)])
|
||||
templates = Jinja2Templates(directory="templates")
|
||||
@@ -156,27 +157,66 @@ def changer_statut_facture(
|
||||
db.commit()
|
||||
return RedirectResponse(f"/factures/{facture_id}", status_code=303)
|
||||
|
||||
from generate_facturx_jinja2 import Invoice, Party, Address, InvoiceLine, filter_amount, filter_datefmt
|
||||
|
||||
@router.get("/{facture_id}/pdf")
|
||||
def telecharger_pdf(facture_id: int, db: Session = Depends(get_db)):
|
||||
from weasyprint import HTML
|
||||
def telecharger_pdf(request: Request, facture_id: int, db: Session = Depends(get_db)):
|
||||
from weasyprint import HTML, Attachment
|
||||
from facturx import generate_from_binary
|
||||
import hashlib
|
||||
import pikepdf
|
||||
from pikepdf import Name
|
||||
import io
|
||||
|
||||
facture = db.query(Facture).get(facture_id)
|
||||
if not facture:
|
||||
raise HTTPException(status_code=404)
|
||||
|
||||
# 1. XML Factur-X
|
||||
invoice = get_invoice_data(facture_id, db)
|
||||
xml_str = generate_facturx_xml(invoice)
|
||||
xml_bytes = xml_str.encode("utf-8")
|
||||
|
||||
# 2. Rendu HTML → PDF simple (pas PDF/A-3 ici)
|
||||
html_content = templates.get_template("pdf/facture.html").render({
|
||||
"facture": facture,
|
||||
"settings": settings,
|
||||
})
|
||||
pdf_bytes = HTML(string=html_content, base_url=".").write_pdf(
|
||||
pdf_variant="pdf/a-3b",
|
||||
)
|
||||
|
||||
pdf_bytes = HTML(string=html_content, base_url=".").write_pdf()
|
||||
# 3. generate_from_binary gère :
|
||||
# - l'intégration du XML
|
||||
# - les métadonnées XMP Factur-X (DocumentType, DocumentFileName, etc.)
|
||||
# - la conformité PDF/A-3b
|
||||
pdf_bytes = generate_from_binary(
|
||||
pdf_bytes,
|
||||
xml_bytes,
|
||||
flavor="factur-x",
|
||||
level="BASIC",
|
||||
)
|
||||
|
||||
# 4. Corriger uniquement /EF/F/Subtype → /text/xml avec pikepdf
|
||||
pdf_io = io.BytesIO(pdf_bytes)
|
||||
with pikepdf.open(pdf_io) as pdf:
|
||||
names = pdf.Root.Names.EmbeddedFiles.Names
|
||||
i = 0
|
||||
while i < len(names):
|
||||
i += 1 # sauter la clé (string)
|
||||
if i < len(names):
|
||||
obj = names[i]
|
||||
try:
|
||||
obj.EF.F.Subtype = Name("/text/xml")
|
||||
except Exception:
|
||||
pass
|
||||
i += 1
|
||||
|
||||
output = io.BytesIO()
|
||||
pdf.save(output)
|
||||
pdf_bytes = output.getvalue()
|
||||
|
||||
filename = f"facture-{facture.numero}.pdf"
|
||||
|
||||
tree = build_facturx(generate_xml (facture_id, db))
|
||||
output_file = "factur-x.xml"
|
||||
tree.write(output_file, xml_declaration=True, encoding="UTF-8", pretty_print=True)
|
||||
|
||||
return Response(
|
||||
content=pdf_bytes,
|
||||
media_type="application/pdf",
|
||||
@@ -194,7 +234,7 @@ def apercu_pdf(request: Request, facture_id: int, db: Session = Depends(get_db))
|
||||
"settings": settings,
|
||||
})
|
||||
|
||||
def generate_xml(facture_id: int, db: Session):
|
||||
def get_invoice_data(facture_id: int, db: Session):
|
||||
facture = db.query(Facture).get(facture_id)
|
||||
invoice = Invoice(
|
||||
number=facture.numero,
|
||||
@@ -228,11 +268,8 @@ def generate_xml(facture_id: int, db: Session):
|
||||
),
|
||||
),
|
||||
|
||||
|
||||
|
||||
payment_means_code="30", # 30 = virement bancaire
|
||||
iban=settings.asso_iban,
|
||||
bic=settings.asso_bic,
|
||||
payment_reference=facture.devis_origine.numero,
|
||||
)
|
||||
|
||||
@@ -243,6 +280,7 @@ def generate_xml(facture_id: int, db: Session):
|
||||
quantity=l.quantite,
|
||||
unit_code="C62",
|
||||
unit_price=l.prix_unitaire_ht,
|
||||
vat_category="E",
|
||||
vat_rate=0.0,
|
||||
))
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ Helper pour injecter automatiquement current_user dans le contexte Jinja2.
|
||||
"""
|
||||
from fastapi import Request
|
||||
from fastapi.templating import Jinja2Templates
|
||||
from starlette.responses import HTMLResponse
|
||||
from starlette.responses import HTMLResponse, Response
|
||||
|
||||
|
||||
def render(templates: Jinja2Templates, template_name: str,
|
||||
|
||||
@@ -4,10 +4,22 @@
|
||||
<meta charset="UTF-8">
|
||||
<style>
|
||||
@page {
|
||||
|
||||
size: A4;
|
||||
margin: 1.5cm 1.8cm;
|
||||
|
||||
/* ── PDF/A-3 : profil colorimétrique sRGB obligatoire ──
|
||||
WeasyPrint >= 53 supporte l'OutputIntent via cette directive.
|
||||
Téléchargez sRGB_v4_ICC_preference.icc depuis ICC et placez-le
|
||||
dans static/icc/ ou utilisez le chemin absolu. */
|
||||
@pdf-output-intent url('/static/icc/sRGB_v4_ICC_preference.icc');
|
||||
}
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
-webkit-print-color-adjust: exact;
|
||||
}
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body {
|
||||
font-family: 'DejaVu Sans', Arial, sans-serif;
|
||||
font-size: 10pt;
|
||||
@@ -26,8 +38,11 @@
|
||||
color: #2c3e50;
|
||||
margin-bottom: 0.3em;
|
||||
}
|
||||
.emetteur p { font-size: 9pt; color: #555; line-height: 1.6; }
|
||||
|
||||
.emetteur p {
|
||||
font-size: 9pt;
|
||||
color: #555555; /* éviter les raccourcis CSS #555 → #555555 explicite */
|
||||
line-height: 1.6;
|
||||
}
|
||||
.facture-titre {
|
||||
text-align: right;
|
||||
}
|
||||
@@ -40,12 +55,12 @@
|
||||
.facture-titre .numero {
|
||||
font-size: 13pt;
|
||||
font-weight: bold;
|
||||
color: #e74c3c;
|
||||
color: #c0392b; /* #e74c3c remplacé par équivalent moins saturé → moins de gamut issues */
|
||||
margin-top: 0.2em;
|
||||
}
|
||||
.facture-titre .dates {
|
||||
font-size: 9pt;
|
||||
color: #555;
|
||||
color: #555555;
|
||||
margin-top: 0.5em;
|
||||
line-height: 1.8;
|
||||
}
|
||||
@@ -66,7 +81,7 @@
|
||||
font-size: 8pt;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 1px;
|
||||
color: #888;
|
||||
color: #888888;
|
||||
margin-bottom: 0.7em;
|
||||
border-bottom: 1px solid #eee;
|
||||
padding-bottom: 0.4em;
|
||||
@@ -128,7 +143,7 @@
|
||||
|
||||
.tva-mention {
|
||||
font-size: 8.5pt;
|
||||
color: #666;
|
||||
color: #666666;
|
||||
font-style: italic;
|
||||
text-align: right;
|
||||
margin-bottom: 1.5em;
|
||||
@@ -138,7 +153,7 @@
|
||||
border-top: 1px solid #ddd;
|
||||
padding-top: 1em;
|
||||
font-size: 8.5pt;
|
||||
color: #555;
|
||||
color: #555555;
|
||||
line-height: 1.7;
|
||||
}
|
||||
.footer-info .conditions {
|
||||
@@ -146,7 +161,7 @@
|
||||
}
|
||||
.footer-info .penalites {
|
||||
font-size: 8pt;
|
||||
color: #888;
|
||||
color: #888888;
|
||||
}
|
||||
.footer-info .iban {
|
||||
margin-top: 0.5em;
|
||||
@@ -155,7 +170,7 @@
|
||||
|
||||
.devis-ref {
|
||||
font-size: 8.5pt;
|
||||
color: #888;
|
||||
color: #888888;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
|
||||
@@ -165,7 +180,7 @@
|
||||
padding: 0.7em 1em;
|
||||
font-size: 9pt;
|
||||
margin-bottom: 1.5em;
|
||||
color: #444;
|
||||
color: #444444;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
|
||||
176
templates/xml/factur-x-basic.xml.j2
Normal file
176
templates/xml/factur-x-basic.xml.j2
Normal file
@@ -0,0 +1,176 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<rsm:CrossIndustryInvoice
|
||||
xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
|
||||
xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
|
||||
xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
|
||||
xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
|
||||
|
||||
<!-- 1. CONTEXTE -->
|
||||
<rsm:ExchangedDocumentContext>
|
||||
<ram:GuidelineSpecifiedDocumentContextParameter>
|
||||
<ram:ID>urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:basic</ram:ID>
|
||||
</ram:GuidelineSpecifiedDocumentContextParameter>
|
||||
</rsm:ExchangedDocumentContext>
|
||||
|
||||
<!-- 2. EN-TÊTE FACTURE -->
|
||||
<rsm:ExchangedDocument>
|
||||
<ram:ID>{{ invoice.number }}</ram:ID>
|
||||
<ram:TypeCode>{{ invoice.type_code }}</ram:TypeCode>
|
||||
<ram:IssueDateTime>
|
||||
<udt:DateTimeString format="102">{{ invoice.issue_date | datefmt }}</udt:DateTimeString>
|
||||
</ram:IssueDateTime>
|
||||
{% if invoice.note %}
|
||||
<ram:IncludedNote>
|
||||
<ram:Content>{{ invoice.note }}</ram:Content>
|
||||
</ram:IncludedNote>
|
||||
{% endif %}
|
||||
</rsm:ExchangedDocument>
|
||||
|
||||
<!-- 3. TRANSACTION COMMERCIALE -->
|
||||
<rsm:SupplyChainTradeTransaction>
|
||||
|
||||
<!-- 3a. Lignes de facture -->
|
||||
{% for line in invoice.lines %}
|
||||
<ram:IncludedSupplyChainTradeLineItem>
|
||||
<ram:AssociatedDocumentLineDocument>
|
||||
<ram:LineID>{{ line.line_id }}</ram:LineID>
|
||||
</ram:AssociatedDocumentLineDocument>
|
||||
<ram:SpecifiedTradeProduct>
|
||||
<ram:Name>{{ line.description }}</ram:Name>
|
||||
</ram:SpecifiedTradeProduct>
|
||||
<ram:SpecifiedLineTradeAgreement>
|
||||
<ram:NetPriceProductTradePrice>
|
||||
<ram:ChargeAmount>{{ line.unit_price | amount }}</ram:ChargeAmount>
|
||||
</ram:NetPriceProductTradePrice>
|
||||
</ram:SpecifiedLineTradeAgreement>
|
||||
<ram:SpecifiedLineTradeDelivery>
|
||||
<ram:BilledQuantity unitCode="{{ line.unit_code }}">{{ line.quantity | amount }}</ram:BilledQuantity>
|
||||
</ram:SpecifiedLineTradeDelivery>
|
||||
<ram:SpecifiedLineTradeSettlement>
|
||||
<ram:ApplicableTradeTax>
|
||||
<ram:TypeCode>VAT</ram:TypeCode>
|
||||
<ram:CategoryCode>{{ line.vat_category }}</ram:CategoryCode>
|
||||
<ram:RateApplicablePercent>{{ line.vat_rate | amount }}</ram:RateApplicablePercent>
|
||||
</ram:ApplicableTradeTax>
|
||||
<ram:SpecifiedTradeSettlementLineMonetarySummation>
|
||||
<ram:LineTotalAmount>{{ (line.quantity * line.unit_price) | amount }}</ram:LineTotalAmount>
|
||||
</ram:SpecifiedTradeSettlementLineMonetarySummation>
|
||||
</ram:SpecifiedLineTradeSettlement>
|
||||
</ram:IncludedSupplyChainTradeLineItem>
|
||||
{% endfor %}
|
||||
|
||||
<!-- 3b. Accord commercial -->
|
||||
<ram:ApplicableHeaderTradeAgreement>
|
||||
|
||||
<ram:SellerTradeParty>
|
||||
<ram:Name>{{ seller.name }}</ram:Name>
|
||||
{% if seller.siret %}
|
||||
<ram:SpecifiedLegalOrganization>
|
||||
<ram:ID schemeID="0002">{{ seller.siret }}</ram:ID>
|
||||
</ram:SpecifiedLegalOrganization>
|
||||
{% endif %}
|
||||
{% if seller.address %}
|
||||
<ram:PostalTradeAddress>
|
||||
<ram:PostcodeCode>{{ seller.address.postcode }}</ram:PostcodeCode>
|
||||
<ram:LineOne>{{ seller.address.line1 }}</ram:LineOne>
|
||||
{% if seller.address.line2 %}
|
||||
<ram:LineTwo>{{ seller.address.line2 }}</ram:LineTwo>
|
||||
{% endif %}
|
||||
<ram:CityName>{{ seller.address.city }}</ram:CityName>
|
||||
<ram:CountryID>{{ seller.address.country_code }}</ram:CountryID>
|
||||
</ram:PostalTradeAddress>
|
||||
{% endif %}
|
||||
{% if seller.vat_id %}
|
||||
<ram:SpecifiedTaxRegistration>
|
||||
<ram:ID schemeID="VA">{{ seller.vat_id }}</ram:ID>
|
||||
</ram:SpecifiedTaxRegistration>
|
||||
{% elif seller.siret %}
|
||||
{# Franchise TVA (art. 293 B CGI) : pas de n° TVA, on utilise le SIRET avec schemeID="FC" #}
|
||||
<ram:SpecifiedTaxRegistration>
|
||||
<ram:ID schemeID="FC">{{ seller.siret }}</ram:ID>
|
||||
</ram:SpecifiedTaxRegistration>
|
||||
{% endif %}
|
||||
</ram:SellerTradeParty>
|
||||
|
||||
<ram:BuyerTradeParty>
|
||||
<ram:Name>{{ buyer.name }}</ram:Name>
|
||||
{% if buyer.siret %}
|
||||
<ram:SpecifiedLegalOrganization>
|
||||
<ram:ID schemeID="0002">{{ buyer.siret }}</ram:ID>
|
||||
</ram:SpecifiedLegalOrganization>
|
||||
{% endif %}
|
||||
{% if buyer.address %}
|
||||
<ram:PostalTradeAddress>
|
||||
<ram:PostcodeCode>{{ buyer.address.postcode }}</ram:PostcodeCode>
|
||||
<ram:LineOne>{{ buyer.address.line1 }}</ram:LineOne>
|
||||
{% if buyer.address.line2 %}
|
||||
<ram:LineTwo>{{ buyer.address.line2 }}</ram:LineTwo>
|
||||
{% endif %}
|
||||
<ram:CityName>{{ buyer.address.city }}</ram:CityName>
|
||||
<ram:CountryID>{{ buyer.address.country_code }}</ram:CountryID>
|
||||
</ram:PostalTradeAddress>
|
||||
{% endif %}
|
||||
</ram:BuyerTradeParty>
|
||||
|
||||
{% if invoice.payment_reference %}
|
||||
<ram:BuyerOrderReferencedDocument>
|
||||
<ram:IssuerAssignedID>{{ invoice.payment_reference }}</ram:IssuerAssignedID>
|
||||
</ram:BuyerOrderReferencedDocument>
|
||||
{% endif %}
|
||||
|
||||
</ram:ApplicableHeaderTradeAgreement>
|
||||
|
||||
<!-- 3c. Livraison -->
|
||||
<ram:ApplicableHeaderTradeDelivery>
|
||||
<ram:ShipToTradeParty>
|
||||
<ram:Name>{{ buyer.name }}</ram:Name>
|
||||
</ram:ShipToTradeParty>
|
||||
</ram:ApplicableHeaderTradeDelivery>
|
||||
|
||||
<!-- 3d. Règlement -->
|
||||
<ram:ApplicableHeaderTradeSettlement>
|
||||
<ram:InvoiceCurrencyCode>{{ invoice.currency }}</ram:InvoiceCurrencyCode>
|
||||
|
||||
<ram:SpecifiedTradeSettlementPaymentMeans>
|
||||
<ram:TypeCode>{{ invoice.payment_means_code }}</ram:TypeCode>
|
||||
{% if invoice.iban %}
|
||||
<ram:PayeePartyCreditorFinancialAccount>
|
||||
<ram:IBANID>{{ invoice.iban }}</ram:IBANID>
|
||||
</ram:PayeePartyCreditorFinancialAccount>
|
||||
{% endif %}
|
||||
</ram:SpecifiedTradeSettlementPaymentMeans>
|
||||
|
||||
{% for tax in invoice.tax_lines %}
|
||||
<ram:ApplicableTradeTax>
|
||||
<ram:CalculatedAmount>{{ tax.amount | amount }}</ram:CalculatedAmount>
|
||||
<ram:TypeCode>VAT</ram:TypeCode>
|
||||
{% if tax.exemption_reason %}
|
||||
<ram:ExemptionReason>{{ tax.exemption_reason }}</ram:ExemptionReason>
|
||||
{% endif %}
|
||||
<ram:BasisAmount>{{ tax.base_amount | amount }}</ram:BasisAmount>
|
||||
<ram:CategoryCode>{{ tax.category }}</ram:CategoryCode>
|
||||
<ram:RateApplicablePercent>{{ tax.rate | amount }}</ram:RateApplicablePercent>
|
||||
</ram:ApplicableTradeTax>
|
||||
{% endfor %}
|
||||
|
||||
{% if invoice.due_date %}
|
||||
<ram:SpecifiedTradePaymentTerms>
|
||||
<ram:DueDateDateTime>
|
||||
<udt:DateTimeString format="102">{{ invoice.due_date | datefmt }}</udt:DateTimeString>
|
||||
</ram:DueDateDateTime>
|
||||
</ram:SpecifiedTradePaymentTerms>
|
||||
{% endif %}
|
||||
|
||||
<ram:SpecifiedTradeSettlementHeaderMonetarySummation>
|
||||
<ram:LineTotalAmount>{{ invoice.total_ht | amount }}</ram:LineTotalAmount>
|
||||
<ram:TaxBasisTotalAmount>{{ invoice.total_ht | amount }}</ram:TaxBasisTotalAmount>
|
||||
<ram:TaxTotalAmount currencyID="{{ invoice.currency }}">{{ invoice.total_tva | amount }}</ram:TaxTotalAmount>
|
||||
<ram:GrandTotalAmount>{{ invoice.total_ttc | amount }}</ram:GrandTotalAmount>
|
||||
<ram:DuePayableAmount>{{ invoice.total_ttc | amount }}</ram:DuePayableAmount>
|
||||
</ram:SpecifiedTradeSettlementHeaderMonetarySummation>
|
||||
|
||||
</ram:ApplicableHeaderTradeSettlement>
|
||||
|
||||
</rsm:SupplyChainTradeTransaction>
|
||||
</rsm:CrossIndustryInvoice>
|
||||
Reference in New Issue
Block a user