einvoice_generate_zugferd
Generate a ZUGFeRD hybrid PDF invoice with embedded CII-XML to meet EN 16931 e-invoice compliance requirements.
Instructions
Erstellt eine ZUGFeRD-Hybrid-PDF (visuelle PDF + eingebettetes CII-XML).
Args: invoice_id: Rechnungsnummer. issue_date: Rechnungsdatum (YYYY-MM-DD). seller_name: Name des Verkäufers. seller_street: Straße des Verkäufers. seller_city: Stadt des Verkäufers. seller_postal_code: PLZ des Verkäufers. seller_country_code: Land des Verkäufers. seller_tax_id: USt-IdNr. des Verkäufers. buyer_name: Name des Käufers. buyer_street: Straße des Käufers. buyer_city: Stadt des Käufers. buyer_postal_code: PLZ des Käufers. buyer_country_code: Land des Käufers. items: JSON-Array der Positionen. seller_street_2: Adresszeile 2 des Verkäufers (BT-36). seller_street_3: Adresszeile 3 des Verkäufers (BT-37). seller_country_subdivision: Bundesland Verkäufer (BT-39, z.B. 'BY'). buyer_street_2: Adresszeile 2 des Käufers (BT-51). buyer_street_3: Adresszeile 3 des Käufers (BT-52). buyer_country_subdivision: Bundesland Käufer (BT-54, z.B. 'NW'). buyer_tax_id: USt-IdNr. des Käufers (optional). currency: Währungscode (Standard: EUR). payment_terms_days: Zahlungsziel in Tagen (optional). leitweg_id: Leitweg-ID (optional). buyer_reference: Käuferreferenz BT-10 (optional). profile: Rechnungsprofil. seller_electronic_address: Elektronische Adresse (BT-34). seller_electronic_address_scheme: EAS-Code (EM/9930). buyer_electronic_address: Elektronische Adresse (BT-49). buyer_electronic_address_scheme: EAS-Code (EM/9930). seller_contact_name: Ansprechpartner (BT-41). seller_contact_email: E-Mail (BT-43). seller_contact_phone: Telefon (BT-42). buyer_contact_name: Ansprechpartner Käufer (BT-44). buyer_contact_email: E-Mail Käufer (BT-47). buyer_contact_phone: Telefon Käufer (BT-46). seller_iban: IBAN (BT-84). seller_bic: BIC (BT-86). seller_bank_name: Bankname. type_code: Rechnungsart (BT-3): 380/381/384. seller_tax_number: Steuernummer (BT-32). delivery_party_name: Lieferort Name (BT-70). delivery_street: Lieferort Straße (BT-75). delivery_city: Lieferort Stadt (BT-77). delivery_postal_code: Lieferort PLZ (BT-78). delivery_country_code: Lieferort Land (BT-80). delivery_date: Lieferdatum (BT-71). service_period_start: Leistungszeitraum Beginn (BT-73). service_period_end: Leistungszeitraum Ende (BT-74). due_date: Fälligkeitsdatum (BT-9, YYYY-MM-DD). invoice_note: Freitext-Bemerkung (BT-22). payment_terms_text: Zahlungsbedingungen (BT-20). purchase_order_reference: Bestellnummer (BT-13). sales_order_reference: Auftragsbestätigung (BT-14). contract_reference: Vertragsnummer (BT-12). project_reference: Projektreferenz (BT-11). preceding_invoice_number: Vorige Rechnungsnr. (BT-25). preceding_invoice_date: Datum der vorigen Rechnung (BT-26, YYYY-MM-DD). despatch_advice_reference: Lieferscheinnummer (BT-16). invoiced_object_identifier: Abrechnungsobjekt (BT-18). business_process_type: Geschäftsprozesstyp (BT-23). seller_registration_id: Handelsregister/GLN (BT-29). buyer_registration_id: GLN des Käufers (BT-46). buyer_iban: IBAN des Käufers (BT-91, SEPA-Lastschrift). mandate_reference_id: SEPA-Mandatsreferenz (BT-89). skonto_percent: Skonto-Prozentsatz (z.B. "2.00"). skonto_days: Skonto-Frist in Tagen. skonto_base_amount: Skonto-Basisbetrag (optional). payment_means_type_code: Zahlungsart (BT-81, Standard 58). remittance_information: Verwendungszweck (BT-83). allowances_charges: JSON-Array der Zu-/Abschläge (BG-20/BG-21). tax_exemption_reason: Befreiungsgrund Text (BT-120). tax_exemption_reason_code: Befreiungsgrund Code (BT-121). tender_or_lot_reference: Vergabe-/Losnummer (BT-17). seller_trading_name: Handelsname Verkäufer (BT-28). buyer_trading_name: Handelsname Käufer (BT-45). payee_name: Zahlungsempfänger Name (BT-59). payee_id: Kennung des Zahlungsempfängers (BT-60). payee_legal_registration_id: Handelsregister (BT-61). payment_card_pan: Kartennummer letzte Stellen (BT-87). payment_card_holder: Karteninhaber (BT-88). seller_tax_rep_name: Steuervertreter Name (BT-62). seller_tax_rep_street: Steuervertreter Straße (BT-64). seller_tax_rep_city: Steuervertreter Stadt. seller_tax_rep_postal_code: Steuervertreter PLZ. seller_tax_rep_country_code: Steuervertreter Land. seller_tax_rep_tax_id: Steuervertreter USt-IdNr. (BT-63). receiving_advice_reference: Wareneingangsreferenz (BT-15). delivery_location_id: Lieferort-Kennung (BT-71). payment_means_text: Zahlungsart Freitext (BT-82). supporting_documents: JSON-Array Belegdokumente (BG-24). prepaid_amount: Bereits gezahlter Betrag (BT-113, z.B. Abschlagszahlungen). vat_point_date_code: Steuerzeitpunkt-Code (BT-8, UNTDID 2005). 3=Rechnungsdatum, 35=Lieferdatum, 432=Zahlungsdatum. seller_additional_legal_info: Zusaetzliche rechtl. Info (BT-33). creditor_reference_id: Glaeubigeridentifikationsnr. (BT-90). buyer_accounting_reference: Kontierung Kaeufer (BT-19).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| profile | No | ZUGFERD_EN16931 | |
| currency | No | EUR | |
| due_date | No | ||
| payee_id | No | ||
| type_code | No | 380 | |
| buyer_city | Yes | ||
| buyer_iban | No | ||
| buyer_name | Yes | ||
| invoice_id | Yes | ||
| issue_date | Yes | ||
| leitweg_id | No | ||
| payee_name | No | ||
| seller_bic | No | ||
| seller_city | Yes | ||
| seller_iban | No | ||
| seller_name | Yes | ||
| skonto_days | No | ||
| buyer_street | Yes | ||
| buyer_tax_id | No | ||
| invoice_note | No | ||
| delivery_city | No | ||
| delivery_date | No | ||
| seller_street | Yes | ||
| seller_tax_id | Yes | ||
| buyer_street_2 | No | ||
| buyer_street_3 | No | ||
| prepaid_amount | No | ||
| skonto_percent | No | ||
| buyer_reference | No | ||
| delivery_street | No | ||
| seller_street_2 | No | ||
| seller_street_3 | No | ||
| payment_card_pan | No | ||
| seller_bank_name | No | ||
| buyer_postal_code | Yes | ||
| project_reference | No | ||
| seller_tax_number | No | ||
| allowances_charges | No | ||
| buyer_contact_name | No | ||
| buyer_country_code | Yes | ||
| buyer_trading_name | No | ||
| contract_reference | No | ||
| payment_means_text | No | ||
| payment_terms_days | No | ||
| payment_terms_text | No | ||
| seller_postal_code | Yes | ||
| service_period_end | No | ||
| skonto_base_amount | No | ||
| buyer_contact_email | No | ||
| buyer_contact_phone | No | ||
| delivery_party_name | No | ||
| payment_card_holder | No | ||
| seller_contact_name | No | ||
| seller_country_code | Yes | ||
| seller_tax_rep_city | No | ||
| seller_tax_rep_name | No | ||
| seller_trading_name | No | ||
| vat_point_date_code | No | ||
| delivery_location_id | No | ||
| delivery_postal_code | No | ||
| mandate_reference_id | No | ||
| seller_contact_email | No | ||
| seller_contact_phone | No | ||
| service_period_start | No | ||
| supporting_documents | No | ||
| tax_exemption_reason | No | ||
| business_process_type | No | ||
| buyer_registration_id | No | ||
| creditor_reference_id | No | ||
| delivery_country_code | No | ||
| sales_order_reference | No | ||
| seller_tax_rep_street | No | ||
| seller_tax_rep_tax_id | No | ||
| preceding_invoice_date | No | ||
| remittance_information | No | ||
| seller_registration_id | No | ||
| payment_means_type_code | No | 58 | |
| tender_or_lot_reference | No | ||
| buyer_electronic_address | No | ||
| preceding_invoice_number | No | ||
| purchase_order_reference | No | ||
| buyer_country_subdivision | No | ||
| despatch_advice_reference | No | ||
| seller_electronic_address | No | ||
| tax_exemption_reason_code | No | ||
| buyer_accounting_reference | No | ||
| invoiced_object_identifier | No | ||
| receiving_advice_reference | No | ||
| seller_country_subdivision | No | ||
| seller_tax_rep_postal_code | No | ||
| payee_legal_registration_id | No | ||
| seller_tax_rep_country_code | No | ||
| seller_additional_legal_info | No | ||
| buyer_electronic_address_scheme | No | EM | |
| seller_electronic_address_scheme | No | EM |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |