1. Ako získam Shopify webhook 

V administrácii Shopify prejdite do Settings následne Notifications, vyhľadajte sekciu Webhooks a vytvorte nový webhook pre udalosť Order payment.  

Ako formát zvoľte JSON a do poľa URL vložte adresu: https://my.numiron.sk/api/v4/shopify/receive_webhook_notification 

Verziu nechajte nastavenú na latest a webhook uložte. 

2. Ako získam HMAC klúč 

Po vytvorení webhooku Shopify vygeneruje HMAC kľúč, ktorý nájdete v detailoch webhooku v rámci červeného rámčeka. Tento kľúč skopírujte. 

3. Nastavenie v Numiron 

V agende Nastavenia v sekcii  Prepojenia kliknete na zelené tlačidlo Nové prepojenie a zvolíte záložku Shopify. 

Do poľa API kľúč / secret vložte vygenerovaný HMAC (Shared secret). 

Zadajte interný názov registrácie, napríklad „SHPF“, a kliknite na Zaregistrovať. 

4. Čo nasleduje? 

Po úspešnej integrácii budú všetky faktúry automaticky importované do agendy Fakturácia – sekcie Vystavené faktúry a párované s transakciami podľa variabilného symbolu či sumy. 

V prípade potreby si v agende Nastavenia v sekcii Prepojenia môžete webhooky či API kľúče odregistrovať alebo nahradiť novými. 

1. Prihláste sa do systému Numiron a zvolte subjekt, pre ktorý {assigned_company_id} potrebujete. 

2. Po prihlásení vás systém presmeruje na stránku prehľadu. {assigned_company_id} sa nachádza v URL adrese. 

3. URL adresa može vyzerať takto:  
   https://my.numiron.sk/company_information?id=68df9487cb414435d3c4a7d5 
   Hodnota za parametrom id= je vaše {assigned_company_id} 
    
   V tomto prípade to je 68df9487cb414435d3c4a7d5. 

4. Ak chcete vytvoriť faktúru pre túto firmu, endpoint bude:  
   POST /api/public/v1/assigned_companies/68df9230cb414435d3c48bef/invoices 

Endpoint & Auth

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

Ako získať {assigned_company_id} nájdete v tomto návode.

• Headers:
  • Authorization: Bearer <API_TOKEN>
  • Accept: application/json
  • Content-Type: application/json
• Formát dátumov: ISO-8601, napr. 2025-06-30T00:00:00.000+00:00
• Mena: ISO-4217, napr. EUR

Pole	Typ	Povinné	Popis	Príklad	Enum / Poznámka
address_purchaser	string	✅	Adresa odberateľa – ulica a číslo.	Main street 5
address_supplier	string	✅	Moja adresa – ulica a číslo.	Main street 5
city_purchaser	string	✅	Mesto odberateľa.	Bratislava
city_supplier	string	✅	Moje mesto.	Bratislava
client_emails	array<object>		Zoznam e-mailov klienta (adresátov).		Každá položka má email: string (napr. client@client.com).
constant_symbol	string		Konštantný symbol dokumentu.	1234
country_purchaser	string	✅	Krajina odberateľa (ISO 3166-1 alpha-2).	SK
country_supplier	string		Moja krajina (ISO 3166-1 alpha-2).	SK
creation_date	string (datetime)	✅	Dátum vystavenia.	2025-08-26T07:59:41.920Z	ISO-8601
currency	string	✅	Mena (ISO 4217 kód).	CZK
delivery_city	string		Mesto dodacej adresy.	Bratislava
delivery_country	string		Krajina dodacej adresy (ISO-2).	SK
delivery_method	string	✅	Spôsob dodania.	in_person	by_courier, electronically, in_person, own_transport
delivery_name	string		Meno/kontakt na dodacej adrese.	Milan Malinový
delivery_street	string		Ulica a číslo dodacej adresy.	Main street 5
delivery_zip	string		PSČ dodacej adresy.	12345
dic_purchaser	string		DIČ odberateľa.	1234567890
dic_supplier	string		Moje DIČ.	1234567890
exchange_rate	number	✅	Kurz cudzej meny voči EUR.	25.123
icdph_purchaser	string		IČ DPH odberateľa.	SK1234567890
icdph_supplier	string		Moje IČ DPH.	SK1234567890
ico_purchaser	string		IČO odberateľa.	12345678
ico_supplier	string		Moje IČO.	12345678
invoice_lines	array<object>	✅	Položky dokumentu (viď tabuľka nižšie).
language	string	✅	Jazyk dokumentu.	SK	DE, EN, SK
message	string		Hlavný text (za „Fakturujeme Vám“).	na základe zmluvy...
name_purchaser	string	✅	Názov/meno odberateľa.	Company s.r.o.
name_supplier	string	✅	Môj názov/meno.	Company s.r.o.
note	string		Interná poznámka k dokladu.	Zákazník chcel darčekové balenie.
order_number	string		Číslo objednávky.	123ABC
oss	boolean		Režim OSS (One Stop Shop).	false
paragraph_purchaser	string		Paragraf registrácie DPH odberateľa.	4
paragraph_supplier	string		Paragraf mojej registrácie DPH.	4
payment_method	string	✅	Spôsob úhrady.	bank_transfer	advance_payment, bank_transfer, by_compensation, card, cash, cash_on_delivery
save_client	boolean		Uložiť klienta do adresára.	false
signature	boolean		Podpis/pečiatka na PDF.	false
zip_purchaser	string	✅	PSČ odberateľa.	12345
zip_supplier	string	✅	Moje PSČ.	12345
delivery_date	string (datetime)	✅	Dátum dodania (DUZP).	2025-08-26T07:59:41.920Z	ISO-8601
delivery_note	boolean		Vytvoriť aj dodací list.	false
expiration_date	string (datetime)	✅	Dátum splatnosti.	2025-08-26T07:59:41.920Z	ISO-8601
iban	string (IBAN)	✅	IBAN dokladu.	SK0000000000000000000000	Validný IBAN
invoice_number	string	✅	Číslo dokladu.	20250001	Unikátne v rade
variable_symbol	string	✅	Variabilný symbol.	1234123477

---

Položky

Pole	Typ	Povinné	Popis	Príklad	Enum / Poznámka
activity	string		Činnosť (pre dashboard „Tržby podľa činnosti“).	Act 1
amount	number	✅	Množstvo položky.	1
DPH	number	✅	Sadzba DPH v %.	23
danova_povinnost	string		Daňový režim pre 0% riadok.	prenesenie_15	oslobodenie_danovej_povinnosti, prenesenie_15, prenesenie_16, trojstranny_obchod, vynimka
delivery_type	string		Typ plnenia.	services	napr. goods, services, …
department	string		Stredisko (pre dashboard „Tržby podľa strediska“).	Dep 1
discount_one_row	number	✅	Zľava na položke v %.	10
desired_total	number	✅	Finálna suma položky.	1.23	Zvyčajne s DPH
idx	string	✅	Unikátny index položky v rámci dokladu.	1
itemInfo	string	✅	Text/názov položky.	apples
measureUnit	string		Merná jednotka.	ks
order	string		Zákazka (pre dashboard „Tržby podľa zákazky“).	Ord 1

---

Pozn.: Pri desired_total systém dopočíta jednotkové ceny a zaokrúhlenie podľa aktuálnych pravidiel.

---

cURL príklad (šablóna)

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“: „Main Street 5“,
„address_supplier“: „Industrial Ave 10“,
„city_purchaser“: „Bratislava“,
„city_supplier“: „Bratislava“,
„client_emails“: [„client@example.com“],
„country_purchaser“: „SK“,
„country_supplier“: „SK“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„currency“: „EUR“,
„delivery_city“: „Bratislava“,
„delivery_country“: „SK“,
„delivery_method“: „in_person“,
„delivery_name“: „Contact Person“,
„delivery_street“: „Main Street 5“,
„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,
„DPH“: 23,
„delivery_type“: „services“,
„desired_total“: 195.10,
„idx“: „1“,
„itemInfo“: „Service package 06/2025“
},
{
„amount“: 1,
„DPH“: 23,
„delivery_type“: „services“,
„desired_total“: 18.44,
„idx“: „2“,
„itemInfo“: „Account maintenance 06/2025“
}
],
„language“: „SK“,
„message“: „Vyúčtovacia faktúra za poskytované služby“,
„name_purchaser“: „Customer s.r.o.“,
„name_supplier“: „Supplier s.r.o.“,
„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“
}‘

---

Očakávaná odpoveď

  „abc123“

Možné kódy odpovedí:

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.