Errores y reintentos seguros

Consulta la operación y verifica cuenta, autoridad, revisión y mapeo antes de continuar.

La operación tiene una concesión vigente. Respeta Retry-After y vuelve a consultar su estado.

Otra operación ocupa el mismo artículo fuente. Respeta Retry-After sin cambiar la identidad del pedido.

Vuelve a leer la versión de la operación antes de solicitar una nueva concesión.

La concesión venció o cambió. Vuelve a consultar la operación y conserva cualquier comando incierto.

Consulta el recibo del comando original. Un recibo ausente nunca autoriza a repetir el débito.

Verifica el SHA-256 y envía una imagen JPEG, PNG o WebP válida, de un solo cuadro y hasta 16 megapíxeles.

Reduce la imagen: tanto el archivo original como la salida normalizada deben medir hasta 2 MiB.

La tienda alcanzó su presupuesto de 256 MiB o 1000 imágenes, incluidas cargas pendientes. Contacta a Moku antes de agregar más; reintentar el mismo contenido no consume otra admisión.

Detén escrituras, liquida reservas y pedidos pendientes, vuelve a leer la autoridad y reintenta el reemplazo de roles.

Vuelve a leer la conexión o conflicto y reintenta con su versión actual.

Conserva las líneas comerciales originales; corrige el pedido en el sistema fuente mediante una operación compatible.

No reutilices una versión fuente para contenido diferente; envía una nueva versión y timestamp.

Descarta la observación antigua y continúa desde el último source_updated_at aceptado.

No intentes reabrir un pedido terminal; consulta su estado y crea un pedido distinto si corresponde.

Resuelve primero terminal-resolution con la versión actual del pedido externo.

Detén fulfillment y completa la revisión terminal antes de avanzar.

Vuelve a leer el pedido y aplica solo la siguiente transición monotónica permitida.

Vuelve a leer fulfillment y reintenta con expected_version actualizado.

Usa una clave nueva para trabajo distinto; conserva la clave original solo para un replay idéntico.

Crea o usa un PAT con el bundle requerido para el endpoint.

Registra request_id y contacta soporte; verifica el estado antes de repetir una escritura.

Usa sin modificar el next_cursor de la página anterior y con el mismo recurso y filtros.

Corrige cuerpo, parámetros o cabeceras conforme al esquema OpenAPI; no repitas la misma solicitud.

Vuelve a leer el item, recalcula target_on_hand y reintenta con una clave nueva.

Actualiza disponibilidad y reduce o elimina las unidades que ya no pueden reservarse.

Vuelve a leer el listing y corrige identidad, estado o versión fuente antes de reintentar.

No bajes on_hand por debajo de reserved; libera compromisos o usa una cantidad mayor.

Vuelve a leer el producto, fusiona cambios y reintenta con expected_revision actualizado.

Elige otro slug estable para el vendedor.

Vuelve a leer el producto y usa una transición válida para su estado actual.

Espera Retry-After, agrega jitter y reduce concurrencia por PAT.

Vuelve a leer la reserva y no mezcles comandos de pedido externo con comandos públicos.

Crea una reserva nueva después de refrescar disponibilidad.

Cambia el estado mediante external-orders; no renueves, consumas ni liberes la reserva directamente.

Verifica el ID y el vendor concedido al PAT; Moku no revela recursos de otro vendedor.

Reintenta con backoff; para una escritura idéntica conserva la misma Idempotency-Key y verifica el estado.

Envía un PAT válido, no vencido ni revocado en Authorization: Bearer.