# Errores, reintentos y operación

Distingue un conflicto de revisión, una credencial rechazada y un resultado incierto antes de reintentar.

Página: https://zoydelivery.com/docs/operacion

## Qué hacer ante un error

| Respuesta | Acción |
| --- | --- |
| 400 / entrada inválida | Corrige campos, tipo de archivo o argumentos. En preview, inspecciona también errors por fila. |
| 401 | Comprueba clave, vencimiento, revocación y permiso actual del propietario. |
| 403 | Revisa escritura, origen HTTP o acceso al negocio. No cambies de credencial para eludir el rechazo. |
| 404 | Comprueba endpoint, ID y negocio autorizado. Un recurso de otro tenant no está disponible. |
| 409 / revisión o moneda | Vuelve a leer y crea un preview nuevo. No cambies solo expectedRevision para forzar la aplicación. |
| 409 / idempotencia | La misma clave ya identifica otro cuerpo. Recupera el intento original y determina si se aplicó. |
| 413 | Reduce archivo, páginas, filas o tamaño del documento preparado. |
| 429 | Respeta Retry-After si está presente y aplica backoff; no uses bucles agresivos. |
| 503 / proveedor IA | Revisa configuración o disponibilidad del proveedor. Conserva checkpoints y reanuda si el trabajo lo permite. |

En MCP un fallo puede llegar con result.isError y un contenido JSON que incluye status/error, aunque la respuesta HTTP del transporte sea 200. Inspecciona el resultado de la herramienta; no interpretes solo el status del transporte como éxito de negocio.

## Timeout no significa que no se aplicó

1. Conserva importId, expectedRevision, cuerpo y clave de idempotencia del intento.
2. Consulta import_get: si hay resultado persistido, comprueba los productos y utiliza ese recibo.
3. Si necesitas repetir apply, usa exactamente el mismo cuerpo y clave. Una clave nueva no es una estrategia de recuperación.
4. Un plan vence a las 24 horas. Si no se aplicó y venció, vuelve a leer y revisar una propuesta nueva.

## Añadir un POS o administrativo

Mantén un mapeo versionado por proveedor: código, moneda, precio/costo, impuestos, variantes, ingredientes y política de existencias. Prueba primero un lote pequeño, verifica persistencia y repite el mismo intento para comprobar que no duplica.

> **Un export no es una conexión activa**
>
> El MCP es agnóstico del proveedor, pero una sincronización automática con PosAndTouch, A2 u otro sistema sigue necesitando su API/export autorizado y un adaptador. No se anuncia un conector instalado ni acceso a un proveedor por tener su documentación.

- [Volver al ciclo de importación](https://zoydelivery.com/docs/importar-documentos)
- [Reglas del catálogo](https://zoydelivery.com/docs/catalogo)