Skip to content

Buyer Information

The Buyer Information group defines which customer or order attributes the buyer-related business terms are populated from. The fields are split into two subgroups according to their data source.

Buyer Information
Buyer Information

Buyer Identification

These values identify the buyer as a business party and are read from the customer account. They therefore only apply to registered customers – guest orders have no customer attributes.

  • Customer Number Attribute (buyer/customer_number_attribute, default: entity_id, BT-46): Customer attribute for the buyer identifier. Use Customer ID for the Magento entity ID or a custom attribute with your customer numbers. When the field is empty, the customer ID is used instead.
  • Legal Registration Attribute (buyer/buyer_registration_attribute, BT-47): Customer attribute holding the buyer's legal or company registration number. Recommended for B2B.
  • Legal Registration Scheme (ICD) (buyer/buyer_registration_scheme, BT-47-1): ISO 6523 ICD code that qualifies the registration number in the field above – for example 0147 (Standard Company Code) or 0199 (LEI). It only takes effect when a registration attribute is selected. If left empty, the number is written without a scheme qualifier; this is permitted by EN 16931, but its type is then only known bilaterally between you and the buyer.

Order & Document References

Reference identifiers printed on the invoice. They are read from the order – from system fields, from checkout or extension fields, or from optional order attributes.

  • Buyer Reference (Leitweg-ID) (buyer/buyer_reference_attribute, BT-10): The buyer's reference, e.g. the Leitweg-ID (mandatory for B2G/XRechnung) or a cost center. Both customer and order attributes can be used as the source. XRechnung (BR-DE-15): mandatory field – if no value applies, the order number is used automatically.
  • Project Reference Attribute (buyer/project_reference_attribute, BT-11): Order attribute for the project reference. Helps buyers with cost allocation per project.
  • Purchase Order Reference Attribute (buyer/purchase_order_reference_attribute, BT-13): Order attribute for the buyer's purchase order number (PO number). Used by buyers to assign invoices to their orders.

The seller's order reference (BT-14) is no longer configurable. By definition it is your own order reference and is therefore always taken from the Magento order number.

Buyer reference with prefix (BT-10)

The Buyer Reference field supports prefixed values to define the source of the value:

Value Meaning
customer:leitweg_id Reads the leitweg_id attribute from the customer.
order:increment_id Reads the order number (Order Increment ID).

If a module for additional order attributes is installed, its fields appear as a separate group in the selection list and can be used in the same way.

If the resolved value is empty, the order number (Order Increment ID) is automatically used as the buyer reference. This ensures that the XRechnung rule BR-DE-15 (buyer reference is mandatory) is also fulfilled for guest orders.

For pure B2B scenarios without the public sector, it is usually sufficient to use the order number as the buyer reference. For the public sector, the recipient's Leitweg-ID must end up here – see XRechnung.