RKR Recambios : Vendez votre pièce détachée d'occasion sur Ovoko depuis PrestaShop sans la vendre deux fois.

01/11/2026
v1.2.0

Test complet de l'API officielle Ovoko ( api.rrr.lt/openapi/swagger.yaml ) : la version 1.1.0 ne fonctionnait pas avec un compte réel.

La véritable API

• Chemins d'accès réels : crm/importCar , crm/importPart , crm/updatePart , crm/changePartStatus , crm/deletePart , get/ , get/car_models /{marca} et v2/get/orders /{desde} /{hasta} (la version 1.1.0 appelait des fichiers *.php qui n'existent pas). Environnement de production ou de test (préproduction).
• La qualité, le statut de vente, le carburant, la carrosserie, la boîte de vitesses, le volant, la traction et l'état de la voiture sont envoyés sous forme d'identifiants numériques Ovoko (auparavant, des textes comme used ou on_sale que l'API rejetait).
• Partie : le code OEM est dans manufacturer_code , la photo principale dans photo (= photos [0] , couverture en premier), original_currency (EUR/PLN ; les autres devises sont converties en euros), notes avec le nom et une courte description, et external_id : une nouvelle tentative renvoie la même partie au lieu de la dupliquer.
• Véhicule : car_years (un an), car_body_number (VIN), car_engine_code , car_wheel_type , modèle choisi dans la liste Ovoko par marque (chargé lors du choix de la marque).
• Listes de références lues dans les trois formats ; catégories de niveau 3 uniquement avec leur chemin (« Moteur › Système d’alimentation › Injecteur »).
• Une réponse sans status_code n'est plus considérée comme correcte.

Commandes et webhook

• Téléchargement par date à partir de l'export v2 avec les champs réels ( item_list , client_* , total_price.seller , tracking_url ); une commande n'est pas enregistrée deux fois (clé unique).
• Webhook par événements ( order.created/prepared/sent/delivered/cancelled , part.status.changed ), secret uniquement dans l'en-tête X-RKR-SECRET , 401 si non correspondant.
• Les ventes réalisées sur Ovoko sont déduites du stock PrestaShop (facultatif) et remboursées en cas d'annulation.

Pas de double vente

• Un article publié qui est en rupture de stock (solde en magasin, ajustement, retour…) est actuellement réservé dans Ovoko ( actionUpdateQuantity , actionValidateOrder , actionOrderStatusPostUpdate ) ; actionOrderStatusUpdateAfter n'existe pas dans le noyau.

Des bugs dans la version 1.1.0 empêchaient son utilisation

• Les noms de classe des contrôleurs cron et webhook étaient inversés : une erreur fatale à chaque fois.
• Db::IGNORE (n'existe pas) : tout appel à l'API s'est terminé par une erreur fatale.
• Product::getImages() et Product::getLinkRewrite() : erreur fatale lors de la création d'une annonce.
• Recréer une publicité pour un produit déjà publié l'a déconnecté de son article sur Ovoko.
• Une œuvre sans véhicule était suspendue à la première voiture de la liste (ou à une voiture de démonstration).
• Importation de JSON/CSV écrits dans les tables du noyau ( ps_log …) sans échappement (injection SQL).
• Annonces enregistrées avec le magasin 0 dans les magasins sans multi-magasins : la lecture du stock était toujours de 0.
• La suppression d'une annonce publiée a laissé l'article en vente sur Ovoko.
• La fonction « Traduire » n'a rien fait ; veuillez maintenant saisir une brève description de la langue demandée.
• Les URL de recherche en IA pourraient lire des fichiers depuis le serveur ( file:// ) ou le réseau interne.
• Une erreur de tâche cron a maintenu le verrou actif pendant 15 minutes.
• Les statistiques des données de démonstration n'étaient pas visibles (elles étaient stockées dans un espace de stockage qui n'a jamais été consulté).
• Icônes de menu latéral vides dans PrestaShop 9 ; les graphiques de qualité et de catégorie affichent les noms, et non les identifiants.

En plus

• La qualité et la catégorie Ovoko sont choisies lors de la création de l'annonce ; bouton « Mettre à jour dans Ovoko ».
• Associez les catégories à une liste déroulante des catégories Ovoko de niveau 3 (auparavant, l'identifiant était saisi manuellement).
• Panneau complet en espagnol (125 chaînes manquantes).
• Sans nofilter , .htaccess , modèles dans views/templates/admin , style PrestaShop.
• La mise à jour convertit les textes enregistrés par la 1.1.0 en identifiants Ovoko, et le module ne la termine que si la console met à niveau la version sans exécuter upgrade/ .