Germany Invoice

Changes to generic fields

  • recipient.address.line1 is required.
  • recipient.address.line2 is required.
  • recipient.address.city is required.
  • recipient.address.state is required.
  • recipient.address.country is required.
  • recipient.address.postalCode is required.

Germany-specific fields

type Invoice {
  // ...generic invoice fields
  customInfo: {
    deu: {
      paymentCode: CodeListUncl4461;
    };
  };
  lines: [
    { 
      // ...other line item fields
      vat: {
      // ...other line item vat fields
	    code: VatCodeUNTDID;
      exemptReason?: string;
      }
    }
  ];
  recipient: {
    contact: {
      email?: string;
    }
    peppolId: {
      endpointId: string;
    };
  };
};

NameTypeRequiredDescription
customInfo.deu.paymentCodestringYesMust contain payment means type code Payment Means. Required for XRechnung and ZUGFeRD.
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. Optional for XRechnung when VAT is 0 and required for ZUGFeRD.
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.

Example CSV files

Invoice - Germany - PEPPOL.csv

Invoice - Germany - XRechnung.csv

Invoice - Germany ZUGFerd.csv