Germany

Invoice

Changes to generic fields

  • dueDate is required.
  • recipient.address.line1 is required.
  • recipient.address.city is required.
  • recipient.address.country is required.
  • recipient.address.postalCode is required.
  • lines[].vat.code must be a value from VAT code classification (UNTDID 5305), e.g. S for the standard rate.
  • For self-billed invoices both the recipient and sender details are required to be populated.
  • XRechnung: recipient.peppolId.endpointId is required.
  • ZUGFeRD: recipient.contact.email is 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

NameTypeRequiredDescription
dueDatestring (ISO 8601 date)YesDue date of invoice.
purchaseOrderRefstringOptionalThe buyer's purchase order number.
salesOrderRefstringOptionalThe seller's sales order number.
customInfo.deu.paymentCodestringYesMust 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.deliveryDatestringYesDelivery date of goods
customInfo.deu.isSelfBilledbooleanOptionalIndicates if this invoice is being self-billed.
customInfo.deu.buyerRefstringOptionalThe buyer's reference. For German public-sector buyers, this is the Leitweg-ID (5–46 characters).
customInfo.deu.projectRefstringOptionalProject number the invoice belongs to.
customInfo.deu.contractRefstringOptionalContract number the invoice belongs to.
customInfo.deu.serviceStartDatestring (ISO 8601 date)OptionalFirst day of the billing period.
customInfo.deu.serviceEndDatestring (ISO 8601 date)OptionalLast day of the billing period.
recipient.address.line1stringYesStreet and house number.
recipient.address.line2stringOptionalAdditional address line, for example building or floor.
recipient.address.citystringYesCity.
recipient.address.statestringOptionalFederal state (Bundesland).
recipient.address.countrystringYesThree-letter country code, for example DEU.
recipient.address.postalCodestringYesPostal code.
recipient.contact.emailstringConditionalRecipient email address. Required for ZUGFeRD.
recipient.peppolId.endpointIdstringConditionalPeppol ID of the recipient (eg. iso6523-actorid-upis::9930:uat-eezi-12345) Required for XRechnung.
shipToParty.namestringOptionalName of the party receiving the goods or services, if different from the buyer.
shipToParty.address.line1stringOptionalDelivery address: street and house number.
shipToParty.address.line2stringOptionalDelivery address: additional address line.
shipToParty.address.citystringOptionalDelivery address: city.
shipToParty.address.postalCodestringOptionalDelivery address: postal code.
shipToParty.address.countrystringOptionalDelivery address: three-letter country code, for example DEU.
lines[].buyerAssignedIdstringOptionalThe buyer's own article number for this item.
lines[].vat.codestringYesA value from an enumerated list as outlined on VAT code classification (UNTDID 5305)
lines[].vat.exemptReasonstringConditionalA 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[].refstringOptionalRemittance 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[].codestringConditionalPayment 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.ibanstringConditionalIBAN 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.accountNumberstringOptionalPayment 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.accountNamestringOptionalPayment account name
The name of the payment account, at a payment service provider, to which payment should be made.
paymentMeans[].account.bicstringOptionalThe 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.bankNamestringOptionalName of bank.
paymentMeans[].account.branchstringOptionalThe branch identifier for the payment service provider where a payment account is located.
notesstringOptionalFree text notes for additional data

Supported Formats

ScenarioStatusFormat sentChannelLegal documentWhat the recipient gets
Buyer has a Peppol IDSupportedXRechnung 3.0 (UBL)PeppolThe XMLThe XML, plus any PDFs you attached. eezi generates no PDF for XRechnung
No Peppol ID, email givenSupportedZUGFeRD (EN 16931)EmailCII XML inside the PDF/A-3One PDF/A-3 that is both readable and machine-readable, plus your attachments

Example CSV files

Invoice - Germany - XRechnung.csv

Invoice - Germany ZUGFerd.csv

Postman Collection

DEU - Postman Collection


Did this page help you?