Mercaio: tutoriales CSV, listings y trabajos EN/ES

CSV, evidencia, preparación de listings y recuperación de trabajos: cuatro pasos de uso local de Mercaio.

Los tutoriales de Mercaio explican cómo importar CSV, revisar evidencia, comparar productos propios, calcular margen con tus costes y preparar listings EN/ES. También cubren validación local, exportación y recuperación de trabajos. Empieza con un producto guardado; si aún no lo tienes, sigue el inicio rápido bilingüe.

Manual de uso v1.0 · 19-11-2026. Los controles privados se contrastaron con el código da1f9ae y los informes técnicos #6/#8; se revisaron portada, vista previa, acceso y canales públicos. Esta edición no incluye una nueva prueba de sesión privada completa. Las instrucciones no dependen de la transferencia temporal de datos desde la portada. Los ejemplos son ficticios y las operaciones descritas son locales salvo autorización y soporte expresos del destino.

Centro de ayuda, FAQ y glosario.

ES: importar un CSV de proveedor

Objetivo: crear productos privados con borradores EN/ES. Requisitos: sesión iniciada y CSV permitido. Los controles de esta pantalla siguen en inglés.

  1. Abre Importar CSV de proveedor. Incluye las cabeceras obligatorias title_en, details_en, source_url, observed_on, niche, category, market, evidence_notes, supplier_notes. Son opcionales title_es, details_es, risk_notes.
  2. Rellena cada campo obligatorio en cada fila. Usa fecha real YYYY-MM-DD y URL completa. Se admite coma o punto y coma; usa comillas en valores con separadores o saltos de línea.
  3. Carga el CSV y revisa CSV preview: ready, invalid y duplicate_in_csv. Corrige los mensajes de las filas y vuelve a cargar el archivo antes de confirmar.
  4. Marca la confirmación que comienza I understand that importing creates y pulsa Confirm import (... unique products). La vista previa no guarda.
  5. Lee Import results: inserted, duplicate e invalid. Pulsa Open compare y después Open EN + ES draft para editar.

Ejemplo ficticio: title_en=Bamboo desk organizer, details_en=Bamboo material; two compartments, source_url=https://example.com/product, observed_on=2026-11-19, niche=Desk organization, category=Office, market=Spain, evidence_notes=Example only; demand unknown, supplier_notes=Example only; costs unknown. La URL es un marcador de práctica, no una fuente comprobada.

Resultado: cada fila aceptada crea un producto privado y borrador. ES vacío queda para edición manual. Errores: corrige cabeceras ausentes y filas invalid. Un duplicado conserva el registro previo sin sobrescribirlo. La clave combina title_en + source_url + observed_on en tu cuenta; no cambies fechas solo para forzar otro registro. Siguiente acción: comparar productos.

ES: registrar evidencia y datos faltantes

Objetivo: distinguir observaciones de supuestos. Requisitos: producto propio y permiso para consultar la fuente.

  1. Abre el borrador y Evaluación del nicho · Datos del vendedor.
  2. Completa Nicho / problema del cliente, Categoría de investigación (no taxonomía del marketplace) y Mercado objetivo.
  3. Añade URL de fuente permitida y Fecha de consulta de la fuente. En Observaciones de demanda / competencia y carencias, escribe lo observado y lo que falta comprobar.
  4. Registra Proveedor, costes y supuestos logísticos y Cumplimiento, elegibilidad y otros riesgos. Pulsa Guardar cambios.
  5. En Flujo y trabajos, selecciona el producto y la skill de evidencia; pulsa Ejecutar skill y consulta Evidencia y Resultado completo / pruebas.

Ejemplo ficticio: “Ficha consultada el 2026-11-19: bambú y dos compartimentos. No consta peso ni certificación. Demanda pendiente”. Resultado: notas fechadas y revisión local de faltantes; no consulta ni verificación remota de la URL. Errores: una fuente vacía no demuestra falta de demanda. Corrige fechas inválidas o futuras. La revisión de vigencia se señala tras 30 días; una fuente más reciente tampoco garantiza exactitud. Siguiente acción: comparar productos y revisar costes.

ES: filtrar y comparar productos propios

Objetivo: elegir qué producto revisar. Requisitos: dos o tres productos propios guardados o importados; controles en inglés.

  1. Abre Comparar tus productos.
  2. Combina Niche / customer problem, Target market, Provenance y Search. La búsqueda compara título, nicho, categoría y mercado.
  3. Marca Compare en dos o tres tarjetas; el máximo es tres.
  4. Lee Evidence, Unknowns y procedencia Imported CSV o Seller entry.
  5. Selecciona Open EN + ES draft para corregir datos o texto.

Ejemplo ficticio: dos organizadores para Spain; uno tiene notas fechadas y otro carece de coste logístico. Comprueba ese coste: más campos completos no demuestran rentabilidad. Resultado: comparación con carencias visibles y acceso al borrador. Errores: si aparece No matches, vuelve a All y vacía Search. Un producto sin mercado no coincide con un mercado concreto. Esta edición no incluye búsquedas guardadas ni filtros avanzados por precio o estado del trabajo. Siguiente acción: calcular margen con costes propios.

ES: margen y comparación de proveedores

Objetivo: comparar contribución y costes aportados, no predecir beneficio neto. Requisitos: producto guardado, cifras por unidad y moneda EUR.

  1. Abre Flujo y trabajos, elige la skill de margen y selecciona el producto.
  2. Rellena Nombre, Precio venta (€), Coste producto (€), Comisión (%), Comisión fija (€), Envío (€) · opcional y Otros costes (€) · opcional cuando correspondan. Deja costes desconocidos pendientes; escribe 0 solo si has comprobado que son cero.
  3. Usa Añadir escenario para comparar hasta cinco escenarios y pulsa Ejecutar skill.
  4. Lee contribución, porcentaje, precio de equilibrio y Pendiente.
  5. Para comparar ofertas, elige la skill de proveedores e introduce Nombre proveedor, Coste unitario (€), Envío por unidad (€), Pedido mínimo (unidades), Plazo (días) y Condiciones de pago / devolución / entrega. Usa Añadir oferta, ejecuta y revisa las entradas y faltantes.

Ejemplo ficticio de margen: precio 30 €, coste 10 €, comisión 10%, comisión fija 1 €, envío 4 € y otros 2 €. Contribución: 30 − 10 − 3 − 1 − 4 − 2 = 10 €; margen 33,33%; equilibrio (10 + 1 + 4 + 2) / (1 − 0,10) = 18,89 €. No incluye impuestos, devoluciones ni gastos omitidos. Dos ofertas de 10 € + 4 € y 12 € + 1 € tienen costes aportados de 14 € y 13 € por unidad; revisa también mínimos y plazos, sin declararlas verificadas.

Resultado: escenarios reproducibles y comparación de ofertas introducidas. Errores: costes vacíos producen resultados parciales; no mezcles monedas ni costes de lote con unitarios. Una comisión del 100% no permite equilibrio finito. Siguiente acción: verificar supuestos y editar el listing.

ES: editar EN/ES, validar y exportar

Objetivo: preparar texto por idioma y un paquete local del destino. Requisitos: borrador guardado y datos del canal confirmados.

  1. Abre Abrir borrador EN + ES. Revisa Título del listing, Descripción, Puntos clave, Palabras clave (separadas por comas) y Notas del vendedor en English (EN) y Español (ES).
  2. Si quieres reorganizar texto, abre Crear plantilla local con tus datos, rellena Datos del producto del vendedor y pulsa Aplicar plantilla local. Sustituye solo descripción y puntos del idioma activo; revísalos antes de guardar.
  3. En Preparación por canal, elige Destino. Aporta Precio (EUR), Cantidad disponible, URLs de imágenes (una por línea), Tipo de producto Amazon, ID categoría / taxonomía y Condición según corresponda. Usa imágenes con derechos.
  4. Pulsa Ejecutar prueba local; lee Resultado local, OK o Revisar. Corrige faltantes y repite.
  5. Usa Guardar cambios, Descargar .md, Descargar EN + ES o Exportar preparación JSON. La exportación normal guarda antes de descargar.

Ejemplo ficticio: corregir “Organizador de escritorio de bambú” en ES no traduce ni sustituye EN. No añadas peso desconocido para superar una comprobación. Resultado: Markdown/JSON local; no aceptación ni envío al marketplace. Errores: si falla Copiar exportación, descarga. Para errores de longitud revisa título hasta 1.000 caracteres, descripción hasta 20.000 y cada punto hasta 2.000. Ante error de guardado usa Descargar copia local (no guardada online) cuando aparezca y conserva los cambios. Siguiente acción: leer el estado de conexión.

ES: conexiones y permisos

Objetivo: distinguir preparación, prueba y publicación autorizada. Requisitos: acceso a la pantalla pública de canales.

  1. Abre Preparación por canal y lee cada estado.
  2. En Amazon.es, eBay y Etsy, No conectado y Envío deshabilitado significan preparación local, no publicación.
  3. En Amazon.es o eBay, abre Configuración de autorización nativa para leer requisitos. Las referencias oficiales no son conexiones.
  4. Donde figure Solo exportación genérica · Sin adaptador de publicación, utiliza guardado y exportación, no envío.
  5. Si hay acceso a Tiendas y catálogos, revisa ese estado y sus permisos por separado. Esta edición no certifica importación/publicación real de WooCommerce o PrestaShop.

Ejemplo de estado: Amazon.es no conectado permite preparar texto, no crear un anuncio en Seller Central. Resultado: decidir entre exportar y completar un flujo de autorización habilitado. Errores: una clave del servidor no autoriza una cuenta. Un sandbox oficial o una prueba local no es publicación real. No envíes listings para practicar esta guía ni pegues credenciales en borradores o correo. Siguiente acción: continuar preparación o revisar trabajos.

ES: ejecutar skills y recuperar trabajos

Objetivo: inspeccionar resultados y continuar pasos recuperables. Requisitos: productos guardados; borradores para validar/exportar y entradas explícitas para margen/proveedores.

  1. En Flujo y trabajos, elige Skill · ejecución local, Destino de preparación y Productos guardados. Seleccionar todos (hasta 25) tiene ese límite.
  2. Completa las entradas de la skill y pulsa Ejecutar skill.
  3. En Operador del flujo · ejecuciones persistentes, lee estado, pasos y Entradas y supuestos guardados. Abre Resultado completo / pruebas.
  4. Usa Cancelar trabajo pendiente para detener pasos no ejecutados. Para una interrupción recuperable, selecciona Reanudar / reintentar pasos recuperables.
  5. Ante Bloqueado · corrige datos en una nueva ejecución, corrige entradas y crea otro trabajo. Usa Descargar resultados guardados o Descargar resultados del lote.

Ejemplo ficticio: un lote de tres productos tiene dos borradores y un producto sin borrador. Puede retener los dos resultados y marcar el tercero para revisión; crea su borrador y una ejecución nueva. Resultado: historial privado y recuperación sin sobrescribir borradores existentes. Errores: el navegador impulsa estos pasos locales mientras el workbench está abierto. Recargar puede continuar trabajo pendiente; cancelar requiere reanudar. Hay hasta tres intentos por paso recuperable. Los faltantes no se arreglan con reintentos ciegos. Siguiente acción: corregir los resultados parciales antes de repetir un lote.

ES: limpieza CSV, inventario y restauración selectiva

Objetivo: generar una copia limpia, calcular inventario con cifras propias o restaurar campos explícitos. Requisitos: CSV de hasta 60 KB, datos de inventario o ejecución anterior guardada.

  1. Para limpieza, usa Cargar archivo CSV, Separador y Leer columnas y definir mapeo. Asigna Campo destino y Regla de limpieza: Recortar espacios, Coma decimal → punto, g → kg o cm → m.
  2. Ejecuta y revisa Original → copia limpia (todas las filas). Marca He revisado cada fila y acepto una copia limpia separada., pulsa Aceptar copia CSV limpia y Descargar copia CSV aceptada. No sustituye automáticamente el catálogo.
  3. Para inventario, aporta Stock disponible (unidades), Ventas diarias aportadas (unidades/día), Plazo (días), Stock de seguridad (unidades) y Entradas esperadas (unidades); ejecuta y revisa cobertura y reposición.
  4. Para Revisar cambios, elige Versión guardada con la que comparar y ejecuta. Guarda o descarta los cambios del editor antes de seleccionar campos para restaurar.
  5. Marca He guardado o descartado ediciones y confirmo restaurar solo campos seleccionados. y pulsa Confirmar restauración selectiva. Recarga el editor y revisa el resultado.

Ejemplos ficticios: 500 g → 0,5 kg. Inventario de 40 unidades, 2 ventas/día, plazo 10 días, seguridad 5 y sin entradas: cobertura 20 días y punto de reposición 25 unidades. Resultado: copia revisada, escenario calculado o restauración elegida, no sincronización real de stock ni previsión de demanda. Errores: cobertura indefinida con cero ventas; comprueba unidades antes de convertir y no restaures con ediciones sin guardar. Siguiente acción: revisar el producto y exportar el borrador.

EN: supplier CSV import

Goal: private products and EN/ES drafts. Requirements: signed-in account and permitted CSV; controls use English.

  1. Open Import supplier CSV. Required headers: title_en, details_en, source_url, observed_on, niche, category, market, evidence_notes, supplier_notes; optional: title_es, details_es, risk_notes.
  2. Fill every required row field. Use a real YYYY-MM-DD date and complete URL. Use comma or semicolon consistently; quote values containing separators or line breaks.
  3. Choose the file; inspect CSV preview, ready, invalid and duplicate_in_csv. Fix messages and reload before confirming.
  4. Tick the acknowledgement starting I understand that importing creates, then Confirm import (... unique products). Preview alone does not save.
  5. Inspect Import results (inserted, duplicate, invalid), select Open compare, then Open EN + ES draft.

Fictional row: title “Bamboo desk organizer”; details “Bamboo material; two compartments”; source https://example.com/product; date 2026-11-19; niche “Desk organization”; category “Office”; market “Spain”; evidence “Example only; demand unknown”; supplier “Example only; costs unknown”. The URL is a placeholder, not a checked source. Result: accepted rows create private products and drafts; blank ES needs manual wording. Errors: fix missing headers/invalid rows. Duplicates preserve prior records using title_en + source_url + observed_on within your account; do not change dates to force duplicates. Next: compare products.

EN: evidence and missing information

Goal: separate observations from assumptions. Requirements: your own product and source access permission.

  1. Open the draft and Niche assessment · Seller-entered.
  2. Fill Niche / customer problem, Research category (not marketplace taxonomy) and Target market.
  3. Add Permitted source URL, Date you observed the source and Demand / competition observations and gaps.
  4. Record Supplier, costs and fulfillment assumptions and Compliance, eligibility and other risks; select Save changes.
  5. In Workflow & jobs, choose the product and evidence skill, Run skill, then inspect Evidence and Full outcome / checks.

Fictional note: “Page viewed 2026-11-19 states bamboo and two compartments; weight/certification absent; demand unchecked.” Result: dated notes and local missing-data review, not remote URL fetching or independent verification. Errors: a missing source is not proof of absent demand. Correct invalid/future dates. Freshness review is flagged after 30 days; newer data is not automatically accurate. Next: compare products and costs.

EN: filter and compare own products

Goal: choose what to review. Requirements: two or three saved/imported own products.

  1. Open Compare your products.
  2. Combine Niche / customer problem, Target market, Provenance and Search, which matches title, niche, category and market.
  3. Tick Compare on two or three cards; maximum three.
  4. Read Evidence, Unknowns, Imported CSV and Seller entry provenance.
  5. Select Open EN + ES draft to correct content.

Fictional example: two Spain-targeted organizers; one has dated notes, the other lacks shipping cost. Check the cost instead of treating completeness as proof of profit. Result: side-by-side gaps and draft access. Errors: for No matches, return selectors to All and clear Search. Missing market does not match a specific market. Saved searches and advanced price/job filters are outside this edition. Next: explicit-input margin.

EN: margin and supplier comparison

Goal: evaluate entered contribution and supplier costs, not predict net profit. Requirements: saved product and per-unit EUR inputs.

  1. In Workflow & jobs, choose the margin skill and saved product.
  2. Fill Name, Sale price (€), Product cost (€), Fee (%), Fixed fee (€), Shipping (€) · optional and Other costs (€) · optional where applicable. Unknown costs stay pending; zero must mean a checked zero.
  3. Use Add scenario for up to five scenarios and Run skill.
  4. Inspect contribution, percentage, break-even price and Pending.
  5. For supplier comparison, enter Supplier name, Unit cost (€), Per-unit shipping (€), Minimum order (units), Lead time (days) and Payment / return / delivery terms. Use Add supplier offer, run, and inspect inputs and gaps.

Fictional margin: price 30 €, product 10 €, fee 10%, fixed fee 1 €, shipping 4 €, other 2 € gives contribution 10 €, margin 33.33% and break-even 18.89 €. Taxes, returns and omitted expenses are excluded. Offers of 10 € + 4 € and 12 € + 1 € give entered unit costs of 14 € and 13 €; compare minimums/lead time too without treating offers as verified. Result: reproducible entered-data scenarios. Errors: blank costs give partial results; do not mix currencies or batch/per-unit costs. A 100% fee prevents finite break-even. Next: verify assumptions and edit the listing.

EN: edit, validate and export

Goal: language-specific text and a local destination package. Requirements: saved draft and confirmed channel fields.

  1. Open EN + ES draft. Review Listing title, Description, Bullet points, Search keywords (comma separated) and Seller notes in English (EN) and Español (ES).
  2. Open Build a local template from your details, fill Seller product details, then Apply local template. This replaces only active-language description/bullets; review before saving.
  3. In Channel preparation, choose Destination; supply Price (EUR), Stock quantity, Image URLs (one per line), Amazon product type, Category / taxonomy ID and Condition as applicable. Use images you have rights to use.
  4. Run offline test and inspect Offline result, OK or Review; correct gaps and repeat.
  5. Use Save changes, Download .md, Download EN + ES or Export preparation JSON. Normal export saves before download.

Fictional example: correcting the Spanish organizer title neither translates nor replaces EN. Do not invent unknown weight to pass a check. Result: local Markdown/JSON, not channel acceptance or dispatch. Errors: download if Copy export fails. Length errors: title up to 1,000 characters, description 20,000 and each bullet 2,000. On save error use Download local backup (not saved online) when offered and retain edits. Next: inspect connection status.

EN: connections and permissions

Goal: distinguish preparation, tests and authorized publishing. Requirements: public channel page.

  1. Open Channel preparation and read each state.
  2. Amazon.es, eBay and Etsy unconnected/dispatch-disabled states mean local preparation, not publishing.
  3. For Amazon.es/eBay open Native authorization setup to read requirements. Official references are not connections.
  4. Generic-export-only destinations without publishing adapters support save/export, not dispatch.
  5. If Stores & catalogs is available, read that state and permissions separately. This edition does not certify live WooCommerce/PrestaShop import or publication.

State example: unconnected Amazon.es permits text preparation, not Seller Central listing creation. Result: choose export or an enabled official authorization flow. Errors: a server key does not authorize a seller account; sandbox/local responses are not live publication. Do not dispatch listings for this tutorial or paste credentials into drafts/email. Next: continue preparation or inspect jobs.

EN: skills and recovery

Goal: inspect outcomes and resume recoverable steps. Requirements: saved products, drafts for validation/export and explicit margin/supplier inputs.

  1. In Workflow & jobs, choose Skill · local execution, Preparation destination and Saved products. Select all (up to 25) enforces that limit.
  2. Complete inputs and Run skill.
  3. In Workflow operator · durable runs, inspect state, steps, Retained inputs & assumptions and Full outcome / checks.
  4. Use Cancel pending work to stop remaining steps and Resume / retry recoverable steps for recoverable interruptions.
  5. For Blocked · fix inputs in a new run, correct inputs and create a new job. Use Download saved results or Download batch results.

Fictional example: a three-product batch has two drafts and one missing draft. It can retain two results and flag the third; create its draft and a new run. Result: private retained history and recovery without overwriting existing drafts. Errors: browser-driven local steps need the workbench open. Reloading can continue pending work; cancellation requires resume. Recoverable steps allow at most three attempts. Missing data needs corrections, not blind retries. Next: fix partial outcomes before rerunning a batch.

EN: CSV cleanup, inventory and selective restoration

Goal: cleaned copies, entered-data inventory scenarios or explicit field restoration. Requirements: CSV up to 60 KB, inventory inputs or a retained prior run.

  1. Use Load CSV file, Delimiter, Read columns & set mapping, Target field and Cleanup rule: Trim text, Decimal comma → dot, g → kg or cm → m.
  2. Run and inspect Original → cleaned preview (all rows). Tick I reviewed every mapped row and accept a separate cleaned copy., then Accept cleaned CSV copy and Download accepted CSV copy. The catalog is not automatically replaced.
  3. For inventory, enter On-hand stock (units), Entered daily sales (units/day), Lead time (days), Safety stock (units) and Expected inbound (units); run and inspect coverage/reorder point.
  4. For Change review, select Retained version to compare against and run. Save/discard editor changes before selecting fields to restore.
  5. Tick I saved or discarded editor changes and confirm restoring only the selected fields., select Confirm selective restoration, reload the editor and review.

Fictional examples: 500 g → 0.5 kg. Inventory: 40 units, 2 sales/day, 10-day lead time, 5 safety units and no inbound gives 20 coverage days and a 25-unit reorder point. Result: reviewed copy, calculated scenario or selected restoration; not live stock synchronization or demand prediction. Errors: zero sales makes coverage undefined; check units before converting and do not restore with unsaved edits. Next: review product and export.

Cobertura de versión / Version coverage

Para datos desde un enlace, registra manualmente una fuente permitida o usa CSV. El campo fuente no descarga URLs. Esta edición no ofrece recorridos verificados de extracción URL/catálogo, sincronización continua, publicación real de tiendas, IA con modelo configurado, generación de imágenes, categorías automáticas, memoria, automatización en segundo plano, API pública, webhooks o MCP. Usa las rutas locales documentadas; su ayuda se ampliará cuando exista un recorrido comprobable.

For linked product data, manually record permitted evidence or use CSV; source fields do not fetch URLs. This edition does not provide verified tutorials for URL/catalog extraction, continuous sync, live store publication, configured-model AI, image generation, automatic taxonomy mapping, memory, background automation, public API, webhooks or MCP. Use the documented local paths until those journeys can be verified.

Siguiente acción / Next action

Abre tu producto en español · Open your product in English · FAQ y glosario / FAQ and glossary.

Soporte / Support: mercaio@brainer.one. Indica pantalla, idioma, error y acción anterior; nunca claves. Include screen, language, error and preceding action; never include keys.