Zacatrus

Reserva mesa en la ludoteca de una tienda de Zacatrus para el cliente. Busca antes las franjas libres con ludoteca_slots. Pídele al cliente que confirme tienda, día y franjas, y pregúntale SIEMPRE su teléfono de contacto para esta reserva (no lo supongas ni lo reutilices de otra). Zacatrus le envía por correo la confirmación con el QR. Necesita que el cliente haya iniciado sesión.

Cancela una reserva de mesa en la ludoteca del cliente (solo las suyas, y solo las que aún no han pasado). Obtén el booking_id con my_bookings y pídele confirmación al cliente antes de cancelar. Zacatrus le envía el correo de cancelación. Necesita que el cliente haya iniciado sesión.

Lo que hace falta para preparar un pedido con prepare_order: las direcciones guardadas del cliente (solo un id y una etiqueta corta: ciudad y código postal), las tiendas donde puede recogerlo, las formas de envío y lo que usó en su último pedido si sigue valiendo. Una dirección nueva solo se añade desde la web. Es solo lectura. Necesita que el cliente haya iniciado sesión.

Qué incluyen Zaca+ Club (socios con descuentos, prioridad en la ludoteca y promociones anticipadas) y Zaca+ Box (suscripción a cajas sorpresa de juegos), con precios y enlaces para suscribirse. El contenido de la caja del mes solo aparece cuando ya está desvelado; antes no se puede contar.

Ranking de juegos según la comunidad de Zacatrus: los más deseados (marcados como "lo quiero") o los favoritos de sus clientes. Solo datos agregados: número de clientes por juego, nunca quién. Sirve para recomendar "lo que más gusta" o "lo que más se desea".

Ficha completa (texto, precio, disponibilidad, enlace) de un resultado de search, a partir de su id. Equivale a get_game.

Comentarios que clientes de Zacatrus han dejado como públicos sobre un juego, tal como están en la web, y cuántos clientes lo desean o lo tienen como favorito. Salen sin nombre ni perfil. Pueden ser pocos o ninguno: si no hay, no lo inventes.

Ficha completa de un juego de Zacatrus: descripción, precio (y precio sin oferta si lo hay), disponibilidad en la web (in_stock, out_of_stock o preorder; en preventa, la fecha prevista), jugadores, edad, duración, temáticas, autores y editorial. Identifícalo con el sku que devuelve search_games, o con la URL de la ficha.

Próximos eventos publicados en la web de Zacatrus (ligas, torneos, encuentros) en las tiendas físicas: tienda, fecha y hora, duración, plazas libres y descripción. Los eventos que se repiten (cada semana o cada 15 días) salen con su próxima fecha. La inscripción se hace en la web con la cuenta (enlace en url).

Tiendas físicas de Zacatrus con dirección, horario declarado (el mismo que se muestra al elegir recogida en tienda), próximos días de cierre y si tienen ludoteca (mesas para jugar en la tienda). El horario es el declarado en la web: no garantiza que la tienda esté abierta en este momento.

Franjas con mesa libre en la ludoteca de las tiendas de Zacatrus (mesas para jugar en la tienda con los juegos de la ludoteca) por tienda y día. Sin reservar nada: para reservar hay que entrar en la web con la cuenta (enlace en url). Los clientes sin Zaca+ Club solo pueden reservar con pocos días de antelación; más allá el día sale como club_only.

Añade un juego a la colección del cliente marcándolo como «lo tengo» (owned) o «lo quiero» (wanted). Solo añade la marca: no quita ninguna ni cambia nada más de la cuenta. Pídele confirmación al cliente antes de marcar. Identifica el juego con el sku de search_games o la URL de su ficha. Necesita que el cliente haya iniciado sesión.

Comprueba qué cuenta de Zacatrus tiene conectada el cliente a este asistente (solo el nombre de pila) y desde cuándo. Úsala para saludar al cliente o para comprobar que la conexión funciona. Necesita que el cliente haya iniciado sesión.

Las reservas de mesa en la ludoteca que el cliente tiene a partir de hoy: tienda, día, franjas y mesas, con el booking_id que pide cancel_booking. Necesita que el cliente haya iniciado sesión.

Si el cliente está suscrito a Zaca+ Box: qué modalidades tiene activas (Familiar, Para 2, Outlet…) y, de cada una, la próxima caja (nombre, fecha de envío y precio máximo). Los juegos de la caja solo salen cuando ya están desvelados, igual que en «Tu cuenta > BOX»; antes se dice desde qué día. Solo lectura: no da de alta ni de baja ni cambia la modalidad (eso lo hace el cliente en su cuenta, enlace manage_url). Necesita que el cliente haya iniciado sesión.

Si el cliente es socio de Zaca+ Club: plan, desde cuándo, hasta cuándo está pagado y si se renueva solo (próxima renovación). Solo lectura: no da de alta ni de baja ni cambia la renovación (eso lo hace el cliente en su cuenta, enlace manage_url). Necesita que el cliente haya iniciado sesión.

La colección del cliente en Zacatrus: los juegos que tiene (owned) y los que quiere (wanted), cada uno con su ficha resumida. Úsala para recomendar a partir de lo que ya tiene («tengo estos, ¿qué me llevo para 6?») y para no recomendarle lo que ya posee. Necesita que el cliente haya iniciado sesión.

El saldo de fichas del cliente (el programa de puntos de Zacatrus) y su equivalente en euros, el mismo que ve en «Tu cuenta». Solo lectura. Necesita que el cliente haya iniciado sesión.

Los últimos pedidos del cliente en Zacatrus: número, fecha, juegos, total y su estado tal como lo da el soporte de la tienda (el mismo que el chatbot de la web): customer_status (en preparación, pendiente de pago, enviado, en reparto, incidencia, listo en tienda, entregado, cancelado), si el pago está cobrado, pendiente o sin finalizar, si ha salido de verdad (shipped), el plazo de entrega estimado (estimated_delivery), el seguimiento del transportista con su última incidencia y si todavía se puede cancelar (can_cancel). Usa customer_status y no el estado «Tramitado» de la tienda, que solo significa cobrado: un pedido puede estar tramitado y no haber salido. Un pedido sin cobrar no tiene fecha de entrega. Si not_shipped_yet o support_contact, remite al cliente a hola@zacatrus.es. Con "order" (el número de pedido) devuelve solo ese, con los eventos del transportista. Es solo lectura: no muestra direcciones ni datos de pago. Necesita que el cliente haya iniciado sesión.

Prepara un pedido de Zacatrus para el cliente: productos y cantidades, dirección guardada o tienda de recogida, y forma de envío. Devuelve el resumen (líneas con su precio, envío, total, destino, caducidad) y el enlace para confirmarlo y pagarlo en la web. Con punto de recogida Nacexshop (shipping_method droppoint_droppoint, con address_id) el cliente elige el punto en el mapa de la web al confirmar: aquí no se elige. ENSÉÑALE SIEMPRE al cliente el resumen y el enlace, y dile claramente que el pedido NO está hecho hasta que lo confirme y pague en zacatrus.es: aquí no se cobra nada. Antes de llamar, consulta checkout_options y confirma con el cliente qué quiere y a dónde. Usa los sku de search_games, get_game o store_stock (para un juego con varias versiones, el sku de la versión). Solo productos con stock en la web, con los precios del cliente (tarifa de Club si la tiene); nada de preventas, tarjetas regalo ni suscripciones. Manda una idempotency_key aleatoria nueva por cada pedido distinto: si repites la llamada con la misma clave, recibes el mismo pedido preparado, no otro. Necesita que el cliente haya iniciado sesión.

Dice si un pedido preparado con prepare_order sigue pendiente de que el cliente lo confirme en la web, ha caducado, lo canceló o ya es un pedido (y su número). Identifícalo por prepared_id o por la idempotency_key que usaste. Es solo lectura. Necesita que el cliente haya iniciado sesión.

Búsqueda de texto libre en el catálogo de Zacatrus (juegos de mesa). Devuelve id, título y enlace; usa fetch con el id para ver la ficha. Equivale a search_games sin filtros, pensada para clientes que solo conocen search y fetch.

Busca en el catálogo de Zacatrus (juegos de mesa, rol, cartas y accesorios) con el mismo buscador que la web. Se puede combinar texto libre con filtros: número de jugadores, edad, duración, temática y precio. Devuelve precio, disponibilidad web (in_stock, out_of_stock o preorder), jugadores, edad, duración y el enlace a la ficha. Si no hay resultados, prueba con menos filtros antes de decir que no lo tenemos.

Unidades de un juego en cada tienda física de Zacatrus (in_stock, low_stock o out_of_stock) y disponibilidad en la web. Úsalo cuando alguien quiera comprar en tienda o recoger hoy. Las unidades llegan hasta 10 y pueden cambiar en minutos; para una reserva segura, que confirme con la tienda.