> ## 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.

# Crear, revisar y eliminar coincidencias

> Crear enlaces, rechazar o actualizar revisiones y eliminar coincidencias mediante una clave API.

Todas las solicitudes utilizan `Authorization: Bearer $RETAILGRID_API_KEY`. Las escrituras requieren un UUID en `Idempotency-Key`. Reutilícelo con la misma solicitud si se pierde la respuesta. Cambiar el contenido con la misma clave, actor y operación devuelve `409`.

## Leer antes de decidir

Consulte [`GET /v1/matching/matches`](https://docs.retailgrid.io/es/api-reference/matching/list-matches) para obtener `match_id`, `version`, `review.revision` y `review.evidence`. Estos valores protegen contra cambios simultáneos. No sustituya automáticamente los valores después de un conflicto.

## Rechazar o actualizar revisiones

`POST /v1/matching/matches:batch-decide` acepta `decisions`, una lista de 1 a 500 identificadores únicos, con las acciones `approve`, `reject`, `reopen` o `rematch`.

```json theme={null}
{
  "decisions": [{
    "match_id": "m1_example", "version": 1, "revision": 0,
    "evidence": "0123456789abcdef0123456789abcdef",
    "action": "reject", "note": "Producto incorrecto"
  }]
}
```

El rechazo sigue visible con `review.status = rejected` y el actor del propietario de la clave API. Deja de alimentar las cuadrículas en su próxima actualización. Para corregir la clasificación, apruebe con `relation: "direct"` o `"substitute"`. Para sustituir un enlace, use `rematch` y `replacement: {rg_item_id, competitor_product_id, relation}`. Reabra una coincidencia rechazada antes de aprobarla o sustituirla.

## Eliminar coincidencias

`POST /v1/matching/matches:batch-remove` requiere una versión positiva para cada uno de los 1 a 500 identificadores únicos:

```json theme={null}
{
  "match_ids": ["m1_example"],
  "expected_versions": {"m1_example": 1}
}
```

La eliminación oculta la coincidencia en las lecturas públicas y deja de alimentar las cuadrículas. Conserva el historial. Los procesos automáticos y las instantáneas normales respetan la eliminación. Para restaurarla, añada o reabra explícitamente el enlace.

Los lotes de revisión y eliminación devuelven `200`, `external_org_id`, `request_id`, `results` ordenados y `changed_item_ids`. Cada resultado contiene `index`, `match_id`, `outcome`, y opcionalmente `result_match_id` y `code`. Los resultados son `decided`, `removed`, `already_removed` o `error`. Los identificadores desconocidos y de otras organizaciones devuelven el mismo código `resource_unavailable`; las versiones o evidencias obsoletas, `match_version_conflict`. Los elementos válidos se procesan de forma independiente. Un reintento exacto reproduce todos los resultados originales, incluidos los errores. Una interrupción del servicio o de la base de datos revierte la transacción.

Los duplicados, versiones ausentes, solicitudes mal formadas o listas de más de 500 elementos devuelven `422` antes de escribir. Una clave API ausente o inválida devuelve `401`; la ausencia de `Idempotency-Key`, `422`. Tras corregir un conflicto intencionalmente, use una clave nueva.

## Crear enlaces y buscar productos de competidores

`GET /v1/matching/competitor-products` admite `query`, `competitor`, `availability` y `cursor`. Siga `next_cursor` mientras `has_more` sea verdadero. Utilice el `competitor_product_id` devuelto; un SKU o URL no lo sustituye.

`POST /v1/matching/matches:batch-add` acepta de 1 a 500 pares únicos:

```json theme={null}
{
  "pairs": [{"rg_item_id": "SKU-1", "competitor_product_id": "listing-id", "relation": "direct"}]
}
```

Las relaciones son `direct` o `substitute`. Los resultados son `created`, `restored` o `unchanged`. La adición conserva el contrato **atómico**: un recurso no disponible o un conflicto de relación rechaza todo el lote. Para cambiar una relación existente, utilice una decisión de revisión.


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