{"id":444870,"date":"2026-09-18T00:57:44","date_gmt":"2026-09-17T22:57:44","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-suppression-en-masse\/"},"modified":"2026-09-18T00:57:54","modified_gmt":"2026-09-17T22:57:54","password":"","slug":"api-rest-suppression-en-masse","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-suppression-en-masse\/","title":{"rendered":"API REST – Suppression en masse (corbeille)"},"content":{"rendered":"

Cette page d\u00e9crit l’op\u00e9ration \u00e0 utiliser pour mettre beaucoup d’enregistrements \u00e0 la corbeille
\nd’un coup<\/strong>, typiquement pour effacer ce qu’une synchronisation ou un import pr\u00e9c\u00e9dent a \u00e9crit avant
\nde reprendre une base proprement.<\/p>\n

\n\n\n\n\n\n
Op\u00e9ration<\/th>\nM\u00e9thode<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
mass_delete<\/code><\/td>\nPOST<\/td>\nMettre un lot d’enregistrements \u00e0 la corbeille<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n

R\u00e9serv\u00e9e aux administrateurs.<\/strong> Supprimer des centaines d’enregistrements en un appel est un
\ntravail de reprise de donn\u00e9es. Un compte non administrateur garde delete<\/code>, un enregistrement \u00e0 la
\nfois, avec ses propres droits.<\/p>\n<\/blockquote>\n

\n

Rien n’est effac\u00e9 : c’est une mise \u00e0 la corbeille<\/h2>\n

mass_delete<\/code> fait exactement ce que fait le bouton Supprimer de l’interface<\/strong> : l’enregistrement
\npart \u00e0 la corbeille. Il conserve son identifiant, ses liens et son historique, et il peut \u00eatre
\nrestaur\u00e9.<\/p>\n

La suppression d\u00e9finitive n’existe pas dans l’API.<\/strong> Vider la corbeille reste une action d\u00e9lib\u00e9r\u00e9e,
\n\u00e0 faire depuis l’instance (Param\u00e8tres > Corbeille<\/em>). C’est volontaire : une suppression irr\u00e9versible
\nne doit pas pouvoir \u00eatre d\u00e9clench\u00e9e par un script.<\/p>\n

\n

Suppression en masse \u2013 Mettre un lot \u00e0 la corbeille<\/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>\nDoit \u00eatre mass_delete<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session<\/td>\n<\/tr>\n
elementType<\/code><\/td>\nstring<\/td>\noui<\/td>\nNom du module vis\u00e9 (ex : Products<\/code>, SalesOrder<\/code>)<\/td>\n<\/tr>\n
ids<\/code><\/td>\nJSON<\/td>\noui<\/td>\nTableau des identifiants (500 au maximum par appel)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

Les identifiants se r\u00e9cup\u00e8rent avec query<\/code><\/a>.<\/p>\n

<\/p>\n

curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=mass_delete" \\\n  -d "sessionName=YOUR_SESSION_ID" \\\n  -d "elementType=SalesOrder" \\\n  -d 'ids=["7x54993","7x54994","7x54995"]'\n<\/code><\/pre>\n
R\u00e9ponse<\/h3>\n
{\n  "success": true,\n  "result": {\n    "module": "SalesOrder",\n    "processed": 3,\n    "deleted": 2,\n    "alreadyDeleted": 1,\n    "records": [\n      { "index": 0, "id": "7x54993", "outcome": "deleted" },\n      { "index": 1, "id": "7x54994", "outcome": "deleted" },\n      { "index": 2, "id": "7x54995", "outcome": "alreadyDeleted" }\n    ],\n    "errors": []\n  }\n}\n<\/code><\/pre>\n
\n\n\n\n\n\n\n\n\n\n
Champ<\/th>\nSignification<\/th>\n<\/tr>\n<\/thead>\n
processed<\/code><\/td>\nNombre d’enregistrements trait\u00e9s sans erreur<\/td>\n<\/tr>\n
deleted<\/code><\/td>\nEnregistrements qui viennent de partir \u00e0 la corbeille<\/td>\n<\/tr>\n
alreadyDeleted<\/code><\/td>\nEnregistrements qui y \u00e9taient d\u00e9j\u00e0 : rien n’a \u00e9t\u00e9 fait, ce n’est pas une erreur<\/td>\n<\/tr>\n
records<\/code><\/td>\nLe d\u00e9tail ligne par ligne, avec la position dans le lot<\/strong><\/td>\n<\/tr>\n
errors<\/code><\/td>\nLes identifiants refus\u00e9s, avec leur position dans le lot et le motif<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n
Les garde-fous<\/h2>\n
Une suppression en masse n’a pas de seconde chance, donc l’op\u00e9ration est volontairement stricte :<\/p>\n