1. Wie bekomme ich Shopify Webhook 

Gehen Sie in der Shopify-Verwaltung zu Einstellungen anschließend Benachrichtigungen, Suchbereich Webhaken und erstellen Sie einen neuen Webhook für das Ereignis Bezahlung bestellen.  

Als Format wählen JSON und geben Sie die Adresse in das Feld URL ein: https://my.numiron.sk/api/v4/shopify/receive_webhook_notification 

Setzen Sie die Version auf neueste und speichern Sie den Webhook. 

2. Wie erhalte ich einen HMAC-Schlüssel? 

Nachdem Sie einen Webhook erstellt haben, generiert Shopify HMAC-Schlüssel, der in den Details des Webhooks im roten Kasten zu finden ist. Kopieren Sie diesen Schlüssel. 

3. Einstellungen in Numiron 

In der Tagesordnung Einstellungen im Abschnitt  Links Klicken Sie auf die grüne Schaltfläche Neue Verbindung und wählen Sie die Registerkarte Shopify. 

Auf dem Feld API-Schlüssel/Geheimnis den generierten HMAC (Shared secret) einfügen. 

Geben Sie einen internen Registrierungsnamen ein, zum Beispiel „SHPF“, und klicken Sie auf Register. 

4. Was kommt als nächstes? 

Nach erfolgreicher Integration werden alle Rechnungen automatisch in die Agenda importiert. Rechnungsstellung - Abschnitte von Ausgestellte Rechnungen und gepaart mit Transaktionen nach variablem Symbol oder Betrag. 

Falls erforderlich, in der Tagesordnung Einstellungen im Abschnitt Links können Sie die Registrierung von Webhooks oder API-Schlüsseln aufheben oder sie durch neue ersetzen. 

1. Melden Sie sich bei Numiron an und wählen Sie die Entität, für die Sie die {assigned_company_id} benötigen. 

2. Nach der Anmeldung leitet Sie das System auf die Übersichtsseite weiter. Die {assigned_company_id} befindet sich in der URL. 

3. Die URL kann wie folgt aussehen:  
   https://my.numiron.sk/company_information?id=68df9487cb414435d3c4a7d5 
   Der Wert nach dem Parameter id= ist Ihre {assigned_company_id} 
    
   In diesem Fall ist es 68df9487cb414435d3c4a7d5. 

4. Um eine Rechnung für dieses Unternehmen zu erstellen, wird der Endpunkt:  
   POST /api/public/v1/zugeordnete_Unternehmen/68df9230cb414435d3c48bef/invoices 

Endpunkt & Autorisierung

• POST /api/public/v1/zugewiesene_Unternehmen/{zugewiesene_Unternehmen_id}/invoices

Wie erhält man {assigned_company_id} Bitte beachten Sie diesen Leitfaden.

• Überschriften:
  • Autorisierung: Überbringer
  • Akzeptieren: application/json
  • Inhalt-Typ: application/json
• Datumsformat: ISO-8601, z. B. 2025-06-30T00:00:00.000+00:00
• Währung: ISO-4217, z.B. EUR

Feld	Typ	Erforderlich	Beschreibung	Beispiel	Aufzählung / Anmerkung
Adresse_Käufer	String	✅	Adresse des Kunden - Straße und Hausnummer.	Hauptstraße 5
Adresse_Lieferant	String	✅	Meine Adresse - Straße und Hausnummer.	Hauptstraße 5
stadt_käufer	String	✅	Stadt des Kunden.	Bratislava
stadt_lieferant	String	✅	Meine Wohnung.	Bratislava
kunden_emails	array		Liste der Kunden-E-Mails (Empfänger).		Jeder Artikel hat E-Mail: Zeichenkette (z.B.. client@client.com).
konstantes_symbol	String		Konstantes Dokumentensymbol.	1234
land_käufer	String	✅	Land des Kunden (ISO 3166-1 alpha-2).	DE
land_lieferant	String		Mein Land (ISO 3166-1 alpha-2).	DE
Erstellungsdatum	string (datetime)	✅	Datum der Ausgabe.	2025-08-26T07:59:41.920Z	ISO-8601
Währung	String	✅	Währung (ISO 4217 Code).	CZK
lieferung_stadt	String		Ort der Lieferadresse.	Bratislava
lieferland	String		Land der Lieferadresse (ISO-2).	DE
Liefermethode	String	✅	Art der Lieferung.	in_person	durch_Kurier, elektronisch, in_person, eigener_Transport
lieferung_name	String		Name/Kontaktperson an der Lieferadresse.	Milan Malinový
Lieferstraße	String		Straße und Nummer der Lieferadresse.	Hauptstraße 5
lieferung_zip	String		Die Postleitzahl der Lieferadresse.	12345
dic_käufer	String		die Mehrwertsteuernummer des Kunden.	1234567890
dic_lieferant	String		Meine Umsatzsteuer-Identifikationsnummer.	1234567890
Umrechnungskurs	Nummer	✅	Fremdwährungskurs gegenüber EUR.	25.123
icdph_Käufer	String		Mehrwertsteuernummer des Kunden.	SK1234567890
icdph_lieferant	String		Meine Umsatzsteuer-Identifikationsnummer.	SK1234567890
ico_Käufer	String		Kunden-ID.	12345678
ico_Lieferant	String		Meine ID.	12345678
rechnung_zeilen	array	✅	Belegpositionen (siehe Tabelle unten).
Sprache	String	✅	Sprache des Dokuments.	DE	DE, DE, DE
Nachricht	String		Haupttext (nach „Wir stellen Ihnen eine Rechnung“).	unter Vertrag...
Name_Käufer	String	✅	Name des Kunden.	Gesellschaft s.r.o.
Name_Lieferant	String	✅	Mein Name.	Gesellschaft s.r.o.
Hinweis	String		Interne Notiz zum Dokument.	Der Kunde wollte eine Geschenkverpackung.
auftrag_nummer	String		Bestellnummer.	123ABC
oss	boolean		OSS-Modus (One Stop Shop).	falsch
absatz_käufer	String		Absatz der Mehrwertsteuerregistrierung des Kunden.	4
absatz_lieferant	String		Absatz meiner MwSt.-Registrierung.	4
Zahlungsmethode	String	✅	Art der Bezahlung.	bank_überweisung	Vorschuss_Zahlung, bank_überweisung, durch_Entschädigung, Karte, Bargeld, Nachnahme
save_client	boolean		Speichern Sie den Client in dem Verzeichnis.	falsch
Unterschrift	boolean		Unterschrift/Stempel auf PDF.	falsch
zip_käufer	String	✅	die Postleitzahl des Kunden.	12345
zip_lieferant	String	✅	Meine Postleitzahl.	12345
Lieferdatum	string (datetime)	✅	Datum der Lieferung (DUZP).	2025-08-26T07:59:41.920Z	ISO-8601
Lieferschein	boolean		Erstellen Sie auch einen Lieferschein.	falsch
Verfallsdatum	string (datetime)	✅	Fälligkeitsdatum.	2025-08-26T07:59:41.920Z	ISO-8601
iban	Zeichenfolge (IBAN)	✅	IBAN des Dokuments.	SK0000000000000000000000	Gültige IBAN
rechnung_nummer	String	✅	Dokument Nummer.	20250001	Einzigartig in der Serie
variables_symbol	String	✅	Variables Symbol.	1234123477

---

Artikel

Feld	Typ	Erforderlich	Beschreibung	Beispiel	Aufzählung / Anmerkung
Tätigkeit	String		Aktivität (für das Dashboard „Umsatz nach Aktivität“).	Akt 1
Betrag	Nummer	✅	Menge des Artikels.	1
MEHRWERTSTEUER	Nummer	✅	Mehrwertsteuersatz in %.	23
gegebene_verpflichtung	String		Steuermodus für die Linie 0%.	transfer_15	Befreiung_von_der_Steuerpflicht, transfer_15, transfer_16, dreieckig_handeln, Ausnahme
lieferung_art	String		Art der Leistung.	Dienstleistungen	z.B.. Waren, Dienstleistungen, ...
Abteilung	String		Zentrum (für das Dashboard „Verkäufe nach Zentrum“).	Depot 1
rabatt_eine_zeile	Nummer	✅	Rabatt auf den Artikel in %.	10
gewünschte_gesamtzahl	Nummer	✅	Der Endbetrag des Postens.	1.23	In der Regel mit Mehrwertsteuer
idx	String	✅	Eindeutiger Index des Artikels innerhalb des Dokuments.	1
itemInfo	String	✅	Text/Titel des Artikels.	Äpfel
measureUnit	String		Maßeinheit.	ks
Bestellung	String		Vertrag (für das Dashboard „Verkäufe nach Vertrag“).	Bestellung 1

---

Hinweis: Für desired_total berechnet das System die Einheitspreise und Rundungen nach den geltenden Regeln.

---

cURL-Beispiel (Vorlage)

curl -X POST \
‚https://my.numiron.sk/api/public/v1/assigned_companies/{ASSIGNED_COMPANY_ID}/Rechnungen‘
-H ‚accept: application/json‘ \
-H ‚authorization: bearer‚ \
-H ‚Content-Type: application/json‘ \
-d ‚{
„Adresse_Käufer“: „5 Main Street“,
„Adresse_Lieferant“: „10 Industrial Ave“,
„Stadt_Käufer“: „Bratislava“,
„Stadt_Lieferant“: „Bratislava“,
„client_emails“: [ „client@example.com“ ],
„Land_Käufer“: „de“,
„Land_Lieferant“: „de“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„Währung“: „EUR“,
„lieferung_stadt“: „Bratislava“,
„Lieferland“,
„Zustellungsmethode“,
„lieferung_name“,
„Lieferstraße“: „5 Main Street“,
„lieferung_zip“: „01001“,
„dic_purchaser“: „1234567890“,
„dic_supplier“: „1234567890“,
„Wechselkurs“: 1,
„icdph_supplier“: „SK1234567890“,
„ico_purchaser“: „12345678“,
„ico_lieferant“: „12345678“,
„invoice_lines“: [
{
„Betrag“: 1,
„MEHRWERTSTEUER“: 23,
„Lieferart“: „Dienstleistungen“,
„gewünschte_summe“: 195.10,
„idx“: „1“,
„itemInfo“: „Dienstleistungspaket 06/2025“
},
{
„Betrag“: 1,
„MEHRWERTSTEUER“: 23,
„Lieferart“: „Dienstleistungen“,
„gewünschte_gesamtsumme“: 18.44,
„idx“: „2“,
„itemInfo“: „Kontoführung 06/2025“
}
],
„Sprache“,
„Nachricht“: „Rechnung für erbrachte Dienstleistungen“,
„Name_Käufer“,
„Name_Lieferant“,
„Absatz-Lieferant“: „4“,
„Zahlungsmethode“: „Banküberweisung“,
„Unterschrift“: true,
„zip_purchaser“: „01001“,
„zip_lieferant“: „01002“,
„delivery_date“: „2025-06-30T00:00:00.000+00:00“,
„expiration_date“: „2025-07-14T00:00:00.000+00:00“,
„iban“: „SK0000000000000000000000“,
„Rechnungsnummer“: „20250687“,
„variable_symbol“: „3001827867“
}‘

---

Erwartete Antwort

  „abc123“

Mögliche Antwortcodes:

Code	Beschreibung
201	Erstellt.
400	Fehlerhafte Anfrage. Die Belegnummer ist bereits vorhanden oder die Verknüpfung mit den Belegen ist fehlgeschlagen.
401	Nicht eingeloggt.
403	Nicht erlaubt.
422	Fehler bei der Eingabeüberprüfung.