Téléverser et gérer les factures avec l’API Channable

Apprenez à téléverser et gérer les factures de commande avec l’API Channable pour les marketplaces prises en charge.

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

• 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

1

Générer un token d’accès à l’API Channable

Conseil : vous pouvez ignorer cette étape si vous avez déjà généré un token d’accès.

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.

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.

2

Trouvez et notez vos identifiants de produit et de commande

1

OPTION 1 : récupérer les identifiants de commande à l’aide de l’API Channable (recommandé pour les développeurs)

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à.

1. Utilisez Toutes les commandes V2 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.

2

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.

3

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.

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.

4

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.