☰

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

(https://developer.viva.com/downloads/fiscalisation/Viva-Fiscalisation-App-demo-5.40.8.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

Activate Viva Fiscal from the merchant’s self-care portal:

  1. Go to vivapayments.com/selfcare/el/integrations/vivafiscal, or navigate there from the menu under Ενσωματώσεις → Viva Fiscal.
  2. Click Enable.
  3. Complete the form. It asks for the merchant’s internet provider (ISP), the contract number and date, and the planned start date for e-invoicing. These are required under clause 3.11 of the terms of use, which obliges the merchant to declare an alternative internet connection.
  4. Tick the terms of use checkbox, then click Αίτηση ενεργοποίησης.

Viva Fiscal activation form

Note: The form covers the activation request only. Branches cannot be declared here — see Step 3.

Step 3

Branches have to be set up separately, as the self-care form does not handle them. Contact your ISV Manager and provide the entity’s VAT number, plus the following for each branch:

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