Germany
Invoice
Changes to generic fields
dueDateis required.recipient.address.line1is required.recipient.address.cityis required.recipient.address.countryis required.recipient.address.postalCodeis required.lines[].vat.codemust be a value from VAT code classification (UNTDID 5305), e.g.Sfor the standard rate.- For self-billed invoices both the
recipientandsenderdetails are required to be populated. - XRechnung:
recipient.peppolId.endpointIdis required. - ZUGFeRD:
recipient.contact.emailis required.
type Invoice {
// ...all generic invoice fields
dueDate: string;
purchaseOrderRef?: string;
salesOrderRef?: string;
notes?: string;
customInfo: {
deu: {
paymentCode: CodeListUncl4461;
deliveryDate: string;
isSelfBilled?: boolean;
buyerRef?: string; // Leitweg-ID for public-sector buyers
projectRef?: string;
contractRef?: string;
serviceStartDate?: string;
serviceEndDate?: string;
};
};
recipient: {
// ...all other generic recipient fields
address: {
line1: string;
line2?: string;
city: string;
state?: string;
country: string;
postalCode: string;
};
contact?: {
email?: string; // required for ZUGFeRD
};
peppolId?: {
endpointId: string; // required for XRechnung
};
};
shipToParty?: {
name?: string;
address?: {
line1?: string;
line2?: string;
city?: string;
postalCode?: string;
country?: string;
};
};
lines: [
{
// ...all other generic line item fields
buyerAssignedId?: string;
vat: {
// ...all other generic line item vat fields
code: VatCodeUNTDID;
exemptReason?: string; // required when the line is exempt or zero-rated
};
}
];
paymentMeans?: [ // required when paymentCode is 58: code + account.iban
{
code?: string;
ref?: string;
account?: {
iban?: string;
accountName?: string;
accountNumber?: string;
bic?: string;
bankName?: string;
branch?: string;
};
}
];
};Field information
| Name | Type | Required | Description |
|---|---|---|---|
dueDate | string (ISO 8601 date) | Yes | Due date of invoice. |
purchaseOrderRef | string | Optional | The buyer's purchase order number. |
salesOrderRef | string | Optional | The seller's sales order number. |
customInfo.deu.paymentCode | string | Yes | Must contain payment means type code Payment Means. Required for XRechnung and ZUGFeRD. If you use 58 (SEPA credit transfer), also send paymentMeans[].code and paymentMeans[].account.iban. |
customInfo.deu.deliveryDate | string | Yes | Delivery date of goods |
customInfo.deu.isSelfBilled | boolean | Optional | Indicates if this invoice is being self-billed. |
customInfo.deu.buyerRef | string | Optional | The buyer's reference. For German public-sector buyers, this is the Leitweg-ID (5–46 characters). |
customInfo.deu.projectRef | string | Optional | Project number the invoice belongs to. |
customInfo.deu.contractRef | string | Optional | Contract number the invoice belongs to. |
customInfo.deu.serviceStartDate | string (ISO 8601 date) | Optional | First day of the billing period. |
customInfo.deu.serviceEndDate | string (ISO 8601 date) | Optional | Last day of the billing period. |
recipient.address.line1 | string | Yes | Street and house number. |
recipient.address.line2 | string | Optional | Additional address line, for example building or floor. |
recipient.address.city | string | Yes | City. |
recipient.address.state | string | Optional | Federal state (Bundesland). |
recipient.address.country | string | Yes | Three-letter country code, for example DEU. |
recipient.address.postalCode | string | Yes | Postal code. |
recipient.contact.email | string | Conditional | Recipient email address. Required for ZUGFeRD. |
recipient.peppolId.endpointId | string | Conditional | Peppol ID of the recipient (eg. iso6523-actorid-upis::9930:uat-eezi-12345) Required for XRechnung. |
shipToParty.name | string | Optional | Name of the party receiving the goods or services, if different from the buyer. |
shipToParty.address.line1 | string | Optional | Delivery address: street and house number. |
shipToParty.address.line2 | string | Optional | Delivery address: additional address line. |
shipToParty.address.city | string | Optional | Delivery address: city. |
shipToParty.address.postalCode | string | Optional | Delivery address: postal code. |
shipToParty.address.country | string | Optional | Delivery address: three-letter country code, for example DEU. |
lines[].buyerAssignedId | string | Optional | The buyer's own article number for this item. |
lines[].vat.code | string | Yes | A value from an enumerated list as outlined on VAT code classification (UNTDID 5305) |
lines[].vat.exemptReason | string | Conditional | A textual statement of the reason why the amount is exempted from VAT or why no VAT is being charged. Required when the line is exempt or zero-rated. Leave empty on standard-rated (S) lines. |
paymentMeans[].ref | string | Optional | Remittance information A textual value used to establish a link between the payment and the Invoice, issued by the Seller. Used for creditor's critical reconciliation information. This information element helps the Seller to assign an incoming payment to the relevant payment process. |
paymentMeans[].code | string | Conditional | Payment means type code The means, expressed as code, for how a payment is expected to be or has been settled. Required when customInfo.deu.paymentCode is 58; use the same code. |
paymentMeans[].account.iban | string | Conditional | IBAN Payment account identifier A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. This would be used instead of account.accountNumber when provided. Required when customInfo.deu.paymentCode is 58. |
paymentMeans[].account.accountNumber | string | Optional | Payment account identifier A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. This will only be used if when no IBAN number was specified. |
paymentMeans[].account.accountName | string | Optional | Payment account name The name of the payment account, at a payment service provider, to which payment should be made. |
paymentMeans[].account.bic | string | Optional | The BIC (Bank Identifier Code) is an international code that clearly identifies banks worldwide. The BIC, often also called the SWIFT Code, is used as a second identifier in addition to the IBAN. |
paymentMeans[].account.bankName | string | Optional | Name of bank. |
paymentMeans[].account.branch | string | Optional | The branch identifier for the payment service provider where a payment account is located. |
notes | string | Optional | Free text notes for additional data |
Supported Formats
| Scenario | Status | Format sent | Channel | Legal document | What the recipient gets |
|---|---|---|---|---|---|
| Buyer has a Peppol ID | Supported | XRechnung 3.0 (UBL) | Peppol | The XML | The XML, plus any PDFs you attached. eezi generates no PDF for XRechnung |
| No Peppol ID, email given | Supported | ZUGFeRD (EN 16931) | CII XML inside the PDF/A-3 | One PDF/A-3 that is both readable and machine-readable, plus your attachments |
Example CSV files
Invoice - Germany - XRechnung.csv
Postman Collection
Updated 8 days ago
Did this page help you?