Zum Hauptinhalt springen

Rechnungen (Invoices)

Workist XML​

Unterstützter Dokumenttyp: Rechnungen
Dateiendung: .xml

Das Workist-XML-Format für Rechnungen umfasst allgemeine Kopfinformationen, Empfänger- und Absenderdetails, Zahlungsinformationen, eine Finanzzusammenfassung und Positionen.

Vollständiges Beispiel​

<?xml version="1.0" encoding="UTF-8"?>
<invoice>
    <invoice_number>INV-2025-0042</invoice_number>
    <order_number>PO-2025-0001</order_number>
    <contract_number>CON-2025-100</contract_number>
    <delivery_note_number>DN-2025-300</delivery_note_number>
    <invoice_date>2025-03-20</invoice_date>
    <invoice_due_date>2025-04-19</invoice_due_date>
    <delivery_date>2025-03-15</delivery_date>
    <document_type>invoice</document_type>

    <recipient_address>
        <Code>RCPT-001</Code>
        <name>Acme Corporation</name>
        <street_and_nr>Hauptstrasse 42</street_and_nr>
        <misc>Building A</misc>
        <company_name>Acme Corp GmbH</company_name>
        <postcode>80331</postcode>
        <city>Munich</city>
        <country>DE</country>
        <country_subdivision>BY</country_subdivision>
        <email>invoices@acme.de</email>
        <phone>+49 89 12345678</phone>
    </recipient_address>

    <sender_supplier>
        <address>
            <name>Supplier Contact Name</name>
            <street_and_nr>Lieferantenweg 10</street_and_nr>
            <company_name>Best Supplier GmbH</company_name>
            <postcode>20095</postcode>
            <city>Hamburg</city>
            <country>DE</country>
            <email>info@bestsupplier.de</email>
            <phone>+49 40 99999999</phone>
        </address>
        <name>Best Supplier GmbH</name>
        <customer_number>SUP-500</customer_number>
        <customer_type>preferred</customer_type>
        <contact_person>Hans Mueller</contact_person>
        <vat_id>DE987654321</vat_id>
    </sender_supplier>

    <sender_vat_id>DE987654321</sender_vat_id>
    <sender_tax_number>143/123/45678</sender_tax_number>

    <sender_contact>
        <contact_id>SC-001</contact_id>
        <name>Hans Mueller</name>
        <email>hans@bestsupplier.de</email>
        <phone>+49 40 88888888</phone>
    </sender_contact>

    <Info_Text>Payment due within 30 days.</Info_Text>

    <payment>
        <payment_bank>Deutsche Bank AG</payment_bank>
        <payment_bic>DEUTDEFF</payment_bic>
        <payment_iban>DE89370400440532013000</payment_iban>
        <payment_method>bank_transfer</payment_method>
        <payment_reference>INV-2025-0042</payment_reference>
        <payment_swift>DEUTDEFF</payment_swift>
        <payment_terms_discount>2% within 10 days</payment_terms_discount>
        <payment_terms_due_days>30</payment_terms_due_days>
        <payment_terms_type>net</payment_terms_type>
        <payment_terms>Net 30 days</payment_terms>
    </payment>

    <summary>
        <currency>EUR</currency>
        <net_amount>1250.00</net_amount>
        <tax_rate>19</tax_rate>
        <tax_amount>237.50</tax_amount>
        <total_amount>1487.50</total_amount>
        <total_due>1487.50</total_due>
    </summary>

    <line_items>
        <line_item>
            <pos>10</pos>
            <article_id1>ART-001-A</article_id1>
            <article_id2>GTIN-12345</article_id2>
            <article_id3>EAN-67890</article_id3>
            <article_partition_specific_number>CUST-ART-555</article_partition_specific_number>
            <article_description>Industrial Sensor Module Type A</article_description>
            <quantity>100</quantity>
            <unit>PCE</unit>
            <unit_price>12.50</unit_price>
            <total_price>1250.00</total_price>
            <gross_price>14.88</gross_price>
            <price_unit>1</price_unit>
            <tax_rate>19</tax_rate>
            <tax_amount>237.50</tax_amount>
        </line_item>
    </line_items>
</invoice>

Kopffelder​

XML-ElementTypBeschreibung
invoice_numberTextRechnungsnummer
order_numberTextZugehörige Bestellnummer
contract_numberTextVertragsreferenz
delivery_note_numberTextZugehörige Lieferscheinnummer
invoice_dateDatumRechnungsdatum
invoice_due_dateDatumFälligkeitsdatum
delivery_dateDatumLieferdatum
document_typeTextDokumenttyp (z.B. invoice, credit_note)
recipient_addressBlockRechnungsempfängeradresse
sender_supplierBlockLieferanteninformationen mit verschachtelter Adresse
sender_vat_idTextUSt-IdNr. des Lieferanten
sender_tax_numberTextSteuernummer des Lieferanten
sender_contactBlockAnsprechpartner des Lieferanten (ID, Name, E-Mail, Telefon)
Info_TextTextFreitextnotizen (bis zu 5 Blöcke mit je 70 Zeichen)

Zahlungsfelder​

XML-ElementTypBeschreibung
payment_bankTextBankname
payment_bicTextBIC-Code
payment_ibanTextIBAN
payment_methodTextZahlungsmethode (z.B. bank_transfer)
payment_referenceTextZahlungsreferenznummer
payment_swiftTextSWIFT-Code
payment_terms_discountTextSkontobedingungen
payment_terms_due_daysTextAnzahl Tage bis Fälligkeit
payment_terms_typeTextArt der Zahlungsbedingung
payment_termsTextVollständige Zahlungsbedingungen

Zusammenfassungsfelder​

XML-ElementTypBeschreibung
currencyTextWährungscode (z.B. EUR, USD)
net_amountDezimalNettobetrag vor Steuern
tax_rateDezimalSteuersatz in Prozent
tax_amountDezimalSteuerbetrag
total_amountDezimalBrutto-Gesamtbetrag
total_dueDezimalFälliger Gesamtbetrag

Positionsfelder​

XML-ElementTypBeschreibung
posTextPositionsnummer
article_id1TextPrimäre Artikel-ID
article_id2TextSekundäre Artikel-ID
article_id3TextTertiäre Artikel-ID
article_partition_specific_numberTextKundenspezifische Artikelnummer
article_descriptionTextProduktbeschreibung
quantityDezimalMenge
unitTextMengeneinheit
unit_priceDezimalPreis pro Einheit
total_priceDezimalPositionsgesamtbetrag
gross_priceDezimalBruttopreis pro Einheit
price_unitTextPreiseinheitsbasis
tax_rateDezimalSteuersatz auf Positionsebene
tax_amountDezimalSteuerbetrag auf Positionsebene