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é | Valeur | Description |
|---|---|---|
X-API-KEY | {{apiKey}} | Votre clé d'API unique. |
Content-Type | multipart/form-data | Né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 :
| id | name | type | baseStationId | currentTemplateId | status | product_sku | aisle |
|---|---|---|---|---|---|---|---|
| LABEL_ABC_001 | Étiquette Produit X | eink_2.9_bw | BS_001_Store_Paris_01 | template_promo_1 | paired | SKU67890 | B05 |
| LABEL_DEF_002 | Étiquette Info Y | eink_4.2_bwy | BS_002_Store_Lyon_01 | template_info_large | unpaired | SKU12345 | C12 |
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(ou200 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
]
}