Microtienda y pedidos

tilopay_store_create

Crea un enlace de microtienda para compartir con un cliente: muestra los productos del catálogo, el cliente arma un carrito y al finalizar paga desde la misma página con un enlace que incluye el detalle del carrito. Por defecto incluye todo el catálogo; se puede limitar a ciertos IDs de productos.

Parámetros

Devuelve

{ slug, url, items }

slug = identificador de la microtienda; url = enlace público de la tienda con carrito; items = cuántos productos del catálogo quedaron incluidos.

tilopay_store_list

Lista las microtiendas activas del comercio con su enlace para compartir.

Parámetros

Sin parámetros.

Devuelve

{ stores[] }

stores = microtiendas activas con slug, título, enlace público y los ids de productos que incluye cada una.

tilopay_store_delete

Desactiva una microtienda por su slug: el enlace deja de abrir. Confirme con el comercio antes de usarla.

Parámetros

Devuelve

{ slug, active }

Desactiva la microtienda: el enlace deja de mostrar productos. active queda en false; los productos del catálogo no se borran.

tilopay_orders_setup

Activa el control de pedidos de la microtienda y guarda el nombre de la tienda, el logo y la hora del recordatorio diario de pedidos pagados sin entregar. Sirve también para cambiar cualquiera de esos datos después. El logo puede venir como enlace https de una imagen o como la imagen que el comercio acaba de enviar por WhatsApp (pase la referencia que aparece en el mensaje).

Parámetros

Devuelve

{ orders_enabled, store_name, has_logo, reminder_time }

Deja la gestión de pedidos activa y devuelve la configuración resultante: nombre de la tienda que ven los clientes, si hay logo cargado y la hora del recordatorio diario de pedidos pendientes.

tilopay_orders_settings

Muestra si la gestión de pedidos está activa, el nombre de la tienda, si hay logo y la hora del recordatorio diario.

Parámetros

Sin parámetros.

Devuelve

{ orders_enabled, store_name, has_logo, reminder_time }

Configuración actual de la tienda y de los pedidos, sin cambiar nada.

tilopay_orders_status

Resumen de los pedidos de las microtiendas: cuántos están pendientes de pago, cuántos pagados sin entregar (con su monto) y cuántos se entregaron hoy.

Parámetros

Sin parámetros.

Devuelve

{ pending, paid, delivered, ... }

Resumen de pedidos: cuántos están pendientes de pago, pagados sin entregar y entregados, con los montos del período.

tilopay_orders_list

Lista los pedidos de las microtiendas con su código, cliente, total y detalle. Se puede filtrar por estado (pending = pendiente de pago, paid = pagado sin entregar, delivered = entregado) y por los últimos días.

Parámetros

Devuelve

{ orders[] }

orders = pedidos con código, cliente, total, moneda, estado y fecha. Se puede filtrar por estado (pending, paid, delivered, all) y por los últimos días.

tilopay_orders_pending

Lista los pedidos ya pagados que aún no se han entregado. Es la herramienta que usa el recordatorio diario.

Parámetros

Sin parámetros.

Devuelve

{ pending, orders[] }

pending = cuántos pedidos están pagados y sin entregar; orders = esos pedidos con código, cliente, total y moneda.

tilopay_order_mark_delivered

Marca uno o varios pedidos como entregados. Acepta el código del pedido (ej. "#A3F2", incluso varios en el mismo mensaje) o el nombre del cliente.

Parámetros

Devuelve

{ delivered, missing }

delivered = cuántos pedidos quedaron marcados como entregados; missing = los códigos que no se encontraron.

tilopay_orders_disable

Apaga el control de pedidos y cancela el recordatorio diario. Los pedidos ya registrados se conservan. Pida un sí explícito antes de usarla.

Parámetros

Sin parámetros.

Devuelve

{ orders_enabled: false }

Apaga la gestión de pedidos. Los pedidos ya registrados se conservan.