Der Manual/API-Kanal

Wann einen Manual/API-Kanal nutzen

Ein Manual/API-Kanal ist mit keinem Shop verknüpft. Es wird nichts auf eine Website hochgeladen, und keine Bestellungen kommen von selbst herein. Nutzen Sie ihn, wenn:

• Sie auf Ihrer eigenen Website, auf einem von uns nicht unterstützten Marktplatz, in sozialen Medien oder telefonisch verkaufen und jede Bestellung selbst an uns senden möchten.
• Sie ein eigenes System oder einen Entwickler haben und Bestellungen über unsere API an uns senden möchten.

Läuft Ihr Shop auf einer auf der Seite Add Sales Channel gezeigten Plattform, wie Shopify, WooCommerce, eBay oder TikTok Shop, verbinden Sie stattdessen diese Plattform. Dann werden Produkte für Sie hochgeladen, und Bestellungen kommen von selbst herein.

Sie können mehr als einen Manual/API-Kanal haben, zum Beispiel einen pro Website.

Den Kanal erstellen

1. Öffnen Sie Channels im Menü. Sie sehen die Liste Ihrer Sales Channels.
2. Drücken Sie Add Sales Channel. Die Seite zeigt Select channel you want to create.
3. Drücken Sie auf der Karte Manual/API Create.
4. Ein Fenster Create platform manual öffnet sich. Geben Sie einen Namen für den Kanal ein, zum Beispiel den Namen Ihrer Website. Der Name darf bis zu 28 Zeichen lang sein.
5. Drücken Sie Create.

Sie sehen die Meldung Your Manual store has been created., und die Kanalseite öffnet sich.

Jeder Ihrer Kanäle braucht einen eigenen Namen. Wird der Name bereits von einem anderen Ihrer Kanäle verwendet, zeigt das Fenster einen Fehler. Wählen Sie einen anderen Namen.

Ihre Kanalseite

Die Kanalseite trägt den Namen Ihres Kanals als Titel und die Überschrift Manual/API order management. Sie zeigt drei Felder, jedes mit einem Link View all:

• Orders: die von Ihnen in diesem Kanal aufgegebenen Bestellungen.
• Clients: die Personen, an die Sie Bestellungen senden.
• Products: die Produkte in Ihrer Liste My Products.

Im Menü, unter dem Kanalnamen, finden Sie:

• Baskets: begonnene, noch nicht bezahlte Bestellungen.
• My Products: die von Ihnen in diesem Kanal verkauften Produkte. Siehe Managing products on the Manual/API channel.
• Clients: Ihre Käufer. Siehe Managing clients.
• Orders: Ihre aufgegebenen Bestellungen. Siehe Placing orders manually.
• API: Tokens und Dokumentation, um Ihr eigenes System zu verbinden.

Der übliche Arbeitsweg ist:

1. Fügen Sie mit Add products die von Ihnen verkauften Produkte zu My Products hinzu. Dies wird für die API benötigt. Für selbst eingetippte Bestellungen ist es optional: Der Warenkorb lässt Sie jedes von uns verkaufte Produkt auswählen.
2. Erhalten Sie eine Bestellung, öffnen Sie Clients, suchen Sie Ihren Käufer oder fügen Sie ihn hinzu.
3. Drücken Sie auf der Kundenseite Create Order, fügen Sie Produkte und Mengen hinzu und bezahlen Sie.

Den Namen ändern oder den Kanal schließen

Um den Kanal umzubenennen, drücken Sie auf der Kanalseite Edit und ändern Sie Store name.

Um einen Kanal zu schließen, gehen Sie zu Channels und drücken Sie die Schließen-Schaltfläche in der Spalte Action (Tooltip Close channel). Das Fenster fragt Are you sure you want to close this channel? und warnt This operation is irreversible. Ein geschlossener Kanal verschwindet aus dem Menü. Ihre vergangenen Bestellungen und Rechnungen bleiben erhalten.

Ihr eigenes System mit der API verbinden

Die API lässt Ihre Website oder App selbst tun, was Sie auf den Kanalseiten tun: unseren Produktkatalog mit aktuellen Preisen lesen, Produkte zu My Products hinzufügen, Kunden anlegen und ändern, Bestellungen erstellen, ihnen Produkte hinzufügen, sie absenden und verfolgen. Sie können auch Ihre Liste My Products als CSV- oder JSON-Feed herunterladen, um Produkte in Ihre eigene Website zu laden.

Öffnen Sie API unter Ihrem Kanal. Die Seite hat diese Tabs:

• Overview: wie Sie sich verbinden, die Basisadresse der API und die Schaltfläche API documentation. Die Dokumentation listet jeden Endpunkt mit Beispielen.
• API tokens: die Tokens für diesen Kanal.
• API calls: die von Ihrem System gestellten Anfragen.
• History: Änderungen an Ihrem Konto.

Ein Token erhalten

1. Drücken Sie Generate API token.
2. Soll das Token nur zum Lesen von Daten dienen, haken Sie Read only (cannot create, change or submit orders) an.
3. Drücken Sie Click to Generate.
4. Kopieren Sie das Token mit dem Kopiersymbol und bewahren Sie es sicher auf. Das Fenster sagt Put this token in a safe place, you won't be able to see it again. Die kurze Bezeichnung in der Token-Liste ist nur ein Name, nicht das Token.

Senden Sie das Token bei jeder Anfrage im Header Authorization: Bearer, gefolgt von Ihrem Token. Jedes Token gehört zu einem Kanal: Produkte, Kunden und Bestellungen, die Ihr System anlegt, gehen an diesen Kanal. Um ein Token unbrauchbar zu machen, löschen Sie es im Tab API tokens.

Zuerst auf Staging testen

Der Tab Overview hat außerdem Open staging mirror. Staging ist eine separate Kopie der Website, auf der Sie ohne echte Bestellungen oder Zahlungen testen können. Melden Sie sich mit derselben E-Mail-Adresse und demselben Passwort an. Staging wird regelmäßig mit einer frischen Kopie zurückgesetzt, wodurch Ihre dortigen Änderungen gelöscht werden. Tokens der echten Website funktionieren auf Staging nicht: Erzeugen Sie ein separates Token auf Staging, und nach jedem Reset ein neues. Die Basisadresse für Staging steht im Tab Overview.

Wie API-Bestellungen bezahlt werden

Sobald Ihr System eine Bestellung absendet, bezahlen wir sie zuerst von Ihrem Kontoguthaben, dann von Ihren gespeicherten Karten. Fügen Sie eine Karte hinzu, bevor Sie beginnen. Sobald Sie ein Token haben, zeigt das Menü Saved Cards. Solange keine Karte gespeichert ist, zeigt die API-Seite You have no cards saved yet. mit einer Schaltfläche Add card.

Decken weder Ihr Guthaben noch Ihre Karten die Bestellung, wird sie als Unpaid markiert und geht nicht ans Lager. Laden Sie Ihr Guthaben mit Top Up auf, öffnen Sie die Bestellung und drücken Sie Pay … with balance. Die Schaltfläche erscheint, sobald Ihr Guthaben den fälligen Betrag deckt.

Wenn etwas schiefgeht

• The name is already taken when I create the channel. Einer Ihrer geöffneten Kanäle trägt diesen Namen bereits. Geben Sie einen anderen Namen ein. Der Name eines geschlossenen Kanals kann erneut verwendet werden.
• My orders are not arriving by themselves. Ein Manual/API-Kanal sammelt nie Bestellungen von einer Website. Erstellen Sie sie auf der Kundenseite, oder senden Sie sie über die API von Ihrem System aus. Verkaufen Sie auf einer auf der Seite Add Sales Channel gezeigten Plattform, verbinden Sie diese Plattform als eigenen Kanal.
• My products are not on my website. Von einem Manual/API-Kanal laden wir nichts hoch. Laden Sie sie selbst in Ihre Website, mit dem CSV-Download unter My Products oder über die API.
• I lost my API token. Es kann nicht erneut angezeigt werden. Erzeugen Sie ein neues Token, tragen Sie es in Ihr System ein und löschen Sie das alte.
• The API answers that I cannot create or change orders. Das Token ist nur lesend. Erzeugen Sie ein Token ohne angehaktes Read only.
• The API refuses my requests for a short while. Jedes Token kann bis zu 120 Anfragen pro Minute stellen. Verlangsamen Sie Ihr System und versuchen Sie es nach einer Minute erneut.
• The API says "This order has no products yet". Fügen Sie der Bestellung mindestens ein Produkt hinzu, bevor Sie sie absenden.
• The API says "Unable to find related portfolio item". Über die API fügen Sie einer Bestellung ein Produkt über sein My Products-Element hinzu, nicht über das Produkt selbst. Fügen Sie das Produkt zuerst zu My Products hinzu und verwenden Sie die ID dieses Elements.
• The API says another transaction with the same product already exists. Das Produkt befindet sich bereits auf der Bestellung. Ändern Sie stattdessen die Menge dieser Zeile, statt sie erneut hinzuzufügen.
• The API says the order "is already in the 'submitted' state and cannot be updated". Abgesendete Bestellungen können über die API nicht geändert oder gelöscht werden. Kontaktieren Sie uns im Chat auf unserer Website, wenn die Bestellung geändert werden muss.
• My API order shows Unpaid. Ihr Guthaben und Ihre gespeicherten Karten haben sie nicht gedeckt. Laden Sie Ihr Guthaben auf, öffnen Sie die Bestellung und drücken Sie Pay … with balance, und prüfen Sie, ob Ihre gespeicherte Karte noch gültig ist.