☰

Navigation:

Getting Started with Viva Fiscalisation

Before you begin

Please start by reading the fiscalisation guide on the Viva Developer Portal: Fiscalisation | Viva.com Developer Portal and Viva Fiscalisation for ISVs | Viva.com Developer Portal, specifically the section for Greece and the business use case code samples here: https://developer.viva.com/viva-fiscalisation/greece/samples/

Demo environment setup

1. Create a demo account

Create a demo merchant account here: https://demo.vivapayments.com/en/signup

Then provide us with the Demo Merchant ID that you will find here: https://demo.vivapayments.com/selfcare/en/security/apiaccess

Important: Your VAT number (ΑΦΜ) must be valid and corporate. It can be whatever you want for testing purposes, but it must be the same as the one you will send during document issuance tests.

2. Download the Viva Terminal app (Demo)

Download the Demo version of the Viva Terminal app from here: SPoC-PayApp-hotfix-5.39.4-demo-protected.apk

Make sure you always have the latest version of the Viva Terminal App DEMO.

3. Enable POS APIs Credentials

You also need to enable the POS APIs Credentials in the same section (API Access), in case of integration with our Cloud REST API.

You will find more general information regarding the integration methods here:

4. Start Receipt request

Once we receive your Merchant ID and activate fiscalisation on your account, you will need to send a Start Receipt request — this is done once per Merchant ID/merchant.

Example: https://developer.viva.com/viva-fiscalisation/greece/samples/#startreceipt

When calling the start receipt, the amount must be greater than 0 (you can assign any value you want to it).

5. ftReceiptCaseData

Pay attention to the ftReceiptCaseData payload: Greece | Viva.com Developer Portal

For any help, let us know in the Group chat.

Production onboarding steps

As soon as you have a merchant ready for onboarding, follow the steps below:

Step 1

Create a production account on Viva.com.

Step 2

Contract signing. Here you will speak with your ISV Manager.

Step 3

Go to TaxisNet (log in with the client entity’s credentials).

Then, go to the Authorizations (Εξουσιοδοτήσεις) page.

Scroll down and select New (Νέα) on the right side to create a new authorization.

Enter the tax registration number in the VAT (ΑΦΜ) field and click on Register Authorization (Καταχώρηση εξουσιοδότησης) to create the new authorization.

The screen will refresh and the authorization request will now appear under the E-Invoicing Providers (Πάροχοι Ηλεκτρονικής Τιμολόγησης) section. The status of the request will appear in orange and in bold as Pending Reception (Σε αναμονή υποδοχής), under the Status (Κατάσταση) column.

Step 4

Let us know that they have completed Step 3 so we can give internal instructions to accept it.

Step 5

Go to AADE Bookkeeper.

Select Declarations of electronic issuance of elements via Provider, Self-Provider (A.1112, Article 6) (Δηλώσεις ηλεκτρονικής έκδοσης στοιχείων μέσω Παρόχου, ΙδιοΠαρόχου (Α.1112, Άρθρο 6)).

Fill in the date in the Start date of issuing obligation (Ημ. έναρξης απ. έκδοσης) field from which the obligation to issue electronic B2C and/or B2B invoices became effective for the specific business.

From the Software Selection (Επιλογή λογισμικού) drop-down menu, choose VIVA WALLET HOLDINGS - SOFTWARE DEVELOPMENT S.A.+ - Viva Fiscal.

Fill in today’s date in the Contract signing date (Ημ. σύναψης σύμβασης) field.

Fill in the desired start date for the provision of services (fiscalisation) by Viva Fiscal in the Effective start date (Ημ. έναρξης ισχύος) field.

Step 6

Proceed with a request to activate Viva Fiscal on the account, mentioning the ISV Manager. Provide the entity’s VAT number and, if it has branches, the following:

Fiscalisation API for Online Sales

Where you can use it

The new API is intended for documents concerning online sales that are paid electronically (Viva SmartCheckout, bank transfer, etc.) and typically serves scenarios such as the following:

Scenario A – Purchase of services 1. Purchase/Order and execution of payment 2. Simultaneous, immediate, or near-immediate issuance of a document and transmission of document data to myDATA

Scenario B – Purchase of products 1. Purchase/Order and execution of payment 2. Subsequent issuance of a document and transmission of document data to myDATA