Rechnungen mit der Channable API hochladen und verwalten

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 (z. B. MediaMarkt, Decathlon, Leroy Merlin usw.) verfügbar.

Bevor du beginnst

Damit du das Feature optimal nutzen kannst, stelle sicher, dass du Folgendes bedacht hast:

Du benötigst

• Eine aktive Bestellsynchronisation mit bestehenden Bestellungen

• Ein Channable API-Zugangstoken

• Grundlagenwissen darüber, wie Channables API funktioniert

• Vorhandene Bestellungen von einem unterstützten Marktplatz

Gut zu wissen

• Derzeit kannst du nur Webshops über die Channable API hochladen und verwalten (nicht webshop-basierte Plattformen).

• Die API erlaubt uns, zu empfangen Rechnungsinformationen. Derzeit können wir Rechnungen nicht automatisch von Bestellplattformen abrufen.

• Diese Einrichtung verbindet dein System mit Channable über unsere API. Das ist ein technischer Prozess, für den üblicherweise ein Entwickler oder jemand mit Programmierkenntnissen nötig ist.

Alle Mirakl-basierten Marktplätze

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• But

• 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-Zugangstoken erzeugen

Tipp: Diesen Schritt kannst du überspringen, wenn du bereits ein Zugangstoken erstellt hast.

1. Gehe in Channable zu deinen Firmeneinstellungen.

2. Wähle im Bereich Tools Channable API.

3. Notiere dir deine Company ID, da du sie später benötigst.

4. Klicke Token erzeugen um ein Company-Token zu generieren.

Wichtig: Sobald dein Token erzeugt wurde, sichere es an einem sicheren Ort. Aus Sicherheitsgründen zeigen wir den Token nach der Erstellung nicht erneut an. Wenn du ihn verlierst, musst du einen neuen generieren.

2

Finde und notiere deine Produkt- und Bestell-IDs

1

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

Hinweis: Wenn du die Channable-Bestell-ID beim erstmaligen Abrufen und Verarbeiten offener Bestellungen speicherst, musst du die Bestellungen beim Hochladen der Rechnungen nicht erneut abrufen. Du kannst die ID aus den bereits vorhandenen Daten verwenden.

1. Nutze Alle Bestellungen V2 um Bestellungen aus Channable abzurufen.

2. Jede Bestellung enthält ein id-Attribut — das ist die ID, die du beim Hochladen einer Rechnung 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. Das bringt dich zu deiner Projekteinstellungen.

3. Notiere dir deine Projekt-ID, da du sie in deiner API-Anfrage brauchst.

4. Gehe zu Bestellungen. Du siehst eine Liste deiner importierten Bestellungen.

5. Notiere dir die spezifischen Bestell-IDs, für die du Rechnungen hochladen möchtest.

3

Integration für Rechnungen (Entwickler)

In diesem Schritt schreibt du bzw. dein Entwickler Code, der direkt mit Channable kommuniziert, um die Rechnungsdaten der richtigen Bestellung zuzuordnen.

1. Wandle deine Rechnungsdatei von PDF in einen Base64-codierten String um.

2. Baue deine Anfrage auf:

   1. Erstelle eine POST-Anfrage an den order_attachment_upload-Endpunkt.

   2. Binde dein API-Zugangstoken im Header Authorization: Bearer your_api_token ein.

   3. Fülle den Request-Body. Er sollte enthalten:

      • attachment_type: Setze auf „INVOICE“

      • file: den Base64-codierten String deiner Rechnungsdatei

      • order_item_ids (optional, nur bol): ein Array von Order-Item-IDs. Wenn du sie nicht angibst, wird die Rechnung mit allen Artikeln der Bestellung verknüpft.

Für detaillierte Anweisungen siehe unsere Dokumentation zur Order Attachments API.

Hinweis: Du kannst mehrere Rechnungen pro Bestellung einreichen. Einige Kanäle (z. B. Amazon) speichern jedoch nur die neueste Rechnung und entfernen frühere. Für Informationen zum Verhalten eines bestimmten Kanals wende dich am besten an den Support des jeweiligen Marktplatzes.

4

Prüfe deine hochgeladenen Rechnungen

Nachdem du bzw. dein Entwickler eine Rechnung über unsere Channable API gesendet habt, 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 prüfen.

• Klicke Rechnung herunterladen.