The regulations of IAPR stimulate that the values of invoices must be transmitted in euro. In cases where the currency is not in euro, it is suggested to include the AC fields (alternative currency) in the JSON file document. The implementation should be developed in the customer's systems to avoid the risk of significant discrepancies during the transformation from foreign currency to euros. By following this procedure, the amounts of the documents transmitted to IAPR correspond to those in the customer's systems.
json definition with remarks:
{
"CurrencyCode": "USD",
"InvoiceTypeCode": "1.1",
"DocumentType": "INVOICE",
"DocumentTypeCode": "INVOICE",
"Series": "016",
"Number": "111",
"DateIssued": "2024-10-17T00:00:00",
"Issuer": {
"RegisteredName": "Company",
"BrandName": "Company Α.Β.Ε.Ε.",
"Vat": "EL123456789",
"TaxOffice": "Φ.Α.Ε. ΑΘΗΝΩΝ",
"Activities": [
"ΑΝΩΝΥΜΟΣ ΒΙΟΜΗΧΑΝΙΚΗ & ΕΜΠΟΡΙΚΗ ΕΤΑΙΡΕΙΑ"
],
"Phones": [
"2103333333"
],
"Faxes": [
"2106666733"
],
"Emails": [],
"Url": "",
"Address": {
"Country": "",
"CountryCode": "GR",
"City": "Πόλη",
"Street": "Οδός",
"Postal": "15351"
},
"BranchCode": 0,
"BranchId": "",
"BranchAddress": {
"Country": "",
"CountryCode": "",
"City": "Πόλη",
"Street": "Οδός",
"Postal": "15351"
},
"BranchPhones": [
"21066654444"
],
"BranchFaxes": [
"2106666744"
]
},
"CounterParty": {
"RegisteredName": "Customer",
"BrandName": "Customer Brand",
"Vat": "123456789",
"TaxOffice": "",
"Activities": [
""
],
"RegistrationNumber": "",
"Phones": [
"210 799 1111",
"210 799 1111"
],
"Faxes": [],
"Emails": [],
"Url": "",
"Address": {
"Country": "",
"CountryCode": "GR",
"City": "Αθήνα",
"Street": "Αμφιθέας ",
"Postal": "11813"
}
},
"DistributionDetails": {
"InternalDocumentId": "0_16121213"
},
"PaymentDetails": {
"PaymentMethods": [
{
"PaymentMethodTypeCode": "5",
"PaymentMethodType": "On credit",
"Amount": 624.49,
"AmountAC": 672.00
}
],
"ExchangeCurrencyRate": 0.9293
},
"AdditionalDetails": {
"AccountingDepartmentEmails": [],
"TransmissionMethod": "A"
},
"Details": [
{
"LineNo": 36024,
"Code": "00037",
"Descriptions": [
"0. CHARGE 1"
],
"MeasurementUnitCodeEN": "EA",
"Quantity": 1.00,
"UnitPrice": 92.93,
"NetTotal": 92.93,
"Total": 115.23,
"VATTotal": 22.30,
"UnitPriceAC": 100.0,
"NetTotalAC": 100.00,
"VATTotalAC": 24.00,
"TotalAC": 124.00,
"VatCategory": "ΦΠΑ συντελεστής 24%",
"VatCategoryCode": "1",
"IncomeClassification": {
"ClassificationTypeCode": "E3_561_001",
"ClassificationCategoryCode": "category1_3"
}
},
{
"LineNo": 36025,
"Code": "00038",
"Descriptions": [
"0. CHARGE 2"
],
"MeasurementUnitCodeEN": "EA",
"Quantity": 1.00,
"UnitPrice": 185.86,
"NetTotal": 185.86,
"Total": 230.47,
"VATTotal": 44.61,
"UnitPriceAC": 200.0,
"NetTotalAC": 200.00,
"VATTotalAC": 48.00,
"TotalAC": 248.00,
"VatCategory": "ΦΠΑ συντελεστής 24%",
"VatCategoryCode": "1",
"IncomeClassification": {
"ClassificationTypeCode": "E3_561_001",
"ClassificationCategoryCode": "category1_3"
}
},
{
"LineNo": 36026,
"Code": "00039",
"Descriptions": [
"0. CHARGE 3"
],
"MeasurementUnitCodeEN": "EA",
"Quantity": 1.00,
"UnitPrice": 278.79,
"NetTotal": 278.79,
"Total": 278.79,
"VATTotal": 0.00,
"UnitPriceAC": 300.0,
"NetTotalAC": 300.00,
"VATTotalAC": 0.00,
"TotalAC": 300.00,
"VatExemptionCategoryCode": "5",
"VatCategory": "Άνευ Φ.Π.Α. 0%",
"VatCategoryCode": "7",
"IncomeClassification": {
"ClassificationTypeCode": "E3_561_001",
"ClassificationCategoryCode": "category1_3"
}
}
],
"VatAnalysis": [
{
"Name": "24,00",
"Percentage": 24.00,
"VatAmount": 66.91,
"VatAmountAC": 72.00,
"underlyingValue": 278.79,
"underlyingValueAC": 300.00
},
{
"Name": "0",
"Percentage": 0,
"VatAmount": 0,
"underlyingValue": 278.79,
"underlyingValueAC": 300.00
}
],
"Summaries": {
"TotalNetAmount": 557.58,
"TotalVATAmount": 66.91,
"TotalGrossValue": 624.49,
"TotalNetAmountAC": 600.00,
"TotalVATAmountAC": 72.00,
"TotalGrossValueAC": 672.00
},
"MiscellaneousData": {
"MoreInformation1": "More information you can find in..."
},
"isDelayedCode": 0
}
Important remarks
- Issuer: Τhe details of the issuer are entered in this object and it is mandatory for all the invoices
- Counterparty: Τhe details of the counterparty are entered in this object. It is mandatory for the B2Β invoices.
- InternalDocumentId: It is a unique document number in the issuer’s system
- PaymethodTypeCode: This code corresponds to the paragraph 8.12 of IAPR myDATA manual
- ExchangeCurrencyRate: It refers to the exchange rate between foreign currency and euro
- TransmissionMethod: If this field has value “E”, an email with the invoice url will be sent to the email address that has being setted to the field “AccountingDepartmentEmails”. If it has value “A”, the invoice is only going to be archived.
- Details: In this object, each line is a product/service that you sell and all the details of it.
- Summaries: the summary ammounts
- VatAnalysis: The analysis of vat amounts by percentage
- IsDelayedCode: This field is used for heterochronous transmission. Value 0: Realtime, 1: Problem on the issuer side, 2: Problem on the IAPR side
- All values with and without VAT must be included in all fields related to foreign currencies (AC). Only in cases of foreign countries can VAT values in foreign currency be zero.