UBL bestanden verwerken in Venice

(Last Updated On: 23 maart 2022)

Venice ondersteunt algemeen UBL 2.0 en UBL 2.1 zowel aan de exportkant als aan de importkant.  Ook via elektronische documenten worden deze UBL bestanden correct verwerkt.  Daarbovenop worden ook de volgende 4 onderliggende formaten ondersteund/aanvaard in Venice.

  • eFFF v1
  • eFFF v3
  • Peppol BIS 2
  • Peppol BIS 3

Om geimporteerd te kunnen worden moet het bestand minimaal voldoen aan het UBL 2.0 of UBL 2.1 schema (zie lager testen Ecosio) door “UBL Invoice 2.0” (ook voor CN), “UBL Invoice 2.1” of “UBL Creditnote 2.1” te kiezen.   

Bij import in Verkopen gelden de extra regels na te zien in de de parameters om te voldoen aan een geldig bestand.  Dat gaat dan bijvoorbeeld over het overnemen van omzetrekening, klantennummers, … uit het UBL bestand.  Deze parameters vragen extra tags in het UBL bestand om de gegevens te kunnen ophalen.  Deze zaken uit het bestand halen is in de meeste gevallen enkel nuttig voor B2B communicatie (bedrijf naar accountant/boekhouder)

Bestanden die niet valideren of waar tags ontbreken worden geweigerd en worden gezien als ongeldig UBL-formaat.

Het is ook belangrijk dat de UBL bestanden uniek zijn dus een unieke ID hebben.  Het gaat over de tag <cbc:ID></cbc:ID> in het UBL document en over het veld ‘Verkoop.Identificatie goederendocument’ in de module ‘Verkopen’.    Als dat niet het geval is zal het bestand ook geweigerd worden

Daarnaast zijn er ook bestanden  die “beweren” een UBL 2.0, UBL 2.1 of 1 van de 4 ondersteunde formaten te zijn (volgens de UBLVersionID, CustomizationID en/of ProfileID).   Maar vervolgens niet de rest van de specificaties/standaard correct volgen.  Dat zorgt ervoor dat niet alle info correct kan overgenomen worden in Venice.

UBL bestanden en onderliggende formaten kunnen vormelijk getest worden op bijvoorbeeld https://ecosio.com/en/peppol-and-xml-document-validator/

Algemene kenmerken voor UBL 2.1 of UBL 2.0

    • In UBL 2.0 zitten facturen en creditnota’s samen in éénzelfde Invoice schema.
    • In UBL 2.1 is er een apart schema voor facturen en creditnota’s.
    • Beide soorten bestanden zijn te valideren met de generic UBL 2.1 schema. Maar dit is dus enkel een vormelijke test, het zegt niets over de inhoud.

Kenmerken van de 4 ondersteunde onderliggende varianten

  • eFFFv1 (dit is een “variant” van UBL 2.0)
    • UBLVersionID moet 2.0 zijn
    • CustomizationID moet “1.0” zijn
    • ProfileID moet “FFF.BE” bevatten
    • Ecosio heeft geen specifiek schema voor deze variant, en kan dus enkel UBL 2.0 vormelijk valideren
  • Peppol BIS 2 (dit is een variant van UBL 2.1)
    • UBLVersionID moet 2.1 zijn
    • CustomizationID moet zijn voor creditnota’s “urn:www.cenbii.eu:transaction:biitrns014:ver2.0:extended:urn:www.peppol.eu:bis:peppol5a:ver2.0” 
    • CustomizationID moet zijn voor facturen ‘”urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol5a:ver2.0″
    • ProfileID moet “urn:www.cenbii.eu:profile:bii05:ver2.0” zijn
    • Te valideren dmv “OpenPEPPOL Invoice 3.7.0 (aka BIS 2) (deprecated)” of “OpenPEPPOL Creditnote 3.7.0 (aka BIS 2) (deprecated)”
  • eFFF V3 (Dit is een variant op Peppol BIS 2 en dus ook een variant op UBL 2.1
    • UBLVersionID moet 2.1 zijn
    • De customizationID is uitgebreid met “:extended:e-fff:ver3.0”
    • Zelfde ProfileID als Peppol BIS2
    • Te valideren dmv “eFFF-Invoice 3.0.0 (deprecated!)” of “eFFF-Creditnote 3.0.0 (deprecated!)”
  • Peppol BIS 3 (dit is een variant op UBL 2.1)
    • UBLVersionID ontbreekt en is impliciet “2.1”
    • CustomizationID moet zijn “urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0”
    • ProfileID moet “urn:fdc:peppol.eu:2017:poacc:billing:01:1.0” zijn
    • Te valideren met de meest recente variant dit is op dit moment “OpenPEPPOL Invoice 3.13.0) (aka BIS Billing 3.0.12)” of “OpenPEPPOL Creditnote 3.13.0) (aka BIS Billing 3.0.12)”

 

Dit bericht is geplaatst in Boekhouding, Facturatie, Interfaces/Technisch, Tip met de tags , , , , , . Bookmark de permalink.