eHDM Integration Add-on – Planet Studio

PlanetStudio Payment Gateway

Electronic Cash Register (eHDM)

Registration of an Electronic Cash Register in the SRC eHDM System

To register an electronic cash register and obtain its registration number, the business entity must fill out the U6 application (101. Application for Cash Register Registration) in the Reports section of the SRC eHDM system.

See the official guide here

You need to complete step 1 — Registration of the electronic cash register in the SRC eHDM system

eHDM – License

Steps required to activate the plugin:

After purchasing the eHDM plugin, you will receive the activation key or keys by email.

Copy the key, paste it into the “eHDM – License” section of your plugin, and click the “Activate” button.

eHDM – Electronic Cash Register Dashboard

Settings > SRC Information

All main data and parameters are filled in this section:

Cash Register Registration Number — get it from the Cash Registers section of your SRC account.
Company Tax ID — enter your company’s tax ID.
Taxation Type — select your company’s taxation type.
HS Code for Shipping Line — if a WooCommerce order includes shipping, it will be shown as a separate line on the cash register receipt. Enter the HS code for the shipping line.
Cashier Number — this is the default cashier number.
Request Sequence Number Start — the sequence number for SRC requests.
Language of SRC Responses — choose the preferred language for SRC responses.
Upload JKS File — for installing certificates.
Request Logging — all SRC requests and their responses will be stored in the “Request Log”.
Test Mode — intended for performing test transactions. It works if you have an SRC Test account and VPN access. For this, you need to submit an application to the SRC to receive the appropriate permission.

Settings > Cash Register Activation

This section is intended for activating the electronic cash register and checking its status.

After registering the electronic cash register in the SRC eHDM system, it must be activated. This section may be needed again only if you need to check the status of your electronic cash register.

Cash Register Departments

In this section, you can create one or more taxation departments for your electronic cash register.

Retrieve Product List

In this section, you can retrieve your product list from the SRC eHDM system for each department. Select the department and click “Get product list from the SRC eHDM system”. As a result, you will receive a file in JSON format, which can be used to automatically create a product catalog in WooCommerce.

Export to WooCommerce

As a result of this action, all products from the selected product list will be automatically added to the WooCommerce products section.

The fields received from the SRC will be filled in automatically, but it is important to note that the SRC does not provide all required fields. Those fields must be filled in manually.

Important: the old product list is not updated; a new product list is added.

Receipts

In this section, you can see all receipts, get detailed information about each receipt, and also perform a refund or duplicate a receipt.

In the “Screen Options” section, you can choose which columns need to be displayed and specify the number of rows to show.

Receipt Table Fields

Column	Description
ID	The row sequence number.
LogID	The request log ID. To see details, click on the number or open the “Request Log” section.
vPOS ID	The order number of “ArCa Payment Gateway”. To see details, click the number or open “ArCa Payment Gateway” -> order log.
WC ID	The order number of “WooCommerce”. To see details, click the number or open “WooCommerce” -> order log.
Request	There are 3 types: “receipt”, “duplicate”, or “refund”
Receipt Number	The sequence number of the receipt.
Receipt	SRC response JSON
Request Sequence Number	SRC request sequence number
Non-cash Paid Amount	–
Cash Paid Amount	–
Change	–
Partial Payment Amount	–
Prepayment Usage Amount	–
Cashier Number	–
Receipt Print Mode	There are two types: Goods mode or Prepayment mode
Buyer Tax ID	Buyer Tax ID
Used Prepayment	–
Type	–
Transaction	–
Sub-transaction	–
Non-cash Refund Amount	–
Cash Refund Amount	–
Total Refund Amount	–
Product List	–
Fiscal	–
QR	–
Receipt Registration Date	–
Actions	–

New Cash Register Receipt

There is an option to print an electronic cash register receipt manually in three ways

Non-cash

Non-cash payment — for payments made through the “ArCa Payment Gateway” payment form if, for some reason, the receipt could not be printed.
- Enter the order number of “ArCa Payment Gateway”, which you can find in the “ArCa Payment Gateway” order log.

Cash for WooCommerce Orders

Used in cases where a WooCommerce order is paid upon delivery or if, for some reason, the receipt could not be printed.
- Enter the “WooCommerce” order number, which you can find in the “WooCommerce” order log.
- Select the “WooCommerce” order status.

The QR code of the electronic cash register receipt will be automatically sent to the buyer in the WooCommerce order email.

Using Prepayment

“Using Prepayment” is applied in cases where a prepayment has been received for the order, and after completing the order it is necessary to print an electronic cash register receipt.
- Enter the “WooCommerce” order number, which you can find in the “WooCommerce” order log.
- Select the “WooCommerce” order status.

The QR code of the electronic cash register receipt will be automatically sent to the buyer in the WooCommerce order email.

Receipt Return

To return a receipt:

Enter the receipt number, or
In the “Receipts” section, click the “Refund” button for the relevant receipt.

Then you will receive information from the SRC about the receipt to be refunded.
At the end, click the “Refund” button under the received receipt.

Receipt Duplicate

To print a duplicate receipt:

Enter the receipt number, or
In the “Receipts” section, click the “Duplicate” button for the relevant receipt.

WooCommerce Product Configuration

After activation, the e-HDM Plugin will add the “eHDM – Product or Service Parameters” subsection to the WooCommerce product editing page.

Product Name (Maximum 50 characters, cannot be empty)
The value specified in the “Short name on receipt” field of the Cash Register product list page in the SRC eHDM system
Code — the product code, assigned by you.
HS Code — the product HS code. It must be from the appropriate list, which can be found on the https://src.am website.
Unit of Measurement.
Cash Register Department — the number of the cash register department under which the cash register receipt was printed.

eHDM – Request Log

In the request log, you can see the chain of requests for each receipt or other SRC requests.

Example of a Receipt Sent to the Buyer

Receipt Discount Application Logic and Formulas

According to the official manual for registering the electronic cash register and integrating with the web service, it is possible to apply two types of discounts, each of which in turn has two subtypes.

Product discount / discount
- % PERCENT, percentage discount — discountType = 1
- PRICE (֏), a monetary discount applied to each product / unit — discountType = 2. Calculation: (initial_price – discount) * quantity
- TOTAL (Σ), a discount subtracted from the total quantity — discountType = 4. Calculation: (price*quantity) – discount

Additional product discount / additionalDiscount
- When additionalDiscountType = 16, the monetary discount calculation is: (price*quantity) – discount
- For a percentage discount, it accepts the value 8

e-HDM plugin implementation options for discounts

The e-HDM plugin applies two options for configuring different types of discounts:

Option 1 — discountType = 2
This option is used when a WooCommerce product has a “Sale price” applied.
This means that when a discounted price is set for a product, it will work through this mechanism.

How it works
In this case, the e-HDM plugin detects WooCommerce products that have a sale price applied and automatically applies the corresponding discount based on that price.

Option 2 — additionalDiscountType = 16
This option is used when “Coupons” are used in WooCommerce.
Coupons may be applied as additional discounts, which the system processes based on the applied coupon data.

How it works
When a coupon is applied in WooCommerce, the plugin recognizes it as an additional discount and applies the specified additional discount according to the coupon conditions (Discount Type 16).

Widget Description

Important messages and information are displayed here. The widget is designed for easy and quick access to important notifications, statuses, or other necessary data.

Main features:

Display of important messages
Providing dynamic information for the user
Optimized interface for convenient work

Important information:

The eHDM plugin is designed to work only with the “ArCa Payment Gateway” plugin.
Without activating the eHDM plugin, it works with limited functionality:
- Cash Register Activation
- Creating Cash Register Departments
- Retrieving the product list from the SRC eHDM system
- Export to WooCommerce
- WooCommerce product configuration
As a result of applying one or more discounts to a product or products, you may get a price of 0 AMD; it is not possible to print a cash register receipt for 0 AMD.
In case of connection failure or other technical issues, the receipt may not be printed. In such cases, it will be necessary to print the receipt manually.
If a payment is refunded or canceled, the receipt refund must be performed manually.
The electronic cash register fiscal revenue and other reports are obtained from the Cash Registers section of the SRC eHDM account.
Receipts for payments made through the “ArCa Payment Gateway” payment form are printed as prepayments.
Receipts for payments received through the TATIOSA booking system are also printed as prepayments.