Télécharger et gérer des factures avec l'API Channable

Si vous disposez d’une connexion de commandes, vous pouvez téléverser 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 (ex. 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

• Une connexion de commandes active avec des commandes existantes

• Un token d’accès 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 pouvez uniquement téléverser et gérer vos boutiques web via l’API Channable (pas les plateformes basées sur des webshops)

• L’API nous permet de recevoir les informations de facture. Actuellement, nous ne pouvons pas récupérer automatiquement les factures depuis les plateformes de connexion de commandes.

• Cette configuration implique de connecter votre système à Channable en utilisant 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

• But

• Conrad

• La Redoute

• Praxis

• Le BHV Marais

• Home24

• Galeries LaFayette

• fonQ

• BlokkerConnect !

• Carrefour France

• Carrefour Espagne

• Maisons du Monde

• Kruidvat

• Obelink

• Worten

• Douglas

• Offres FNAC Darty

• Manor

• Leen Bakker

• Conforama

• PcComponentes

• ePrice

1

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

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

1. Dans Channable, allez dans votre Paramètres entreprise.

2. Dans la section Outils, sélectionnez API Channable.

3. Notez votre ID entreprise, car vous en aurez besoin plus tard.

4. Cliquez Générer un token pour générer un token d’entreprise.

Important : une fois votre token généré, enregistrez-le dans un endroit 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 via l’API Channable (recommandé pour les développeur(se)s)

Remarque : si vous enregistrez l’identifiant de commande Channable lors de la récupération initiale et du traitement des commandes ouvertes, vous n’aurez pas besoin de refetcher les commandes lors de l’envoi des factures. Vous pouvez utiliser l’ID depuis les données que vous avez 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 du téléversement des factures pour une commande spécifique.

2

OPTION 2 : Trouver les identifiants de commande manuellement dans Channable (recommandé pour les non-développeur(se)s)

1. Dans Channable, ouvrez le projet avec votre connexion de commandes.

2. Dans la barre latérale, allez à Paramètres. Cela vous amènera à votre Paramètres du projet.

3. Notez votre ID projet, car vous en aurez besoin dans votre requête API.

4. Allez à Commandes. Vous verrez une liste de vos commandes importées.

5. Notez les identifiants de commande spécifiques pour lesquels vous souhaitez téléverser des factures.

3

Intégration pour les factures (développeur(se))

À cette étape, vous/votre développeur(se) écrirez du code qui communique directement avec Channable pour envoyer les données de la facture vers la commande appropriée.

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 endpoint order_attachment_upload.

   2. Intégrez votre token d’accès API dans l’en-tête Authorization: Bearer your_api_token.

   3. Remplissez le corps de la requête. Il doit contenir :

      • attachment_type : Définir sur “INVOICE”

      • file : la chaîne encodée en Base64 de votre fichier de facture

      • order_item_ids (optionnel, bol uniquement) : un tableau d’identifiants d’items de commande. Si vous ne les ajoutez pas, la facture sera liée à tous les items de la commande.

Pour des instructions détaillées, référez-vous à notre documentation de l’API Order Attachments.

Remarque : Vous pouvez soumettre plusieurs factures par commande. Toutefois, certains canaux (comme Amazon) ne conservent qu’un enregistrement de la dernière facture, supprimant les précédentes. Pour des informations spécifiques sur le comportement d’un canal, il est préférable de contacter l’équipe d’assistance de la marketplace.

4

Vérifiez vos factures téléversées

Après que vous/votre développeur(se) ayez envoyé une facture via notre API Channable, vérifiez qu’elle a bien été attachée dans Channable.

• Dans Channable, ouvrez le projet avec votre connexion de commandes.

• Allez à Commandes.

• Cliquez sur la commande pour laquelle vous avez téléversé la facture.

• Allez à l'étape Pièces jointes de commande .

• Cliquez Télécharger la facture.