Rechnungen mit der Channable API hochladen und verwalten

Erfahre, wie du Bestellrechnungen mit der Channable API für unterstützte Marktplätze hochlädst und verwaltest.

Wenn du eine Bestellsynchronisation hast, kannst du deine Rechnungen im PDF-Format für unterstützte Marktplätze über die Channable API hochladen und verwalten. Diese Funktion ist für Amazon, Kaufland, bol und alle Mirakl-basierten Marktplätze verfügbar (z. B. MediaMarkt, Decathlon, Leroy Merlin usw.)

Bevor du beginnst

Damit du diese Funktion optimal nutzen kannst, stelle sicher, dass du Folgendes berücksichtigt hast:

Du brauchst

• Eine aktive Bestellsynchronisation mit bestehenden Bestellungen
• Einen Channable API-Zugriffstoken
• Ein Verständnis dafür, wie die API von Channable funktioniert
• Bestehende Bestellungen von einem unterstützten Marktplatz

Gut zu wissen

• Derzeit kannst du mit der Channable API nur deine Webshops hochladen und verwalten (keine webshop-basierten Plattformen)
• Die API ermöglicht es uns, zu empfangen Rechnungsinformationen. Derzeit können wir Rechnungen nicht automatisch von Plattformen für Bestellsynchronisationen abrufen.
• Bei diesem Setup verbindest du dein System über unsere API mit Channable. Das ist ein technischer Prozess, für den du normalerweise einen Entwickler oder jemanden mit Programmierkenntnissen brauchst.

Alle Mirakl-basierten Marktplätze

• MediaMarkt
• Leroy Merlin
• Bricoman
• Decathlon
• Debenhams
• Vtwonen
• ANWB
• INNO
• Aber
• Conrad
• La Redoute
• Praxis
• Le BHV Marais
• Home24
• Galeries LaFayette
• fonQ
• BlokkerConnect!
• Carrefour Frankreich
• Carrefour Spanien
• Maisons du Monde
• Kruidvat
• Obelink
• Worten
• Douglas
• FNAC Darty Offers
• Manor
• Leen Bakker
• Conforama
• PcComponentes
• ePrice

1

Channable API-Zugriffstoken generieren

Tipp: Du kannst diesen Schritt überspringen, wenn du bereits einen Zugriffstoken generiert hast.

1. Gehe in Channable zu deinen Firmeneinstellungen.
2. Wähle im Bereich Tools Channable API.
3. Notiere dir deine Firmen-ID, da du sie später brauchst.
4. Klicke Token generieren um einen Firmen-Token zu generieren.

Wichtig: Sobald dein Token generiert wurde, speichere ihn an einem sicheren Ort. Aus Sicherheitsgründen zeigen wir den Token nach der Generierung nicht noch einmal an. Wenn du ihn verlierst, musst du einen neuen generieren.

2

Finde und notiere deine Produkt- und Bestell-IDs

1

OPTION 1: Bestell-IDs über die Channable API abrufen (empfohlen für Entwickler)

Hinweis: Wenn du die Channable-Bestell-ID beim ersten Abrufen und Verarbeiten offener Bestellungen speicherst, musst du Bestellungen beim Senden von Rechnungen nicht noch einmal abrufen. Du kannst die ID aus den Daten verwenden, die du bereits hast.

1. Verwende All Orders V2 um Bestellungen aus Channable abzurufen.
2. Jede Bestellung enthält ein id-Attribut — das ist die ID, die du beim Hochladen von Rechnungen für eine bestimmte Bestellung angeben musst.

2

OPTION 2: Bestell-IDs manuell in Channable finden (empfohlen für Nicht-Entwickler)

1. Öffne in Channable das Projekt mit deiner Bestellsynchronisation.
2. Gehe in der Seitenleiste zu Einstellungen. Dadurch gelangst du zu deinen Projekteinstellungen.
3. Notiere dir deine Projekt-ID, da du sie in deiner API-Anfrage brauchst.
4. Gehe zu Bestellungen. Dort siehst du eine Liste deiner importierten Bestellungen.
5. Notiere dir die konkreten Bestell-IDs, für die du Rechnungen hochladen möchtest.

3

Integration für Rechnungen (Entwickler)

In diesem Schritt schreibst du oder dein Entwickler Code, der direkt mit Channable kommuniziert, um die Rechnungsdaten an die richtige Bestellung zu senden.

1. Konvertiere deine Rechnungsdatei von einer PDF in einen Base64-kodierten String.
2. Erstelle deine Anfrage:

   1. Erstelle eine POST-Anfrage an den Endpunkt order_attachment_upload.
   2. Füge deinen API-Zugriffstoken in den Header Authorization: Bearer your_api_token ein.
   3. Fülle den Request-Body aus. Er sollte Folgendes enthalten:

      • attachment_type: Setze auf „INVOICE“
      • file: der Base64-kodierte String deiner Rechnungsdatei
      • order_item_ids (optional, nur bol): ein Array mit Bestellpositions-IDs. Wenn du sie nicht hinzufügst, wird die Rechnung mit allen Artikeln in der Bestellung verknüpft.

Ausführliche Anweisungen findest du in unserer Dokumentation zur Order Attachments API.

Hinweis: Du kannst mehrere Rechnungen pro Bestellung übermitteln. Einige Kanäle, zum Beispiel Amazon, speichern jedoch nur die neueste Rechnung und entfernen frühere Versionen. Für genaue Informationen zum Verhalten eines Kanals kontaktierst du am besten das Support-Team deines Marktplatzes.

4

Prüfe deine hochgeladenen Rechnungen

Nachdem du oder dein Entwickler eine Rechnung über unsere Channable API gesendet hat, prüfe in Channable, ob sie korrekt angehängt wurde.

• Öffne in Channable das Projekt mit deiner Bestellsynchronisation.
• Gehe zu Bestellungen.
• Klicke auf die Bestellung, für die du die Rechnung hochgeladen hast.
• Gehe zum Bestellanhänge Tab.
• Klicke Rechnung herunterladen.