> 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-fr/commandes/configurer-linstallation-des-commandes/televerser-et-gerer-les-factures-avec-lapi-channable.md). # Téléverser et gérer les factures avec l'API Channable Si vous disposez d’une connexion commande, vous pouvez importer et gérer vos factures au format PDF pour les marketplaces prises en charge via l’API Channable. Cette fonctionnalité est disponible pour Amazon, Kaufland, bol et toutes les marketplaces basées sur Mirakl (par exemple MediaMarkt, Decathlon, Leroy Merlin, etc.). ### Avant de commencer Pour tirer le meilleur parti de cette fonctionnalité, assurez-vous d’avoir pris en compte les éléments suivants : **Vous aurez besoin de** * Une connexion commande active avec des commandes existantes * Un token d’accès à l’API Channable * [Une compréhension du fonctionnement de l’API Channable](/list-advertise/list-and-advertise-fr/commandes/connexions-de-commande/plateformes-ecommerce-prises-en-charge-pour-les-connexions-de-commande/comment-a-configurer-vers-le-haut-lapi-channable-pour-une-connexion-de-commande.md) * Des commandes existantes provenant d’une marketplace prise en charge **Bon à savoir** * Actuellement, vous ne pouvez importer et gérer vos boutiques en ligne qu’avec l’API Channable (et non les plateformes basées sur une boutique en ligne) * L’API nous permet de **recevoir** les informations de facturation. Actuellement, nous ne pouvons pas récupérer automatiquement les factures depuis les plateformes de connexion commande. * Cette configuration consiste à connecter votre système à Channable à l’aide de notre API. Il s’agit d’un processus technique qui nécessite généralement un développeur ou une personne ayant des connaissances en programmation.
Toutes les marketplaces basées sur Mirakl * MediaMarkt * Leroy Merlin * Bricoman * Decathlon * Debenhams * Vtwonen * ANWB * INNO * Mais * Conrad * La Redoute * Praxis * Le BHV Marais * Home24 * Galeries LaFayette * fonQ * BlokkerConnect! * Carrefour France * Carrefour Espagne * Maisons du Monde * Kruidvat * Obelink * Worten * Douglas * FNAC Darty Offers * Manor * Leen Bakker * Conforama * PcComponentes * ePrice
{% stepper %} {% step %} ### Générer un token d’accès à l’API Channable {% hint style="success" %} Conseil : vous pouvez ignorer cette étape si vous avez déjà généré un token d’accès. {% endhint %} 1. Dans Channable, rendez-vous dans vos **Paramètres entreprise**. 2. Dans la section Outils, sélectionnez **API Channable**. 3. Notez votre **ID de l’entreprise**, car vous en aurez besoin plus tard. 4. Cliquez **Générer un jeton** pour générer un token d’entreprise. {% hint style="warning" %} Important : une fois votre token généré, conservez-le en lieu sûr. Pour des raisons de sécurité, nous n’affichons pas le token à nouveau après sa génération. Si vous le perdez, vous devrez en générer un nouveau. {% endhint %} {% endstep %} {% step %} ### Trouvez et notez vos identifiants de produit et de commande {% stepper %} {% step %} #### OPTION 1 : récupérer les identifiants de commande à l’aide de l’API Channable (recommandé pour les développeurs) {% hint style="info" %} Remarque : si vous enregistrez l’ID de commande Channable lors de la récupération initiale et du traitement des commandes ouvertes, vous n’aurez pas besoin de récupérer à nouveau les commandes lors de l’envoi des factures. Vous pouvez utiliser l’ID des données dont vous disposez déjà. {% endhint %} 1. Utilisez [Toutes les commandes V2](https://api.channable.com/v1/docs#tag/orders/operation/all_orders_v2_v2_companies__company_id__projects__project_id__orders_get) pour récupérer les commandes depuis Channable. 2. Chaque commande contient un attribut id — c’est l’identifiant que vous devez fournir lors de l’import de factures pour une commande spécifique. {% endstep %} {% step %} #### OPTION 2 : trouver les identifiants de commande manuellement dans Channable (recommandé pour les non-développeurs) 1. Dans Channable, ouvrez le projet avec votre connexion commande. 2. Dans la barre latérale, allez dans **Paramètres**. Vous accéderez alors à vos **Paramètres du projet**. 3. Notez votre **ID du projet**, car vous en aurez besoin dans votre requête API. 4. Accédez à **Commandes**. Vous verrez la liste de vos commandes importées. 5. Notez les identifiants de commande spécifiques pour lesquels vous souhaitez importer des factures. {% endstep %} {% endstepper %} {% endstep %} {% step %} ### Intégration pour les factures (développeur) À cette étape, vous ou votre développeur écrirez du code qui communique directement avec Channable afin d’envoyer les données de facturation à la bonne commande. 1. Convertissez votre fichier de facture PDF en une chaîne encodée en Base64. 2. Construisez votre requête : 1. Créez une requête POST vers le point de terminaison order\_attachment\_upload. 2. Intégrez votre token d’accès à l’API dans l’en-tête Authorization: Bearer your\_api\_token. 3. Renseignez le corps de la requête. Il doit contenir : * attachment\_type : définissez sur **« INVOICE »** * file : la chaîne encodée en Base64 de votre fichier de facture * order\_item\_ids (facultatif, **bol uniquement**) : un tableau d’identifiants d’articles de commande. Si vous ne les ajoutez pas, la facture sera liée à tous les articles de la commande. Pour des instructions détaillées, consultez notre [documentation de l’API Order Attachments](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" %} **Remarque :** Vous pouvez envoyer plusieurs factures par commande. Cependant, certains canaux (comme Amazon) conservent uniquement l’enregistrement de la dernière facture et suppriment les précédentes. Pour des informations spécifiques sur le comportement du canal, il est préférable de contacter l’équipe d’assistance de votre marketplace. {% endhint %} {% endstep %} {% step %} ### Vérifiez vos factures importées Après que vous ou votre développeur a envoyé une facture via notre API Channable, vérifiez qu’elle a bien été associée dans Channable. * Dans Channable, ouvrez le projet avec votre connexion commande. * Accédez à **Commandes**. * Cliquez sur la commande pour laquelle vous avez importé la facture. * Accédez à l’étape **Pièces jointes de commande** . * Cliquez **Télécharger la facture**.
{% 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-fr/commandes/configurer-linstallation-des-commandes/televerser-et-gerer-les-factures-avec-lapi-channable.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.