Complyance Logo

Germany (DE) Field Mapping

Country: DE Compliance: XRechnung 3.0, EN 16931-1:2017, Peppol BIS Billing 3.0 Last Updated: 2026

This page includes the full Germany field mapping and Germany extension fields in one place.

Complete Sample Payload

{
  "invoice_data": {
    "document_number": "DE-INV-2025-001",
    "document_type": "tax_invoice",
    "invoice_date": "2025-01-15",
    "invoice_time": "14:30:00Z",
    "currency_code": "EUR",
    "tax_currency_code": "EUR",
    "due_date": "2025-02-14",
    "period_start_date": "2025-01-01",
    "period_end_date": "2025-01-31",
    "order_reference": "PO-2025-001",
    "line_extension_amount": 2000.00,
    "tax_exclusive_amount": 2000.00,
    "total_tax_amount": 380.00,
    "total_amount": 2380.00,
    "amount_due": 2380.00,
    "vat_point_date": "2025-01-15",
    "vat_point_date_code": "3.0",
    "buyer_reference": "XXX-XXXXXAAAA-XX",
    "invoiced_object_id": "OBJ-12345",
    "buyer_accounting_ref": "KONTO-123",
    "payment_terms": "Zahlung innerhalb von 30 Tagen",
    "invoice_note": "Rechnungshinweis: Bitte innerhalb der Frist zahlen",
    "business_process_type": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "specification_id": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
    "preceding_invoice_reference": "DE-INV-2024-999",
    "preceding_invoice_date": "2024-12-15"
  },
  "seller_info": {
    "seller_name": "Deutsche Handelsgesellschaft GmbH",
    "seller_trade_name": "DHG Trading",
    "seller_party_id": "SELLER-DE-12345",
    "vat_number_type": "VAT",
    "vat_number": "DE123456789",
    "registration_number": "HRB 12345 B",
    "registration_type": "DE:HRB",
    "legal_info": "Amtsgericht Berlin, HRB 12345 B",
    "peppol_id": "9930:DE123456789",
    "seller_email": "info@dhg-trading.de",
    "seller_phone": "+49 30 12345678",
    "street_name": "Unter den Linden 1",
    "additional_address": "Eingang A",
    "building_number": "1",
    "city_name": "Berlin",
    "state_province": "Berlin",
    "postal_code": "10117",
    "country_code": "DE"
  },
  "buyer_info": {
    "buyer_name": "Bayerische Industrie AG",
    "buyer_party_id": "BUYER-DE-67890",
    "buyer_vat_type": "VAT",
    "buyer_vat_number": "DE987654321",
    "buyer_registration_number": "HRB 67890 M",
    "buyer_registration_type": "DE:HRB",
    "buyer_peppol_id": "0204:991-33333TEST-33",
    "buyer_email": "einkauf@biag.de",
    "buyer_phone": "+49 89 98765432",
    "buyer_street_name": "Maximilianstraße 2",
    "buyer_additional_address": "3. Stock",
    "buyer_building_number": "2",
    "buyer_city": "München",
    "buyer_state_province": "Bayern",
    "buyer_postal_code": "80539",
    "buyer_country": "DE"
  },
  "payment_info": {
    "payment_means_code": "30",
    "payment_means_text": "Überweisung",
    "payee_iban": "DE89370400440532013000",
    "payee_account_name": "Deutsche Handelsgesellschaft GmbH",
    "bic_code": "COBADEFFXXX",
    "direct_debit_mandate_id": "MANDATE-2025-001",
    "payment_reference": "Rechnung DE-INV-2025-001"
  },
  "line_items": [
    {
      "line_id": "1",
      "item_name": "Beratungsdienstleistung",
      "item_description": "IT-Beratungsdienstleistungen für Q1 2025",
      "quantity": 10.00,
      "unit_code": "C62",
      "unit_price": 100.00,
      "net_price": 100.00,
      "discount_amount": 0.00,
      "discount_reason_code": "95",
      "taxable_amount": 1000.00,
      "tax_category": "S",
      "tax_rate": 19.0,
      "tax_amount": 190.00,
      "line_total": 1190.00,
      "standard_item_code": "4006381333931",
      "standard_code_scheme": "GTIN",
      "classification_code": "85312310",
      "classification_scheme": "CPV",
      "country_of_origin": "DE",
      "seller_item_code": "SELLER-ITEM-001",
      "buyer_item_code": "BUYER-ITEM-001"
    },
    {
      "line_id": "2",
      "item_name": "Software-Lizenz",
      "item_description": "Jahreslizenz für Unternehmenssoftware",
      "quantity": 5.00,
      "unit_code": "C62",
      "unit_price": 200.00,
      "net_price": 200.00,
      "taxable_amount": 1000.00,
      "tax_category": "S",
      "tax_rate": 19.0,
      "tax_amount": 190.00,
      "line_total": 1190.00,
      "standard_item_code": "4006381333932",
      "standard_code_scheme": "GTIN",
      "classification_code": "48000000",
      "classification_scheme": "CPV",
      "country_of_origin": "DE",
      "seller_item_code": "SELLER-ITEM-002",
      "buyer_item_code": "BUYER-ITEM-002"
    }
  ],
  "destinations": [
    {
      "type": "tax_authority",
      "details": {
        "country": "DE",
        "authority": "KOSIT",
        "document_type": "xrechnung"
      }
    }
  ]
}

Document Header Fields

JSON Field PathTypeRequiredDescriptionExample
invoice_data.document_numberstringYesInvoice number.DE-INV-2025-001
invoice_data.document_typestringYesDocument type.tax_invoice
invoice_data.invoice_datestringYesIssue date (YYYY-MM-DD).2025-01-15
invoice_data.invoice_timestringNoIssue time (HH:MM:SSZ).14:30:00Z
invoice_data.currency_codestringYesCurrency code.EUR
invoice_data.tax_currency_codestringNoTax currency (if different).EUR
invoice_data.due_datestringNoPayment due date.2025-02-14
invoice_data.period_start_datestringNoInvoice period start.2025-01-01
invoice_data.period_end_datestringNoInvoice period end.2025-01-31
invoice_data.order_referencestringNoPurchase order reference.PO-2025-001
invoice_data.line_extension_amountnumberYesSum of line taxable amounts.2000.00
invoice_data.tax_exclusive_amountnumberYesTotal excluding VAT.2000.00
invoice_data.total_tax_amountnumberYesTotal VAT amount.380.00
invoice_data.total_amountnumberYesTotal including VAT.2380.00
invoice_data.amount_duenumberYesAmount due for payment.2380.00

Seller Information Fields

JSON Field PathTypeRequiredDescriptionExample
seller_info.seller_namestringYesSeller legal name.Deutsche Handelsgesellschaft GmbH
seller_info.seller_trade_namestringNoTrading name.DHG Trading
seller_info.seller_party_idstringNoSeller party identifier.SELLER-DE-12345
seller_info.vat_number_typestringYesTax ID scheme.VAT
seller_info.vat_numberstringYesVAT number (DE + 9 digits).DE123456789
seller_info.registration_numberstringNoHandelsregisternummer.HRB 12345 B
seller_info.registration_typestringNoRegistration type.DE:HRB
seller_info.peppol_idstringNoPeppol participant ID.9930:DE123456789
seller_info.seller_emailstringNoContact email.info@dhg-trading.de
seller_info.seller_phonestringNoContact phone.+49 30 12345678
seller_info.street_namestringYesStreet address.Unter den Linden 1
seller_info.additional_addressstringNoAddress line 2.Eingang A
seller_info.building_numberstringNoBuilding number.1
seller_info.city_namestringYesCity.Berlin
seller_info.state_provincestringNoBundesland.Berlin
seller_info.postal_codestringYesPostal code.10117
seller_info.country_codestringYesCountry code.DE

Buyer Information Fields

JSON Field PathTypeRequiredDescriptionExample
buyer_info.buyer_namestringYesBuyer legal name.Bayerische Industrie AG
buyer_info.buyer_party_idstringNoBuyer party identifier.BUYER-DE-67890
buyer_info.buyer_vat_typestringYesTax ID scheme.VAT
buyer_info.buyer_vat_numberstringYesBuyer VAT number.DE987654321
buyer_info.buyer_registration_numberstringNoBuyer Handelsregisternummer.HRB 67890 M
buyer_info.buyer_peppol_idstringNoBuyer Peppol ID (or Leitweg-ID for B2G).0204:991-33333TEST-33
buyer_info.buyer_emailstringNoBuyer contact email.einkauf@biag.de
buyer_info.buyer_phonestringNoBuyer contact phone.+49 89 98765432
buyer_info.buyer_street_namestringYesStreet address.Maximilianstraße 2
buyer_info.buyer_additional_addressstringNoAddress line 2.3. Stock
buyer_info.buyer_building_numberstringNoBuilding number.2
buyer_info.buyer_citystringYesCity.München
buyer_info.buyer_state_provincestringNoBundesland.Bayern
buyer_info.buyer_postal_codestringYesPostal code.80539
buyer_info.buyer_countrystringYesCountry code.DE

Payment Information Fields

JSON Field PathTypeRequiredDescriptionExample
payment_info.payment_means_codestringYesPayment means code (30=Credit transfer, 58=SEPA credit, 59=SEPA debit).30
payment_info.payment_means_textstringNoPayment means description.Überweisung
payment_info.payee_ibanstringNoPayee IBAN.DE89370400440532013000
payment_info.payee_account_namestringNoPayee account name.Deutsche Handelsgesellschaft GmbH
payment_info.bic_codestringNoBIC/SWIFT code.COBADEFFXXX
payment_info.direct_debit_mandate_idstringNoSEPA direct debit mandate ID.MANDATE-2025-001
payment_info.payment_referencestringNoPayment reference.Rechnung DE-INV-2025-001

Line Items Fields

JSON Field PathTypeRequiredDescriptionExample
line_items[].line_idstringYesLine item identifier.1
line_items[].item_namestringYesItem name.Beratungsdienstleistung
line_items[].item_descriptionstringNoItem description.IT-Beratungsdienstleistungen für Q1 2025
line_items[].quantitynumberYesQuantity.10.00
line_items[].unit_codestringYesUnit code (UN/ECE C62).C62
line_items[].unit_pricenumberYesUnit price.100.00
line_items[].net_pricenumberNoNet price.100.00
line_items[].discount_amountnumberNoDiscount amount.0.00
line_items[].taxable_amountnumberYesLine taxable amount.1000.00
line_items[].tax_categorystringYesVAT category (S=19%, AA=7%, Z=0%, E=Exempt).S
line_items[].tax_ratenumberYesVAT rate percentage.19.0
line_items[].tax_amountnumberYesVAT amount.190.00
line_items[].line_totalnumberYesLine total with VAT.1190.00
line_items[].standard_item_codestringNoGTIN/EAN.4006381333931
line_items[].classification_codestringNoCPV classification code.85312310
line_items[].country_of_originstringNoCountry of origin.DE

Country Extensions

Germany currently applies extension fields in tax_invoice, credit_note, debit_note, self_billed_invoice, and export_invoice.

JSON Field PathTypeReqDescriptionExample
invoice_data.vat_point_datestringODate when VAT becomes due (BT-7).2025-01-15
invoice_data.vat_point_date_codestringOCode for VAT point timing (BT-8).3.0
invoice_data.invoiced_object_idstringOIdentifier for invoiced object/item (BT-18).OBJ-12345
invoice_data.buyer_accounting_refstringOBuyer accounting reference (BT-19).KONTO-123
invoice_data.buyer_referencestringOLeitweg-ID for B2G transactions.XXX-XXXXXAAAA-XX
invoice_data.payment_termsstringOPayment terms note.Zahlung innerhalb von 30 Tagen
invoice_data.invoice_notestringOAdditional invoice notes.Rechnungshinweis...
invoice_data.business_process_typestringOBusiness process identifier (BT-23).urn:fdc:peppol.eu:2017:poacc:billing:01:1.0
invoice_data.specification_idstringOXRechnung specification identifier (BT-24).urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
invoice_data.preceding_invoice_referencestringCMReference to preceding invoice (BT-25).DE-INV-2024-999
invoice_data.preceding_invoice_datestringCMDate of preceding invoice (BT-26).2024-12-15
seller_info.legal_infostringOAdditional seller legal information (BT-33).Amtsgericht Berlin, HRB 12345 B
invoice_data.invoice_period_descriptionstringOText description of billing period (BT-72).Abrechnungszeitraum Januar 2025

* In credit_note and debit_note, preceding_invoice_date is overridden to mandatory (M).

Destinations

JSON Field PathTypeRequiredDescriptionExample
destinations[].typestringNoDestination type.tax_authority
destinations[].details.countrystringNoTarget country.DE
destinations[].details.authoritystringNoTarget authority.KOSIT
destinations[].details.document_typestringNoDocument type.xrechnung

See Also