PSPG eHDM Fiscal Receipt Setup Guide

PlanetStudio Payment Gateway

Electronic Cash Register (eHDM)

This guide explains how to configure and use PlanetStudio Payment Gateway (eHDM Add-on). Open its dashboard in WordPress under PS Gateway → eHDM. License management is separate, under PS Gateway → Add-ons.

Registering an electronic cash register with the Tax Service

To register an electronic cash register and obtain its registration number, the taxpayer must complete the u6 application (101: Application for cash register registration) in the Reports section of the Tax Service electronic reporting system.

Read the official integration manual

Complete Section 1 of the official manual: registering an electronic cash register in the electronic reporting system.

Installation and license activation

eHDM is an add-on for PS Gateway Core. Install and activate PlanetStudio Payment Gateway first, then the eHDM Add-on. WooCommerce, PayForm and WPForms integrations also require their corresponding PS Gateway add-ons.

Open PS Gateway → Add-ons and find the eHDM add-on card.

In Add-on license, enter the activation token provided for your purchase or subscription and click Activate. Check that the status changes to Active. To renew your subscription when needed, use Renew now.

Activating the add-on license and activating the cash register with the Tax Service are different operations. Manage the license under Add-ons; activate the Tax Service cash register under Settings → Cash register activation (Կարգավորումներ → ՀԴՄ Ակտիվացում) in the eHDM dashboard.

eHDM dashboard

Settings: Tax Service details

Open PS Gateway → eHDM → Settings (Կարգավորումներ). This section contains the connection details and the main receipt settings.

Cash register registration number (ՀԴՄ գրանցման համար): copy it from your cash register list in the electronic reporting system. It must match the cash register registration number associated with the certificate you use.
Company TIN (Կազմակերպության ՀՎՀՀ): enter your organization’s taxpayer identification number.
Tax regime (Հարկման տեսակ): select your organization’s tax regime.
Shipping line ADG code (Առաքման տողի ԱՏԳ կոդ): enter the classification code for shipping. Paid shipping on a WooCommerce order is included as a separate receipt line.
Cashier ID (Գանձապահի համար): the default cashier identifier.
Starting request sequence number (Հարցման հերթական համարի սկիզբ): the starting value for the Tax Service request sequence. Do not change it unnecessarily on an existing connection.
Tax Service response language (ՊԵԿ պատասխանների լեզուն): choose the preferred language for Tax Service responses.
Upload the JKS file (Ներբեռնեք JKS ֆայլը) and enter its password (JKS ֆայլի գաղտնաբառ). After saving, check the SSL Certificate and SSL Private Key indicators.
Request logging (Հարցումների լոգավորում): saves Tax Service requests and their responses in the request log.
Test mode (Փորձարկման ռեժիմ): sends requests to the Tax Service test environment. Use the credentials and access provided for that environment, including a VPN if required. Turn this mode off for real sales.

Click Save (Պահպանել). Do not publish the certificate file, private key, its password or your activation token, or include them in materials sent to customers.

Settings > Cash register activation

After registering the cash register and configuring the connection, open Settings → Cash register activation (Կարգավորումներ → ՀԴՄ Ակտիվացում) and click Activate cash register (Կատարել ՀԴՄ ակտիվացում). The result appears on the page.

This action sends a cash register activation request to the Tax Service. If there is a connection problem, check the registration number, certificate and access to the selected environment. Do not assume that a connection error necessarily means the add-on license is inactive.

Exchange rates

Open the Exchange rates (Փոխարժեքներ) tab in the eHDM dashboard. These rates are used to print receipts for foreign-currency orders in AMD. Supported currencies are AMD, USD, EUR and RUB. A rate represents the AMD value of one unit of the currency. The AMD rate is always 1.

Foreign-currency receipt printing is disabled by default, including after updating an existing site. To enable it, open Exchange rates (Փոխարժեքներ), select Print foreign-currency order receipts in AMD (Արտարժույթով պատվերների կտրոնները տպել ՀՀ դրամով) and click the Save (Պահպանել) button beside that checkbox. While it is off, new AMD receipts continue to work, but new USD, EUR and RUB receipts are not printed. Viewing, emailing, copying and returning existing receipts remain available. Fetching rates or enabling their automatic updates does not enable foreign-currency receipt printing.

Column	Description
Currency	AMD, USD, EUR or RUB.
Source	Choose `cba.am` to use the saved Central Bank of Armenia rate, or Manual (Ձեռքով) to enter your own rate.
Exchange rate	The active rate, expressed as AMD per one currency unit. The field is read-only in CBA mode and editable in manual mode.
Updated	The date and time of the CBA data retrieval or the saved manual rate update. This field is not editable.

Central Bank and manual rates

To fetch rates immediately, click Refresh from the Central Bank of Armenia (Թարմացնել ՀՀ Կենտրոնական բանկից). This button also works when automatic updates are off.
To set your own rate, change that currency’s source to Manual (Ձեռքով), edit the rate and click Save (Պահպանել) below the currency table. Switching to manual mode retains the displayed value so you can edit it directly.
To switch back to the Central Bank rate, select cba.am and save using the button below the table. The field displays the saved bank rate instead of the inactive manual value.
Fetching new CBA data does not override a manual rate selected for a currency.
The CBA rate date is shown separately above the table. It may differ from the date and time when the add-on retrieved the data.

Automatic updates

Automatic updates are disabled by default. If you only accept AMD orders, you can leave them off. AMD receipts do not require exchange rate configuration.
To enable daily updates, select Automatic updates (Ինքնաշխատ թարմացում), choose the time and click the Save (Պահպանել) button beside the time field.
The default time is 16:15 in the Asia/Yerevan timezone. It is independent of the WordPress site timezone. A previously saved time is retained.
When automatic updates are off, the time field is disabled, but its Save (Պահպանել) button remains available so you can save that choice. Saving the disabled state removes only the eHDM exchange rate background tasks, including pending retries. It does not disable WordPress cron or other plugins’ tasks.
The Save (Պահպանել) button beside the time saves the automatic update setting and schedule. The separate Save (Պահպանել) button below the currency table saves rate sources and manual values.
The last successful update, last attempt and next scheduled update are shown above the form. No next run is scheduled while automatic updates are off.
WordPress cron runs when the site receives traffic unless a separate server cron is configured. The actual update may therefore occur later than the selected time.

Turning off automatic updates does not delete saved rates or receipt history, and does not disable currency conversion. If foreign-currency printing is enabled, the selected saved rate remains in use. If a CBA refresh fails, the last successfully saved rates remain unchanged. Check the displayed error and update dates. A foreign-currency receipt cannot be printed without a valid rate.

Printing receipts for foreign-currency orders

Fiscal receipt and QR payment amounts are always in AMD. AMD orders are not converted. USD, EUR and RUB orders use the selected saved rate at print time, not the rate at order creation or payment time.
Conversion applies to both automatic and manual printing. For WooCommerce orders it includes item prices, monetary discounts and shipping. Quantities and percentage discounts do not change.
The AMD total of a goods receipt is calculated from the converted lines and discounts. Monetary values are rounded to two decimal places, so a small difference from directly converting the order total is possible.
For PayLink, PayForm and WPForms prepayment receipts without items, the payment amount is converted directly to AMD.
The original order and bank payment retain their original amount and currency. The original currency, amount and applied rate are saved with the receipt. Later rate changes do not recalculate an already printed receipt.
Before printing the first foreign-currency receipt, enable foreign-currency printing and fetch CBA rates or save a valid manual rate. Printing does not request a new rate from the bank.
The eHDM exchange rate settings are independent of the store’s currency switcher. They do not change product display currencies or the amount charged through the payment system.

For example, using an illustrative rate of 360.93 and without item-rounding differences, a 10 USD payment produces a 3,609.30 AMD fiscal receipt. The rate actually applied is shown in the receipt’s Exchange rate (Փոխարժեք) column.

Cash register departments

Open Cash register departments (ՀԴՄ բաժիններ), select the required department or departments and click Send to the Tax Service (Փոխանցել ՊԵԿ համակարգ). Available regimes are VAT taxable, Not subject to VAT, Turnover tax payer and Microenterprise. Select the regimes that match your registered cash register and business activity.

Retrieving the product list

If your products are already registered in the Tax Service electronic reporting system, configure the cash register departments first, then open Retrieve product list (Ապրանքացանկի ստացում). Select a department and click Retrieve the product list from the reporting system (Ստանալ ապրանքացանկը ՀՆԷՀ համակարգից). On success, the active product list is saved as JSON for later import into WooCommerce. This step is optional if you already have WooCommerce products and fill in their eHDM details manually.

Importing products into WooCommerce

Under Import into WC (Վերբեռնում WC), select a previously retrieved list and click Import into WooCommerce (Վերբեռնել WooCommerce). This creates new, published WooCommerce products from the list.

Fields supplied by the Tax Service are filled in automatically, but the response does not include every required product field. Complete the missing fields manually.

Important: existing products are not updated. Importing the same list again creates new products. Check the list first to avoid duplicates. After importing, fill in missing ADG codes and units, and check the prices.

Receipts

The Receipts (Կտրոններ) tab shows saved fiscal records for the current test/live mode: sales receipts, copies and returns. You can inspect the Tax Service response, items, QR and applied rate, and follow links to the associated payment or WooCommerce order.

Use Screen Options to choose which columns to display and set the number of rows per page.

Receipt table columns

Column	Description
ID	The unique internal ID of the saved receipt record. It differs from the Tax Service fiscal receipt number.
LogID	A link to the associated request log record. Details are available if the log was saved.
vPOS ID	The bank payment or bank order identifier. The link opens the associated payment in PS Gateway Orders. This is not the internal PSPG order number.
PSPG	The internal PS Gateway order number and a link to its payment, when available.
Source	The payment or order source, such as WooCommerce, PayLink, PayForm or WPForms.
Source ID	The source object’s ID, for example a WooCommerce order ID. A link is provided for supported sources.
Request	The saved operation: receipt, copy or return.
Receipt number	The fiscal receipt number returned by the Tax Service. It may repeat for different cash registers.
Receipt	The saved Tax Service response in JSON format.
Request sequence number	The sequence number sent to the Tax Service.
Exchange rate	The saved rate, source and rate date, for example 1 USD = 360.93 AMD. The AMD rate is 1. Older records without saved conversion data may show a dash.
Non-cash amount	The non-cash payment amount in the print request, in AMD.
Cash amount	The cash payment amount in the print request, in AMD.
Change	The change amount returned by the Tax Service, when available.
Partial payment amount	The amount submitted as a partial payment.
Prepayment usage amount	The prepayment amount used in the print request.
Cashier ID	The cashier specified in the request.
Print mode	Goods or prepayment.
Buyer TIN	The buyer’s taxpayer identification number, when included in the request.
Used prepayment	The prepayment usage data returned by the Tax Service, when present in that operation’s response.
Type	The Tax Service saleType classification, when available.
Transaction	The Tax Service receiptType classification, when available.
Transaction subtype	The Tax Service receiptSubType classification, such as sale or prepayment usage.
Non-cash refund amount	The non-cash portion of the fiscal return, in AMD.
Cash refund amount	The cash portion of the fiscal return, in AMD.
Total refund amount	The return record’s total amount, when available.
Items	The saved item lines, prices, quantities and discounts in JSON format.
Fiscal	The fiscal number returned by the Tax Service.
QR	The QR image for this saved receipt.
Record date	The date and time the record was created in the add-on database.
Actions	Available actions for the record, such as return, copy or email.

PSPG and vPOS ID may be empty for cash or cash-on-delivery WooCommerce receipts, and for WooCommerce receipts printed manually without a PSPG payment. This is normal: the WooCommerce order is identified by Source and Source ID. A separate WC ID column is no longer offered in Screen Options or included in CSV exports. The rate saved with a receipt is historical data, not the latest value shown in Exchange rates.

ID identifies a unique database record, while Receipt number is the Tax Service fiscal number. Fiscal numbers may repeat across cash registers or modes. Use the specific record’s actions when viewing QR data or sending an email. Resending an email does not print a new fiscal receipt.

CSV export

Click Export (Արտահանել) above the receipts table. If Delete all (Ջնջել բոլորը) is available, the export link is next to it.
In the dialog, select the From (Սկսած) and To (Մինչև) dates. The previous calendar month is selected by default. Filtering uses the record date and includes both selected dates.
Click Export CSV (Արտահանել CSV). A UTF-8 CSV file downloads, which you can open in Excel or another spreadsheet application.
The export includes all matching records, not only the table’s current page. It uses the current eHDM test/live mode. If the receipts page is filtered to a particular receipt number, that restriction also applies to the export.
The file includes PSPG, Source, Source ID, the bank vPOS ID, item details and a summary of saved conversion data. Changing visible columns in Screen Options does not change the CSV columns.

Each receipt item is exported as a separate row. A receipt with three items produces three rows for the same receipt. A receipt without items produces one row with empty item fields.

Receipt number	Item name
1001	Item 1
1001	Item 2
1001	Item 3

The conversion summary columns are Original Currency, Original Amount, Exchange Rate (AMD per unit), Exchange Rate Date and Exchange Rate Source. The full conversion JSON is not included. Receipt totals are repeated on each item row: do not add them together as if they were separate receipts. Also account for the request type when analyzing copies and returns.

New fiscal receipt

You can manually print a WooCommerce order receipt, record a prepayment without items, or use a previously received prepayment for a WooCommerce order. Before printing, confirm that payment was actually received and check whether a fiscal receipt already exists. To obtain a copy of an existing receipt, use the Copy action instead of printing a new receipt for the same payment.

Prepayment without items

Use this option for a PS Gateway payment without WooCommerce items, such as PayLink, PayForm or WPForms, when a prepayment fiscal receipt needs to be printed manually.
- Enter the payment’s bank order ID / vPOS ID from PS Gateway Orders. This form finds the payment by its bank identifier, not by the internal numeric PSPG order number.

WooCommerce order receipts

Use this option for cash or cash-on-delivery WooCommerce orders, or if the order’s receipt was not printed automatically. It prints a receipt containing the order items and the shipping line, when applicable.
- Enter the WooCommerce order ID, available in the WooCommerce orders list.
- Select the payment method: Cash (Կանխիկ), Non-cash (Անկանխիկ) or Non-cash via another terminal (Անկանխիկ այլ տերմինալով). Enter the bank payment identifier when required.
- Select the WooCommerce order status to apply after the fiscal receipt is printed successfully.

After successful printing and saving, eHDM attempts to send a separate receipt email to the customer’s address saved on the WooCommerce order. Check that the order has a valid email address. Changing the order status may also trigger standard WooCommerce emails according to your settings. The order currency is detected automatically, and foreign-currency amounts are converted to AMD using the selected saved rate.

Prepayment usage

Open New fiscal receipt → Prepayment usage (Նոր ՀԴՄ կտրոն → Կանխավճարի օգտագործում) when a WooCommerce goods receipt needs to be issued against a previously received prepayment.
- Enter the WooCommerce order ID, available in the WooCommerce orders list.
- Select the WooCommerce order status.

The items and prepayment usage amount come from the specified WooCommerce order. This form does not require an old prepayment receipt number and does not use an old receipt’s items. It also does not maintain a separate combined balance of previous prepayments. Check that sufficient prepayment is available for the order before proceeding.

After successful printing, the selected WooCommerce status is applied and the receipt email is attempted. Foreign-currency orders require foreign-currency printing to be enabled. The selected saved rate at print time is used, not the rate from the earlier prepayment receipt.

Receipt return

To return a receipt:

Enter the fiscal receipt number, or
Click the receipt’s Return (Վերադարձ) action in the Receipts (Կտրոններ) tab.

Click Get receipt information from the Tax Service (Ստանալ կտրոնի վերաբերյալ տեղեկատվություն ՊԵԿ-ից). Check the receipt details and amounts, then click Return (Վերադարձնել) at the bottom of the page. The current form submits the displayed returnable items and their quantities; it is not a form for selecting individual items or partial quantities.

Return amounts come from the original fiscal receipt and are in AMD. Even if the order was paid in USD, EUR or RUB, do not recalculate the return using a new rate. A fiscal return is not itself a bank refund: refund the payment separately through the relevant payment system. Return receipt QR emails are not sent to the customer.

Receipt copy

To print a receipt copy:

Enter the fiscal receipt number, or
Click the receipt’s Copy (Կրկնօրինակ) action in the Receipts (Կտրոններ) tab.

Open Receipt copy (Կտրոնի կրկնօրինակ), enter the receipt number and click Print receipt copy (Տպել կտրոնի կրկնօրինակը). A copy refers to an existing fiscal receipt; it does not turn the order into a new sale or reconvert it using the current rate. The copy request is saved in history as a separate operation.

WooCommerce product eHDM settings

Open the WooCommerce product editor. In the Product data panel, select the separate eHDM tab from the left-hand menu. It contains the product or service’s fiscal fields, which are no longer in the General tab.

Product name (Ապրանքի անվանում): the name used on the fiscal receipt, up to 50 characters. If the product is registered in the reporting system, enter its corresponding abbreviated name. This is separate from the WooCommerce product title.
Code (Կոդ): the product or service’s fiscal code. Enter the corresponding value from your records.
ADG code (ԱՏԳ կոդ): the product or service classification code. Use the relevant official Tax Service lists. Preserve the code’s format, for example 62.01.
Unit (Չափման միավոր): for example piece (հատ), kg (կգ) or litre (լիտր). Choose a suggested value or enter the appropriate unit.
Cash register department (ՀԴՄ բաժին): the tax department used for this product’s fiscal receipt line. This does not change WooCommerce tax settings.

You can save the product without eHDM details. Empty fields have a soft red border and a hint meaning Required for fiscal receipt printing. This is a visual reminder, not a validation rule that blocks saving the product. The warning disappears when the field is filled. If you clear an existing field and update the product, the empty value is saved rather than restoring the old value.

The ADG field shows the code’s description when found in the bundled reference list. If the code is not listed, a message suggests checking it, but saving and the print request are not blocked for that reason. The reference combines goods and service codes and is not an online Tax Service validation service. The source link and the date the data was obtained appear below the field.

Complete all necessary fiscal details before selling. The add-on prepares the print request using the saved values. Missing or incorrect details may lead to a Tax Service rejection, with details available in the request log. Leaving eHDM fields empty does not disable fiscal printing for that product. If a variation has no separate fiscal value, the corresponding parent product value is used.

Automatic printing and PS Gateway Orders

After payment is successfully confirmed through a supported PS Gateway integration, eHDM initiates fiscal receipt printing. WooCommerce orders use item lines and, for paid shipping, a separate Shipping (Առաքում) line. PayLink, PayForm and WPForms payments use prepayment mode without items.

Simply creating a cash-on-delivery order is not a successful PS Gateway payment. Use the manual WooCommerce receipt form when appropriate.
GiveWP donations are not included in the automatic fiscal receipt printing flow.
USD, EUR and RUB receipts are printed only when foreign-currency printing is enabled and a valid saved rate is available.
Use the eHDM column in PS Gateway → Orders to check the saved receipt and open the relevant records under Receipts (Կտրոններ). Links from a receipt lead back to the payment or source order.
Printing a new receipt manually is a separate fiscal operation. Check first whether a receipt already exists. Use a copy for a duplicate document, or resend the QR email to send the same receipt to the customer again.

eHDM request logs

When Request logging (Հարցումների լոգավորում) is enabled, the Request logs (Հարցումների մատյան) tab stores Tax Service requests and responses for the selected test/live mode. Click the Log icon to open the full JSON. Select All (Բոլորը) or Errors only (Միայն սխալները). You can also open a receipt’s associated log through its LogID link.

Inspect the request data, the Tax Service code/errorMessage fields, or connection failure details. An incorrect register number or invalid field is a different issue from an unavailable server or a missing VPN connection. Do not decide whether to print another receipt based only on a generic page notice: check receipt history and the request response first.

Receipt email and QR data

The receipt email contains a QR image and readable fields derived from the Tax Service QR data: receipt number, date and time, fiscal number, taxpayer identifiers and payment amounts, when present. Fiscal amounts are in AMD.

For WooCommerce, the separate eHDM email is sent to the customer’s email address saved on the order. For other PSPG payments, the customer address in supported payment log entries is used when available. Otherwise, the current user’s or site administrator’s address is used. Actual delivery depends on the WordPress mail configuration.

You can resend the QR email through the receipt actions. A fiscal receipt QR email action is also available on the WooCommerce order. Resending does not create a new fiscal receipt.

The QR image and readable email details come from the same saved fiscal record. After changing the cash register, old receipts can still be viewed and resent through their specific record’s action. Return receipt emails are not sent. If sending fails, it does not mean an already printed fiscal receipt was canceled or not printed. Check the address and mail system, then resend that same receipt.

Receipt discounts: logic and formulas

The official electronic cash register integration manual describes two discount fields, each with different calculation types:

Product discount / discount
- PERCENT: percentage discount, discountType = 1
- PRICE: monetary discount per item or unit, discountType = 2. Formula: (initial_price – discount) * quantity
- TOTAL: monetary discount on the entire quantity, discountType = 4. Formula: (price * quantity) – discount

Additional product discount / additionalDiscount
- additionalDiscountType = 16: a monetary discount subtracted from the line amount after the main product discount.
- Use type 8 for an additional percentage discount.

Discount handling in the eHDM Add-on

The eHDM Add-on uses two approaches for WooCommerce discounts:

1. Product discount: discountType = 2
This applies when a WooCommerce product has a Sale price.
The difference from its regular price is represented as a per-unit product discount.

How it works
When preparing the receipt, the difference between the regular and active product prices becomes the product discount. If the order item has an eHDM price snapshot, those saved prices are used instead of the product’s current catalog prices.

2. Additional discount: additionalDiscountType = 16
This is used for WooCommerce coupons.
The coupon reduction is represented as an additional monetary discount based on the discounted order item data.

How it works
If an order item’s final total differs from its subtotal before coupon discounts, an additional monetary discount is prepared with additionalDiscountType = 16. It applies to the entire line after the main product discount. In foreign-currency receipts, monetary prices and discounts are converted to AMD, while percentage values remain percentages.

Special cases: if you use WooCommerce taxes, manually edit prices within an order, add fees or use complex pricing plugins, test your specific order and compare its fiscal lines with the amount paid. Selecting a cash register department does not itself transfer all WooCommerce tax calculations into the receipt. For older orders without a price snapshot, later catalog price changes may also affect the receipt.

Dashboard widget

The PS Gateway eHDM: Missing Receipts widget on the WordPress dashboard helps identify paid PSPG orders without fiscal receipts. It is a diagnostic list, not a complete fiscal revenue report.

Foreign-currency orders are included in the missing receipt list only when foreign-currency receipt printing is enabled.

Select a period: Last 7 days, Last 30 days or All time.
Up to ten matching orders are displayed with their PSPG order number, source, original payment amount and paid time. The number above the list counts the displayed orders, not all missing receipts.
The widget follows eHDM test mode: in test mode it checks test orders and their test receipts; in live mode it checks live orders and their live receipts. A receipt in the other mode does not replace the required receipt for that order.
GiveWP donations and legacy-source orders are excluded. Pending or failed payments are not treated as paid orders requiring a receipt.
Use View Orders and Receipts to inspect the payment and its fiscal records before printing manually.
The displayed amount is in the payment’s original currency. A foreign-currency payment’s fiscal receipt is printed in AMD using the selected saved rate.

Important information

The eHDM Add-on extends PlanetStudio Payment Gateway (PS Gateway Core). Enable the corresponding integration add-on when using WooCommerce, PayForm or WPForms.
Check the license under PS Gateway → Add-ons and the cash register and certificate details under PS Gateway → eHDM → Settings (Կարգավորումներ). Successful activation of one does not replace activation of the other.
Discounts can reduce a product or the order total to zero. A fiscal receipt with a zero AMD total cannot be printed.
If a connection fails, check receipt history, the request response and, when necessary, the Tax Service reporting system. Print a new receipt manually only after confirming that it is missing. A connection error or a missing email does not itself prove that the Tax Service did not create the receipt.
If a payment is refunded or canceled, handle the fiscal receipt return separately.
Obtain fiscal revenue and other official cash register reports from the cash register section of your Tax Service reporting account.
Supported order currencies are AMD, USD, EUR and RUB. Fiscal receipts are in AMD. Check the saved rate and its date before printing a foreign-currency receipt. Enable daily rate updates separately if needed.
If eHDM captured prices when the WooCommerce order item was created, later catalog changes do not replace its saved regular and active prices. Older order items without that data still use catalog prices. Check them before printing a receipt later.
Custom integrations must pass the required currency argument to print(). See the examples in the PSPG eHDM API guide.
PayLink, PayForm and WPForms payments use prepayment receipts without items. WooCommerce orders use goods receipts. Fiscal receipts are not created for GiveWP donations.
Use the documented eHDM API for other software and custom integrations. Installing an arbitrary third-party payment plugin does not mean its payments will also be fiscalized automatically.