> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/bestellungen/bestell-setup-konfigurieren/rechnungen-mit-der-channable-api-hochladen-und-verwalten.md). # 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 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](/list-advertise/list-and-advertise-de/bestellungen/bestellung-verbindungen/unterstutzte-e-commerce-plattformen-fur-bestellungsverbindungen/so-richtest-du-die-channable-api-fur-eine-bestellungsverbindung-ein.md) * 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
{% stepper %} {% step %} ### Channable API-Zugriffstoken generieren {% hint style="success" %} Tipp: Du kannst diesen Schritt überspringen, wenn du bereits einen Zugriffstoken generiert hast. {% endhint %} 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. {% hint style="warning" %} 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. {% endhint %} {% endstep %} {% step %} ### Finde und notiere deine Produkt- und Bestell-IDs {% stepper %} {% step %} #### OPTION 1: Bestell-IDs über die Channable API abrufen (empfohlen für Entwickler) {% hint style="info" %} 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. {% endhint %} 1. Verwende [All Orders V2](https://api.channable.com/v1/docs#tag/orders/operation/all_orders_v2_v2_companies__company_id__projects__project_id__orders_get) 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. {% endstep %} {% step %} #### 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. {% endstep %} {% endstepper %} {% endstep %} {% step %} ### 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](https://api.channable.com/v1/docs#tag/order_attachments/operation/order_attachment_upload_companies__company_id__projects__project_id__orders__order_id__attachments_post). {% hint style="info" %} **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. {% endhint %} {% endstep %} {% step %} ### 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**.
{% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/bestellungen/bestell-setup-konfigurieren/rechnungen-mit-der-channable-api-hochladen-und-verwalten.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.