Verbindung mit Shopify über WebHook

Die Integration mit Shopify funktioniert über den WebHook-Mechanismus. Wenn eine Bestellung in Shopify erfüllt (fulfill) wird, werden die Daten automatisch an Kigo gesendet, die eine Rechnung oder ein Angebot erstellt, das Dokument fiskalisiert und per E-Mail an den Käufer sendet.

Aktivierungsvorgang:

1. Öffnen Sie im Shopify Admin Settings → Notifications.
2. Klicken Sie am Ende der Seite auf Create Webhook.
3. Wählen Sie den Event-Typ Order Fulfillment (alle orders/* Events werden unterstützt).
4. Fügen Sie die WebHook-URL aus den Kigo-Einstellungen ein (verfügbar auf der Shopify-Integrationsseite).
5. Speichern Sie den WebHook und testen Sie ihn durch Senden einer Testbestellung.

Erstellung von Rechnung oder Angebot

Der Dokumenttyp hängt vom Zahlungsstatus der Bestellung zum Zeitpunkt des WebHook-Versands ab:

• Wenn die Bestellung als bezahlt markiert ist (financial_status = paid) — wird eine Rechnung erstellt.
• Wenn die Bestellung nicht bezahlt ist — wird ein Angebot erstellt.

Dieses Verhalten können Sie über den Tab Zusätzliche Regeln weiter anpassen, wo Sie die Kombination aus Event, Zahlungsmethode und gewünschtem Dokumentstatus definieren.

Artikel werden automatisch aus der Shopify-Bestellung zusammen mit Preis und Steuer übernommen. Wichtig ist, dass jeder Artikel in Shopify eine definierte SKU hat, damit er nicht bei jeder neuen Bestellung dupliziert wird.

Zuordnung der Zahlungsmethoden

Kigo erkennt automatisch die Zahlungsmethode aus der Shopify-Bestellung nach folgenden Regeln:

• Kartenzahlungen — werden als Zahlungsmethode Karte erfasst.
• Banküberweisung, Nachnahme (COD), Bankeinzahlung, PayPal — werden als Transaktion erfasst.

Für spezifische Konfigurationen verwenden Sie den Tab Zusätzliche Regeln, wo Sie einzelne Shopify Payment Gateways der gewünschten Kigo-Zahlungsmethode zuordnen können.

USt-Einrichtung und B2B-Rechnungen (R1)

Die USt wird automatisch aus der Shopify-Bestellung übernommen. Für die korrekte Einrichtung:

1. Öffnen Sie in Shopify Settings → Taxes and duties und fügen Sie Kroatien mit einem USt-Satz von 25% hinzu.
2. Aktivieren Sie bei jedem Produkt die Option Charge tax on this product.

Für B2B-Kunden (Ausstellung von R1-Rechnungen) gibt der Käufer bei der Bestellung im Feld Company name den Firmennamen und die OIB ein (z.B. Firma d.o.o. / 12345678901). Kigo erkennt automatisch die OIB (11 Ziffern) aus diesem Feld und erstellt einen B2B-Kunden.

Das Feld Company name aktivieren Sie unter Shopify Admin → Settings → Checkout, Abschnitt Customer information, auf Optional oder Required setzen.

Artikelsynchronisation (PREMIUM)

Für die bidirektionale Synchronisation von Artikeln, Beständen und Kategorien mit Shopify ist die Option Shopify-Synchronisation erforderlich, die eine PREMIUM-Lizenz voraussetzt.

Für die Nutzung der Synchronisation benötigen Sie Shopify-API-Zugangsdaten:

1. Öffnen Sie im Shopify Admin Apps → Apps and sales channels → Developer apps.
2. Erstellen Sie eine neue Anwendung (z.B. KigoPOS) und aktivieren Sie die Berechtigungen: write_inventory, read_inventory, read_locations, read_products, write_products.
3. Kopieren Sie API Key, Password und Shared Secret und geben Sie diese in den Kigo Shopify-Einstellungen ein.

Artikel müssen einen eingerichteten Web-Namen haben (eindeutig für alle Variationen), die Option Im Web sichtbar = Ja, sowie bei Bedarf Attribute für Variationen (z.B. Größe: XL) und Metadaten.

Häufige Fragen

• Die Bestellung erscheint nicht in Kigo? Überprüfen Sie, ob die WebHook-URL korrekt kopiert wurde und ob der richtige Event ausgewählt ist. Den Zustellungsstatus des WebHooks können Sie unter Shopify Admin → Settings → Notifications → Webhooks überprüfen.
• Wie storniere ich eine aus Shopify erstellte Rechnung? Die Stornierung erfolgt ausschließlich in der Kigo-Anwendung. Finden Sie die Rechnung und verwenden Sie die Stornierungsoption – die fiskalisierte Stornierung wird automatisch der Steuerbehörde gemeldet.
• Kann ich Kategorien mit Unterkategorien verwenden? Ja, verwenden Sie das Zeichen > im Gruppennamen zur Definition der Hierarchie (z.B. Kleidung > Damen > Kleider). Kigo erstellt automatisch die entsprechenden Kollektionen in Shopify.
• Muss ich Artikel manuell eingeben? Nein, wenn Sie kein Lager führen. Artikel werden automatisch aus jeder Bestellung hinzugefügt, müssen aber eine definierte SKU in Shopify haben.