Errores, reintentos y operación
Distingue un conflicto de revisión, una credencial rechazada y un resultado incierto antes de reintentar.
Servidor 1.0 · MCP 2025-11-25 · Claves Bearer por negocio
En esta página
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ó
- Conserva importId, expectedRevision, cuerpo y clave de idempotencia del intento.
- Consulta import_get: si hay resultado persistido, comprueba los productos y utiliza ese recibo.
- Si necesitas repetir apply, usa exactamente el mismo cuerpo y clave. Una clave nueva no es una estrategia de recuperación.
- 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.