Arbictus Sync for e-Arveldaja

Description

An independent integration built by Arbictus OÜ. It is not affiliated with, endorsed by or
sponsored by Registrite ja Infosüsteemide Keskus (RIK), the operator of e-Financials /
e-Arveldaja, nor by Automattic, the owner of the WooCommerce trademark. “e-Financials”,
“e-Arveldaja” and “WooCommerce” are used here only to describe what this plugin connects to.

Background sync so checkout stays fast. Once an order is paid (or marked completed) the plugin:

1. Upserts the customer as an e-Financials client.
2. Ensures every ordered product exists as an e-Financials product.
3. Creates and registers the sale invoice.
4. Records the payment (cash fields and/or a bank transaction), gateway-agnostic.
5. Optionally delivers the invoice to the customer by email or e-invoice.
6. Issues credit invoices on full and partial refunds.

Merchants get a settings screen, an order list column, an order metabox with the invoice PDF,
manual order actions and an optional note on customer emails.

The plugin is compatible with WooCommerce High-Performance Order Storage (HPOS) and queues its
work through Action Scheduler, so no API call ever blocks a shopper.

External service: e-Financials (e-Arveldaja)

This plugin is an interface to e-Financials / e-Arveldaja, the accounting service operated by
Registrite ja Infosüsteemide Keskus (RIK), an Estonian government agency. It is not affiliated with
or endorsed by RIK.

The plugin sends no data anywhere until you enter your own e-Financials API credentials on the
settings screen. Once configured, it contacts RIK’s API at https://rmp-api.rik.ee (live) or
https://demo-rmp-api.rik.ee (test environment), depending on the environment you select.

Data sent to that service, only for orders your shop processes:

• Billing name, company name, e-mail address, phone number, postal address and country.
• VAT / registry number, when your shop collects one.
• Order line items: product names, SKUs, quantities, prices, VAT rates, shipping and fee lines.
• Order number, order date, payment method identifier and payment amounts.
• Refund amounts and reasons, when you issue a refund.

Data received from that service: client, product, invoice and transaction identifiers, invoice
numbers and invoice PDFs, plus the option lists (invoice series, templates, sale articles, cash
accounts) shown on the settings screen.

If you enable invoice delivery, RIK’s service sends the invoice e-mail or e-invoice to your
customer on your behalf.

Using the service requires an agreement with RIK. Please review their terms before enabling the
plugin:

• Service overview: https://www.rik.ee/en/e-financials/introduction-e-financials
• API technical documentation: https://abiinfo.rik.ee/index.php/en/node/304
• API terms of use: https://e-arveldaja.rik.ee/static/web/contracts/API_kasutustingimused.pdf
• e-Arveldaja terms of use: https://e-arveldaja.rik.ee/static/web/contracts/e-arveldaja_kasutustingimused.pdf

All API traffic goes through the aanndryyyy/e-financials-php-client library and is signed with
HMAC-SHA-384.

Technical details