Select region API v1.2 myDATA classifications myDATA examples API v1.1

Service Rendered Receipt

When selling services to private individuals, you are required to issue a “Service rendered receipt” (myDATA document type 11.2). In some cases, service receipts must be specially marked for taxation purposes. Elorus integrates with SoftOne EINVOICING, a certified provider of electronic invoicing services, to issue legally stamped receipts.

Make sure the integration with myDATA or SoftOne is activated in your Elorus account before using the guide below. If not, feel free to contact the Elorus support team for more information regarding the activation of the integration.
Please note that you may need to use SoftOne integration specifically to issue documents of this type. In order to comply with the Greek Accounting Standards you must reassure that your business is eligible to issue & send unsigned documents.

Authorization variables

Client

1.1 Create a new contact

- The guide assumes you’re working on a new Elorus organization, so this step can be omitted.

First lets create a contact so there is someone to bill. Since the case is a “Service Rendered Receipt” no VAT number is needed and only minimal contact information will be used. In a business context, contacts are individuals or businesses whom you transact with; typically your clients, leads, suppliers and partners. Since Elorus will let you manage your sales as well as your expenses, a contact may represent either a client or a supplier (or even both).

Request
curl -X POST -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/contacts/ -d '{"client_type": "4", "first_name": "Γιώργος", "last_name":"Παπαδόπουλος", "is_client": true, "is_supplier":false}'

1.2 Get contact ID

Search e.g. by “first_name” & “last_name”, to get the contact ID. Retrieved contact ID in this case is “2480507735397893496”.

Request
curl -X GET -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/contacts/?search="Γιώργος Παπαδόπουλος"&search_fields=first_name,last_name

Document type

2.1 Get document type ID

In this case, a “Service Rendered Receipt” document type will be needed. There is a “Service Rendered Receipt” document type pre-created.
Default title is “Απόδειξη παροχής υπηρεσιών”. Search by “title”, to get the document type ID. Retrieved document type ID in this case is “2480464981884143585”.
In case the title is changed or the document type is missing, use the Elorus UI to create a new one.

Request
curl -X GET -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/documenttypes/?search="Απόδειξη παροχής υπηρεσιών"&search_fields=title

Taxes

3.1 About taxes

By default there are some taxes preset in Elorus. Usually 24% tax is used for Greece “Service Rendered Receipt” so the preset tax will be retrieved and used. In case there is a need for a new tax to be created, use of Elorus' UI is mandatory.
Optional steps to create new tax:

  1. Login to your Elorus account
  2. Go to: “Settings -> Taxes”
  3. Click “+Add” on top right corner
  4. And set it up as the picture below. AADE category and title used are for example purposes.
  5. Click “Save”

3.2 Get taxes ID

Search by “percentage”, to get the tax ID. Retrieved tax ID in this case is “2476911428611605999”. Make sure that “aade_type”:1 is in the response packet.

Request
curl -X GET -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/taxes/?search="24"&search_fields=percentage

Receipt creation

4.1 Create Service Rendered Receipt

The final step, is to create the Receipt itself. The list below describes all the needed fields.

  1. X-Elorus-Organization: your organization ID
  2. calculator_mode: sets your values as “initial” or “total”, meaning before or after taxes.
    1. When “total” is used, then it is mandatory to use “unit_total” in items.
    2. When “initial” is used, then it is mandatory to use “unit_value” in items.
    3. Depending on the situation, Elorus will calculate the taxes accordingly.
  3. client: Client id - In this case we created a “Γιώργος Παπαδόπουλος” contact.
  4. draft: true or false depending on the need to issue immediately an invoice or not. If true, the invoice will not reach MyData/Softone, until issued.
  5. documenttype: Document Type ID - In this case we used “Απόδειξη παροχής υπηρεσιών” document type, associated with the corresponding “aade type”.
  6. My data specific fields: mydata_document_type - mydata_classification_category - mydata_classification_type - paid_on_receipt - payment_method
    1. mydata_document_type: aade type
    2. mydata_classification_category: income type aade
    3. mydata_classification_type: classifications of Ε3 aade
    4. paid_on_receipt: Invoice amount that was paid when invoice was issued. If “0” then you don’t need to send payment_method since Elorus will automatically apply payment_method as on credit.
    5. payment_method:
      1. “1”: Domestic Payments Account
      2. “2”: Foreign Payments Account
      3. “3”: Cash
      4. “4”: Cheque
      5. “6”: Web Banking
      6. “7”: POS / e-POS
Request
curl -X POST -H "Content-Type: application/json" -H "Authorization: Token ~Your-API-key~" -H "X-Elorus-Organization: ~Your-Organization-ID~" https://api.elorus.com/v1.1/invoices/ -d '{"calculator_mode": "total", "currency_code": "EUR", "exchange_rate": "1.000000", "client": "2480507735397893496", "date": "2022-5-16", "draft": true, "documenttype": "2480464981884143585", "mydata_document_type": "11.2", "items": [{"title": "Αναβάθμιση λογισμικού", "unit_total": "12.4", "quantity": "1", "taxes": ["2476911428611605999"], "mydata_classification_category": "category1_3", "mydata_classification_type": "E3_561_003"}], "paid_on_receipt": "12.4", "payment_method": "3"}'