RKR Recambios: vende tu recambio usado en Ovoko desde PrestaShop sin vender dos veces

v1.2.02026/11/01

Revisión completa contra la API oficial de Ovoko (api.rrr.lt/openapi/swagger.yaml): la 1.1.0 no llegaba a funcionar con una cuenta real.

La API de verdad

• Rutas reales: crm/importCar, crm/importPart, crm/updatePart, crm/changePartStatus, crm/deletePart, get/<lista>, get/car_models/{marca} y v2/get/orders/{desde}/{hasta} (la 1.1.0 llamaba a ficheros *.php que no existen). Entorno producción o pruebas (staging).
• Calidad, estado de venta, combustible, carrocería, caja, volante, tracción y estado del coche se envían como los ids numéricos de Ovoko (antes, textos como used o on_sale que la API rechaza).
• Pieza: el OEM va en manufacturer_code, la foto principal en photo (= photos[0], portada primero), original_currency (EUR/PLN; otra moneda se convierte a euros), notes con el nombre y la descripción corta, y external_id: un reintento devuelve la misma pieza en vez de duplicarla.
• Vehículo: car_years de un año, car_body_number (VIN), car_engine_code, car_wheel_type, modelo elegido de la lista de Ovoko por marca (se carga al elegir la marca).
• Listas de referencia leídas en sus tres formatos; categorías solo de nivel 3 con su ruta («Motor › Sistema de combustible › Inyector»).
• Una respuesta sin status_code ya no cuenta como correcta.

Pedidos y webhook

• Descarga por fechas de la exportación v2 con los campos reales (item_list, client_*, total_price.seller, tracking_url); un pedido no se guarda dos veces (clave única).
• Webhook por eventos (order.created/prepared/sent/delivered/cancelled, part.status.changed), secreto solo en la cabecera X-RKR-SECRET, 401 si no cuadra.
• Lo vendido en Ovoko se descuenta del stock de PrestaShop (opcional) y se devuelve si se cancela.

Sin doble venta

• Una pieza publicada que se queda sin stock (venta en la tienda, ajuste, devolución…) se reserva en Ovoko al momento (actionUpdateQuantity, actionValidateOrder, actionOrderStatusPostUpdate); actionOrderStatusUpdateAfter no existe en el núcleo.

Fallos de la 1.1.0 que impedían usarlo

• Los controladores cron y webhook tenían el nombre de clase al revés: error fatal siempre.
• Db::IGNORE (no existe): cualquier llamada a la API terminaba en error fatal.
• Product::getImages() y Product::getLinkRewrite(): error fatal al crear un anuncio.
• Volver a crear el anuncio de un producto publicado lo desenganchaba de su pieza en Ovoko.
• Una pieza sin vehículo se colgaba del primer coche de la lista (o de uno de demostración).
• Importar JSON/CSV escribía en tablas del núcleo (ps_log…) y sin escapar (inyección SQL).
• Anuncios guardados con tienda 0 en tiendas sin multitienda: el stock leído era siempre 0.
• Borrar un anuncio publicado dejaba la pieza a la venta en Ovoko.
• «Traducir» no hacía nada; ahora escribe la descripción corta del idioma pedido.
• Las URL de investigación de la IA podían leer ficheros del servidor (file://) o la red interna.
• Un error en una tarea del cron dejaba el candado puesto 15 minutos.
• Las estadísticas de los datos de demostración no se veían (se guardaban en una tienda que nunca se leía).
• Iconos del menú lateral vacíos en PrestaShop 9; el gráfico de calidad y el de categorías enseñan nombres, no ids.

Además

• Calidad y categoría de Ovoko se eligen al crear el anuncio; botón «Actualizar en Ovoko».
• Emparejar categorías con un desplegable de las categorías de Ovoko de nivel 3 (antes, el id a mano).
• Panel en español completo (125 cadenas que faltaban).
• Sin nofilter, .htaccess, plantillas en views/templates/admin, estilo de PrestaShop.
• La actualización convierte los textos guardados por la 1.1.0 en los ids de Ovoko, y el módulo la completa solo si la consola sube la versión sin ejecutar upgrade/.