Skip to main content

Ajouter et utiliser les standards UBL

Le module base_ubl, comme son nom l'indique, est le module de base pour l'implémentation de la norme Universal Business Language (UBL). Le standard UBL est devenu le standard ISO/IEC 19845 en janvier 2016 (cf l'annonce officielle).

Ce module contient des méthodes pour générer et analyser les fichiers UBL. Ce module ne fait rien d'utile en lui-même, mais il est utilisé par plusieurs autres modules :

    • purchase_order_ubl qui génère des bons de commande UBL,
    • sale_order_import_ubl qui importe les commandes de vente UBL.
    • account_invoice_import_ubl qui importe les factures UBL,

Le module base_ubl installe et dépend de 3 modules qui seront explicités ci-dessous :

1. account_tax_unece

Ce module ajoute deux champs Code Type UNECE (CEE-ONU) et Code Catégorie UNECE (CEE-ONU) sur les taxes pour permettre l'utilisation des normes écrites par la Commission économique des Nations Unies pour l'Europe (qui compte 56 états membres en Europe, Amérique et Asie centrale, cf Wikipedia) :

    • Le code de type de taxe UNECE est défini dans le DataElement 5153,
    • Le code de la catégorie de taxe UNECE est défini dans le DataElement 5305.

Cette codification fait partie de l'UNCL (United Nations Code List). Cette codification est utilisée par exemple dans les deux principales normes internationales pour la facturation électronique :

Pour y accéder,

  • Allez dans le menu Facturation < Configuration < "Comptabilité" < Taxes.
  • Cliquez sur "Créer" et allez des les Options avancées
  • Définissez le champ Code Type CEE-ONU (la valeur devrait être TVA pour la plupart de vos taxes).
  • Définissez le champ Code de catégorie CEE-ONU.

image-1618910048326.png

2. uom_unece

Ce module ajoute un champ UNCE Code (CEE-ONU) sur les unités de mesure pour permettre l'utilisation de la norme rédigée par la Commission économique des Nations Unies pour l'Europe (qui compte 56 Etats membres en Europe, Amérique et Asie centrale, cf. Wikipedia). La codification des unités de mesure est définie dans la recommandation numéro 20 de l'UNECE/CEFACT sur la facilitation des échanges (lien direct avec la révision 12).

Cette codification est utilisée par exemple dans les deux principales normes internationales pour la facturation électronique :

    • Cross Industry Invoice (CII),
    • Universal Business Language (UBL).

image-1618910714463.png

3. base_vat_sanitized

Ce module ajoute un champ technique sanitized_vat sur les partenaires qui stocke le numéro de TVA sans espaces et avec des lettres en majuscules. Il est utile pour d'autres modules qui ont besoin de faire correspondre les partenaires sur le numéro de TVA, comme le module base_business_document_import par exemple.

 

4. Exporter massivement les UBL

Le module account_invoice_ubl_mass_download doit être installé. Ce module permet de générer dans un seul zip :

  • les UBL
  • les PDF

des factures sélectionnées.

Un fichier xml/pdf par facture est généré.

Sélectionnez les factures souhaitées, puis cliquez sur Action < Factures UBL XML et PDF (zip). 2.png