This page explains how to create electronic invoices (XRechnung or Zugferd) using the Detailed Invoice Model API. It includes field descriptions, data structures, and examples for different payment me
This is the general structure of each call to create an e-invoice file.
//Main function callapp.businessFunction({functionName:"ERechnung",methodName:"CreateERechnung", //Option to choose the profile (xRechnung or Zugferd) //Option to save the file as an attachment //Invoice Header with general data //Payment Terms //Depending on the payment terms debitor or creditor information //Invoice totals //Taxes for each tax rate //Seller information //Buyer information //Item lines with price and quantity information});
First select the profile that is to be used to create the XML file.
You can use these options to create an attachment and add it to an existing data record.
The general header data of the invoice is saved in this area. The fields “invoiceNoAsReference” and “referenceOrderNo” are mandatory fields. If no information is available, the invoice number can be used.
The payment terms must be transferred as an array. Depending on the payment type, either a debitor account or creditor account is required.
The invoice totals are shown in this section. The totals are cross-checked against the individual items.
The control information is transferred in an array. One entry is required for each tax rate.
Necessary information about the seller including identification and contact details.
Necessary information about the buyer including identification.
Information on article items on the invoice. If there is an item discount or surcharge, this can be entered here.
//Option to choose the profile (xRechnung or Zugferd)
type: "XRechnung",
or
type: "Zugferd"
//Option to save the file as an attachment
archive: true, //enables the archive function
recordId: 20, //record that gets the attachemnt
appName: "customerOrder", //app name for the record id
filename: "Rechnung2024000.xml", //filename for the attachment
documentTypeId: 1, //document type of the attachment
//Invoice Header with general data
invoiceType: "Invoice" //Invoice, credit note, etc.
invoiceNo: "RE2024000", //invoice number
invoiceDate: "2025-01-01", //invoice date
currencyCode: "EUR", //currency
invoiceNoAsReference: "RE2024000", //invoice reference
actualDeliveryDate: "2025-01-01", //service date
referenceOrderNo: "PO-12345", //external order number
//Payment Terms
"tradePaymentTerms": [ //this is an array
{
"description": "Zahlbar innerhalb 30 Tagen netto",
"dueDate": "2025-01-31"
}
],
//Payment Means
"paymentMeans": {
"paymentCode": "SEPACreditTransfer", //code for the payment type
"information": "Überweisung", //information text
"identifikationsnummer": "DE02120300000000202051" //identification in the example IBAN
},
//Only one of the next options is required:
//For SEPADirectDebit the debitorFinancialAccount is required
"debitorFinancialAccount": {
"iban": "DE02500105170137075030",
"bic": "GENODEM1GLS"
},
//For SEPACreditTransfer the creditorFinancialAccount is required
"creditorFinancialAccount": {
"iban": "DE02500105170137075030",
"bic": "GENODEM1GLS"
},
//Invoice totals
"invoiceTotals": {
"lineTotalAmount": 100, //net amount of all lines
"chargeTotalAmount": 0, //sum of surcharges
"allowanceTotalAmount": 0, //sum of discounts
"taxBasisAmount": 100, //base for tax calculation
"taxTotalAmount": 19, //total tax amount
"grandTotalAmount": 119, //gross invoice amount
"totalPrepaidAmount": 0, //prepaid amount
"duePayableAmount": 119 //payable amount
},
//Taxes for each tax rate
"applicableTradeTaxes": [ //this is an array
{
"basisAmount": 100, //base for this specific tax calculation
"percent": 19, //tax percentage
"taxAmount": 19, //tax amount for this specific tax
"typeCode": "VAT", //tax type code
"categoryCode": "S" //tax category code
}
],
