eINVOICING
  1. API Endpoints
eINVOICING
  • eInvoicing Service
    • About Us
    • What We Offer
    • FAQ
    • Changelog
    • On Boarding
    • eInvoicing Service API
      • API Authentication
        • API Key Authentication
          • /Authentication/login
        • Bearer Token Authentication
          • Authentication Login Bearer Token
          • Authentication Refresh
      • API Endpoints
        • API Validations
        • Sending a Document
          • Sending a Document
          • Mandatory Fields B2C, B2B
          • Mobile Notifications
          • IAPR SIGN POLICY METHODS
          • QR OF THE DOCUMENT
          • einvoice/json
          • Invoice/credit
        • Purchase Orders for F&B
          • FnB Purchase Orders Documentation
          • Offline QR Code Implementation
          • Retrieve Open Order Documents (FnB)
        • Document Management
          • Retrieving a document
          • PDF Invoice Attachment
        • Alternative Currency Holding
          • ALTERNATIVE CURRENCY (AC)
        • Delivery Notes
          • Delivery Notes Documentation
          • /Invoice/cancelDeliveryNote
        • POS Integration
          • POS Integration
          • Offline QR Code Implementation
          • /PosSignatures/{issuerTin}
          • /Receipt
          • /PosTransactions/signpos
        • Delayed POS Payment
          • Delayed POS Payment
        • B2G Documents
          • B2G Documents
          • B2G Mandatory Fields
          • B2G Status response
          • B2G Soft Reject
          • RESEED INVOICE
          • ΕΓΚΥΚΛΙΟΣ ΠΡΟΣ ΠΑΡΟΧΟΥΣ-ΠΡΟΜΗΘΕΥΤΕΣ ΥΠΗΡΕΣΙΩΝ ΥΓΕΙΑΣ ΓΙΑ ΤΗΝ ΗΛΕΚΤΡΟΝΙΚΗ ΤΙΜΟΛΟΓΗΣΗ
          • BT-10 BuyerReference
          • /B2GInvoice/ReSeedInvoice
          • /B2GInvoice/GetLastStatus
      • JSON Structures & Payloads
        • EliseCoreDocument Structure
          • EliseCoreDocument Structure
        • Minimum & Conditional Fields
          • Minimum & Conditional Fields
        • Response Examples & Error Handling
          • Response Examples & Error Handling
      • Offline QR Code
        • Offline QR Code Instructions
      • Status MyData
        • MyData/status
      • Extra Functionalities
        • Archiver
          • Archiver Functionality
      • Terminology
        • Document Type Codes
        • VAT & TAX Codes
        • Country & Currency Codes
        • Measurement Unit Codes (IAPR & EN16931)
        • Self-Billing Remarks (IAPR)
        • Classification & Payment Method Codes (IAPR)
        • Special Invoice Category
      • VAT Validation
        • Greek VAT Check
        • EU VAT Check
      • Attachments
        • Attaching Media & PDFs
        • Invoice Document Upload (Invoice/File)
      • SOFTONE ERP Related Segments
        • SOFTONE Configurator
          • SOFTONE Configurator - B2G Mapping
    • eInvoicing Portal
      • Template Configuration (Default Template)
      • Single Sign-On (SSO)
        • Single Sign-on (SSO) Setup Instructions
        • Single Sign-On (SSO)
    • WIKI JSON Samples
      • 1.1 B2B
      • 1.3 B2B Sales Invoice Third Country
      • 5.2 B2B Credit Invoice Non-Associated
      • 2.1 B2B Service Rendered Invoice
      • 1.1 Debit B2G
      • 11.1 B2C Retail Sales Receipt
      • 11.4 Retail Sales Credit Note
  1. API Endpoints

Purchase Orders for F&B

1. Introduction#

The issued document is a type of FNB purchase order, to receive data from purchase orders issued for FNB transactions. Businesses are obliged to transmit the relevant Document Type to the myDATA digital platform. Within twenty-four (24) hours from the date and time of issuance, the business is obligated to correlate all the Document Types (8.6) with the issuance of debit and zero values documents. The non-correlation of Document Types 8.6 per usage with value documents is recorded and entails consequences for the business that affect its transactional activity.
We have three types of documents : (1) FNB form, (2) FNB return Form recType7, (3) FNB Cancel form.
At the end of the date all FNB documents (8.6) must be equal to the issued documents. Zero debit documents must be issued as well.
PORTAL: Find all issued 8.6 FnB in the submenu Food N Beverage –MY DATA (menu invoices)

POST Domain/invoice/json (depends on the provider you use)

SOFTONE IMPACT
https://einvoiceapiuat.impact.gr/invoice/json (UAT)
https://einvoiceapi.impact.gr/invoice/json (Production)

SOFTONE
https://einvoice-demo.s1ecos.gr/invoice/json (UAT)
https:einvoice.coreapi.s1ecos.gr/invoice/json (Production)

FnB 8.6 JSON Sample#


    "CurrencyCode": "EUR",​

    "InvoiceType": "Δελτίο Παραγγελίας Εστίασης/FNB Form 8.6",​

    "InvoiceTypeCode": "8.6",​

    "DocumentTypeCode": "INVOICE",​

    "Series": "FNB",​

    "number": 123,​

     "dateIssued": "2024-07-24T00:00:00",​

    "OrderCode": "Order 1",​

    "tableId": "2/20",​

    "issuer": {​

        "registeredName": "Ταβέρνα Γ.",​

  "vat": "EL111111111",​

        "taxOffice": "ΔΟΥ ΣΤ ΑΘΗΝΩΝ",​

        "GeneralCommercialRegistryNumber": "2154697391",​

        "activities": [ "Ταβέρνα" ],​

        "address": {​

            "countryCode": "GR",​

            "city": "Αθήνα",​

            "street": "Αθήνας",​

            "number": "32",​

            "postal": "15342"},​

        "phones":[2109929299],​

        "branchCode": 0,​

        "branch": "Κεντρικό κατάστημα" },​

"AdditionalDetails": {​

        "AccountingDepartmentEmails": [​

            "test@example.com"],​

        "TransmissionMethod": "A",​

        "AvoidEmailGrouping": false },​

    "DistributionDetails": {​

        "internalDocumentId": "c3417575595",​

        "salesman": "Σερβιτόρος Α1", ​

"content":"Άτομα 3" },
"Details": [​

        { "LineNo": 1,​

            "code": "251320104",​

            "Descriptions": [​

                " Product " ],​

            "MeasurementUnitCode": 1,​

            "MeasurementUnit": "ΤΜΧ",​

            "Quantity": 100,​

            "UnitPrice": 1.09,​

            "allowancesTotal": 0.0,​

            "NetTotal": 109.73,​

            "VatCategory": "13",​

            "VatCategoryCode": 2,​

            "VATTotal": 14.27,​

            "Total": 124,​

            "IsInformative": false,​

            "IsHidden": false,​

            "RecordTypeCode": 0,​

            "noVat":true,​

                 "IncomeClassification": {​

                "ClassificationTypeCode": "",​

                "ClassificationCategoryCode": "category1_95" }} ],​

    "Summaries": {​

        "totalAllowances": 0.0,​

        "TotalNetAmount": 109.73,​

        "TotalVATAmount": 14.27,​

        "TotalGrossValue": 124​

    },​

    "VatAnalysis": [​

        {​

            "Percentage": 13.0,​

            "VatAmount": 14.27,​

            "UnderlyingValue": 109.73 }],​

    "IsDelayedCode": 0}

FnB Return 8.6 JSON Sample#


    "CurrencyCode": "EUR",​

    "InvoiceType": "Δελτίο Παραγγελίας Εστίασης/FNB Form 8.6",​

    "InvoiceTypeCode": "8.6",​

    "DocumentTypeCode": "INVOICE",​

    "Series": "FNB",​

    "number":"123",​

    "dateIssued": "2024-07-01T13:33:43.845",​

    "OrderCode": "Order 1",​

    "tableId": "2/20",​

    "issuer": {​

        "registeredName": "Ταβέρνα Γ.",​

        "vat": "EL111111111",​

 "taxOffice": "ΔΟΥ ΣΤ ΑΘΗΝΩΝ",​

        "GeneralCommercialRegistryNumber": "2154697391",​

        "activities": [​

            "Ταβέρνα"],​

        "address": {​

            "countryCode": "GR",​

            "city": "Αθήνα",​

            "street": "Αθήνας",​

            "number": "32",​

            "postal": "15342"},​

        "phones": [2109929299 ],​

        "branchCode": 0,​

        "branch": "Κεντρικό κατάστημα"},​

    "AdditionalDetails": {​

        "AccountingDepartmentEmails": [​

            "test@example.com"​

        ],​

        "TransmissionMethod": "A",​

        "AvoidEmailGrouping": false​

    },​

    "DistributionDetails": {​

        "InternalDocumentId": "13432434",​

        "salesman": "Σερβιτόρος Α1", ​

 "content": "Άτομα 3“},
  "Details": [​

        {​

            "LineNo": 1,​

            "code": "251320104",​

            "Descriptions": [​

                " Product " ],​

            "MeasurementUnitCode": 1,​

            "MeasurementUnit": "ΤΜΧ",​

            "Quantity": 100,​

            "UnitPrice": 1.09,​

            "allowancesTotal": 0.0,​

            "NetTotal": 109.73,​

            "VatCategory": "13",​

            "VatCategoryCode": 2,​

            "VATTotal": 14.27,​

            "Total": 124,​

            "IsInformative": false,​

            "IsHidden": false,​

            "RecordTypeCode": 7,​

            "noVat": true,​

            "IncomeClassification": {​

                "ClassificationTypeCode": "",​

                "ClassificationCategoryCode": "category1_95"​

            }}],​

    "Summaries": {​

        "totalAllowances": 0.0,​

        "TotalNetAmount": 109.73,​

        "TotalVATAmount": 14.27,​

        "TotalGrossValue": 124​

    },​

    "VatAnalysis": [​

        {​

            "Percentage": 13.0,​

            "VatAmount": 14.27,​

            "UnderlyingValue": 109.73​

        }​

    ],​

    "IsDelayedCode": 0}

Data Types of JSON Fields#

NameTypeImportanceDescription
measurementUnitstringMandatoryProduct’s Measurement Unit (kg, piece, etc)
measurementUnitCodeintegerMandatoryProduct’s Measurement Unit (IAPR)
quantitynumberMandatoryProduct Quantity
totalNetAmountnumberMandatoryTotal Net Amount
totalGrossValuenumberMandatoryTotal Gross Value, sum of Details Totals
VatCategoryCodeintegerMandatoryVat Category Code
RecordTypeCodestringMandatoryNEGATIVEVAL (7): Line contains negative values
tableIdstringMandatoryThe ID of the table of the FnB
noVatbooleanOptionalIndicator of NoVat for myData. Allowed for Elise.Models.Format.EliseCore.EliseCoreDocument.InvoiceTypeCode 1.1 - 11.5. In the 8.6, in case the field is not present, the provider sends it by default as 'true' to the IAPR.

FnB Cancel JSON Sample#


    "CurrencyCode": "EUR",​

    "InvoiceType": "Δελτίο Παραγγελίας Ακύρωσης 8.6 /FNB Cancel Form 8.6",​

    "InvoiceTypeCode": "8.6",​

    "DocumentTypeCode": "INVOICE",​

    "Series": "FNBC1",​

    "number": "5641",​

    "dateIssued": "2024-07-01T13:33:43.845",​

    "multipleConnectedMarks": [​

        400001930204042],​

    "cancelDeliveryOrders": true,​

    "OrderCode": "Order 1",​

 "tableId": "2/20",​

    "issuer": {​

        "registeredName": "Ταβέρνα Γ.",​

 "vat": "EL111111111",​

        "taxOffice": "ΔΟΥ ΣΤ ΑΘΗΝΩΝ",​

        "GeneralCommercialRegistryNumber": "2154697391",​

        "activities": [ "Ταβέρνα" ],​

        "address": {​

            "countryCode": "GR",​

            "city": "Αθήνα",​

            "street": "Αθήνας",​

            "number": "32",​

            "postal": "15342"},​

        "phones":[2109929299],​

        "branchCode": 0,​

        "branch": "Κεντρικό κατάστημα" },​

"AdditionalDetails": {​

        "AccountingDepartmentEmails": [​

            "test@example.com"],​

        "TransmissionMethod": "A",​

        "AvoidEmailGrouping": false },​

    "DistributionDetails": {​

        "InternalDocumentId": "251320104",​

        "salesman": "Σερβιτόρος Α1", ​

  "content":"Άτομα 3" },
  
  "Details": [​

        { "LineNo": 1,​

            "code": "251320104",​

            "Descriptions": [​

                “Canceled Product" ],​

            "MeasurementUnitCode": 1,​

            "MeasurementUnit": "ΤΜΧ",​

            "Quantity": 100,​

            "UnitPrice": 0.0,​

            "allowancesTotal": 0.0,​

            "NetTotal": 0.0,​

            "VatCategory": 0,​

            "VatCategoryCode": 8,​

            "VATTotal": 0.0,​

            "Total": 0.0,​

            "IsInformative": false,​

            "IsHidden": false,​

            "RecordTypeCode": 0,​

                 "IncomeClassification": {​

                "ClassificationTypeCode": "",​

                "ClassificationCategoryCode": "category1_95" }} ],​

    "Summaries": {​

        "totalAllowances": 0.0,​

        "TotalNetAmount": 0.0,​

        "TotalVATAmount": 0.0,​

        "TotalGrossValue": 0.0​

    },​

    "VatAnalysis": [​

        {​

            "Percentage": 0.0,​

            "VatAmount": 0.0,​

            "UnderlyingValue": 0.0 }],​

    "IsDelayedCode": 0}
  

Data Types of JSON Fields#

NameTypeImportanceDescription
multipleConnectedMarkslistMandatoryRelation to 8.6 myData documents using their Elise.Models.Format.EliseCore.EliseCoreDocument.Mark. Forbidden for Elise.Models.Format.EliseCore.EliseCoreDocument.InvoiceTypeCode 1.6, 2.4 and 5.1
cancelDeliveryOrdersbooleanMandatoryFlag indicating cancellation of myData table orders
measurementUnitstringOptionalProduct’s Measurement Unit (kg, piece, etc)
measurementUnitCodeintegerOptionalProduct’s Measurement Unit (IAPR)
quantitynumberMandatoryProduct Quantity
totalNetAmountnumberMandatoryTotal Net Amount
totalGrossValuenumberMandatoryTotal Gross Value, sum of Details Totals
VatCategoryCodeintegerMandatoryVat Category Code
RecordTypeCodestringMandatoryNEGATIVEVAL (7): Line contains negative values
tableIdstringMandatoryThe ID of the table of the FnB
noVatbooleanOptionalIndicator of NoVat for myData. Allowed for Elise.Models.Format.EliseCore.EliseCoreDocument.InvoiceTypeCode 1.1 - 11.5. In the 8.6, in case the field is not present, the provider sends it by default as 'true' to the IAPR.

Debit & Credit Invoices - Important Remark
In this case, the data is associated with Document Types of debit and credit invoices that affect the accounting and tax result and which mandatorily bear the indication “SpecialInvoiceCategory”:”12”

11.1 JSON Sample#


    "CurrencyCode": "EUR",​

    "InvoiceType": " ΑΠΟΔΕΙΞΗ ΛΙΑΝΙΚΗΣ ΠΩΛΗΣΗΣ",​

    "InvoiceTypeCode": "11.1",​

    "SpecialInvoiceCategory": 12,​

    "DocumentTypeCode": "INVOICE",​

    "IsDeliveryNote": false,​

    "Series": "ΑΛΠ",​

    "number": "32362",​

   "dateIssued": "2024-07-01T13:33:43.845",​

    "RelativeDocuments": ["", "" ],​

    "multipleConnectedMarks": [400001929492771],​

    "OrderCode": "101",​

   "issuer": {​

        "registeredName": "Ταβέρνα Γ.",​

        "vat": "EL111111111",​

      "taxOffice": "ΔΟΥ ΣΤ ΑΘΗΝΩΝ",​

        "GeneralCommercialRegistryNumber": "2154697391",​

        "activities": [​

            "Ταβέρνα"],​

        "address": {​

            "countryCode": "GR",​

            "city": "Αθήνα",​

            "street": "Αθήνας",​

            "number": "32",​

            "postal": "15342" },​

        "phones":[2109929299],​

        "branchCode": 0,​

        "branch": "Κεντρικό κατάστημα" },​

    "CounterParty": {​

        "RegisteredName": "ΠΕΛΑΤΗΣ ΛΙΑΝΙΚΗΣ",​

        "Vat": "",​

        "Address": {​

            "CountryCode": "GR",​

            "Municipality": "ΑΘΗΝΑ",​

            "City": "ΑΘΗΝΑ",​

            "Street": "Κηφισού",​

            "number": "32",​

            "Postal": "11000"} },
            
    "AllowancesCharges": [],​

    "DistributionDetails": {​

        "InternalDocumentId": "42"},​

    "PaymentDetails": {​

        "PaymentMethods": [​

            { "PaymentMethodType": "ΕΠΙ ΠΙΣΤΩΣΕΙ",​

                "PaymentMethodTypeCode": 5,​

                "Amount": 124}]},​

    "AdditionalDetails": {​

        "AccountingDepartmentEmails": [""],​

        "TransmissionMethod": "A",​

        "AvoidEmailGrouping": false},​

    "Details": [ {"LineNo": 1,​

            "ClassificationLineNo": 1,​

            "Descriptions": [ "COCA COLA 330ml" ],​

            "MeasurementUnit": "τεμάχια",​

            "MeasurementUnitCode": 1,​

            "Quantity": 100,​

            "UnitPrice": 1.09,​

            "NetTotal": 109.73,​

            "VatCategory": "13",​

            "VatCategoryCode": 2,​

            "VATTotal": 14.27,​

            "Total": 124,​

            "IsInformative": false,​

            "IsHidden": false,​

            "RecordTypeCode": 0,​

            "IncomeClassification": {​

                "ClassificationTypeCode": "E3_561_003",​

                "ClassificationCategoryCode": "category1_1" } } ],​

    "Summaries": {  "TotalNetAmount": 109.73,​

        "TotalVATAmount": 14.27,​

        "TotalGrossValue": 124 },​

    "VatAnalysis": [{​

            "Percentage": 13.0,​

            "VatAmount": 14.27,​

            "UnderlyingValue": 109.73 } ],​

    "MiscellaneousData": {},​

    "IsDelayedCode": 1}

Data Types of JSON Fields#

NameTypeImportanceDescription
measurementUnitstringMandatoryProduct’s Measurement Unit (kg, piece, etc)
measurementUnitCodeintegerMandatoryProduct’s Measurement Unit (IAPR)
quantitynumberMandatoryProduct Quantity
totalNetAmountnumberMandatoryTotal Net Amount
TotalGrossValuenumberMandatoryTotal Gross Value, sum of Details Totals
VatCategoryCodeintegerMandatoryVat Category Code
“SpecialInvoiceCategory": 12integerMandatoryIndicates that the invoice is correlated to FnB purchase order
MultipleConnectedMarkslong numberMandatoryAbility to connect the invoice with multiple number of Marks (8.5, 8.6)

Q&A#


What happens if I have issued an order 8.6 and I want to cover the entire amount for the table?
I issue a new order 8.6 with recordTypeCode 7, which includes the entire amount and items from the original order. In this scenario, I need to issue a zero debit document, correlating the two orders 8.6 using the 'multipleConnectedMarks' field.

What happens in the case where we want to apply a discount/complimentary for part of the amount?
In this case, I issue a new 8.6 with recordTypeCode 7, including all the values and quantities from the first one. Then, I issue a third 8.6 with the amounts that the customer needs to pay. Afterward, I issue a debit document that correlates all three marks of the 8.6 FNB to close them.

What happens to the order if a customer moves to another table?
We close the customer's current order 8.6 with a new one using recordTypeCode 7 and issue a zero debit document. Then, we open a new 8.6 order at the table where the customer moved.

If a customer wants to leave the table and pay for their portion of the bill while others are still present, what should be done in this case?
I issue a debit document for the amount paid for order note 8.6 with the correlated MARK X. For the remaining amount, I issue a new debit document for the correlated order 8.6 with the same MARK X.

If, after a customer leaves the table, the remaining individuals order additional items, what should be done?
Then the procedure from the previous question regarding the customer who left is followed. However, in this case, we have at least one more order note 8.6 with MARK Y. Therefore, a debit document will be issued with the correlated MARKS (MARK X and MARK Y).

What if a customer wants to pay half of the bill with a receipt and the rest with an invoice?
In this case, I issue an invoice for the amount related to purchase order 8.6, and correspondingly a receipt for the same purchase order 8.6.

What about self delivery invoices 6.1 in such cases?
Self-delivery invoice is done independently. Regarding 6.1, it is out of scope in relation to the 8.6 FNB documents, as 6.1 only concerns the issuer's electronic books for the VAT payment on products and services used.

Can we have discrepancies in the 8.6 with the closing FNB documents we transmit to the IAPR?
The values of the 8.6 FNB documents may be less than or equal to the values of the 11.1 documents plus 0.10 for rounding margin.

What are the main checks that are performed?
As the first check, we are interested in ensuring that all 8.6 FNB documents are correlated with a receipt (e.g., 11.1). The second check concerns the closure of the 8.6 documents in relation to the 11.1 documents. If the first check is valid, an automatic calculation check of all 8.6 FNB documents against the 11.1 documents will be performed, covering complex correlation scenarios.
Modified at 2025-03-11 11:54:25
Previous
Invoice/credit
Next
FnB Purchase Orders Documentation
Built with