Mercaio: tutoriales CSV, listings y trabajos EN/ES

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.
- 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 opcionalestitle_es, details_es, risk_notes. - Rellena cada campo obligatorio en cada fila. Usa fecha real
YYYY-MM-DDy URL completa. Se admite coma o punto y coma; usa comillas en valores con separadores o saltos de línea. - Carga el CSV y revisa CSV preview:
ready,invalidyduplicate_in_csv. Corrige los mensajes de las filas y vuelve a cargar el archivo antes de confirmar. - Marca la confirmación que comienza I understand that importing creates y pulsa Confirm import (... unique products). La vista previa no guarda.
- Lee Import results:
inserted,duplicateeinvalid. 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.
- Abre el borrador y Evaluación del nicho · Datos del vendedor.
- Completa Nicho / problema del cliente, Categoría de investigación (no taxonomía del marketplace) y Mercado objetivo.
- 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.
- Registra Proveedor, costes y supuestos logísticos y Cumplimiento, elegibilidad y otros riesgos. Pulsa Guardar cambios.
- 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.
- Abre Comparar tus productos.
- Combina Niche / customer problem, Target market, Provenance y Search. La búsqueda compara título, nicho, categoría y mercado.
- Marca Compare en dos o tres tarjetas; el máximo es tres.
- Lee Evidence, Unknowns y procedencia Imported CSV o Seller entry.
- 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.
- Abre Flujo y trabajos, elige la skill de margen y selecciona el producto.
- 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.
- Usa Añadir escenario para comparar hasta cinco escenarios y pulsa Ejecutar skill.
- Lee contribución, porcentaje, precio de equilibrio y Pendiente.
- 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.
- 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).
- 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.
- 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.
- Pulsa Ejecutar prueba local; lee Resultado local, OK o Revisar. Corrige faltantes y repite.
- 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.
- Abre Preparación por canal y lee cada estado.
- En Amazon.es, eBay y Etsy, No conectado y Envío deshabilitado significan preparación local, no publicación.
- En Amazon.es o eBay, abre Configuración de autorización nativa para leer requisitos. Las referencias oficiales no son conexiones.
- Donde figure Solo exportación genérica · Sin adaptador de publicación, utiliza guardado y exportación, no envío.
- 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.
- En Flujo y trabajos, elige Skill · ejecución local, Destino de preparación y Productos guardados. Seleccionar todos (hasta 25) tiene ese límite.
- Completa las entradas de la skill y pulsa Ejecutar skill.
- En Operador del flujo · ejecuciones persistentes, lee estado, pasos y Entradas y supuestos guardados. Abre Resultado completo / pruebas.
- Usa Cancelar trabajo pendiente para detener pasos no ejecutados. Para una interrupción recuperable, selecciona Reanudar / reintentar pasos recuperables.
- 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.
- 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 → kgocm → m. - 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.
- 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.
- 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.
- 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.
- 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. - Fill every required row field. Use a real
YYYY-MM-DDdate and complete URL. Use comma or semicolon consistently; quote values containing separators or line breaks. - Choose the file; inspect CSV preview,
ready,invalidandduplicate_in_csv. Fix messages and reload before confirming. - Tick the acknowledgement starting I understand that importing creates, then Confirm import (... unique products). Preview alone does not save.
- 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.
- Open the draft and Niche assessment · Seller-entered.
- Fill Niche / customer problem, Research category (not marketplace taxonomy) and Target market.
- Add Permitted source URL, Date you observed the source and Demand / competition observations and gaps.
- Record Supplier, costs and fulfillment assumptions and Compliance, eligibility and other risks; select Save changes.
- 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.
- Open Compare your products.
- Combine Niche / customer problem, Target market, Provenance and Search, which matches title, niche, category and market.
- Tick Compare on two or three cards; maximum three.
- Read Evidence, Unknowns, Imported CSV and Seller entry provenance.
- 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.
- In Workflow & jobs, choose the margin skill and saved product.
- 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.
- Use Add scenario for up to five scenarios and Run skill.
- Inspect contribution, percentage, break-even price and Pending.
- 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.
- Open EN + ES draft. Review Listing title, Description, Bullet points, Search keywords (comma separated) and Seller notes in English (EN) and Español (ES).
- 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.
- 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.
- Run offline test and inspect Offline result, OK or Review; correct gaps and repeat.
- 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.
- Open Channel preparation and read each state.
- Amazon.es, eBay and Etsy unconnected/dispatch-disabled states mean local preparation, not publishing.
- For Amazon.es/eBay open Native authorization setup to read requirements. Official references are not connections.
- Generic-export-only destinations without publishing adapters support save/export, not dispatch.
- 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.
- In Workflow & jobs, choose Skill · local execution, Preparation destination and Saved products. Select all (up to 25) enforces that limit.
- Complete inputs and Run skill.
- In Workflow operator · durable runs, inspect state, steps, Retained inputs & assumptions and Full outcome / checks.
- Use Cancel pending work to stop remaining steps and Resume / retry recoverable steps for recoverable interruptions.
- 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.
- Use Load CSV file, Delimiter, Read columns & set mapping, Target field and Cleanup rule: Trim text, Decimal comma → dot,
g → kgorcm → m. - 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.
- 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.
- For Change review, select Retained version to compare against and run. Save/discard editor changes before selecting fields to restore.
- 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.