{"id":444885,"date":"2026-09-18T23:47:17","date_gmt":"2026-09-18T21:47:17","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-kits-de-produits\/"},"modified":"2026-09-18T23:47:17","modified_gmt":"2026-09-18T21:47:17","password":"","slug":"api-rest-kits-de-produits","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-kits-de-produits\/","title":{"rendered":"API REST – Kits de produits"},"content":{"rendered":"

Les composants d’un kit ont des quantit\u00e9s, peuvent eux-m\u00eames \u00eatre des kits et participent au calcul du prix. Utilisez les op\u00e9rations m\u00e9tier ci-dessous plut\u00f4t que les op\u00e9rations g\u00e9n\u00e9riques de listes connexes.<\/p>\n

Toutes les op\u00e9rations utilisent des ID Webservice. La lecture exige l’acc\u00e8s au kit et \u00e0 chacun de ses composants. Toute modification exige \u00e9galement le droit de modifier le kit.<\/p>\n

Lire la composition<\/h2>\n
\n

GET<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n

\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nproduct_kit_get_components<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session<\/td>\n<\/tr>\n
kitId<\/code><\/td>\nstring<\/td>\noui<\/td>\nID Webservice du kit<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
curl "https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=product_kit_get_components&sessionName=YOUR_SESSION_ID&kitId=14x120"\n<\/code><\/pre>\n
La r\u00e9ponse contient components<\/code> avec l’identifiant, le code, le nom et la quantit\u00e9 de chaque composant. integrityIssues<\/code> signale les anciennes r\u00e9f\u00e9rences dont le produit a \u00e9t\u00e9 supprim\u00e9 ou n’existe plus.<\/p>\n
Remplacer toute la composition<\/h2>\n
\n
POST<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nproduct_kit_set_components<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session<\/td>\n<\/tr>\n
kitId<\/code><\/td>\nstring<\/td>\noui<\/td>\nID Webservice du kit<\/td>\n<\/tr>\n
components<\/code><\/td>\nJSON<\/td>\noui<\/td>\nTableau des composants et quantit\u00e9s souhait\u00e9s<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=product_kit_set_components" \\\n  -d "sessionName=YOUR_SESSION_ID" \\\n  -d "kitId=14x120" \\\n  --data-urlencode 'components=[{"id":"14x201","quantity":2},{"id":"14x202","quantity":1.5}]'\n<\/code><\/pre>\n
Cette op\u00e9ration est idempotente : r\u00e9p\u00e9ter exactement la m\u00eame demande conserve la m\u00eame composition. Tous les composants demand\u00e9s sont valid\u00e9s avant la premi\u00e8re \u00e9criture. Un produit existant mais inaccessible bloque donc l’op\u00e9ration enti\u00e8re.<\/p>\n
Une r\u00e9f\u00e9rence orpheline d\u00e9j\u00e0 pr\u00e9sente dans le kit ne bloque pas la r\u00e9paration. Elle est retir\u00e9e lors du remplacement et compt\u00e9e dans removedOrphans<\/code>.<\/p>\n
Ajouter un composant ou modifier sa quantit\u00e9<\/h2>\n
Utilisez product_kit_add_component<\/code> avec kitId<\/code>, componentId<\/code> et une quantity<\/code> strictement positive. Si le composant est d\u00e9j\u00e0 pr\u00e9sent, sa quantit\u00e9 est remplac\u00e9e.<\/p>\n
curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=product_kit_add_component" \\\n  -d "sessionName=YOUR_SESSION_ID" \\\n  -d "kitId=14x120" \\\n  -d "componentId=14x203" \\\n  -d "quantity=3"\n<\/code><\/pre>\n
Retirer un composant<\/h2>\n
Utilisez product_kit_remove_component<\/code> avec kitId<\/code> et componentId<\/code>. L’op\u00e9ration reste sans effet si le composant n’est pas pr\u00e9sent.<\/p>\n
R\u00e8gles et erreurs<\/h2>\n
Les quatre op\u00e9rations appliquent les m\u00eames r\u00e8gles que l’\u00e9cran Kafinea :<\/p>\n