Installation und Berechtigungen
BundlesIQ wird über den Shopify App Store mit standardmäßiger OAuth-Authentifizierung installiert. Diese Seite erklärt, auf welchen Zugriff die App angewiesen ist und warum.
Installieren Sie BundlesIQ
- Besuchen Sie die BundlesIQ-Listing im Shopify App Store
- Klicken Sie auf App hinzufügen und bestätigen Sie die Installation in Ihrem Shopify-Shop
- Überprüfen Sie die angeforderten Berechtigungen und genehmigen Sie diese
- Vervollständigen Sie den Onboarding-Assistenten, um Ihren Standardbehandlungsmodus auszuwählen und grundlegende Einstellungen zu konfigurieren
Erforderliche Berechtigungen
BundlesIQ fordert während der Installation die folgenden Shopify-Zugriffsbereiche an:
Produkte
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_products |
Suchen Sie nach Bundle- und Komponentenprodukt-/Varianten-Daten (Preise, SKUs, Status, Bilder) zur Erkennung, Preisberechnung und für das Produkt-Suchmodal |
write_products |
Synchronisieren Sie abgeleitete Bundle-Inventarlevels und Einzelhandelspreise zurück zum Ghost-SKU-Produkt, wenn die Inventarsynchronisierung oder der Einzelhandelssynchronisierung aktiviert ist |
Bestellungen
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_orders |
Erkennen Sie Bundles bei eingehenden Bestellungen, lesen Sie Zeilenartikel, Tags, Rabattzuweisungen und Metafelder zur Verarbeitung und für das Gesundheits-Dashboard |
write_orders |
Schreiben Sie Verarbeitungstags (BIQ_PROCESSING, BIQ_READY, BIQ_ERROR), schreiben Sie Transformations-Audit-Metafelder und aktualisieren Sie Bestellnotizattribute |
write_order_edits |
Transformieren Sie Bestellungen über die Order Edit API — fügen Sie Komponenten-Zeilenartikel hinzu, wenden Sie Rabatte an und ändern oder entfernen Sie den Bundle-Zeilenartikel |
Entwurfsbestellungen
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_draft_orders |
Erkennen Sie Bundles bei Entwurfsbestellungen und lesen Sie Zeilenartikel-Daten für B2B- und Großhandelsverarbeitung |
write_draft_orders |
Transformieren Sie Entwurfsbestellungen, indem Sie Zeilenartikel über die draftOrderUpdate-Mutation ersetzen. Wird auch verwendet, um Entwurfsbestelltransformationen zurückzusetzen |
Inventar
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_inventory |
Berechnen Sie die Verfügbarkeit von Bundles aus den Komponentenlagerbeständen an verschiedenen Standorten |
write_inventory |
Synchronisieren Sie abgeleitetes Bundle-Inventar zurück zur Ghost-SKU-Variante. Im Parent-Only (BOM)-Modus wird es auch verwendet, um Komponenteninventar über die Inventarstatus-API von Shopify zu reservieren, zu verbrauchen und freizugeben |
Erfüllung
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_fulfillments |
Lesen Sie den Status der Erfüllungsbestellungen, um die Berechtigung zur Zurückhaltung zu bestimmen und den Erfüllungsstatus während der Verarbeitung zu überprüfen |
write_assigned_fulfillment_orders |
Platzieren und Freigeben von Erfüllungszurückhaltungen für Bestellungen, die Ihren Standorten zugewiesen sind (3PL-Schutz) |
write_merchant_managed_fulfillment_orders |
Platzieren und Freigeben von Erfüllungszurückhaltungen für vom Händler verwaltete Erfüllungsbestellungen (3PL-Schutz) |
write_third_party_fulfillment_orders |
Platzieren und Freigeben von Erfüllungszurückhaltungen für Drittanbieter-Erfüllungsbestellungen (3PL-Schutz) |
Rabatte, Standorte und andere Daten
| Bereich | Warum BundlesIQ es benötigt |
|---|---|
read_discounts |
Lesen Sie Rabattcode- und automatische Rabattinformationen aus Bestellungen, um Promo-Rabatte in die Preiszuweisung für Komponenten einzubeziehen |
read_locations |
Lesen Sie die Standortdaten von Shopify für die Multi-Standort-Inventarsynchronisierung und die Parent-Only (BOM)-Standortstrategie-Konfiguration |
read_markets |
Lesen Sie die Markt- und Währungs-Konfiguration für die Unterstützung von Multi-Währungs-Preisen |
read_locales |
Lesen Sie die Einstellungen für den Store-Locale für lokalisierte Inhalte |
read_metaobjects |
Lesen Sie die Metaobjektdefinitionen, die von der Storefront-Erweiterung für die Anzeige "Was ist enthalten" verwendet werden |
read_returns |
Lesen Sie Rückgabedaten, um das Verhalten der Wiederauffüllung von Komponenten für Bundle-Bestellungen zu verfolgen |
Registrierte Webhooks
BundlesIQ abonniert Shopify-Webhooks, um in Echtzeit auf Shop-Ereignisse zu reagieren. Die wichtigsten Webhook-Gruppen sind unten beschrieben.
Kernverarbeitung
Diese Webhooks steuern die Bundle-Erkennung und Bestelltransformation:
| Webhook | Zweck |
|---|---|
orders/create |
Erkennen Sie neue Bestellungen, die Bundle-Produkte enthalten, und beginnen Sie mit der Verarbeitung |
orders/updated |
Erkennen Sie Bestelländerungen und unterstützen Sie die Wiederverarbeitungs-Workflows |
orders/paid |
Auslösen der Verarbeitung für zahlungsgesteuerte Workflows. Wird auch im Parent-Only (BOM)-Modus verwendet, wenn der Reservierungszeitpunkt auf orders/paid gesetzt ist |
orders/cancelled |
Freigeben von reserviertem Komponenteninventar (Parent-Only-Modus) und Aktualisieren des Verarbeitungsstatus |
draft_orders/create |
Erkennen Sie neue Entwurfsbestellungen, die Bundle-Produkte enthalten |
draft_orders/update |
Verarbeiten Sie Entwurfsbestellungen, wenn sie erstellt oder geändert werden |
draft_orders/delete |
Bereinigen Sie den Verarbeitungsstatus, wenn eine Entwurfsbestellung gelöscht wird |
Inventar- und Katalog-Synchronisierung
Diese Webhooks halten die Verfügbarkeit, Preisgestaltung und Konfiguration von Bundles synchron mit Ihrem Shopify-Katalog:
| Webhook | Zweck |
|---|---|
inventory_levels/update |
Berechnen Sie die Verfügbarkeit von Bundles neu, wenn sich der Komponentenbestand an einem Standort ändert |
inventory_levels/connect / disconnect |
Verfolgen Sie, wann das Inventar an einem Standort aktiviert oder deaktiviert wird, was die Berechnungen der Bundle-Verfügbarkeit beeinflusst |
inventory_items/create / update / delete |
Verfolgen Sie Änderungen an den Einstellungen von Inventarartikeln (z. B. Verfolgungsstatus, Kosten) für Komponenten und Ghost-SKUs |
products/create / update / delete |
Erkennen Sie, wann Komponenten- oder Ghost-SKU-Produkte erstellt, geändert oder entfernt werden. Wird für die Synchronisierung von Einzelhandelspreisen, Statusprüfungen und Bundle-Validierung verwendet |
collections/create / update / delete |
Verfolgen Sie Änderungen an Sammlungen, die die Sichtbarkeit von Bundle-Produkten beeinflussen können |
Erfüllung und Bestelllebenszyklus
BundlesIQ überwacht Erfüllungsereignisse, um 3PL-Schutz zur Verwaltung von Zurückhaltungen, den Bestellstatus für das Gesundheits-Dashboard zu verfolgen und den Verbrauch von Inventar im Parent-Only (BOM)-Modus zu handhaben:
| Webhook | Zweck |
|---|---|
orders/fulfilled / orders/partially_fulfilled |
Verfolgen Sie den Fortschritt der Erfüllung. Im Parent-Only-Modus löst es den Verbrauch von reserviertem Komponenteninventar aus |
orders/edited |
Erkennen Sie externe Änderungen an Bestellungen, die bereits von BundlesIQ verarbeitet wurden |
orders/delete |
Bereinigen Sie den Verarbeitungsstatus, wenn eine Bestellung gelöscht wird |
refunds/create |
Erkennen Sie Rückerstattungen für Bundle-Bestellungen, um das Gesundheits-Dashboard zu aktualisieren und im Parent-Only-Modus reserviertes oder verbrauchtes Komponenteninventar wieder aufzufüllen |
fulfillment_orders/* |
Eine Reihe von Erfüllungsbestell-Webhooks (verschoben, zusammengeführt, aufgeteilt, Zurückhaltung freigegeben, Routing abgeschlossen und andere), die zur Verwaltung von Shopify-nativen Erfüllungszurückhaltungen für 3PL-Schutz verwendet werden |
fulfillments/create / update |
Verfolgen Sie die Erstellung und Aktualisierungen von Erfüllungen für den Verarbeitungsstatus und das Management des Inventarlebenszyklus |
fulfillment_events/create |
Verfolgen Sie Meilensteinereignisse der Erfüllung (z. B. versendet, geliefert) |
Rabatte, Märkte und Standorte
| Webhook | Zweck |
|---|---|
discounts/create / update / delete |
Verfolgen Sie Änderungen an Rabatten, die mit der Preiszuweisung von Bundles interagieren können |
markets/create / update / delete |
Verfolgen Sie Änderungen an der Markt-Konfiguration für die Unterstützung von Multi-Währungs-Preisen |
locations/create / update / delete |
Verfolgen Sie Änderungen an Standorten für die Multi-Standort-Inventarsynchronisierung und die Parent-Only-Standortstrategie |
selling_plan_groups/create / update / delete |
Verfolgen Sie Änderungen an Abonnementverkaufsplänen für die Kompatibilität mit Bestellungen von Abonnement-Apps |
App-Lebenszyklus
BundlesIQ abonniert Webhooks für den Lebenszyklus der App und die Abrechnung zu Betriebszwecken:
| Webhook | Zweck |
|---|---|
app/uninstalled |
Bereinigen Sie App-Daten, geben Sie Erfüllungszurückhaltungen frei und widerrufen Sie den Zugriff, wenn die App entfernt wird |
app_subscriptions/update |
Verfolgen Sie Änderungen an den Abrechnungsplänen und Nutzungsaktualisierungen |
app_subscriptions/approaching_capped_amount |
Auslösen von Benachrichtigungen, wenn die Nutzung von Scale+ die Ausgabenobergrenze erreicht |
app/scopes_update |
Erkennen Sie Änderungen an den gewährten Zugriffsbereichen |
shop/update |
Verfolgen Sie Änderungen an der Shop-Konfiguration (Währung, Zeitzone, Plan) |
Datenspeicherung
BundlesIQ speichert die folgenden Daten:
- Bundle-Definitionen — Bundle-Name, Status, Ghost-SKU-Referenz, Komponentenliste, Preisgestaltungskonfiguration und Einschränkungen
- Verarbeitungsprotokolle — Zeitgestempelte Aufzeichnungen jeder Bestelltransformation, einschließlich Erfolgs-/Fehlerstatus, Flags und Preisdaten
- Bundle-Instanzen — Pro-Bestellung-Snapshot, welche Bundles erkannt wurden, wie sie transformiert wurden und die resultierende Zeilenartikelzuordnung
- Shop-Einstellungen — Ihre Präferenz für den Behandlungsmodus, den Verarbeitungsbereich, die 3PL-Schutzkonfiguration und die Synchronisierungseinstellungen
Alle Daten werden sicher in der Cloud-Infrastruktur von BundlesIQ gespeichert. Bundle-Metadaten werden auch in Shopify-Bestellmetafeldern zur Auditierbarkeit geschrieben.
Firewall- und Netzwerkanforderungen
BundlesIQ funktioniert als cloudbasierter Dienst. Es sind keine Firewall-Konfigurationen auf Ihrer Seite erforderlich. Die Webhook-Zustellung nutzt die standardmäßige Webhook-Infrastruktur von Shopify.