Метод THotPDF.AddFacturXAssociatedFile
Резюме на метода: Метод THotPDF.AddFacturXAssociatedFile
Декларация
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;Модул
HPDFDoc
Параметри
| Име | Предназначение |
|---|---|
XMLBytes | Байтове на XML фактурата, вградени буквално в потока EmbeddedFile на PDF/A-3; идентификаторът на XML ръководството или профила трябва да съвпада с ConformanceLevel |
ConformanceLevel | Разрешен профил на фактура или ниво на съответствие, като например EN 16931, EXTENDED, XRECHNUNG или COMFORT за ZUGFeRD 1.0 |
FileName | Име на файла на вградения XML, записано във /F, /UF, дървото с имена EmbeddedFiles и стойността на XMP DocumentFileName |
Описание | Незадължителен текст за Filespec /Desc, показван на инструментите за обработка |
Relationship | Връзка за асоцииран файл, записана като /AFRelationship и разрешена от избрания профил на фактурата |
Version | Версия на метаданните на фактурата, включително 1.0, 2p0 или съвпадаща версия на XRECHNUNG като 3.0 |
CountryCode | Регионален код за политика, използван при валидиране на профила; използвайте празна стойност, DE или FR |
Върната стойност
Връща индиректния Filespec речник, регистриран за основния XML на фактурата
Бележки за употреба
- Задайте PDFACompliance на 3A, 3B или 3U и извикайте BeginDoc преди да използвате този метод
- Методът отхвърля невалидни комбинации от име на файл, профил и версия на метаданните, така че xrechnung.xml се използва само с XRECHNUNG, ZUGFeRD-invoice.xml се използва само с профили на ZUGFeRD 1.0, zugferd-invoice.xml се използва само с Version 2p0, а factur-x.xml се използва за текущи профили на Factur-X
- Методът проверява идентификатора на XML ръководството или профила спрямо ConformanceLevel, включително URN на профила на ZUGFeRD 1.0, URN на текущия профил на Factur-X, френски подмножества EXTENDED, XMP или псевдоним на профила EN16931, URN на профила на ZUGFeRD 2.0 и известни URN на профили на XRechnung CII или UBL със съвпадащи версии на метаданните
- За XRECHNUNG предайте Version като 1.2, 2.0, 2.1, 2.2, 2.3 или 3.0, за да се запази този fx:Version; съществуващите извиквания, които оставят стойността по подразбиране на Version на 1.0, се нормализират до 3.0
- За контейнери ZUGFeRD 1.0 предайте FileName като ZUGFeRD-invoice.xml, Version като 1.0 и ConformanceLevel като BASIC, COMFORT или EXTENDED
- За контейнери ZUGFeRD 2.0 предайте FileName като zugferd-invoice.xml и Version като 2p0
- Предайте CountryCode като DE, когато контейнерът на фактурата трябва да следва германските правила за връзка на ZUGFeRD; MINIMUM и BASIC WL изискват Data като AFRelationship, докато BASIC, EN 16931, EXTENDED и XRECHNUNG изискват Alternative
- Предайте CountryCode като FR, когато фактурата трябва да следва френските правила за Factur-X; XRECHNUNG се отхвърля, а BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR и EXTENDED-B2B-FR могат да използват Alternative, Source или Data
- Методът използва MIME тип text/xml, записва /Params /Size, /ModDate и /CheckSum, регистрира Filespec в Catalog /AF и добавя запис Catalog /Names /EmbeddedFiles за инструменти за извличане на XML
- След регистрирането на основния XML на фактурата, следващите извиквания на AddPDFA3AssociatedFile могат да добавят придружаващи документи; проверете FacturXWarnings за некритични предупреждения за MIME тип, когато тези прикачени файлове са извън препоръчаните формати за придружаващи документи
- Генерираният XMP пакет включва специфична за профила схема за разширение PDF/A плюс полета DocumentType, DocumentFileName, Version и ConformanceLevel под съвпадащото пространство от имена на фактурата
- Не задавайте CustomXMP, когато използвате този помощник, тъй като предоставен от извикващия XMP пакет ще замени генерираните метаданни на фактурата
- Само един основен XML на фактура може да бъде прикрепен чрез този помощник в работния процес на документа
Свързани API
- Метод THotPDF.AddPDFA3AssociatedFile
- Свойство THotPDF.FacturXWarnings
- Метод THotPDF.AddPDFAOutputIntent
- Свойство THotPDF.PDFACompliance