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?

Codariva ·

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 →