Registro de cambios
Qué cambió en las APIs públicas.
Noviembre de 2026
9 de noviembre
- Acceso de clientes Los clientes pueden entrar con contraseña además del código y crearla o recuperarla mediante un código enviado a su correo.
- Precios del invitado El correo escrito en el carrito ya no aplica la lista de precios ni las promociones de un cliente; solo cuenta para el límite de usos por cliente.
- Cupones con usos limitados El uso se reserva al empezar el pago. Si otra compra se llevó el último, el checkout se detiene con el total nuevo.
- Cupones rechazados Un código que no se puede usar dice el motivo, también cuando se agotó o no existe, y los intentos tienen un límite por minuto.
- Personalización obligatoria Un producto con un grupo de opciones obligatorio no se agrega al carrito ni se paga sin elegirlo.
- Productos fuera de la tienda Un producto que no está publicado en la tienda online no se agrega al carrito ni se paga, salvo como order bump.
- Descuento por medio de pago Si el descuento de un pedido depende del medio de pago, el saldo se paga con ese medio y la página del pedido solo ofrece ese.
8 de noviembre
- Importación por lotes Puedes agrupar el procesamiento posterior y conservar los slugs y las URLs personalizadas al importar productos, manteniendo los webhooks y flujos de la tienda.
7 de noviembre
- Parámetros con otro tipo Un parámetro con otro tipo responde como un error de validación que nombra el parámetro.
- Estados en los webhooks de pedidos Llegan con la misma escritura que en
Admin API:
openen lugar deOpen. - Stock que llega de un canal Cuando un canal cambia el stock de una
variante que ya existía, el movimiento llega con el motivo
sync. - Importación inicial solo al crear
initialImportqueda para el stock con el que se crea una variante; si una importación de archivo cambia el stock de una variante existente, el motivo esinventoryCount. Los movimientos ya guardados se corrigieron con la misma regla. - Apps del panel Una app nueva solo entra a la tienda donde se creó, y su token ya trae esa tienda.
- Imágenes SVG Ya puedes subir SVG a la biblioteca de archivos y usarlos como fotos de producto. Un SVG que trae código, enlaces a otros sitios o está dañado se rechaza al subirlo.
6 de noviembre
- Teléfono en el carrito El teléfono del comprador y el de cada dirección deben ser válidos para el país de la dirección, o llevar el código de su país. Un número que no lo es se rechaza al guardarlo y al pagar.
- Teléfono del cliente El teléfono nuevo de un perfil, de una dirección de la cuenta, del registro o del libro de reclamaciones se valida igual, con el país que le corresponde.
- Datos del comprador Nombres, correo, razón social y dirección tienen límites de longitud y formato; lo que no los cumple recibe un error de validación en vez de un fallo del servidor.
- RUC en el carrito Si el país emisor es Perú, la identificación fiscal del comprador debe ser un RUC válido.
- Catálogo geográfico en el carrito El país emisor del documento, el país de facturación y los códigos de departamento, provincia y distrito deben existir en el catálogo.
- Comprobante de pago Al pagar solo se acepta un comprobante subido a la misma tienda.
- Más lecturas por GraphQL Los métodos de pago, las reseñas de la tienda y los artículos publicados ya se consultan por GraphQL, con los mismos filtros que en REST.
- Colecciones con sus productos Al listar colecciones por GraphQL puedes limitar cuántas llegan y traer los primeros productos de cada una en la misma consulta, en el orden de la colección.
- Reseñas en los listados de productos Cada producto de un listado por GraphQL puede traer sus primeras reseñas en la misma consulta, igual que la primera página de reseñas de ese producto.
- Vendedores fuera de un marketplace En una tienda que no es marketplace, la lista de vendedores por GraphQL llega vacía en vez de dar error; REST sigue respondiendo que no existe.
5 de noviembre
- Logo cuadrado de la tienda Al actualizar los datos generales de la
tienda, envía el logo cuadrado en
icon(nulllo quita);favicon, que repetía ese valor, ya no viene. - Personalizaciones de la tienda Se crean una vez, se asignan a productos en lote y pueden pedir un texto al comprador; crear o editar un producto ya no las cambia.
- Carrito con personalización Cada línea lleva el texto escrito o las
opciones con su cantidad, y
optionsreemplaza aoptionIds. - Personalización en el pedido El pedido guarda el texto y la cantidad de cada opción, y el subtotal cobra cada unidad.
- Filtro por personalización La lista de productos, el conteo, la exportación y las acciones en lote filtran por personalización.
- Personalizaciones en la tienda online La ficha del producto trae sus personalizaciones con sus opciones, y los listados marcan los productos que se personalizan.
- Personalización en correos y hojas de empaque Los correos que listan artículos la muestran con su extra, y la hoja de empaque la pone bajo cada producto. Las plantillas también la reciben.
- Pedido manual con personalización Una línea de un borrador lleva su personalización igual que en el carrito, y el pedido la conserva.
- Pedidos del cliente con personalización Las líneas de sus pedidos, del detalle y del pedido por pagar traen lo que eligió y su extra.
- Número de borrador por tienda Los borradores nuevos se numeran
D1,D2… dentro de cada tienda. Antes, la segunda tienda que creaba uno recibía un error. - Detalle de producto y variante
modifierGroupspasa amodifierGroupIds; las personalizaciones de un producto se consultan aparte, filtradas por producto. - Imágenes al crear un producto
imageAssetIdsya no existe: las imágenes guardadas van enimagescon origenasset.
3 de noviembre
- SDK de temas renombrado
@ecomiq/ahora se llamareact-router @ecomiq/; los temas importan del nombre nuevo.storefront - CLI y SDK en npm
ecomiq,create-ecomiq,@ecomiq/ycore @ecomiq/se instalan desde npm, ystorefront npm create ecomiq@latestbaja el código de tu tienda. - Stock al importar productos Puedes cargar el stock de cada variante en un local de su vendedor junto con el producto.
- Guías de talla por vendedor Dos vendedores pueden usar el mismo nombre para sus guías sin que una importación cambie la del otro, y una publicación puede elegir la guía y sus filas para su categoría.
1 de noviembre
- Perfil de tienda del vendedor Suma eslogan, WhatsApp, estilo de enlaces y sello de verificado; el logo, el banner y las redes deben ser URL completas.
- Vendedores en Storefront La lista muestra el banner, el eslogan y el sello de cada vendedor, y su página suma la descripción, las redes y desde cuándo vende.
- Unidades en los requisitos del canal Cada atributo dice qué tipo de valor espera y, si lleva unidad, cuáles acepta y cuál usa por defecto.
Octubre de 2026
31 de octubre
- Editar variantes Al editar un producto solo cambian las variantes que envías: puedes actualizar, agregar o quitar una, y borrar su precio de comparación o de costo.
- Vendedores sin dueño Puedes crear un vendedor sin los datos de su dueño y enviarle la invitación después.
- Vendedores en bloque Se importan y exportan con Excel, CSV, TSV o JSONL, con revisión previa, y se editan en una hoja.
- Productos de un canal El filtro por canal trae solo lo publicado en ese canal; antes sumaba lo importado desde la misma conexión.
- Exportar por origen Exportar productos respeta el filtro por origen; antes exportaba todo el catálogo.
- Cerrar publicaciones Un vendedor no puede cerrarlas: eso lo maneja el marketplace.
- Stock por local La vista previa de una publicación muestra el stock de cada local por variante.
30 de octubre
- Precio y stock por canal Fija por variante el precio, el precio de comparación, el stock máximo o «no vender aquí», con vista previa y deshacer; reemplaza el cambio de precio por publicación.
- Más acciones de publicación Puedes pasar publicaciones a borrador, cerrarlas o borrarlas, y probar antes qué pasaría.
- Vista de un canal Las publicaciones se filtran por estado, con el conteo de cada uno, y la vista previa evalúa hasta 50 productos sin enviarlos.
- Requisitos del canal Puedes ver y completar en bloque lo que pide un canal, también en productos que aún no se publican.
- Excel por canal Precios, stock y estados de un canal se exportan e importan en Excel, con revisión antes de aplicar.
- Buscar SKU Busca hasta 5000 SKU de una vez y ve cuáles no existen o se repiten entre vendedores.
- Publicaciones sin confirmar Si el canal no confirmó una publicación, puedes buscarla en su cuenta y volver a publicarla o cerrarla.
- Cargos del pedido El pedido trae sus cargos con su impuesto; en WooCommerce ya no se suman al costo de envío.
- Productos de un vendedor En un marketplace, la tienda puede crear un producto a nombre de un vendedor, y entra aprobado.
- Moderación en bloque Decide hasta 500 productos en revisión de una vez; solo esperan revisión los que el vendedor envió.
24 de octubre
- Pagos manuales Puedes registrar efectivo, POS, transferencia, Yape o Plin aunque la tienda no los ofrezca en el checkout.
- Transferencias Cada método guarda hasta 5 cuentas bancarias y sus textos en varios idiomas.
- Cuentas en el checkout El checkout y la página del pedido muestran las cuentas de la transferencia.
21 de octubre
- Idiomas de pagos y envíos Sus textos salen en el idioma del comprador y, si falta, en el idioma principal o en el texto base.
- Envíos traducidos Métodos, tarifas y personalizaciones aceptan traducciones. Ver Zonas y tarifas.
- Pagos con código en un paso Plin y PagoEfectivo generan su código o QR directo desde el checkout o el pedido.
- 3D Secure en Culqi Si el banco pide autenticar la tarjeta, el comprador lo hace y el mismo pago continúa.
- Pagos sin respuesta Si el proveedor no responde a tiempo, el intento queda guardado y un reintento lo recupera en vez de emitir otro.
20 de octubre
- Mercado Pago en el checkout Cobra con tarjeta, Yape y PagoEfectivo.
19 de octubre
- Pago dentro o fuera del checkout Cada conexión de pago elige si el formulario va en el checkout o en la página del proveedor.
- Pagos con código o QR El checkout y la página del pedido muestran el código o QR de los pagos que se completan fuera.
- Tokens de Culqi El checkout rechaza un token de otro método o un método que Culqi no cobra.
- Idioma de los métodos de pago Llegan en el idioma de la tienda; antes llegaban en inglés en todas.
- Stripe El modo de pago se elige en la conexión, como en los demás proveedores.
- Claves guardadas Cada conexión dice qué claves secretas tienen valor, sin mostrarlo.
- Confirmaciones de pago Cada proveedor dice cómo llegan sus confirmaciones, y cada conexión trae la URL para recibirlas.
- Pagos autorizados Con captura manual, el pago queda autorizado y el pedido se confirma al capturarlo.
- Campos por sección La configuración de cada proveedor separa las llaves de la cuenta de los datos de las confirmaciones.
- Historial del pedido Registra cuando cambia su estado en el origen.
- Moneda del canal Publicar en un canal que vende en otra moneda exige su tipo de cambio.
- Pedidos sin confirmar en un canal El pedido se busca en el canal, y puedes vincular el número que ya tiene o reenviarlo.
18 de octubre
- Atributos obligatorios Un atributo solo es obligatorio en las categorías que lo piden; se retira esa marca del atributo.
17 de octubre
- Búsqueda con varias palabras La búsqueda de Admin API encuentra lo que tiene todas las palabras, sin importar mayúsculas ni tildes.
- Errores con código Todos los errores traen un código estable, también por campo: tradúcelos con el código, no con el texto.
- Operaciones con motivo Una operación fallida o vencida dice por qué.
14 de octubre
- Detalle del producto Trae el SKU y ya no dice qué campos actualiza el origen: eso se configura en el origen.
- Crear sin duplicar Reenviar la creación de un producto con el mismo identificador devuelve el producto ya creado.
10 de octubre
- Dirección de Storefront API Las llamadas van a
https:/, sin/ storefront.ecomiq.pe/ v1/ /.api
8 de octubre
- Ediciones y orígenes Lo que editas se conserva, salvo los campos que actualiza su origen; ya no hay campos protegidos a mano.
- Avisos opcionales La tienda puede apagar los avisos que no son obligatorios; confirmación, cancelación, reembolso y pago fallido siempre salen.
- Correo del pedido Con pago en línea pendiente, la confirmación sale cuando entra el pago; con pago manual, al hacer el pedido.
7 de octubre
- Vendedor en cada venta Productos, carritos y pedidos siempre dicen su vendedor, también en las ventas propias.
6 de octubre
- Textos de productos Nombres de hasta 500 caracteres y descripciones de hasta 50.000, igual que en las importaciones.
5 de octubre
- Pedidos en bloque Etiquetas, archivo, captura de pagos y cambio de ubicación para hasta 100 pedidos o para todos los de un filtro.
- Métricas de pedidos Pedidos, artículos, reembolsos, envíos y tiempo hasta el envío, comparados con el periodo anterior.
- Cancelar libera el pago Cancelar un pedido libera el pago autorizado; si el pago llega después, queda por reembolsar.
- Enlace del cliente Puedes obtener el enlace a la página de estado que ve el cliente.
- Preparaciones Se filtran por varios pedidos a la vez (
orderIdsreemplaza aorderId). - IDs en webhooks Llegan como texto, como en la API; antes JavaScript los redondeaba.
- Checkout con tarjeta Acepta el token de la tarjeta y muestra la clave
pública de cada método (
actionTypepasa aactionKind). - Pagos rechazados Responden como error de validación, no del servidor, y el carrito se puede volver a pagar.
- Códigos de descuento Si un código deja de aplicar al pagar, el checkout avisa en vez de cobrar sin él; los descuentos también reducen el IGV incluido.
- Envíos Métodos y zonas se pueden desactivar; el perfil predeterminado, no.
- Pedidos por vendedor Los pedidos se filtran por vendedor.
4 de octubre
- Importaciones más simples Envías el archivo directo y sigues su avance. Ver Importación de productos.
- Lotes con resultado por fila Hasta 100 registros responden al instante con el resultado de cada uno.
- Operaciones Consulta o cancela importaciones y exportaciones; un webhook avisa cuando terminan.
- Pedidos Se filtran por estado de pago y de entrega, se ordenan, se archivan y se cancelan sin avisar al cliente.
- Rutas retiradas Se retiran las reservas manuales de stock y otras rutas que tienen reemplazo.
3 de octubre
- Carrito Guardar la dirección devuelve el carrito; las opciones de envío se piden aparte.
1 de octubre
- URLs propias Cada producto y categoría tiene su URL, que puede ser personalizada, y la tienda publica su sitemap.
Septiembre de 2026
28 de septiembre
- Atributos con tipo Validan sus valores y aceptan números con unidad y enlaces.
- Opciones con color e imagen Cada valor puede tener nombre, color e imagen.
- Atributos por categoría Los obligatorios se piden al activar un producto.
- Cuentas de clientes El registro y el inicio de sesión se configuran desde el checkout. Ver Cuentas de clientes.
26 de septiembre
- Rutas retiradas Las sugerencias de atributos pasan a la búsqueda y el cierre de sesión, a OAuth.
25 de septiembre
- Filtros Pedidos y productos se filtran por etiquetas y canales, también para excluirlos.
6 de septiembre
- Importación Conserva el nombre de cada variante.
4 de septiembre
- Exportación de inventario La columna
statuspasa avariant_status.
Agosto de 2026
25 de agosto
- GraphQL Storefront suma GraphQL para lecturas.
- Storefront Métodos de pago y opciones de retiro.
- Auth Registro de aplicaciones, doble factor y eliminación de cuenta.
- Webhooks Evento de pedido creado.
Julio de 2026
- Primera versión APIs Admin, Storefront y Auth, con OpenAPI descargable.
Última actualización: