Skip to content

Payment Information

The Payment Information group determines BT-81 (payment means code) and BT-20 (payment terms) in the EN-16931 document. You can define default values and map individual Magento payment methods differently.

Payment Information
Payment Information
  • Default Payment Terms (payment/default_terms, default: This invoice is already paid., BT-20): Payment terms when no method-specific mapping exists.
  • Default Payment Means Code (payment/default_means_code, default: 68, BT-81): UNTDID 4461 payment means code. Common codes: 30 (bank transfer), 58 (SEPA transfer), 48 (card), 1 (cash).
  • Payment Method Mapping (payment/payment_method_mapping): Assigns individual Magento payment methods their own payment terms, EN-16931 payment means codes and due days.

Payment method mapping

Via the mapping table you store, per Magento payment method (e.g. "Prepayment", "Invoice", "PayPal"):

Column Meaning
Payment method The Magento payment method of the order.
Payment terms Free text for BT-20 (e.g. "Payable within 14 days net").
Payment means code UNTDID 4461 code (BT-81), matching the method.
Due days Number of days until due (for the due date BT-9).

For bank transfer/prepayment, store the code 30 (or 58 for SEPA) and appropriate due days; for card and online payments, a code such as 48 and payment terms expressing that the payment has already been made. If no mapping applies, the default values set above are used.

For the payment instruction (BG-16) for a bank transfer to be complete, IBAN (BT-84) and BIC (BT-85) must be stored under Seller. If the IBAN is missing, the XRechnung rule BR-DE-23 still requires the credit transfer group – the invoice is then rejected.

SEPA direct debit (code 59)

For direct debit, XRechnung additionally requires the group BG-19 with the creditor identifier (BT-90) and the customer's IBAN to be debited (BT-91); the mandate reference (BT-89) is optional. Both mandatory values must be present together (BR-DE-30, BR-DE-31), and the IBAN is verified against its check digits (BR-DE-20).

Magento has no direct debit payment of its own and therefore does not store these details anywhere. It is therefore not sufficient to map the code 59 in the payment method mapping. Instead, the data is supplied through an extension point that you connect to your own direct debit solution – see Developer.

As long as no extension point is set up, or the supplied data is incomplete, the invoice is automatically issued as a credit transfer. The generated document therefore always stays compliant; the reason is written to the system log.

Card payment (codes 48, 54, 55) requires the group BG-18 with card details in XRechnung. This group is currently not populated – for the public sector, use credit transfer or direct debit instead.