Herzlich willkommen

Seller

The Seller group contains the business details of the invoice issuer that are transferred in a structured way into the XML.

Most seller data comes from the store information (Stores → Configuration → General → Store Information). The mandatory details address (street, postal code, city, country) and VAT ID (BT-31) must be configured there. In this group you only add the additional e-invoice-specific fields.

Seller fields

Seller Information
Seller Information
  • Seller Name (seller/name, mandatory, BT-27): The full legal name under which the seller is registered.
  • Fiscal Number (seller/fiscal_number, BT-32): Tax identification number (tax number). XRechnung: mandatory if no VAT ID is configured.
  • Trading Name (seller/trading_name, optional, BT-28): A differing business/brand name under which the seller is known.
  • Legal Registration Number (seller/legal_registration_id, optional, BT-30): Identifier assigned by the official register that identifies the seller as a legal entity (e.g. legal registration number).
  • Legal Registration ICD Code (seller/legal_registration_type, optional, BT-30): ISO 6523 ICD code for the type of registration number. Default value: 0223.
  • Electronic Address (seller/electronic_address, BT-34): Electronic address for routing the invoice. XRechnung: mandatory.
  • GLN (Global Location Number) (seller/gln, optional, BT-29): 13-digit GS1 Global Location Number for unique location identification.
  • DUNS Number (seller/duns, optional, BT-29): 9-digit Data Universal Numbering System number from Dun & Bradstreet.
  • Leitweg-ID (seller/leitweg_id, optional, BT-29): German XRechnung routing identifier for the public sector (format XXX-XXXXXXX-XX, example 991-12345-67).
  • IBAN (seller/iban, BT-84): IBAN for the payment instruction. Mandatory when bank transfer is the payment means.
  • BIC/SWIFT Code (seller/bic, BT-85): BIC/SWIFT code. Mandatory for international transfers.
  • Global Identifiers (seller/global_ids, optional, BT-29/BT-30): List of further global registration identifiers (scheme ID and value).

IBAN and BIC are formally checked on input (valid IBAN or 8–11 alphanumeric characters for the BIC). GLN and DUNS must have the respectively required number of digits as plain numerals.

Contact information

Contact details of the seller for queries regarding the invoice.

Seller Contact Information
Contact Information
  • Contact person (seller/contact/name, BT-41): Name of the contact person or department. XRechnung: mandatory.
  • Contact Type (seller/contact/contact_type): Determines whether the value is output as a person name (ram:PersonName) or as a department name (ram:DepartmentName). According to CII-SR-465, only one of the two details may appear in the XML.
  • Phone number (seller/contact/phone, BT-42): Phone number of the contact. XRechnung: mandatory.
  • Email address (seller/contact/email, BT-43): Email address of the contact. XRechnung: mandatory.

For XRechnung, name, phone and email of the contact are mandatory fields (BR-DE-5, BR-DE-6, BR-DE-7).

Tax representative

Optional details of the seller's tax representative (BT-62 to BT-70). These are required for certain cross-border business cases.

Tax Representative
Tax Representative
  • Tax representative name (seller/tax_representative/name, BT-62)
  • Tax representative VAT ID (seller/tax_representative/vat_identifier, BT-63)
  • Address line 1–3 (address_line_1/_2/_3, BT-64 to BT-66)
  • City (city, BT-67)
  • Postal code (post_code, BT-68)
  • State/Region (country_subdivision, BT-69)
  • Country code (country_code, BT-70): ISO 3166 alpha-2 country code.

Leave this group empty if you do not have a tax representative. The fields are only transferred into the XML if they are filled in.