Documentation Factur-X - Ajout de champs personnalisés pour Odoo 16.0

Documentation Factur-X - Ajout de champs personnalisés pour Odoo 16.0

Secteur : Menuiserie - Vente de fenêtres

Table des matières

  1. Champs personnalisés sur l’en-tête
  2. Champs personnalisés sur les lignes
  3. Tables de référence et codes
  4. Exemples complets fenêtres

1. Champs personnalisés sur l’en-tête {#champs-entete}

1.1. EAN Client - Méthode GlobalID (RECOMMANDÉ)

Emplacement XML : <ram:BuyerTradeParty>

<ram:ApplicableHeaderTradeAgreement>
  <ram:BuyerTradeParty>
    <ram:ID>CLIENT_001</ram:ID>
    
    <!-- EAN CLIENT - MÉTHODE RECOMMANDÉE -->
    <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
    
    <ram:Name>SARL MENUISERIE DUPONT</ram:Name>
    <ram:PostalTradeAddress>
      <ram:PostcodeCode>69001</ram:PostcodeCode>
      <ram:LineOne>25 avenue de la République</ram:LineOne>
      <ram:CityName>Lyon</ram:CityName>
      <ram:CountryID>FR</ram:CountryID>
    </ram:PostalTradeAddress>
  </ram:BuyerTradeParty>
</ram:ApplicableHeaderTradeAgreement>

Pourquoi cette méthode ?

  • ✅ Standard ISO/IEC 6523
  • ✅ Validation garantie par tous les validateurs
  • ✅ Champ prévu par la norme pour identifiants globaux
  • ✅ schemeID="0160" = code officiel pour GTIN/EAN

1.2. EAN Client - Méthode alternative via IncludedNote

Emplacement XML : <rsm:ExchangedDocument>

<rsm:ExchangedDocument>
  <ram:ID>FA-2024-001</ram:ID>
  <ram:TypeCode>380</ram:TypeCode>
  <ram:IssueDateTime>
    <udt:DateTimeString format="102">20241001</udt:DateTimeString>
  </ram:IssueDateTime>
  
  <!-- EAN CLIENT - MÉTHODE ALTERNATIVE -->
  <ram:IncludedNote>
    <ram:Content>EAN_CLIENT:3401234567890</ram:Content>
    <ram:SubjectCode>AAK</ram:SubjectCode>
  </ram:IncludedNote>
</rsm:ExchangedDocument>

Quand l’utiliser ?

  • Si vous avez besoin de stocker plusieurs identifiants
  • Pour des notes supplémentaires non structurées
  • Moins recommandé que GlobalID pour les EAN

1.3. EAN Client - Méthode via AdditionalReferencedDocument

Emplacement XML : <ram:ApplicableHeaderTradeAgreement>

<ram:ApplicableHeaderTradeAgreement>
  <ram:BuyerReference>BC-2024-123</ram:BuyerReference>
  
  <!-- EAN CLIENT - MÉTHODE DOCUMENT DE RÉFÉRENCE -->
  <ram:AdditionalReferencedDocument>
    <ram:IssuerAssignedID>3401234567890</ram:IssuerAssignedID>
    <ram:TypeCode>130</ram:TypeCode>
    <ram:Name>EAN Client</ram:Name>
  </ram:AdditionalReferencedDocument>
</ram:ApplicableHeaderTradeAgreement>

2. Champs personnalisés sur les lignes {#champs-lignes}

2.1. LARGEUR et HAUTEUR - Méthode ApplicableProductCharacteristic (RECOMMANDÉ)

Emplacement XML : <ram:SpecifiedTradeProduct>

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>1</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  
  <ram:SpecifiedTradeProduct>
    <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
    <ram:SellerAssignedID>FEN-PVC-140X120</ram:SellerAssignedID>
    <ram:Name>Fenêtre PVC double vitrage 140x120cm</ram:Name>
    <ram:Description>Fenêtre PVC blanc, double vitrage 4/16/4, oscillo-battant</ram:Description>
    
    <!-- LARGEUR -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>LARGEUR</ram:Description>
      <ram:Value>140</ram:Value>
      <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <!-- HAUTEUR -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>HAUTEUR</ram:Description>
      <ram:Value>120</ram:Value>
      <ram:ValueMeasure unitCode="CMT">120</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <!-- SURFACE (calculée automatiquement) -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>SURFACE</ram:Description>
      <ram:Value>1.68</ram:Value>
      <ram:ValueMeasure unitCode="MTK">1.68</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
  </ram:SpecifiedTradeProduct>
  
  <!-- ... reste de la ligne ... -->
</ram:IncludedSupplyChainTradeLineItem>

Pourquoi cette méthode ?

  • ✅ Structurée et normalisée
  • ✅ Supporte les unités de mesure officielles
  • ✅ Facile à parser pour les systèmes destinataires
  • ✅ Validation XSD garantie

2.2. LARGEUR et HAUTEUR - Méthode alternative via IncludedNote

Emplacement XML : <ram:AssociatedDocumentLineDocument>

<ram:AssociatedDocumentLineDocument>
  <ram:LineID>1</ram:LineID>
  
  <!-- DIMENSIONS EN NOTE -->
  <ram:IncludedNote>
    <ram:Content>LARGEUR:140|HAUTEUR:120</ram:Content>
    <ram:SubjectCode>AAK</ram:SubjectCode>
  </ram:IncludedNote>
  
  <ram:IncludedNote>
    <ram:Content>Dimensions hors tout : 140cm x 120cm</ram:Content>
    <ram:SubjectCode>AAK</ram:SubjectCode>
  </ram:IncludedNote>
</ram:AssociatedDocumentLineDocument>

Quand l’utiliser ?

  • Pour des notes complémentaires en texte libre
  • Moins recommandé pour les dimensions structurées

3. Tables de référence et codes {#tables-reference}

3.1. Codes schemeID pour GlobalID (ISO/IEC 6523)

CodeDescriptionUsage
0160GTIN/EANCode produit ou identifiant client
0088GLN (Global Location Number)Code localisation EAN
0002SIREN/SIRETEntreprises françaises
0060DUNSDun & Bradstreet

Exemple d’utilisation :

<!-- EAN Client -->
<ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>

<!-- GLN Client -->
<ram:GlobalID schemeID="0088">5790001234567</ram:GlobalID>

<!-- SIRET Client -->
<ram:GlobalID schemeID="0002">12345678901234</ram:GlobalID>

3.2. Unités de mesure (UN/ECE Recommendation 20)

Longueurs

CodeUnitéDescription
CMTcmCentimètre (pour fenêtres)
MMTmmMillimètre
MTRmMètre

Surfaces

CodeUnitéDescription
CMKcm²Centimètre carré
MTKMètre carré (pour surface fenêtres)

Masses

CodeUnitéDescription
GRMgGramme
KGMkgKilogramme (pour poids fenêtres)

Quantités

CodeUnitéDescription
C62unitéPièce (nombre de fenêtres)
MTKMètre carré

Exemple d’utilisation :

<!-- Dimensions en centimètres -->
<ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>

<!-- Surface en m² -->
<ram:ValueMeasure unitCode="MTK">1.68</ram:ValueMeasure>

<!-- Poids en kg -->
<ram:ValueMeasure unitCode="KGM">45.5</ram:ValueMeasure>

<!-- Quantité en unités -->
<ram:BilledQuantity unitCode="C62">2</ram:BilledQuantity>

3.3. Codes SubjectCode pour IncludedNote (UN/EDIFACT 4451)

CodeDescriptionUsage
AAKInformations généralesChamps personnalisés, notes
REGInformations réglementairesNormes, certifications
PMTTermes de paiementConditions de paiement
AAJInformations de paiementDétails bancaires

Exemple d’utilisation :

<!-- Note générale -->
<ram:IncludedNote>
  <ram:Content>Fenêtre sur mesure, fabrication 3 semaines</ram:Content>
  <ram:SubjectCode>AAK</ram:SubjectCode>
</ram:IncludedNote>

<!-- Information réglementaire -->
<ram:IncludedNote>
  <ram:Content>Conforme RT 2012, Coefficient Uw=1.4 W/m².K</ram:Content>
  <ram:SubjectCode>REG</ram:SubjectCode>
</ram:IncludedNote>

3.4. Codes TypeCode pour AdditionalReferencedDocument (UN/EDIFACT 1001)

CodeDescriptionUsage
50Bon de commandeRéférence commande
130Numéro d’identifiantPour EAN, codes divers
916Référence contratContrats, marchés

4. Exemples complets fenêtres {#exemples-fenetres}

4.1. Exemple : Fenêtre PVC double vitrage

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>1</ram:LineID>
    <ram:IncludedNote>
      <ram:Content>Fabrication sur mesure, délai 3 semaines</ram:Content>
      <ram:SubjectCode>AAK</ram:SubjectCode>
    </ram:IncludedNote>
  </ram:AssociatedDocumentLineDocument>
  
  <ram:SpecifiedTradeProduct>
    <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
    <ram:SellerAssignedID>FEN-PVC-140X120-OB</ram:SellerAssignedID>
    <ram:Name>Fenêtre PVC blanc 140x120cm oscillo-battant</ram:Name>
    <ram:Description>Fenêtre 2 vantaux PVC blanc, double vitrage 4/16/4 argon, oscillo-battant</ram:Description>
    
    <!-- DIMENSIONS -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>LARGEUR</ram:Description>
      <ram:Value>140</ram:Value>
      <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>HAUTEUR</ram:Description>
      <ram:Value>120</ram:Value>
      <ram:ValueMeasure unitCode="CMT">120</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>SURFACE</ram:Description>
      <ram:Value>1.68</ram:Value>
      <ram:ValueMeasure unitCode="MTK">1.68</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <!-- CARACTÉRISTIQUES TECHNIQUES -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>MATERIAU</ram:Description>
      <ram:Value>PVC blanc</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>TYPE_OUVRANT</ram:Description>
      <ram:Value>Oscillo-battant 2 vantaux</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>VITRAGE</ram:Description>
      <ram:Value>Double vitrage 4/16/4 argon</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>EPAISSEUR_VITRAGE</ram:Description>
      <ram:Value>24</ram:Value>
      <ram:ValueMeasure unitCode="MMT">24</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>COEFFICIENT_THERMIQUE</ram:Description>
      <ram:Value>Uw = 1.4 W/m².K</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>ISOLATION_ACOUSTIQUE</ram:Description>
      <ram:Value>Rw = 32 dB</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>POIDS</ram:Description>
      <ram:Value>45.5</ram:Value>
      <ram:ValueMeasure unitCode="KGM">45.5</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>NORME</ram:Description>
      <ram:Value>NF EN 14351-1, Marquage CE</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>CERTIFICATION</ram:Description>
      <ram:Value>Certifié CEKAL</ram:Value>
    </ram:ApplicableProductCharacteristic>
  </ram:SpecifiedTradeProduct>
  
  <ram:SpecifiedLineTradeAgreement>
    <ram:NetPriceProductTradePrice>
      <ram:ChargeAmount>850.00</ram:ChargeAmount>
    </ram:NetPriceProductTradePrice>
  </ram:SpecifiedLineTradeAgreement>
  
  <ram:SpecifiedLineTradeDelivery>
    <ram:BilledQuantity unitCode="C62">2</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
  
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:TypeCode>VAT</ram:TypeCode>
      <ram:CategoryCode>S</ram:CategoryCode>
      <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
    </ram:ApplicableTradeTax>
    <ram:SpecifiedTradeSettlementLineMonetarySummation>
      <ram:LineTotalAmount>1700.00</ram:LineTotalAmount>
    </ram:SpecifiedTradeSettlementLineMonetarySummation>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>

4.2. Exemple : Porte-fenêtre coulissante

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>2</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  
  <ram:SpecifiedTradeProduct>
    <ram:GlobalID schemeID="0160">3401234567891</ram:GlobalID>
    <ram:SellerAssignedID>PF-ALU-240X215-COUL</ram:SellerAssignedID>
    <ram:Name>Porte-fenêtre aluminium 240x215cm coulissante</ram:Name>
    <ram:Description>Porte-fenêtre 3 vantaux aluminium gris anthracite, coulissante à galandage</ram:Description>
    
    <!-- DIMENSIONS -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>LARGEUR</ram:Description>
      <ram:Value>240</ram:Value>
      <ram:ValueMeasure unitCode="CMT">240</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>HAUTEUR</ram:Description>
      <ram:Value>215</ram:Value>
      <ram:ValueMeasure unitCode="CMT">215</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>SURFACE</ram:Description>
      <ram:Value>5.16</ram:Value>
      <ram:ValueMeasure unitCode="MTK">5.16</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <!-- CARACTÉRISTIQUES TECHNIQUES -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>MATERIAU</ram:Description>
      <ram:Value>Aluminium thermolaqué gris anthracite RAL 7016</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>TYPE_OUVRANT</ram:Description>
      <ram:Value>Coulissant à galandage 3 vantaux</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>VITRAGE</ram:Description>
      <ram:Value>Double vitrage feuilleté 44.2/16/4 argon</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>COEFFICIENT_THERMIQUE</ram:Description>
      <ram:Value>Uw = 1.3 W/m².K</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>ISOLATION_ACOUSTIQUE</ram:Description>
      <ram:Value>Rw = 37 dB</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>POIDS</ram:Description>
      <ram:Value>125.0</ram:Value>
      <ram:ValueMeasure unitCode="KGM">125.0</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>SECURITE</ram:Description>
      <ram:Value>Vitrage retardateur d'effraction P4A</ram:Value>
    </ram:ApplicableProductCharacteristic>
  </ram:SpecifiedTradeProduct>
  
  <ram:SpecifiedLineTradeAgreement>
    <ram:NetPriceProductTradePrice>
      <ram:ChargeAmount>2450.00</ram:ChargeAmount>
    </ram:NetPriceProductTradePrice>
  </ram:SpecifiedLineTradeAgreement>
  
  <ram:SpecifiedLineTradeDelivery>
    <ram:BilledQuantity unitCode="C62">1</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
  
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:TypeCode>VAT</ram:TypeCode>
      <ram:CategoryCode>S</ram:CategoryCode>
      <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
    </ram:ApplicableTradeTax>
    <ram:SpecifiedTradeSettlementLineMonetarySummation>
      <ram:LineTotalAmount>2450.00</ram:LineTotalAmount>
    </ram:SpecifiedTradeSettlementLineMonetarySummation>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>

4.3. Exemple : Fenêtre de toit / Velux

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>3</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  
  <ram:SpecifiedTradeProduct>
    <ram:GlobalID schemeID="0160">3401234567892</ram:GlobalID>
    <ram:SellerAssignedID>VELUX-78X140-PROJ</ram:SellerAssignedID>
    <ram:Name>Fenêtre de toit 78x140cm à projection</ram:Name>
    <ram:Description>Fenêtre de toit rotation/projection PVC blanc, double vitrage</ram:Description>
    
    <!-- DIMENSIONS -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>LARGEUR</ram:Description>
      <ram:Value>78</ram:Value>
      <ram:ValueMeasure unitCode="CMT">78</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>HAUTEUR</ram:Description>
      <ram:Value>140</ram:Value>
      <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>SURFACE</ram:Description>
      <ram:Value>1.09</ram:Value>
      <ram:ValueMeasure unitCode="MTK">1.09</ram:ValueMeasure>
    </ram:ApplicableProductCharacteristic>
    
    <!-- CARACTÉRISTIQUES TECHNIQUES -->
    <ram:ApplicableProductCharacteristic>
      <ram:Description>TYPE_OUVRANT</ram:Description>
      <ram:Value>Rotation/projection</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>VITRAGE</ram:Description>
      <ram:Value>Double vitrage 4/16/4 argon</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>COEFFICIENT_THERMIQUE</ram:Description>
      <ram:Value>Uw = 1.2 W/m².K</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>PENTE_TOIT</ram:Description>
      <ram:Value>15° à 90°</ram:Value>
    </ram:ApplicableProductCharacteristic>
    
    <ram:ApplicableProductCharacteristic>
      <ram:Description>ACCESSOIRES_INCLUS</ram:Description>
      <ram:Value>Store occultant, raccord d'étanchéité EHV</ram:Value>
    </ram:ApplicableProductCharacteristic>
  </ram:SpecifiedTradeProduct>
  
  <ram:SpecifiedLineTradeAgreement>
    <ram:NetPriceProductTradePrice>
      <ram:ChargeAmount>650.00</ram:ChargeAmount>
    </ram:NetPriceProductTradePrice>
  </ram:SpecifiedLineTradeAgreement>
  
  <ram:SpecifiedLineTradeDelivery>
    <ram:BilledQuantity unitCode="C62">1</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
  
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:TypeCode>VAT</ram:TypeCode>
      <ram:CategoryCode>S</ram:CategoryCode>
      <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
    </ram:ApplicableTradeTax>
    <ram:SpecifiedTradeSettlementLineMonetarySummation>
      <ram:LineTotalAmount>650.00</ram:LineTotalAmount>
    </ram:SpecifiedTradeSettlementLineMonetarySummation>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>

4.4. Facture complète avec EAN client + 3 fenêtres

<?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">
  
  <rsm:ExchangedDocumentContext>
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:extended</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>
  
  <rsm:ExchangedDocument>
    <ram:ID>FA-2024-1523</ram:ID>
    <ram:TypeCode>380</ram:TypeCode>
    <ram:IssueDateTime>
      <udt:DateTimeString format="102">20241001</udt:DateTimeString>
    </ram:IssueDateTime>
  </rsm:ExchangedDocument>
  
  <rsm:SupplyChainTradeTransaction>
    <ram:ApplicableHeaderTradeAgreement>
      <ram:BuyerReference>BC-2024-789</ram:BuyerReference>
      
      <!-- VENDEUR -->
      <ram:SellerTradeParty>
        <ram:ID>VENDEUR_001</ram:ID>
        <ram:Name>FENÊTRES PRO SAS</ram:Name>
        <ram:PostalTradeAddress>
          <ram:PostcodeCode>69100</ram:PostcodeCode>
          <ram:LineOne>15 rue de l'Industrie</ram:LineOne>
          <ram:CityName>Villeurbanne</ram:CityName>
          <ram:CountryID>FR</ram:CountryID>
        </ram:PostalTradeAddress>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">FR12345678901</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:SellerTradeParty>
      
      <!-- CLIENT AVEC EAN -->
      <ram:BuyerTradeParty>
        <ram:ID>CLIENT_DUPONT</ram:ID>
        <!-- ✅ EAN CLIENT - MÉTHODE RECOMMANDÉE -->
        <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
        <ram:Name>SARL MENUISERIE DUPONT</ram:Name>
        <ram:PostalTradeAddress>
          <ram:PostcodeCode>69001</ram:PostcodeCode>
          <ram:LineOne>25 avenue de la République</ram:LineOne>
          <ram:CityName>Lyon</ram:CityName>
          <ram:CountryID>FR</ram:CountryID>
        </ram:PostalTradeAddress>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">FR98765432109</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:BuyerTradeParty>
    </ram:ApplicableHeaderTradeAgreement>
    
    <ram:ApplicableHeaderTradeDelivery>
      <ram:ActualDeliverySupplyChainEvent>
        <ram:OccurrenceDateTime>
          <udt:DateTimeString format="102">20240925</udt:DateTimeString>
        </ram:OccurrenceDateTime>
      </ram:ActualDeliverySupplyChainEvent>
    </ram:ApplicableHeaderTradeDelivery>
    
    <ram:ApplicableHeaderTradeSettlement>
      <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
      
      <!-- TVA 10% -->
      <ram:ApplicableTradeTax>
        <ram:CalculatedAmount>480.00</ram:CalculatedAmount>
        <ram:TypeCode>VAT</ram:TypeCode>
        <ram:BasisAmount>4800.00</ram:BasisAmount>
        <ram:CategoryCode>S</ram:CategoryCode>
        <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
      </ram:ApplicableTradeTax>
      
      <ram:SpecifiedTradePaymentTerms>
        <ram:Description>Paiement à 30 jours fin de mois</ram:Description>
        <ram:DueDateDateTime>
          <udt:DateTimeString format="102">20241031</udt:DateTimeString>
        </ram:DueDateDateTime>
      </ram:SpecifiedTradePaymentTerms>
      
      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
        <ram:LineTotalAmount>4800.00</ram:LineTotalAmount>
        <ram:TaxBasisTotalAmount>4800.00</ram:TaxBasisTotalAmount>
        <ram:TaxTotalAmount currencyID="EUR">480.00</ram:TaxTotalAmount>
        <ram:GrandTotalAmount>5280.00</ram:GrandTotalAmount>
        <ram:DuePayableAmount>5280.00</ram:DuePayableAmount>
      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
    </ram:ApplicableHeaderTradeSettlement>
    
    <!-- LIGNE 1 : Fenêtre PVC 140x120 -->
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>1</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      
      <ram:SpecifiedTradeProduct>
        <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
        <ram:SellerAssignedID>FEN-PVC-140X120-OB</ram:SellerAssignedID>
        <ram:Name>Fenêtre PVC 140x120cm oscillo-battant</ram:Name>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>LARGEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>HAUTEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">120</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
      </ram:SpecifiedTradeProduct>
      
      <ram:SpecifiedLineTradeAgreement>
        <ram:NetPriceProductTradePrice>
          <ram:ChargeAmount>850.00</ram:ChargeAmount>
        </ram:NetPriceProductTradePrice>
      </ram:SpecifiedLineTradeAgreement>
      
      <ram:SpecifiedLineTradeDelivery>
        <ram:BilledQuantity unitCode="C62">2</ram:BilledQuantity>
      </ram:SpecifiedLineTradeDelivery>
      
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>1700.00</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>
    
    <!-- LIGNE 2 : Porte-fenêtre 240x215 -->
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>2</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      
      <ram:SpecifiedTradeProduct>
        <ram:GlobalID schemeID="0160">3401234567891</ram:GlobalID>
        <ram:SellerAssignedID>PF-ALU-240X215-COUL</ram:SellerAssignedID>
        <ram:Name>Porte-fenêtre alu 240x215cm coulissante</ram:Name>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>LARGEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">240</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>HAUTEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">215</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
      </ram:SpecifiedTradeProduct>
      
      <ram:SpecifiedLineTradeAgreement>
        <ram:NetPriceProductTradePrice>
          <ram:ChargeAmount>2450.00</ram:ChargeAmount>
        </ram:NetPriceProductTradePrice>
      </ram:SpecifiedLineTradeAgreement>
      
      <ram:SpecifiedLineTradeDelivery>
        <ram:BilledQuantity unitCode="C62">1</ram:BilledQuantity>
      </ram:SpecifiedLineTradeDelivery>
      
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>2450.00</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>
    
    <!-- LIGNE 3 : Velux 78x140 -->
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>3</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      
      <ram:SpecifiedTradeProduct>
        <ram:GlobalID schemeID="0160">3401234567892</ram:GlobalID>
        <ram:SellerAssignedID>VELUX-78X140-PROJ</ram:SellerAssignedID>
        <ram:Name>Fenêtre de toit 78x140cm projection</ram:Name>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>LARGEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">78</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
        
        <ram:ApplicableProductCharacteristic>
          <ram:Description>HAUTEUR</ram:Description>
          <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
        </ram:ApplicableProductCharacteristic>
      </ram:SpecifiedTradeProduct>
      
      <ram:SpecifiedLineTradeAgreement>
        <ram:NetPriceProductTradePrice>
          <ram:ChargeAmount>650.00</ram:ChargeAmount>
        </ram:NetPriceProductTradePrice>
      </ram:SpecifiedLineTradeAgreement>
      
      <ram:SpecifiedLineTradeDelivery>
        <ram:BilledQuantity unitCode="C62">1</ram:BilledQuantity>
      </ram:SpecifiedLineTradeDelivery>
      
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>10.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>650.00</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>
    
  </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Récapitulatif rapide

✅ Pour l’EAN client (en-tête)

Méthode recommandée :

<ram:BuyerTradeParty>
  <ram:GlobalID schemeID="0160">3401234567890</ram:GlobalID>
</ram:BuyerTradeParty>

✅ Pour LARGEUR et HAUTEUR (lignes)

Méthode recommandée :

<ram:SpecifiedTradeProduct>
  <ram:ApplicableProductCharacteristic>
    <ram:Description>LARGEUR</ram:Description>
    <ram:ValueMeasure unitCode="CMT">140</ram:ValueMeasure>
  </ram:ApplicableProductCharacteristic>
  
  <ram:ApplicableProductCharacteristic>
    <ram:Description>HAUTEUR</ram:Description>
    <ram:ValueMeasure unitCode="CMT">120</ram:ValueMeasure>
  </ram:ApplicableProductCharacteristic>
</ram:SpecifiedTradeProduct>

📋 Codes essentiels

  • schemeID pour EAN : 0160
  • Unité centimètres : CMT
  • Unité m² : MTK
  • Unité kg : KGM
  • Unité pièce : C62
  • TVA réduite fenêtres : 10.00 (rénovation énergétique)

Document généré pour Odoo 16.0 - Secteur Menuiserie