Skip to main content

Importer des Étiquettes (Labels) via Excel

Cette requête permet d'importer plusieurs étiquettes (labels) en une seule opération à partir d'un fichier Excel.

Méthode : POST

URL : {{baseUrl}}/api/horstable/label/importLabel

En-têtes :

CléValeurDescription
X-API-KEY{{apiKey}}Votre clé d'API unique.
Content-Typemultipart/form-dataNécessaire pour l'envoi de fichiers.

Corps de la requête (multipart/form-data) :

Le corps doit contenir le fichier Excel avec les données des étiquettes.

  • file: Le fichier Excel (.xlsx, .xls) contenant les informations des étiquettes.

Exemple de structure attendue pour le fichier Excel :

idnametypebaseStationIdcurrentTemplateIdstatusproduct_skuaisle
LABEL_ABC_001Étiquette Produit Xeink_2.9_bwBS_001_Store_Paris_01template_promo_1pairedSKU67890B05
LABEL_DEF_002Étiquette Info Yeink_4.2_bwyBS_002_Store_Lyon_01template_info_largeunpairedSKU12345C12

Note : La structure exacte du fichier Excel et les champs requis/optionnels peuvent varier. Un modèle peut être téléchargeable via "Exporter le modèle Excel (Étiquettes)". Les colonnes comme product_sku et aisle seraient des exemples de customFields.

Réponses possibles :

  • 201 Created (ou 200 OK) : Importation réussie. Un résumé de l'importation peut être retourné.
  • 400 Bad Request: La requête est malformée, le fichier est manquant, ou le format du fichier est incorrect.
  • 422 Unprocessable Entity: Les données dans le fichier Excel ne sont pas valides ou des erreurs se sont produites lors du traitement de certaines lignes. Un rapport d'erreurs peut être retourné.

Exemple de réponse (Succès) :

{
"status": "success",
"message": "Labels import operation completed.",
"total_rows": 100,
"successful_imports": 95,
"failed_imports": 5,
"errors": [
{
"row_number": 23,
"label_id_attempted": "LABEL_INVALID_01",
"error_message": "Invalid baseStationId provided."
}
// ... autres erreurs si applicable
]
}