Online Invoicing Processing XML Structure for Hungary
This document describes the structure of the XML files that are created for Hungary through the process for online invoicing performed in 'Online Invoicing Transactions. Open' (AAS390). This functionality is described in general in Online Invoicing Processing, and the functionality specific to Hungary is described in Online Invoicing Processing for Hungary.
The XML files created through (AAS391) are specific for the Hungarian requirement for online invoicing.
The XML files are validated against the invoiceData.xsd schema published by the National Tax and Customs Administration of Hungary (NTCA).
The structure and content of the XML files are described below.
Structure | XML element | Content |
---|---|---|
XML file header | Basic data for the XML file. | |
Modifications | invoiceReference | Revised invoice. Details for corrective invoice or credit note. |
Header | supplierInfo | Information about the issuer of the invoice. Details from 'Company. Connect Division' (MNS100). |
customerInfo | Information about the person to whom the invoice is directed. Details from 'Customer. Open' (CRS610). | |
fiscalRepresentativeInfo | Representative. Details from 'Supplier. Open' (CRS620) of the fiscal representative, if any. | |
invoiceData | Invoice header. | |
Lines | invoiceLines | Description of goods and services items. Invoice details from different programs/tables depending on the type of invoice. |
Totals | invoiceSummary | Invoice totals. Calculations based on invoice amounts from the voucher in the general ledger. |
XML file header
The XML file header section contains basic data for the XML file and is created once per XML file (per invoice).
XML element | Description |
---|---|
Message header. XML declaration for character encoding and namespace. Name of schema, and schema location. | |
invoiceExchange | Header for the invoice information. |
Modifications (invoiceReference)
One section is created per XML file (per invoice).
XML element | Description |
---|---|
originalInvoiceNumber |
Reference to the initial invoice that is being modified. For corrective invoices or credit notes, the invoice number from AR additional information category 235 or 255 is used. |
modificationIssueDate | The date of the modified invoice – the invoice date of the original invoice. |
modificationTimestamp | The UTC timestamp of the original invoice, from the source system. |
lastModificationReference |
The reference number of the latest modifying invoice of the original invoice (if any). For original invoice modified by a corrective invoice, AR additional information category 236 is used. For original invoice modified by a credit note, AR additional information category 256 is used. If there is more than one AR additional information category 236 or 256 for the original invoice, the invoice number found for latest record is retrieved to this element. This element should only be written if the latest modifying invoice number is not the same as the modifying invoice number currently being reported, and if element modifyWithoutMaster is set to 'false'. |
modifyWithoutMaster |
Indication of a modification of an original invoice which has not yet been reported at the time of the modification. To validate if the original invoice has been reported or not, table FONINT is searched for this invoice number. If the original invoice number is not found in FONINT/CINO, this element is set to 'true'. If the original invoice number is found in FONINT/CINO, this element is set to 'false'. |
Issuer of the invoice (supplierInfo)
One section is created per XML file (per invoice). The information is retrieved from 'Company. Connect Division' (MNS100).
XML element | Description |
---|---|
supplierTaxNumber |
Start tag. Tax number of the issuer of the invoice. Organization no 2 from (MNS100/G) is used as tax number. If it does not exists, the VAT registration number from (MNS100/G) is used instead, without the leading country code. |
taxpayerId |
The tax registration number, 8 digits. The first 8 digits from organization number 2 are used. |
vatCode |
VAT code indicating taxation status, 1 digit. Values 1-5. Digit 9 from organization number 2 is used. Default=1, if nothing is specified. |
countyCode |
County code, 2 digits. There is a special Hungarian List of county codes: 02; 03; …. 51. Values 1-5. Digits 10 and 11 from organization number 2 are used. Default=00, if nothing is specified. |
groupMemberTaxNumber | Not used/updated. |
taxpayerId | Not used/updated. |
vatCode | Not used/updated. |
countyCode | Not used/updated. |
communityVatNumber | VAT registration number of the issuer of the invoice with leading country code from (MNS100/G). |
supplierName |
Name of the issuer of the invoice (name of the division). Company name from (MNS100/E). In addition to this, address information might also be included, based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that additional information should be added to this element. If this does not exist, only the company name from (MNS100/E) is included. |
supplierAddress |
Address of the issuer of the invoice. Start tag. |
simpleAddress |
Address of the issuer of the invoice. Start tag. |
countryCode | Base country code of the selling division. Country from (MNS100/E). |
region | Not used/updated. |
postalCode |
Postal code of the selling division. Postal code from (MNS100/E). The first 4 digits are used. Default=0000 if nothing is specified. |
city |
City of the selling division. City from (MNS100/E), or from one of the address fields in (MNS100/E), based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that city should be retrieved from one of the address fields to this element. If this does not exist, city from (MNS100/E) is used. |
additionalAddressDetail |
Address lines 1, 2, 3 and 4 from (MNS100/E), or according to the setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that the address information should be retrieved from one or more of the address fields to this element. If this does not exist, address information from all four address fields on (MNS100/E) should be used. |
supplierBankAccountNumber | Not used/updated. |
individualExemption | Not used/updated. |
exciseLicenceNum | Not used/updated. |
Customer to whom the invoice is directed (customerInfo)
One section is created per XML file (per invoice). The information is retrieved from 'Customer. Open' (CRS610).
XML element | Description |
---|---|
customerTaxNumber |
Start tag. Tax number of the customer to whom the goods or services are supplied. Organization number 2 (COR2) from (CRS610/J) is used as tax number. If this does not exist, VAT registration number, without the leading country code, from the first VAT transaction for the voucher in the general ledger, is used instead. If the customer number exists in (CRS881)/(CRS882), this indicates that both the customer's tax number and the group member's tax number should be reported. If it does not exist, only the customer's tax number should be reported. |
taxpayerId |
The tax registration number, 8 digits. The first 8 digits from organization number 2 are used. |
vatCode |
VAT code indicating taxation status, 1 digit. Values 1-5. Digit 9 from organization number 2 is used. Default=1, if nothing is specified. |
countyCode |
County code, 2 digits. There is a special Hungarian List of county codes: 02; 03; …. 51. Values 1-5. Digits 10 and 11 from organization number 2 are used. Default=00, if nothing is specified. |
groupMemberTaxNumber |
Start tag. The group member's tax number, if the sale of the product or provision of service was carried out using a group ID. Organization number (CORG) from (CRS610/J) is used as tax number. If it does not exist, this element is not created. If the customer number exists in (CRS881)/(CRS882), this indicates that both the customer's tax number and the group member's tax number should be reported. If it does not exist, only the customer's tax number should be reported. |
taxpayerId |
The tax registration number, 8 digits. The first 8 digits from organization number 2 are used. |
vatCode |
VAT code indicating taxation status, 1 digit. Values 1-5. Digit 9 from organization number 2 is used. Default=1, if nothing is specified. |
countyCode |
County code, 2 digits. There is a special Hungarian List of county codes: 02; 03; …. 51. Values 1-5. Digits 10 and 11 from organization number 2 are used. Default=00, if nothing is specified. |
communityVatNumber |
VAT registration number of the customer to whom the goods or services are supplied. VAT registration number, including the leading country code, is retrieved from the first VAT transaction for the voucher in the general ledger. |
thirdStateTaxId | Not used/updated. |
customerName |
Name of the customer to whom the goods or services are supplied. Customer name from (CRS610/E). In addition to this, address information might also be included, based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that additional information should be added to this element. If this does not exist, only the customer name from (CRS610/E) is included. |
customerAddress |
Address of the customer to whom the goods or services are supplied. Start tag. |
simpleAddress |
Address of the customer to whom the goods or services are supplied. Start tag. |
countryCode | Country code of the customer. Country from (CRS610/E). |
region | Not used/updated. |
postalCode |
Postal code of the customer. Postal code from (CRS610/E). The first 4 digits are used. Default=0000 if nothing is specified. |
city |
City of the customer. City from (CRS610/E), or from one of the address fields in (CRS610/E), based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that city should be retrieved from one of the address fields to this element. If this does not exists, city from (CRS610/E) is used. |
additionalAddressDetail |
Address lines 1, 2, 3 and 4 from (CRS610/E), or according to the setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that the address information should be retrieved from one or more of the address fields to this element. If this does not exist, address information from all four address fields on (CRS610/E) should be used. |
customerBankAccountNumber | Not used/updated. |
Fiscal representative (fiscalRepresentativeInfo)
One section is created per XML file (per invoice). Details from 'Supplier. Open' (CRS620) and 'Supplier. Connect Address' (CRS622) of the fiscal representative supplier number found in 'Fiscal representation. Open' (TXS030) for the base country code.
XML element | Description |
---|---|
fiscalRepresentativeTaxNumber |
Start tag. Tax number of the fiscal representative (the issuer of the invoice). Organization number 2 from (CRS620/E) is used as tax number. If this does not exist, the VAT registration number from (CRS620/E) is used instead, without the leading country code. |
taxpayerId |
The tax registration number, 8 digits. The first 8 digits from organization number 2 are used. |
vatCode |
VAT code indicating taxation status, 1 digit. Values 1-5. Digit 9 from organization number 2 is used. Default=1, if nothing is specified. |
countyCode |
County code, 2 digits. There is a special Hungarian List of county codes: 02; 03; …. 51. Values 1-5. Digits 10 and 11 from organization number 2 are used. Default=00, if nothing is specified. |
fiscalRepresentativeName |
When a fiscal representative is involved, name of the fiscal representative (issuer of the invoice). Supplier name from (CRS622/E) (from address type 01, if it exists, else from type 02), if this does not exist, supplier name from (CRS620). In addition to this, address information might also be included, based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that additional information should be added to this element. If this does not exist, only the supplier name from (CRS622/E) or (CRS620/E) is included. |
fiscalRepresentativeAddress |
Address of the fiscal representative (the issuer of the invoice). Start tag. |
simpleAddress |
Address of the fiscal representative (the issuer of the invoice). Start tag. |
countryCode | Base country code of the fiscal representative. Country from (CRS622/E) (from address type 01 if it exists, else from type 02), if this does not exist, country from (CRS620/E). |
region | Not used/updated. |
postalCode |
Postal code of the fiscal representative. Postal code from (CRS622/E), from address type 01 if it exists, else from type 02. The first 4 digits are used. Default=0000 if nothing is specified. |
city |
City of the fiscal representative. City from (CRS622/E), from address type 01 if it exists, else from type 02, or from one of the address fields in (CRS622/E), based on setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that city should be retrieved from one of the address fields to this element. If this does not exist, city from (CRS622/E) is used. |
additionalAddressDetail |
Address lines 1, 2, 3 and 4 from (CRS622/E), from address type 01 if it exists, else from type 02, or according to the setup in (CRS881)/(CRS882). If translation exists in (CRS881)/(CRS882), this indicates that the address information should be retrieved from one or more of the address fields to this element. If this does not exist, address information from all four address fields on (CRS622/E) should be used. |
fiscalRepresentativeBankAccountNumber | Not used/updated. |
Invoice header (invoiceData)
One section is created per XML file (per invoice).
XML element | Description |
---|---|
invoiceNumber | Sequential number, which uniquely identifies the invoice. |
invoiceCategory |
Invoice category type; 'NORMAL', 'SIMPLIFIED', or 'AGGREGATE'. Default='NORMAL'. |
invoiceIssueDate | Issue date of the invoice. |
invoiceDeliveryDate |
VAT date: - delivery date, or - for payments on account, date when the amount of VAT payable is charged, if other than the invoice date. VAT date is retrieved from the first VAT transaction for the voucher in the general ledger. If this does not exist, then Invoice date from accounts receivable is used instead. |
invoiceDeliveryPeriodStart | Not used/updated. |
invoiceDeliveryPeriodEnd | Not used/updated. |
invoiceAccountingDeliveryDate | Not used/updated. |
currencyCode | Invoice currency. Currency code for the invoice in accounts receivable. |
exchangeRate |
Exchange rate is retrieved from the first VAT transaction for the voucher in the general ledger. For invoices with currency 'HUF', the value is defaulted to '1'. |
selfBillingIndicator | Not used/updated. |
paymentMethod | Not used/updated. |
paymentDate | Not used/updated. |
cashAccountingIndicator | Not used/updated. |
invoiceAppearance |
Appearance of the invoice; 'PAPER', 'ELECTRONIC' (not EDI), 'EDI', or 'UNKNOWN' (the software cannot identify the form of appearance of the invoice or it is unknown at the time of issue). Default='UNKNOWN'. |
electronicInvoiceHash | Not used/updated. |
additionalInvoiceData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – customer order invoices (OIS350)
Invoice line details for customer order invoices from 'Invoice. Display' (OIS350). One or more sections are created per XML file (per invoice).
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicating the item line level modifications for a modified invoice. To determine if the current invoice has a reference to an original invoice number, AR additional information categories 235 and 255 are checked. If this exists, the invoice number and invoice year found are used to populate the elements of this tag. If this does not exist, this tag is not created. |
lineNumberReference |
The line number of the modified original invoice, or the new line number when creating a new invoice line, continuing the line numbers of the original invoice. The number of lines for the original invoice is calculated. Other corrective invoices that refer to the same original invoice are also considered when calculating the number of lines for the original invoice. To find the original invoice number, AR additional information categories 235 and 255 are checked for the corrective invoice. To determine if there are other corrective invoices with a reference to the same original invoice number, AR additional information categories 236 and 256 are checked for the original invoice. |
lineOperation |
Invoice line modification type; 'CREATE', or 'MODIFY'. Default='CREATE'. |
referencesToOtherLines | Not used/updated. |
referenceToOtherLine | Not used/updated. |
advanceIndicator |
Indicating an advance charge. For invoice lines with line type 50 (advance charge), 'true' is written for this element. For other invoice line types, this element is not created. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. For item lines, the item description is retrieved from language 'HU' in 'Item. Enter Names/Language' (MMS030) if this exists, else from the item name on the customer order. For external header charges, the description is retrieved from language 'HU' if this exists in 'CO Charge Enter Names/Language' (OIS029), else from 'CO Charge. Open' (OIS030). For service charges in the header, the description is retrieved from language 'HU' if this exists in 'Service Charge Enter Names/Lang' (OIS033), else from 'Service Charge. Open' (OIS031). For external line charges, if reported as separate lines in the XML file, the description is retrieved from language 'HU' if this exists in 'Order Line Charge. Enter Names/Language' (CRS276), else from 'Order Line Charge. Open' (CRS275). For advance invoiced lines, the description is retrieved from text lines 1 and 2 in 'Customer Order. Invoice in Advance' (OIS105) if this exists, else the invoice reference and customer order number are used. For lines with a settled amount, previously advance invoiced, the description consists of invoice reference, customer order number, and delivery number. |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. The quantity is retrieved from the delivery line in 'CO Delivery. Display Lines' (OIS356). For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no quantity exists, '1' is entered in this element, since it is mandatory. |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no U/M exists, 'db' (means pcs in Hungarian) is entered in this element, since it is mandatory. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. The 'Sales price U/M' (SPUN) is retrieved from the order line in 'Customer Order. Open Line' (OIS101). For advanced invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no U/M exists, 'db' (means 'pieces' in Hungarian) in this element, since it is mandatory. |
unitPrice |
Net sales price in sales U/M in the currency of the invoice, including all discounts and other deductions. The 'unitPrice' is calculated as the 'lineNetAmount' divided by the 'quantity'. |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount |
Taxable base amount in the currency of the invoice. Net amount for item lines + external line charges of type 'csk' – any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) would always be set to 'false', so they are not included. Based on the possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimal places. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the invoice line in 'Invoice. Display Lines' (OIS351) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. For item lines (line type 31) this element shows the VAT amount of the item line + VAT amount of external line charges of type 'csk' – VAT amount of any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line, and then the VAT amount of that line charge must be included in this element as well. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Total amount payable, including VAT, in the currency of the invoice. Gross amount (including VAT) for item line + external line charges of type 'csk' – any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is reported as a separate line in the XML file. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – manual invoices (ARS100, ARS120, FAS130)
Invoice line details for customer invoices from 'Customer Invoice. Enter' (ARS100), 'Customer Invoice. Enter Manual' (ARS120), and 'Fixed Asset. Sell' (FAS130). The information is retrieved from the voucher in the general ledger, and each voucher line with VAT account type (AT04) 3-9 creates an invoice line in the XML file.
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicates the item line level modifications for a modified invoice. Determines if the current invoice has a reference to an original invoice number, AR additional information categories 235 and 255 are checked. If this exists, the invoice number and invoice year found are used to populate the elements of this tag. If this does not exist this tag is not created. |
lineNumberReference |
The line number of the modified original invoice, or the new line number when creating a new invoice line, continuing the line numbers of the original invoice. The number of lines for the original invoice is calculated. Other corrective invoices that refer to the same original invoice are also considered when calculating the number of lines for the original invoice. To find the original invoice number, AR additional information categories 235 and 255 are checked for the corrective invoice. To determine if there are other corrective invoices with a reference to the same original invoice number, AR additional information categories 236 and 256 are checked for the original invoice. |
lineOperation |
Invoice line modification type; 'CREATE', or 'MODIFY'. Default='CREATE'. |
referencesToOtherLines | Not used/updated. |
referenceToOtherLine | Not used/updated. |
advanceIndicator | Not used/updated. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. Voucher text is used as the line description for manual invoices. |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. The quantity must be entered during the accounting of the invoice in 'Accounting. Open' (GLS120) to update this element. If no quantity is entered in (GLS120), the quantity 0,000000 is used for the transaction in the general ledger, and then the quantity defaults to 1,000000 for this element. |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. U/M does not exist in the general ledger, so 'db' (Hungarian for pcs) is entered for this element, since it is mandatory in the XML file. |
unitPrice |
Unit price in the currency of the invoice. The 'unitPrice' is calculated as the 'lineNetAmount' divided by the 'quantity'. |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount | Taxable base amount in the currency of the invoice. |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) are always set to 'false', so they are not included. Based on a possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimals. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the voucher line in 'General Ledger. Display Transactions' (GLS211) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. The 'lineVatAmount' is calculated as foreign currency amount (CUAM) multiplied by the VAT percentage (VTP1) for the record in the general ledger. |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Gross line amount in invoice currency. Total amount payable, including VAT, in invoice currency. The 'lineGrossAmountNormal' is calculated by summarizing the 'lineNetAmount' and the 'lineVatAmount'. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – internal invoices (MFS100)
Invoice line details for customer invoices from 'Internal Invoice. Create' (MFS100). The information is retrieved from 'Internal Transfer. Display btw Divisions' (MFS200). Each record for the internal invoice in (MFS200) creates an invoice line in the XML file.
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicating the item line level modifications for a modified invoice. This is not applicable to internal invoices. |
lineNumberReference | Not used/updated. |
lineOperation | Not used/updated. |
referencesToOtherLines | Not used/updated. |
referenceToOtherLine | Not used/updated. |
advanceIndicator | Not used/updated. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. For internal invoices, the item description is retrieved from language 'HU' in 'Item. Enter Names/Language' (MMS030), if this exists, else the item name is retrieved from 'Item. Open' (MMS001). |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. For internal invoices, the quantity is retrieved from 'Delivered quantity – basic U/M' (DLQT) in (MFS200). |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. For internal invoices, the 'unitOfMeasure' is retrieved from language 'HU' in 'Unit of Measure. Enter Names/Language' (CRS052), if this exists, else from U/M in (MMS001). |
unitPrice |
Unit price in the currency of the invoice. For internal invoices, the 'unitPrice' 'is retrieved from the 'Internal transfer price' (INPR) in (MFS200). |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount |
Taxable base amount in the currency of the invoice. For internal invoices, the 'lineNetAmount' is calculated as 'Delivered quantity' (DLQT) multiplied by 'Internal transfer price' (INPR) in (MFS200). |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) are always set to 'false', so they are not included. Based on a possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimals. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the record in (MFS200) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. For internal invoices, the 'lineVatAmount' is calculated as 'Delivered quantity' (DLQT) multiplied by 'Internal transfer price' (INPR), multiplied by the 'VAT percentage' (VTP1). |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Gross line amount in invoice currency. Total amount payable, including VAT, in invoice currency. The 'lineGrossAmountNormal' is calculated by summarizing the 'lineNetAmount' and the 'lineVatAmount'. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – maintenance customer order invoices (COS350)
Invoice line details for maintenance customer order invoices are taken from 'Invoice. Display' (COS350). One or more sections are created per XML file (per invoice).
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicating the item line level modifications for a modified invoice. To determine if the current invoice has a reference to an original invoice number, AR additional information categories 235 and 255 are checked. If this exists, the invoice number and invoice year found are used to populate the elements of this tag. If this does not exist, this tag is not created. |
lineNumberReference |
The line number of the modified original invoice, or the new line number when creating a new invoice line, continuing the line numbers of the original invoice. The number of lines for the original invoice is calculated. Other corrective invoices that refer to the same original invoice are also considered when calculating the number of lines for the original invoice. To find the original invoice number, AR additional information categories 235 and 255 are checked for the corrective invoice. To determine if there are other corrective invoices with a reference to the same original invoice number, AR additional information categories 236 and 256 are checked for the original invoice. |
lineOperation |
Invoice line modification type; 'CREATE', or 'MODIFY'. Default='CREATE'. |
referencesToOtherLines | Not used/updated. |
referencesToOtherLine | Not used/updated. |
advanceIndicator |
Indicating an advance charge. For invoice lines with line type 50 (advance charge), 'true' is written for this element. For other invoice line types, this element is not created. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. For labor lines the item description is retrieved from language 'HU' in 'Item. Enter Names/Language' (MMS030) if this exists, else from the item name. For item lines, the item description is retrieved from language 'HU' in 'Item. Enter Names/Language' (MMS030) if this exists, else from the item name. For external header charges, the description is retrieved from language 'HU' if this exists in 'CO Charge Enter Names/Language' (OIS029), else from 'CO Charge. Open' (OIS030). For external line charges, if reported as separate lines in the XML file, the description is retrieved from language 'HU' if this exists in 'Order Line Charge. Enter Names/Language' (CRS276), else from 'Order Line Charge. Open' (CRS275). For external item charges, the description is picked from language 'HU' in 'Order Line Charge. Enter Names/Language' (CRS276) if this exists, else from 'Order Line Charge. Open' (CRS275). For advance invoiced lines, the description is retrieved from text lines 1 and 2 in 'Maint CO. Connect Addresses' (COS105), if this exists, else the invoice reference and customer order number are used. For lines with a settled amount, previously advance invoiced, the description consists of invoice reference and customer order number from the invoice in 'Maint Invoice. Display Lines (COS351). |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. For lines types 31-36 the quantity is retrieved from the invoice specification in delivery line in 'Maint CO. Check Preliminary Invoice Spec' (COS170). For lines types 39 and 91-94 the quantity is retrieved from the order line in 'Maintenance Customer Orders. Open Line' (COS101). For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no quantity exists, '1' is entered in this element, since it is mandatory. |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. For line types 39 and 91-94 the 'Unit of Measure' is retrieved from the order line in 'Maintenance Customer Orders. Open Line' (COS101) field 'Unit of Measure' (UNIT). For line types 31-36 the 'Unit of Measure' is retrieved from the invoice specification in 'Maint CO. Check Preliminary Invoice Spec' (COS170) field 'Unit of Measure' (UNIT). For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no U/M exists, 'db' (means pcs in Hungarian) is entered in this element, since it is mandatory. |
unitPrice |
Net sales price in sales U/M in the currency of the invoice, including all discounts and other deductions. The unit price is calculated as the 'lineNetAmount' divided by the 'quantity'. |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount |
Taxable base amount in the currency of the invoice. Net amount for item lines + external line charges of type 'csk' – any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) would always be set to 'false', so they are not included. Based on the possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimal places. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the invoice line in 'Invoice. Display Lines' (OIS351) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. For item lines (line type 31,32,34,36) this element shows the VAT amount of the item line + VAT amount of external line charges of type 'csk' – VAT amount of any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line, and then the VAT amount of that line charge must be included in this element as well. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Total amount payable, including VAT, in the currency of the invoice. Gross amount (including VAT) for item line + external line charges of type 'csk' – any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is reported as a separate line in the XML file. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – rental, service and leasing invoices (STS350, SOS350, LTS350)
Rental invoices, service order invoices and leasing invoices use FAM function SO20.
Invoice line details for these invoices are taken from 'Service order. Display Lines' (SOS530). One or more sections are created per XML file (per invoice).
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicating the item line level modifications for a modified invoice. To determine if the current invoice has a reference to an original invoice number, AR additional information categories 235 and 255 are checked. If this exists, the invoice number and invoice year found are used to populate the elements of this tag. If this does not exist, this tag is not created. |
lineNumberReference |
The line number of the modified original invoice, or the new line number when creating a new invoice line, continuing the line numbers of the original invoice. The number of lines for the original invoice is calculated. Other corrective invoices that refer to the same original invoice are also considered when calculating the number of lines for the original invoice. To find the original invoice number, AR additional information categories 235 and 255 are checked for the corrective invoice. To determine if there are other corrective invoices with a reference to the same original invoice number, AR additional information categories 236 and 256 are checked for the original invoice. |
lineOperation |
Invoice line modification type; 'CREATE', or 'MODIFY'. Default='CREATE'. |
referencesToOtherLines | Not used/updated. |
referencesToOtherLine | Not used/updated. |
advanceIndicator |
Indicating an advance charge. For invoice lines with line type 50 (advance charge), 'true' is written for this element. For other invoice line types, this element is not created. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. For item lines, the item description is retrieved from language 'HU' in 'Item. Enter Names/Language' (MMS030) if this exists, else from the item name on the service order. For external header charges, the description is retrieved from language 'HU' if this exists in 'CO Charge Enter Names/Language' (OIS029), else from 'CO Charge. Open' (OIS030). For service charges in the header, the description is retrieved from language 'HU' if this exists in 'Service Charge Enter Names/Lang' (OIS033), else from 'Service Charge. Open' (OIS031). For external line charges, if reported as separate lines in the XML file, the description is retrieved from language 'HU' if this exists in 'Order Line Charge. Enter Names/Language' (CRS276), else from 'Order Line Charge. Open' (CRS275). |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. The quantity is retrieved from the service order line 'Service Order. Display line' (SOS530). For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no quantity exists, '1' is entered in this element, since it is mandatory. |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. For rental lines, advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no U/M exists, 'db' (means pcs in Hungarian) is entered in this element, since it is mandatory. For other information types, the U/M from the item master table is used. |
unitPrice |
Net sales price in sales U/M in the currency of the invoice, including all discounts and other deductions. The unit price is calculated as the 'lineNetAmount' divided by the 'quantity'. |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount |
Taxable base amount in the currency of the invoice. Net amount for item lines + external line charges of type 'csk' - any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) would always be set to 'false', so they are not included. Based on the possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimal places. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the invoice line in 'Invoice. Display Lines' (OIS351) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. For item lines (line type 31), this element shows the VAT amount of the item line + VAT amount of external line charges of type 'csk' - VAT amount of any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line, and then the VAT amount of that line charge must be included in this element as well. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Total amount payable, including VAT, in the currency of the invoice. Gross amount (including VAT) for item line + external line charges of type 'csk' - any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is reported as a separate line in the XML file. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice lines (invoiceLines) – Project order invoices (POS350)
Project order invoices use FAM function PO20.
Invoice line details for project invoices are taken from 'Invoice. Display' (STS350). One or more sections are created per XML file (per invoice).
XML element | Description |
---|---|
line | Start tag. |
lineNumber | Sequential line number, starting with 1 for each invoice. |
lineModificationReference |
Start tag. Indicating the item line level modifications for a modified invoice. To determine if the current invoice has a reference to an original invoice number, AR additional information categories 235 and 255 are checked. If this exists, the invoice number and invoice year found are used to populate the elements of this tag. If this does not exist, this tag is not created. |
lineNumberReference |
The line number of the modified original invoice, or the new line number when creating a new invoice line, continuing the line numbers of the original invoice. The number of lines for the original invoice is calculated. Other corrective invoices that refer to the same original invoice are also considered when calculating the number of lines for the original invoice. To find the original invoice number, AR additional information categories 235 and 255 are checked for the corrective invoice. To determine if there are other corrective invoices with a reference to the same original invoice number, AR additional information categories 236 and 256 are checked for the original invoice. |
lineOperation |
Invoice line modification type; 'CREATE', or 'MODIFY'. Default='CREATE'. |
referencesToOtherLines | Not used/updated. |
referencesToOtherLine | Not used/updated. |
advanceIndicator |
Indicating an advance charge. For invoice lines with line type 50 (advance charge), 'true' is written for this element. For other invoice line types, this element is not created. |
productCodes | Not used/updated. |
productCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
lineExpressionIndicator | The quantity unit of an item, if this can be expressed as a natural unit of measurement. |
lineDescription |
Description of goods and/or services supplied. For invoice lines, the item description (ITDS) field of the invoice line is used. For external header charges, the description is retrieved from language 'HU' if this exists in 'CO Charge Enter Names/Language' (OIS029), else from 'CO Charge. Open' (OIS030). |
quantity |
Quantity of goods and/or services supplied, which can be expressed in a unit of measurement. The quantity is retrieved from the project order line in 'Project invoice. Up-date Line' (POS481). If it is not set, the quantity is set to '1'. For advance invoiced lines, header charges and line charges (if reported as separate lines in the XML file), where no quantity exists, '1' is entered in this element, since it is mandatory. |
unitOfMeasure |
Sales unit of measurement of goods and/or services supplied, if it can be expressed in some unit of measurement. Default = 'OWN'. |
unitOfMeasureOwn |
Unit of measurement of goods and/or services supplied, if this can be expressed in a unit of measurement. The unit of measure is primarily taken from the invoice line, secondly from the item master. For partial invoices, advance invoiced lines, header charges (if reported as separate lines in the XML file), where no U/M exists, 'db' (means pcs in Hungarian) is entered in this element, since it is mandatory. For other information types, the U/M from the item master table is used. |
unitPrice |
Net sales price in sales U/M in the currency of the invoice, including all discounts and other deductions. The unit price is calculated as the 'lineNetAmount' divided by the 'quantity'. |
lineDiscountData | Not used/updated. |
discountDescription | Not used/updated. |
discountValue | Not used/updated. |
discountRate | Not used/updated. |
lineAmountsNormal | Start tag. |
lineNetAmount |
Taxable base amount in the currency of the invoice. Net amount for item lines + external line charges of type 'csk' - any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatRate |
Start tag. The VAT rate applied. This tag only contains one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) would always be set to 'false', so they are not included. Based on the possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, determines which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimal places. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the invoice line in 'Invoice. Display Lines' (OIS351) to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text is retrieved from (CRS882). If this does not exist, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT is out of scope, and 'true' is written for this element. If this does not exist, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' is written for this element. If this does not exist, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
lineVatAmount |
VAT amount in the currency of the invoice. The VAT amount payable, except where, in accordance with the law, such a detail is excluded. For this element, the amount of VAT charged is expressed in the currency of the invoice. For item lines (line type 31), this element shows the VAT amount of the item line + VAT amount of external line charges of type 'csk' - VAT amount of any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line, and then the VAT amount of that line charge must be included in this element as well. If this does not exist, the line charge is not of type 'csk' and is then reported as a separate line in the XML file. |
lineVatAmountHUF | Not used/updated. |
lineGrossAmountNormal |
Total amount payable, including VAT, in the currency of the invoice. Gross amount (including VAT) for item line + external line charges of type 'csk' - any external line discounts. If the external line charge exists in (CRS881)/(CRS882), this indicates that the line charge is of type 'csk', which means that it is included in the net amount of the item line. If this does not exist, the line charge is not of type 'csk' and is reported as a separate line in the XML file. |
intermediatedService | Not used/updated. |
aggregateInvoiceLineData | Not used/updated. |
lineExchangeRate | Not used/updated. |
lineDeliveryDate | Not used/updated. |
newTransportMean | Not used/updated. |
brand | Not used/updated. |
serialNum | Not used/updated. |
engineNum | Not used/updated. |
vehicle | Not used/updated. |
engineCapacity | Not used/updated. |
enginePower | Not used/updated. |
firstEntryIntoService | Not used/updated. |
kms | Not used/updated. |
depositIndicator | Not used/updated. |
marginSchemeIndicator | Not used/updated. |
ekaerIds | Not used/updated. |
ekaerId | Not used/updated. |
obligatedForProductFee | Not used/updated. |
GPCExcise | Not used/updated. |
dieselOilPurchase | Not used/updated. |
purchaseLocation | Not used/updated. |
countryCode | Not used/updated. |
region | Not used/updated. |
postalCode | Not used/updated. |
City | Not used/updated. |
additionalAddressDetail | Not used/updated. |
purchaseDate | Not used/updated. |
vehicleRegistrationNumber | Not used/updated. |
dieselOilQuantity | Not used/updated. |
netaDeclaration | Not used/updated. |
productFeeClause | Not used/updated. |
productFeeTakeoverData | Not used/updated. |
takeover | Not used/updated. |
amount | Not used/updated. |
customerDeclaration | Not used/updated. |
productStream | Not used/updated. |
productWeight | Not used/updated. |
lineProductFeeContent | Not used/updated. |
productFeeCode | Not used/updated. |
productCodeCategory | Not used/updated. |
productCodeValue | Not used/updated. |
productQuantity | Not used/updated. |
measuringUnit | Not used/updated. |
productFeeRate | Not used/updated. |
productFeeAmount | Not used/updated. |
additionalLineData | Not used/updated. |
dataName | Not used/updated. |
dataDescription | Not used/updated. |
dataValue | Not used/updated. |
Invoice summary (invoiceSummary)
Totals per invoice. Details from the invoice voucher in the general ledger. One section is created per XML file (per invoice).
The section for <vatRate> consists of sub totals per VAT rate, whereas the sections for <invoiceNetAmount>, <invoiceVatAmount>, <invoiceVatAmountHUF> and <invoiceGrossAmount> are the invoice total amounts summarized from the <vatRate> elements.
XML element | Description |
---|---|
summaryNormal | Start tag. |
summaryByVatRate | Start tag. |
vatRate |
Start tag. There can be several of these tags per invoice. Records with the same VAT rate are accumulated. For all VAT percentages included the invoice voucher, and per exemption specified per VAT code in (CRS881)/(CRS882), such a tag is created. Each tag <vatRate> (for each VAT rate) must only contain one of the underlying six elements. Two out of which (marginSchemeVat and marginSchemeNoVat) would always be set to 'false', so they are not included. Based on possible setup for different VAT codes in (CRS881)/(CRS882) for three of the remaining four elements, it is determined which one to populate based on the VAT code of the transaction. If a translation exists for the current VAT code in (CRS882) for any of those three elements, that element is included in the XML file. If no translation exists for the VAT code under any of these three elements in (CRS882), element vatPercentage is included in the XML file. |
vatPercentage |
The VAT rate applied. 2 decimals. If the VAT code for the VAT transaction for the voucher in the general ledger does not exist in (CRS881)/(CRS882) for any of the three elements below, the VAT percentage is retrieved from the VAT transaction for the voucher in the general ledger to this element. |
vatExemption |
Indication of tax exemption. In case of an exemption, reference to the applicable provision of law or to the VAT Directive, or any other reference indicating that the supply of goods or services is exempt from the payment of VAT. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT exemption, and the VAT exemption text will then be retrieved from (CRS882). If not exists, this element is not created. |
vatOutOfScope |
Excluded from the VAT Act. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT out of scope, and 'true' will be written for this element. If not exists, this element is not created. |
vatDomesticReverseCharge |
Indicates domestic reverse charging. If the VAT code for the VAT transaction for the voucher in the general ledger exists in (CRS881)/(CRS882) for this element, this indicates VAT domestic reverse charge, and 'true' will be written for this element. If not exists, this element is not created. |
marginSchemeVat | Not used/updated. |
marginSchemeNoVat | Not used/updated. |
vatRateNetAmount | Base amount for tax calculation, per VAT rate, in the currency of the invoice. |
vatRateVatAmount | VAT amount per VAT rate, in the currency of the invoice. |
vatRateVatAmountHUF |
VAT amount per VAT rate, expressed in Hungarian Forints (HUF) even if all other details are expressed in another currency. The currency set up in 'Country. Open' (CRS045) for the base country code of the invoice is used for the VAT amount for this element. |
vatRateGrossAmount | Calculated gross amount, including VAT, in the currency of the invoice, per VAT rate. |
invoiceNetAmount |
Total net amount per invoice, expressed in the currency of the invoice. Amounts from the elements under <vatRateNetAmount> are summarized. |
invoiceVatAmount |
Total VAT amount per invoice, expressed in the currency of the invoice. Amounts from the elements under <vatRateVatAmount> are summarized. |
invoiceVatAmountHUF |
Total VAT amount per invoice, expressed in Hungarian Forints (HUF). Amounts from the elements under <vatRateVatAmountHUF> are summarized. |
invoiceGrossAmount |
Total gross amount per invoice, expressed in the currency of the invoice. Amounts from elements under <vatRateGrossAmount> are summarized. |
Example of XML files
This XML file concerns an ordinary customer order invoice, created in 'CO Invoice. Print' (OIS180), with two item lines, a header charge, and two external line charges, out of which one line charge is of type 'csk', and is therefore included in the first item line, whereas the second line charge is reported as a separate line in the XML file.
This XML file concerns a corrective invoice, created in 'CO Invoice. Correct or Credit' (OIS380), in which the first item line in the previous invoice has been corrected.