> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retailgrid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Matching de competidores

> Valida el último escaneo de competidores antes de fijar precios a partir de él: cobertura, calidad de las coincidencias, puntos ciegos y coherencia de precios.

El **matching de competidores** es donde revisas un escaneo de competidores antes de confiar en él. Ábrelo desde la barra lateral izquierda. La página lee una sola cosa: el último escaneo publicado para tu organización, con el rango de fechas observado en el subtítulo.

![Matching de competidores: las cifras principales y la pestaña Coverage](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/price-monitoring/competitor-matching.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=27a7ffa6b43439d8e6fc5107ae22915c)

## Por qué validar primero un escaneo

Los precios de competidores alimentan tus reglas de Price Match, tu CPI y todas las métricas de brecha frente a competidores. Un escaneo con cobertura escasa o coincidencias erróneas mueve los precios sin hacer ruido, y es difícil detectarlo después. Validar lleva unos minutos y es más barato que deshacer una mala revisión de precios.

Recorre esta página cada vez que llegue un escaneo nuevo y antes de cualquier pasada de precios que se apoye en datos de competidores.

## Las cifras principales

Seis mosaicos en la parte superior te dicen sobre qué parte de tu catálogo el escaneo puede sustentar realmente una decisión:

| Mosaico | Qué cuenta |
| :- | :- |
| **Catalog SKUs** | El tamaño de tu maestro de productos, como denominador de todo lo demás. |
| **SKUs with a competitor price** | A qué parte del catálogo llegó el escaneo, y cuánta sigue sin nada. |
| **Competitor price points** | Total de observaciones emparejadas y número medio de competidores por SKU cubierto. |
| **Repricing-ready SKUs** | Coincidencias directas con confianza alta. Este es el conjunto sobre el que realmente puedes revisar precios. |
| **SKUs needing review** | La mejor coincidencia está por debajo del umbral de confianza. Conviene revisarlas antes de confiar en ellas. |
| **SKUs with no match** | Sin ningún precio de competidor. La pestaña **Blind spots** las desglosa. |

La diferencia entre **SKUs with a competitor price** y **Repricing-ready SKUs** es el número que hay que vigilar. La cobertura te dice que el escaneo encontró algo; las listas para revisión de precios te dicen que encontró algo sobre lo que puedes fijar precios.

## Filtra el escaneo

Cuatro filtros ocupan la parte superior de la página:

| Filtro | A qué reduce |
| :- | :- |
| **Products** | Solo productos activos, o todo tu catálogo. |
| **Cost** | Filas con un costo unitario mayor que cero. |
| **Price** | Filas con un precio de venta mayor que cero. |
| **Stock** | Filas con stock mayor que cero. |

Los filtros son globales para la página. Todas las cifras y la tabla de filas se calculan a partir de la misma pasada filtrada sobre el escaneo, así que dos pestañas nunca pueden mostrarte respuestas contradictorias.

Empieza sin filtros para ver el escaneo en bruto. Reduce a productos activos, con stock y con precio cuando quieras la vista que coincide con lo que realmente vendes.

## Coverage: a qué parte del catálogo se llegó

* **Overall catalog coverage** (cobertura general del catálogo): la proporción de SKUs con al menos un precio de competidor. La cobertura se cuenta por SKU, no por coincidencia: un producto encontrado en cuatro vendedores es un único SKU cubierto.
* **Coverage by competitor** (cobertura por competidor): el alcance de cada competidor en todo el catálogo, con la proporción de sus coincidencias que son directas y su confianza media. Ordena por **Highest**, **Lowest** o **Size**. Estas barras no suman la cobertura general, porque un mismo SKU puede encontrarse en varios vendedores.
* **Comparison depth** (profundidad de comparación): cuántos competidores tiene cada SKU cubierto. Este es el mosaico que te dice si tienes un precio de mercado o solo un dato. Un competidor basta para detectar una brecha; tres o más es la franja en la que una decisión de precios puede apoyarse.

## Match quality: cuánto confiar en las coincidencias

![Matching de competidores: la pestaña Match quality](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/price-monitoring/match-quality.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=a09c1dcd2403af5cd96d4b381b61d6b1)

* **Confidence distribution** (distribución de confianza): cada coincidencia agrupada según la seguridad del emparejador, en franjas (menos de 70, 70-79, 80-89, 90-94, 95 o más). Las franjas son las del propio emparejador, así que una barra significa lo mismo aquí que en el archivo entregado.
* **Direct vs substitute** (directa frente a sustituta): si el precio corresponde al mismo producto (**Direct**) o a un análogo que simplemente cumple la misma función (**Substitute**). Revisar precios a partir de un sustituto conlleva un riesgo que una coincidencia directa no tiene. Comprueba este número antes de considerar la cobertura como utilizable.
* **Matches by method** (coincidencias por método): la proporción de cada método de matching que supera la confianza alta: `barcode`, `manufacturer_code`, `fuzzy` y `llm`. Las coincidencias por código de barras y por código de fabricante son casi seguras y suelen ser escasas; las coincidencias fuzzy y LLM son abundantes y necesitan la comprobación de confianza. En mercados donde pocos productos llevan código de barras, espera que el volumen se concentre en los métodos de menor precisión.

## Blind spots: dónde no tienes nada

![Matching de competidores: la pestaña Blind spots](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/price-monitoring/blind-spots.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=71d9fc628264fc3ae41cdf43b822641d)

* **Where the risk sits** (dónde está el riesgo): el catálogo ordenado según lo que se puede hacer con él: sin ningún precio de competidor, solo coincidencias sustitutas, un único competidor, mejor coincidencia por debajo del umbral de confianza, y coincidencias directas con confianza alta. Cada franja se mide frente a todo el catálogo y un SKU puede aparecer en más de una, así que las franjas no suman el 100 %.
* **Category blind spots** (puntos ciegos por categoría): los departamentos peor cubiertos, clasificados según lo que vale la pena atender. Se excluyen los departamentos con menos de cien SKUs: un producto sin cubrir de cada tres se lee como 0 % de cobertura y encabezaría la lista sin costar nada.
* **Manufacturer blind spots** (puntos ciegos por fabricante): marcas y gamas que tus competidores apenas tienen.

Usa esta pestaña para decidir hacia dónde dirigir el próximo escaneo, no para juzgar el actual.

## Price sanity: detectar coincidencias erróneas a través de sus precios

![Matching de competidores: la pestaña Price sanity](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/price-monitoring/price-sanity.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=080662db16fc15684c60b2cf4bb2fbb3)

Una comprobación de precios es también una comprobación de matching. Los productos cuyos precios difieren diez veces rara vez son el mismo producto, así que las colas son donde afloran las coincidencias erróneas.

* **CPI distribution** (distribución del CPI): el precio del competidor dividido entre el tuyo, en intervalos desde menos de 0.50 hasta más de 2.00. Un escaneo sano se agrupa en torno a 1.00. Mira primero las colas.
* **Is the unit comparable?** (¿es comparable la unidad?): si ambas partes venden la misma cantidad. Promediar un paquete de cinco frente a una unidad suelta produce un número que parece una brecha de precio y en realidad es un error de unidades. Solo los paquetes comparables alimentan la distribución del CPI anterior.
* **Median CPI by competitor** (CPI mediano por competidor): quién es sistemáticamente más barato y por cuánto. Una mediana lejos de 1.00 merece una segunda mirada a las coincidencias de ese competidor antes de leerla como una posición de precios.

## All matches: las filas detrás de las cifras

![Matching de competidores: la pestaña All matches](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/price-monitoring/all-matches.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=dc8075297a138100187e86f372e5088f)

La tabla a nivel de fila, una fila por coincidencia:

| Columna | Qué muestra |
| :- | :- |
| **SKU** | Tu identificador del producto. |
| **Our product** | El nombre de tu producto. |
| **Competitor** | De qué competidor procede el precio. |
| **Their listing** | El título de producto del propio competidor, para que puedas juzgar la coincidencia a simple vista. |
| **Confidence** | La seguridad del emparejador. |
| **Type** | `Direct` o `Substitute`. |
| **Method** | Qué método produjo la coincidencia. |
| **Their price** | El precio del competidor. |
| **CPI** | Su precio dividido entre el tuyo. |
| **Unit** | Si los tamaños de paquete son comparables. |

Busca por SKU, producto o competidor, y filtra por un único competidor. Ambas operaciones se ejecutan en el servidor, así que la respuesta se mantiene acotada en un escaneo con decenas de miles de filas. Las páginas tienen un máximo de 200 filas.

Esta es la pestaña que debes abrir cuando una cifra de arriba parece incorrecta. Busca entre los valores extremos del CPI y lee los listados: una coincidencia errónea suele ser evidente cuando ves el título del propio competidor junto al tuyo.

## Lee los estados vacíos con honestidad

La página distingue dos situaciones que requieren reacciones opuestas por tu parte:

* **Nada publicado todavía.** No se ha entregado ningún escaneo para tu organización. La página lo dice en lugar de dibujar un dashboard de ceros, porque los ceros serían indistinguibles de un catálogo que nadie ha emparejado.
* **No se pudo cargar el escaneo.** La fuente detrás del escaneo no estaba accesible. Eso es un incidente, no una cuenta vacía. Vuelve a intentarlo y, si persiste, contáctanos a través del mensajero de la aplicación.

## Publica un escaneo nuevo

**Update** publica un escaneo nuevo y sustituye al actual. Puedes darle un archivo ya **emparejado** (cada fila ya lleva el `item_id` al que pertenece) o una **exportación de competidor en bruto**, que Price Radar empareja con tu catálogo por ti antes de publicarla, de modo que ya no tienes que vincular las filas tú mismo primero.

Una entrega conlleva tres decisiones:

* **Coverage** (cobertura): si el archivo es un barrido **completo** de tu catálogo o uno **parcial**. Esto decide qué puede retirar la entrega.
* **Covered competitors** (competidores cubiertos): en una entrega parcial, de qué competidores habla el archivo. Los competidores fuera de esa lista conservan sus precios existentes.
* **Allow large removal** (permitir eliminación masiva): una confirmación explícita, obligatoria cuando la entrega retiraría una proporción inusualmente grande de las coincidencias existentes. Existe para que un archivo truncado no pueda borrar en silencio tu conjunto de competidores.

La conversión, la validación y la publicación se ejecutan en segundo plano, así que la página sigue respondiendo mientras se procesa un archivo grande. Puedes seguir el progreso en la página mientras se ejecuta.

Para actualizar los mismos datos de Price Radar desde un scraper o una integración, usa la [API de matching](https://docs.retailgrid.io/es/api-reference/matching/overview.md). Envía un CSV en bruto o ya emparejado con una clave de la API pública y luego consulta su trabajo de publicación para ver el progreso, los recuentos y las filas rechazadas. Las cargas por API y desde la aplicación comparten el escaneo publicado y los controles de cobertura de la organización.

## Errores comunes

* **Leer la cobertura como preparación.** Una cifra de cobertura alta en la que la mayoría de los SKUs se apoyan en un único competidor no es un precio de mercado. Comprueba **Comparison depth** antes de actuar.
* **Ignorar el recuento de sustitutos.** Una coincidencia sustituta es un producto distinto. Tratarla como directa es la forma en que un precio acaba anclado al artículo equivocado.
* **Confiar en un competidor cuyo CPI mediano está lejos de 1.00.** Eso suele significar que sus coincidencias son erróneas, no que sea barato.
* **Las cifras de validación son de solo lectura.** Las pestañas de cobertura, calidad y coherencia de precios resumen la última entrega y la siguiente las sustituye por completo. Corrige los datos de origen o el matching, no estos mosaicos. Para corregir coincidencias individuales, usa el espacio de trabajo **Review matches** (consulta [Revisar y aprobar coincidencias de competidores](https://docs.retailgrid.io/es/price-monitoring/review-matches.md)), donde las aprobaciones, los rechazos y los reemparejamientos se conservan.
* **Una entrega a la vez.** Se rechaza una segunda publicación mientras ya hay una en curso para tu organización. Espera a que termine la primera en lugar de reintentar.
* **Una entrega parcial que no nombra competidores** no retira nada y solo añade lo que contiene. Nombra los competidores que cubre el archivo para que se limpien las coincidencias obsoletas de esos competidores.

## Relacionado

* [Price Monitoring](https://docs.retailgrid.io/es/agents/price-monitoring.md): descubre precios de competidores con búsqueda por IA
* [Revisar y aprobar coincidencias de competidores](https://docs.retailgrid.io/es/price-monitoring/review-matches.md): aprueba, rechaza y vuelve a emparejar el último escaneo
* [Especificación de datos de precios de competidores](https://docs.retailgrid.io/es/data-requirements/competitors.md)
* [Asignar competidores a tiendas, zonas y canales](https://docs.retailgrid.io/es/stores/assign-competitors.md)
* [Dashboard Competitive Position](https://docs.retailgrid.io/es/dashboards/competitive-position.md)
* [Glosario de métricas](https://docs.retailgrid.io/es/reference/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.