Fulfillment Nutra · Centro assistenza

Errors and retry

The real minimum shape is { error: string }; some validations add code. No specific public rate limit is documented because these V1 handlers configure none.

Errors and retry

HTTP	Cause	Action
400	Invalid body, address, or idempotency key.	Correct it; do not retry unchanged.
401	Invalid/revoked key or missing scope.	Replace the key or scope.
403	Required profile, plan, or label not authorized.	Correct the named prerequisite.
404	Product not found.	Read the authorized catalog again.
405	HTTP method not allowed.	Use the documented method.
422	Quantity, destination, product, or shipping not eligible.	Correct it; do not retry blindly.
500/503	Temporary failure or ordering disabled.	Keep the same key, wait, then retry with backoff; first check order state.

The real minimum shape is { error: string }; some validations add code. No specific public rate limit is documented because these V1 handlers configure none.

Guida di validazione

Usa questa risposta in un flusso operativo reale

“Errors and retry” fa parte della raccolta “REST API V1”. Usa questa risposta come quadro operativo e verifica i dati attuali di account, prodotto, mercato o negozio prima di effettuare una modifica difficile da annullare. Il riepilogo operativo da tenere presente è: The real minimum shape is { error: string }; some validations add code. No specific public rate limit is documented because these V1 handlers configure none.

Prima di modificare qualsiasi cosa

Individua la fonte dati autorevole e registra lo stato attuale. Una configurazione deve essere collegata all'account, SKU, negozio o ordine corretti. Evita di modificare più variabili contemporaneamente: rende la diagnosi più difficile e può nascondere la causa reale del problema.

Verifica l'identificativo di account, negozio, SKU o ordine.
Conferma mercato, valuta, stato del pagamento e destinazione quando pertinenti.
Conserva lo stato iniziale prima di una modifica importante.

Testa su un perimetro ridotto

Se l'argomento riguarda un'integrazione, un ordine, una pubblicazione o un'impostazione operativa, esegui prima un test controllato. Usa un solo prodotto, ordine o negozio quando possibile. Verifica poi il risultato in entrambi i sistemi coinvolti senza affidarti soltanto al messaggio di successo visualizzato.

Definisci il risultato atteso prima del test.
Controlla gli stati a monte e a valle dopo l'azione.
Estendi la modifica solo dopo un test riproducibile.

Conserva le prove utili

Una cronologia chiara riduce i tempi di risoluzione. Conserva identificativi, orario del test, screenshot utili, messaggi di errore esatti e risultato osservato. Per questioni di prodotto o conformità registra anche mercato, versione del documento, lotto o file utilizzato.

Data e ora del test.
Identificativi e stati pertinenti.
Screenshot o messaggio di errore esatto in caso di discrepanza.

Quando contattare il supporto

Apri un'escalation quando il comportamento reale non corrisponde alla guida, manca un'autorizzazione o un dato previsto, uno stato rimane bloccato dopo le verifiche oppure un'azione può produrre conseguenze finanziarie, normative o logistiche difficili da annullare. Invia subito contesto e prove raccolte.

← Centro assistenza