1. How do I get Shopify webhook 

In the Shopify admin, go to Settings subsequently Notifications, search section Webhooks and create a new webhook for the event Order payment.  

Select as format JSON and enter the address in the URL field: https://my.numiron.sk/api/v4/shopify/receive_webhook_notification 

Leave the version set to latest and save the webhook. 

2. How do I get an HMAC key 

After creating a webhook, Shopify will generate HMAC key, which can be found in the details of the webhook within the red box. Copy this key. 

3. Settings in Numiron 

In the agenda Settings in section  Links click on the green button New link and select the tab Shopify. 

Into the field API key / secret insert the generated HMAC (Shared secret). 

Enter an internal registration name, for example „SHPF“, and click on Register. 

4. What comes next? 

After successful integration, all invoices will be automatically imported into the agenda Invoicing - Sections of Invoices issued and paired with transactions by variable symbol or amount. 

If necessary, in the agenda Settings in section Links you can unregister webhooks or API keys or replace them with new ones. 

1. Log in to Numiron and select the entity for which {assigned_company_id} is required. 

2. After logging in, the system will redirect you to the overview page. The {assigned_company_id} is found in the URL. 

3. The URL can look like this:  
   https://my.numiron.sk/company_information?id=68df9487cb414435d3c4a7d5 
   The value after the id= parameter is your {assigned_company_id} 
    
   In this case it is 68df9487cb414435d3c4a7d5. 

4. To create an invoice for this company, endpoint will:  
   POST /api/public/v1/assigned_companies/68df9230cb414435d3c48bef/invoices 

Endpoint & Auth

• POST /api/public/v1/assigned_companies/{assigned_company_id}/invoices

How to get {assigned_company_id} please refer to this guide.

• Headers:
  • Authorization: Bearer
  • Accept: application/json
  • Content-Type: application/json
• Date format: ISO-8601, e.g. 2025-06-30T00:00:00.000+00:00
• Currency: ISO-4217, e.g. EUR

Field	Type	Required	Description	Example	Enum / Note
address_purchaser	string	✅	Customer's address - street and number.	Main street 5
address_supplier	string	✅	My address - street and number.	Main street 5
city_purchaser	string	✅	City of the customer.	Bratislava
city_supplier	string	✅	My place.	Bratislava
client_emails	array		List of client emails (recipients).		Each item has email: string (e.g. client@client.com).
constant_symbol	string		Constant document symbol.	1234
country_purchaser	string	✅	Country of customer (ISO 3166-1 alpha-2).	EN
country_supplier	string		My country (ISO 3166-1 alpha-2).	EN
creation_date	string (datetime)	✅	Date of issue.	2025-08-26T07:59:41.920Z	ISO-8601
currency	string	✅	Currency (ISO 4217 code).	CZK
delivery_city	string		City of delivery address.	Bratislava
delivery_country	string		Country of delivery address (ISO-2).	EN
delivery_method	string	✅	Method of delivery.	in_person	by_courier, electronically, in_person, own_transport
delivery_name	string		Name/contact at the delivery address.	Milan Malinový
delivery_street	string		Street and delivery address number.	Main street 5
delivery_zip	string		The postcode of the delivery address.	12345
dic_purchaser	string		the customer's VAT number.	1234567890
dic_supplier	string		My VAT number.	1234567890
exchange_rate	number	✅	Foreign currency exchange rate against EUR.	25.123
icdph_purchaser	string		VAT number of the customer.	SK1234567890
icdph_supplier	string		My VAT number.	SK1234567890
ico_purchaser	string		Customer ID.	12345678
ico_supplier	string		My ID.	12345678
invoice_lines	array	✅	Document items (see table below).
language	string	✅	Document language.	EN	DE, EN, EN
message	string		Main text (after „We invoice you“).	under contract...
name_purchaser	string	✅	Name of the customer.	Company s.r.o.
name_supplier	string	✅	My name.	Company s.r.o.
note	string		Internal note to the document.	The customer wanted gift wrapping.
order_number	string		Order number.	123ABC
oss	boolean		OSS (One Stop Shop) mode.	false
paragraph_purchaser	string		Paragraph of the customer's VAT registration.	4
paragraph_supplier	string		Paragraph of my VAT registration.	4
payment_method	string	✅	Method of payment.	bank_transfer	advance_payment, bank_transfer, by_compensation, card, cash, cash_on_delivery
save_client	boolean		Save the client to the directory.	false
signature	boolean		Signature/stamps on PDF.	false
zip_purchaser	string	✅	the postcode of the customer.	12345
zip_supplier	string	✅	My zip code.	12345
delivery_date	string (datetime)	✅	Date of delivery (DUZP).	2025-08-26T07:59:41.920Z	ISO-8601
delivery_note	boolean		Also create a delivery note.	false
expiration_date	string (datetime)	✅	Due Date.	2025-08-26T07:59:41.920Z	ISO-8601
iban	string (IBAN)	✅	IBAN of the document.	SK0000000000000000000000	Valid IBAN
invoice_number	string	✅	Document number.	20250001	Unique in the series
variable_symbol	string	✅	Variable symbol.	1234123477

---

Items

Field	Type	Required	Description	Example	Enum / Note
activity	string		Activity (for the dashboard „Sales by activity“).	Act 1
amount	number	✅	Quantity of the item.	1
VAT	number	✅	VAT rate in %.	23
given_obligation	string		Tax mode for 0% line.	transfer_15	exemption_from_tax_liability, transfer_15, transfer_16, triangular_trade, Exception
delivery_type	string		Type of performance.	services	e.g. goods, services, ...
department	string		Centre (for the dashboard „Sales by Centre“).	Depot 1
discount_one_row	number	✅	Discount on the item in %.	10
desired_total	number	✅	The final amount of the item.	1.23	Usually with VAT
idx	string	✅	Unique index of the item within the document.	1
itemInfo	string	✅	Text/title of the item.	apples
measureUnit	string		Unit of measurement.	ks
order	string		Contract (for the dashboard „Sales by Contract“).	Order 1

---

Note: For desired_total, the system will calculate unit prices and rounding according to the current rules.

---

cURL example (template)

curl -X POST \
‚https://my.numiron.sk/api/public/v1/assigned_companies/{ASSIGNED_COMPANY_ID}/invoices‘
-H ‚accept: application/json‘ \
-H ‚authorization: bearer‚ \
-H ‚Content-Type: application/json‘ \
-d ‚{
„address_purchaser“: „5 Main Street“,
„address_supplier“: „10 Industrial Ave“,
„city_purchaser“: „Bratislava“,
„city_supplier“: „Bratislava“,
„client_emails“: [ „client@example.com“ ],
„country_purchaser“: „en“,
„country_supplier“: „en“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„currency“: „EUR“,
„delivery_city“: „Bratislava“,
„delivery_country“,
„delivery_method“,
„delivery_name“,
„delivery_street“: „5 Main Street“,
„delivery_zip“: „01001“,
„dic_purchaser“: „1234567890“,
„dic_supplier“: „1234567890“,
„exchange_rate“: 1,
„icdph_supplier“: „SK1234567890“,
„ico_purchaser“: „12345678“,
„ico_supplier“: „12345678“,
„invoice_lines“: [
{
„amount“: 1,
„VAT“: 23,
„delivery_type“: „services“,
„desired_total“: 195.10,
„idx“: „1“,
„itemInfo“: „Service package 06/2025“
},
{
„amount“: 1,
„VAT“: 23,
„delivery_type“: „services“,
„desired_total“: 18.44,
„idx“: „2“,
„itemInfo“: „Account maintenance 06/2025“
}
],
„language“,
„message“: „Billing invoice for services rendered“,
„name_purchaser“,
„name_supplier“,
„paragraph_supplier“: „4“,
„payment_method“: „bank_transfer“,
„signature“: true,
„zip_purchaser“: „01001“,
„zip_supplier“: „01002“,
„delivery_date“: „2025-06-30T00:00:00.000+00:00“,
„expiration_date“: „2025-07-14T00:00:00.000+00:00“,
„iban“: „SK0000000000000000000000“,
„invoice_number“: „20250687“,
„variable_symbol“: „3001827867“
}‘

---

Expected answer

  „abc123“

Possible answer codes:

Code	Description
201	Created.
400	Bad request. Document number already exists or pairing to documents failed.
401	Not logged in.
403	Not allowed.
422	Input validation error.