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.

Related topics