THotPDF.AddFacturXAssociatedFile Method
Rezumatul metodei: THotPDF.AddFacturXAssociatedFile Method
Declarație
function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const FileName : AnsiString = 'factur-x.xml'; const Description : AnsiString = 'Factur-X invoice XML'; const Relationship : AnsiString = 'Alternative'; const Version : AnsiString = '1.0'; const CountryCode : AnsiString = ''): THPDFDictionaryObject;Unitate
HPDFDoc
Parametri
| Nume | Scop |
|---|---|
XMLBytes | Octeții XML ai facturii încorporați verbatim în fluxul EmbeddedFile al documentului PDF/A-3; ghidul XML sau identificatorul de profil trebuie să se potrivească cu ConformanceLevel |
ConformanceLevel | Profilul de factură sau nivelul de conformitate permis, cum ar fi EN 16931, EXTENDED, XRECHNUNG sau COMFORT pentru ZUGFeRD 1.0 |
FileName | Numele fișierului XML încorporat scris în /F, /UF, arborele de nume EmbeddedFiles și valoarea XMP DocumentFileName |
Descriere | Text opțional Filespec /Desc afișat instrumentelor de consum |
Relationship | Relația de fișier asociat scrisă ca /AFRelationship și permisă de profilul de factură selectat |
Version | Versiunea metadatelor facturii, inclusiv 1.0, 2p0 sau o versiune XRECHNUNG corespunzătoare, cum ar fi 3.0 |
CountryCode | Codul politicii regionale utilizat de validarea profilului; utilizați o valoare goală, DE sau FR |
Valoare de întoarcere
Returnează dicționarul Filespec indirect înregistrat pentru fișierul XML principal al facturii
Note de utilizare
- Setați PDFACompliance to 3A, 3B sau 3U și apelați BeginDoc înainte de a utiliza această metodă
- Metoda respinge combinațiile nevalide de nume de fișier, profil și versiune de metadate, astfel încât xrechnung.xml este utilizat doar cu XRECHNUNG, ZUGFeRD-invoice.xml este utilizat doar cu profilurile ZUGFeRD 1.0, zugferd-invoice.xml este utilizat doar cu versiunea 2p0, iar factur-x.xml este utilizat pentru profilurile Factur-X actuale
- Metoda verifică ghidul XML sau identificatorul de profil în raport cu ConformanceLevel, inclusiv URN-urile de profil ZUGFeRD 1.0, URN-urile de profil Factur-X actuale, subseturile EXTENDED franceze, aliasul XMP sau de profil EN16931, URN-urile de profil ZUGFeRD 2.0 și URN-urile cunoscute de profil XRechnung CII sau UBL cu versiuni de metadate corespunzătoare
- Pentru XRECHNUNG, transmiteți Version ca 1.2, 2.0, 2.1, 2.2, 2.3 sau 3.0 pentru a păstra acel fx:Version; apelurile existente care lasă valoarea implicită a parametrului Version la 1.0 sunt normalizate la 3.0
- Pentru containerele ZUGFeRD 1.0, transmiteți FileName ca ZUGFeRD-invoice.xml, Version ca 1.0 și ConformanceLevel ca BASIC, COMFORT sau EXTENDED
- Pentru containerele ZUGFeRD 2.0, transmiteți FileName ca zugferd-invoice.xml și Version ca 2p0
- Transmiteți CountryCode ca DE atunci când containerul de factură trebuie să respecte regulile germane de relație ZUGFeRD; MINIMUM și BASIC WL necesită Data ca AFRelationship, în timp ce BASIC, EN 16931, EXTENDED și XRECHNUNG necesită Alternative
- Transmiteți CountryCode ca FR atunci când factura trebuie să respecte regulile franceze Factur-X; XRECHNUNG este respins, iar BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR și EXTENDED-B2B-FR pot folosi Alternative, Source sau Data
- Metoda utilizează tipul MIME text/xml, scrie /Params /Size, /ModDate și /CheckSum, înregistrează Filespec în Catalog /AF și adaugă o intrare Catalog /Names /EmbeddedFiles pentru instrumentele de extragere XML
- După înregistrarea fișierului XML principal al facturii, apelurile ulterioare AddPDFA3AssociatedFile pot adăuga documente justificative; inspectați FacturXWarnings pentru avertismente non-fatale privind tipul MIME atunci când acele fișiere atașate sunt în afara formatelor recomandate pentru documentele justificative
- Pachetul XMP generat include schema de extensie PDF/A specifică profilului plus câmpurile DocumentType, DocumentFileName, Version și ConformanceLevel sub spațiul de nume corespunzător al facturii
- Nu setați CustomXMP când utilizați acest helper, deoarece un pachet XMP furnizat de apelant ar înlocui metadatele generate ale facturii
- O singură factură XML principală poate fi atașată prin intermediul acestui helper într-un flux de lucru al documentului
API-uri asociate
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property