Rutas de la API
Generado por
scripts/generar-referencia.mjs. No editar a mano.
Las rutas de /admin exigen sesión de administrador. Las de /store exigen la
clave publicable del canal de venta (x-publishable-api-key).
| Ruta | Métodos | Qué hace |
|---|---|---|
/auth-propia/entrar |
POST | POST /auth-propia/entrar |
/auth-propia/restablecer/confirmar |
POST | POST /auth-propia/restablecer/confirmar |
/auth-propia/restablecer/pedir |
POST | POST /auth-propia/restablecer/pedir |
/auth-propia/salir |
POST | POST /auth-propia/salir |
/auth-propia/yo |
GET, DELETE | GET /auth-propia/yo — quién soy, y con qué sesiones abiertas. |
/gestion/ai |
GET, POST | Conectores de IA. |
/gestion/ai/contenido |
POST | POST /admin/ai/contenido — escribir la ficha de un producto. |
/gestion/ai/copiloto |
POST | POST /admin/ai/copiloto — preguntarle algo a la tienda. |
/gestion/ai/copiloto/aplicar |
POST | POST /admin/ai/copiloto/aplicar — ejecuta una propuesta que ha aprobado |
/gestion/ai/indice |
GET, POST | GET /admin/ai/indice — cómo está el índice de búsqueda. |
/gestion/ai/probar |
POST | POST /admin/ai/probar — llama de verdad al proveedor elegido. |
/gestion/ai/uso |
GET | GET /admin/ai/uso — cuánto se ha gastado en IA y en qué. |
/gestion/avisos |
GET | GET /admin/avisos — qué hay que mirar hoy. Cero avisos es buena señal. |
/gestion/capabilities |
GET | GET /admin/capabilities — qué secciones extra tiene ESTA instalación. |
/gestion/cart-recovery |
GET | GET /admin/cart-recovery — carritos abandonados y cuánto dinero hay parado en ellos. |
/gestion/cart-recovery/{id}/resend |
POST | POST /gestion/cart-recovery/{id}/resend — reenvía a mano el recordatorio de |
/gestion/categorias |
GET | GET /gestion/categorias — planas, con parent_category_id. |
/gestion/clientes |
GET | GET /gestion/clientes — los clientes para el panel. |
/gestion/clientes/{id} |
GET, PATCH | GET /gestion/clientes/:id |
/gestion/create-staff |
POST | POST /gestion/create-staff — da de alta a alguien del equipo. |
/gestion/customer-stats |
GET | GET /admin/customer-stats?ids=cus_1,cus_2 — pedidos y gasto de cada cliente. |
/gestion/idiomas |
GET, POST, DELETE | GET /admin/idiomas — qué idiomas vende la tienda y cuánto falta por traducir. |
/gestion/idiomas/traducir |
POST | POST /admin/idiomas/traducir — traduce con IA lo que falte de una entidad. |
/gestion/inventario |
POST | POST /gestion/inventario — fija el stock de una variante en una ubicación. |
/gestion/inventario/{id}/niveles |
GET, POST | GET /gestion/inventario/:id/niveles — dónde hay existencias de este artículo. |
/gestion/marketplace/mi-cuenta |
GET | GET /admin/marketplace/mi-cuenta — lo que ve un vendedor de sí mismo. |
/gestion/marketplace/vendedores |
GET, POST | GET /admin/marketplace/vendedores — los vendedores y lo que se les debe. · POST /admin/marketplace/vendedores — dar de alta uno. |
/gestion/marketplace/vendedores/{id} |
GET, POST | GET /admin/marketplace/vendedores/:id — su ficha, su saldo y su libro. · POST /admin/marketplace/vendedores/:id — cambiar sus datos o su estado. |
/gestion/marketplace/vendedores/{id}/envios |
GET, POST | Las tarifas de envío de un vendedor. |
/gestion/marketplace/vendedores/{id}/liquidar |
POST | POST /admin/marketplace/vendedores/:id/liquidar — pagarle lo que se le debe. |
/gestion/migracion/analizar |
POST | POST /admin/migracion/analizar — qué pasaría al importar este fichero. |
/gestion/migracion/importar |
POST | POST /admin/migracion/importar — trae el catálogo de verdad. |
/gestion/migracion/redirecciones |
POST | POST /admin/migracion/redirecciones?formato=nginx|apache|json|csv |
/gestion/mudanzas |
GET, POST | GET /gestion/mudanzas — las últimas, para la pantalla. · POST /gestion/mudanzas — pedir una. |
/gestion/mudanzas/{id} |
GET, POST | GET /gestion/mudanzas/:id — cómo va, con sus problemas. · POST /gestion/mudanzas/:id — { accion: "pausar" | "seguir" | "deshacer" }. |
/gestion/orders/{id}/notify-confirmed |
POST | POST /gestion/orders/{id}/notify-confirmed — avisa al cliente de que su |
/gestion/pagos-ajustes |
GET, POST | GET /gestion/pagos-ajustes — proveedores, regiones y la configuración. · POST /gestion/pagos-ajustes — guarda qué proveedor va en qué región y los |
/gestion/pedidos |
GET | GET /gestion/pedidos — los pedidos para el panel. |
/gestion/pedidos/{id} |
GET | GET /gestion/pedidos/:id |
/gestion/pedidos/{id}/cancelar |
POST | POST /gestion/pedidos/:id/cancelar |
/gestion/pedidos/{id}/cobrar |
POST | POST /gestion/pedidos/:id/cobrar — marca como cobrado lo autorizado. |
/gestion/pedidos/{id}/completar |
POST | POST /gestion/pedidos/:id/completar |
/gestion/pedidos/{id}/envios/{idEnvio}/entregado |
POST | POST /gestion/pedidos/:id/envios/:idEnvio/entregado |
/gestion/pedidos/{id}/preparar |
POST | POST /gestion/pedidos/:id/preparar — saca la mercancía del almacén. |
/gestion/pedidos/{id}/reembolsos |
GET, POST | GET — qué se puede devolver de este pedido, y cuánto se ha devuelto ya. |
/gestion/plugins |
GET, POST | GET /admin/plugins — qué hay instalado y qué está pasando. |
/gestion/plugins/{id} |
GET | GET /admin/plugins/:id — el registro de un plugin. |
/gestion/plugins/{id}/ajustes |
GET, PUT | Ajustes de un plugin. |
/gestion/posts |
GET, POST | GET /admin/posts — entradas del blog, publicadas y borradores. · POST /admin/posts — crea una entrada. |
/gestion/posts/{id} |
GET, POST, DELETE | GET /admin/posts/{id} — una entrada del blog. · POST /admin/posts/{id} — la modifica. · DELETE /admin/posts/{id} — la borra. |
/gestion/productos |
GET, POST | GET /gestion/productos — el catálogo para el panel. Nuestro, sin motor. |
/gestion/productos/{id} |
GET, POST, DELETE | GET /gestion/productos/:id — una ficha completa para el panel. |
/gestion/productos/{id}/historial |
GET | GET /gestion/productos/:id/historial — quién cambió qué en esta ficha. |
/gestion/productos/{id}/variantes/{idVariante} |
POST | POST /gestion/productos/:id/variantes/:idVariante — cambia la variante y su precio. |
/gestion/products/visibility |
POST | POST /gestion/products/visibility — visibilidad en lote: |
/gestion/proveedores-pago |
GET | GET /gestion/proveedores-pago |
/gestion/puntos |
GET | GET /gestion/puntos — el estado del programa: qué debe la tienda en puntos y |
/gestion/puntos/ajustes |
GET, POST | GET/POST /gestion/puntos/ajustes — cómo funciona el programa. |
/gestion/puntos/clientes/{id} |
GET, POST | GET /gestion/puntos/clientes/:id — el libro de un cliente, con sus lotes. · POST /gestion/puntos/clientes/:id — un ajuste a mano, con nota obligatoria. |
/gestion/quien-soy |
GET | GET /gestion/quien-soy — la sesión actual. |
/gestion/regiones |
GET | GET /gestion/regiones |
/gestion/regiones/{id} |
PATCH | PATCH /gestion/regiones/:id |
/gestion/reviews |
GET | GET /admin/reviews?status=pending&limit=100 — lo que hay que moderar. |
/gestion/reviews/{id} |
POST, DELETE | POST /admin/reviews/:id { status } — aprobar o rechazar. |
/gestion/saldo |
GET | GET /gestion/saldo — el pasivo: cuánto dinero debe la tienda en saldo y |
/gestion/saldo/{id} |
GET, DELETE | GET /gestion/saldo/:id — un saldo con sus movimientos. |
/gestion/saldo/clientes |
POST | POST /gestion/saldo/clientes — abonar saldo de tienda a un cliente. |
/gestion/saldo/tarjetas |
POST | POST /gestion/saldo/tarjetas — emitir una tarjeta regalo a mano. |
/gestion/scan |
GET | GET /admin/scan?q=… — busca una variante por código de barras o SKU. |
/gestion/scan/adjust |
POST | POST /gestion/scan/adjust — corrige el stock de una variante en una ubicación. |
/gestion/scan/bind |
POST | POST /gestion/scan/bind — asocia un código de barras a una variante. |
/gestion/scan/count-apply |
POST | POST /gestion/scan/count-apply — aplica un recuento completo: cada variante |
/gestion/send-invoice |
POST | POST /admin/send-invoice — manda por correo la factura de un pedido en PDF. |
/gestion/soporte |
GET | GET /admin/soporte — la bandeja. Lo que lleva más esperando, primero. |
/gestion/soporte/{id} |
GET, POST, DELETE | GET /admin/soporte/:id — la conversación entera. |
/gestion/soporte/{id}/borrador |
POST | POST /admin/soporte/:id/borrador — escribe la respuesta, NO la envía. |
/gestion/soporte/{id}/responder |
POST | POST /admin/soporte/:id/responder — envía la respuesta al cliente. |
/gestion/soporte/borrar |
GET, POST | GET /admin/soporte/borrar — qué plazo hay puesto. · POST /admin/soporte/borrar — borrar ya, por plazo o por correo. |
/gestion/tema-activo |
GET, POST | GET /gestion/tema-activo — qué tema está puesto y cuáles tienen ajustes. · POST /gestion/tema-activo { tema } — poner otro. |
/gestion/temas-ajustes |
GET, POST | GET /gestion/temas-ajustes?tema= |
/gestion/temas-demo |
GET, POST | GET /admin/temas-demo?tema= |
/gestion/tienda |
GET, PATCH | GET /gestion/tienda — la tienda y sus ajustes. |
/gestion/ubicaciones |
GET | GET /gestion/ubicaciones — los almacenes. |
/gestion/uploads |
POST | POST /gestion/uploads — sube imágenes y devuelve sus URL. |
/gestion/usuarios |
GET | GET /gestion/usuarios — el personal de la tienda. |
/gestion/usuarios/{id} |
GET, PATCH, DELETE | GET /gestion/usuarios/:id |
/gestion/wishlist |
GET | GET /admin/wishlist — qué producto desea más gente. |
/hooks/sendcloud |
POST | POST /hooks/sendcloud — avisos de envío de Sendcloud. |
/mcp |
POST, GET | POST /mcp — la tienda, hablando el idioma de los agentes de IA. |
/payment-config |
GET | GET /payment-config — qué formas de pago enseñar en el checkout. |
/setup |
GET | GET /setup — estado de la instalación. |
/setup/database |
GET | GET /setup/database — estado de la base de datos y de las migraciones. |
/setup/database/migrate |
POST | POST /setup/database/migrate — ejecuta las migraciones y va contando qué pasa. |
/setup/demo |
POST | POST /setup/demo — deja la tienda montada con el tema base y su contenido. |
/setup/finish |
POST | POST /setup/finish — crea el primer administrador y cierra la instalación. |
/site-status |
GET | GET /site-status — si la tienda está en mantenimiento y qué mensaje enseñar. |
/telegram/webhook |
POST | POST /telegram/webhook — hablar con la tienda desde el móvil. |
/tienda/buscar |
GET | GET /store/buscar?q=… — el buscador de la tienda. |
/tienda/categorias |
GET | GET /tienda/categorias — la navegación de la tienda. |
/tienda/contact |
POST | POST /tienda/contact — el formulario de contacto de la tienda. |
/tienda/marketplace/envios |
GET, POST | GET /store/marketplace/envios?cart_id=… |
/tienda/pagos/recargo |
POST | POST /store/pagos/recargo — pone en el carrito el recargo de la forma de pago. |
/tienda/pedidos/{id}/factura |
GET | GET /tienda/pedidos/{id}/factura — la factura de un pedido, en PDF. |
/tienda/posts |
GET | GET /store/posts?handle=… — el blog público. |
/tienda/producto-extras |
GET | GET /store/producto-extras?product_id=… — lo que añade la IA a una ficha: |
/tienda/productos |
GET | El catálogo, servido por nosotros. |
/tienda/productos/{handle} |
GET | Un producto por su dirección. Mismo filtro de canal que el listado. |
/tienda/products-by-price |
GET | GET /store/products-by-price — ids de producto ordenados por PRECIO. |
/tienda/regiones |
GET | GET /tienda/regiones — moneda e impuestos por país. |
/tienda/reviews |
GET, POST | GET /store/reviews?product_id=… — solo las APROBADAS, con la nota media. · POST /store/reviews — deja una, que nace pendiente de moderar. |
/tienda/soporte |
POST | POST /store/soporte — el formulario de contacto de la tienda. |
/tienda/soporte/chat |
POST | POST /store/soporte/chat — la IA contesta al cliente en el momento. |
/tienda/stock-map |
GET | GET /store/stock-map — cuánto stock hay de cada variante, para el escaparate. |
/tienda/wishlist |
GET, POST, DELETE | GET /store/wishlist — la lista de deseos de quien ha iniciado sesión. · POST /store/wishlist — añade un producto. · DELETE /store/wishlist — lo quita. |