{"id":444891,"date":"2026-09-19T00:18:46","date_gmt":"2026-09-18T22:18:46","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-produits-generiques-et-specifiques\/"},"modified":"2026-09-19T00:18:46","modified_gmt":"2026-09-18T22:18:46","password":"","slug":"api-rest-produits-generiques-et-specifiques","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-produits-generiques-et-specifiques\/","title":{"rendered":"API REST – Produits g\u00e9n\u00e9riques et sp\u00e9cifiques"},"content":{"rendered":"

Les produits g\u00e9n\u00e9riques et sp\u00e9cifiques utilisent les op\u00e9rations standard de l’API sur les Produits. Aucun endpoint m\u00e9tier suppl\u00e9mentaire n’est n\u00e9cessaire : les m\u00eames champs, listes connexes, validations et calculs sont utilis\u00e9s depuis Kafinea, l’API REST et le serveur MCP.<\/p>\n

Avant une int\u00e9gration, utilisez describe<\/code> sur le module Produits. Si les champs attendus ne sont pas retourn\u00e9s, l’administrateur doit les rendre visibles dans le gestionnaire d’agencement.<\/p>\n

\n

Cr\u00e9er ou modifier un produit g\u00e9n\u00e9rique<\/h2>\n

Utilisez create<\/code> ou revise<\/code> et renseignez la nature du produit ainsi que sa politique tarifaire. L’exemple suivant transforme un produit existant en produit g\u00e9n\u00e9rique avec un prix calcul\u00e9 depuis le sp\u00e9cifique le moins cher :<\/p>\n

curl -X POST "https:\/\/apps.kafinea.com\/{instance}\/webservice.php" \\\n  --data-urlencode "operation=revise" \\\n  --data-urlencode "sessionName=YOUR_SESSION_ID" \\\n  --data-urlencode 'element={\n    "id": "14x1201",\n    "is_standard": 1,\n    "standard_pricing_mode": "CHEAPEST_SPECIFIC",\n    "standard_margin_pct": 25,\n    "standard_price_rounding": "0.01"\n  }'\n<\/code><\/pre>\n
Le prix est recalcul\u00e9 automatiquement apr\u00e8s l’enregistrement. En mode de saisie manuelle, le prix fourni reste inchang\u00e9.<\/p>\n
\n
Rattacher un produit sp\u00e9cifique<\/h2>\n
Deux chemins \u00e9quivalents sont disponibles.<\/p>\n
Vous pouvez r\u00e9viser le produit sp\u00e9cifique en renseignant son produit g\u00e9n\u00e9rique parent :<\/p>\n
curl -X POST "https:\/\/apps.kafinea.com\/{instance}\/webservice.php" \\\n  --data-urlencode "operation=revise" \\\n  --data-urlencode "sessionName=YOUR_SESSION_ID" \\\n  --data-urlencode 'element={\n    "id": "14x1250",\n    "is_standard": 0,\n    "standard_parent_id": "14x1201"\n  }'\n<\/code><\/pre>\n
Vous pouvez \u00e9galement utiliser la liste connexe d\u00e9clar\u00e9e sur le produit g\u00e9n\u00e9rique :<\/p>\n
curl -X POST "https:\/\/apps.kafinea.com\/{instance}\/webservice.php" \\\n  --data-urlencode "operation=add_related" \\\n  --data-urlencode "sessionName=YOUR_SESSION_ID" \\\n  --data-urlencode "sourceRecordId=14x1201" \\\n  --data-urlencode "relatedRecordId=14x1250" \\\n  --data-urlencode "relationIdLabel=Specific Products"\n<\/code><\/pre>\n
Dans les deux cas, Kafinea valide que le parent est bien un produit g\u00e9n\u00e9rique, enregistre le sp\u00e9cifique par le chemin normal de la fiche et recalcule les prix concern\u00e9s.<\/p>\n
Pour retirer le rattachement, r\u00e9visez le produit sp\u00e9cifique avec une valeur vide :<\/p>\n
{\n  "id": "14x1250",\n  "standard_parent_id": ""\n}\n<\/code><\/pre>\n
\n
Lire les produits sp\u00e9cifiques<\/h2>\n
Utilisez relatedtypes<\/code> pour d\u00e9couvrir la liste connexe, puis query_related<\/code> avec son libell\u00e9 exact. Vous pouvez aussi interroger directement les Produits avec query<\/code> lorsque vous connaissez l’identifiant du parent.<\/p>\n
Le serveur MCP expose les m\u00eames possibilit\u00e9s avec relatedtypes<\/code>, query_related<\/code>, add_related<\/code>, find_records<\/code>, get_record<\/code> et update_record<\/code>. Il n’introduit pas de vocabulaire propre aux produits g\u00e9n\u00e9riques.<\/p>\n
\n
Droits et recalculs<\/h2>\n
La lecture respecte les droits d’acc\u00e8s de l’utilisateur connect\u00e9. Un rattachement par liste connexe exige le droit de modifier le produit g\u00e9n\u00e9rique et le produit sp\u00e9cifique, car l’op\u00e9ration met \u00e0 jour la fiche du sp\u00e9cifique.<\/p>\n
Les recalculs n\u00e9cessaires sont lanc\u00e9s automatiquement apr\u00e8s les modifications de configuration, de co\u00fbt, de prix, de rattachement ou d’offre fournisseur. Une erreur de validation ou d’autorisation interrompt l’op\u00e9ration avec un message explicite.<\/p>\n
\n
R\u00e9f\u00e9rences associ\u00e9es<\/h2>\n