Centro risoluzione errori
Business Central 429 Too Many Requests: diagnosi e soluzione
Come progettare attese, nuovi tentativi, webhook e code quando Business Central raggiunge i limiti di quota API?
Se una chiamata all'API Dynamics 365 Business Central restituisce 429 Too Many Requests, è stato superato il limite di richieste. Questo, da solo, non indica un problema con la password dell'utente o con i dati del prodotto. La documentazione ufficiale Microsoft raccomanda che il client adotti una strategia controllata di nuovi tentativi quando il volume delle richieste è elevato.
Cause frequenti dell'errore
- Richiedere nuovamente l'intero elenco delle giacenze a ogni schermata.
- Più integrazioni che generano contemporaneamente molte chiamate.
- Controlli eccessivamente frequenti anziché monitorare le modifiche dei dati tramite eventi.
- Inviare ripetutamente l'operazione non riuscita senza attendere.
Soluzione applicabile
1. Misura: Registra quale endpoint e quale integrazione stanno aumentando il numero di chiamate. Collega le operazioni dello stesso cliente.
2. Introduci un tempo di attesa: Usa attese progressive o exponential backoff in base alle risposte del server e alla documentazione pertinente. Aggiungere ritardi casuali ai nuovi tentativi può ridurre il rischio che tutti i client riprendano il carico contemporaneamente.
3. Usa una coda: Inserisci ordini e attività critiche in una coda tracciabile anziché lasciarli soltanto in memoria. Le operazioni ripetute non devono generare ordini duplicati.
4. Lavora sulle modifiche: Valuta le funzionalità webhook di Business Central per le risorse adatte; non scaricare un grande insieme di dati a ogni schermata.
5. Riconcilia: Esegui riconciliazioni periodiche per individuare eventi persi e ordini mancanti.
Esempio di pseudocodice
istek_yap()
429 gelirse:
uygun_bekleme_suresini_belirle()
kuyruga_al_ve_bekle()
islem_kimligini_koruyarak_tekrar_dene()
sinirli_tekrar_sayisi_asildiysa:
insan_incelemesine_gonder()
Criterio di successo
Il risultato da ottenere è un'integrazione che funzioni nelle ore di punta senza perdere ordini, oltre alla riuscita di una singola richiesta. Monitora separatamente il rapporto tra chiamate fallite e riuscite e il ritardo della coda.
Quando interrompere i nuovi tentativi?
Limita il numero di tentativi e il tempo totale di attesa per la stessa attività. Allo scadere, l'operazione non deve andare persa: lo stato fallito/in attesa e la persona responsabile della verifica devono restare visibili. Avviare worker paralleli senza limiti per velocizzare la coda aumenta il carico.
Scenario di esempio: Il trasferimento notturno del catalogo si sovrappone agli ordini mattutini dei rivenditori. Restringi prima il perimetro della query del catalogo e riduci la concorrenza complessiva sullo stesso ambiente. Puoi dare priorità alla coda degli ordini, senza saltare le regole di validazione dei record e prevenzione dei duplicati.
| Controllo di accettazione | Condizione di successo |
|---|---|
| Limite dei tentativi raggiunto | L'attività passa alla verifica umana, senza cicli infiniti |
| Servizio riavviato | Le attività in attesa riprendono da registrazioni persistenti |
| Risposta all'invio persa | Si cerca il riferimento esistente prima di creare un nuovo record |
Per il problema di una singola richiesta troppo lunga, consulta la guida al timeout 504.
Quando chiedere supporto all'amministratore?
Se anche una singola lettura controllata continua a ricevere 429 dopo aver ridotto il ritmo delle richieste, esamina con l'amministratore le altre applicazioni e code che usano lo stesso ambiente. Non cercare di aggirare il limite assegnando casualmente nuove identità all'utente. Contatta l'assistenza del prodotto fornendo l'identificativo dell'errore depurato, l'intervallo temporale, la concorrenza totale e il ritardo della coda.
Fonti e verifica
I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.
Adatta il flusso alla tua azienda
Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo software su misura; possiamo valutare insieme il tuo processo attuale.
Parliamo delle tue esigenze →