ValidateFin
Torna al blog
Stati Uniti10 min di letturaDi Eliel Nicaise

Codici di ritorno ACH: il riferimento completo R01-R85, verificato sulle fonti ufficiali

Esistono ufficialmente esattamente 70 codici di ritorno ACH. Quattro codici pubblicati dal settore non sono affatto codici di ritorno, una definizione ampiamente citata è semplicemente falsa, e un codice reale manca dalla maggior parte degli elenchi. La tabella completa, con il significato di ogni codice e se sia possibile reinviare l'entry.

Che cos'è un codice di ritorno ACH?

Un codice di ritorno ACH è un codice di tre caratteri che la banca ricevente (RDFI) scrive in un record addenda di tipo 99, alle posizioni 4-6, per dire all'originante perché un'entry è stata rispedita indietro. Ne esistono ufficialmente esattamente 70: da R01 a R47, da R50 a R53, R61, R62, da R67 a R77, e da R80 a R85. Codici come R63, R64, R65 e R66 sono pubblicati ovunque sul web ma non sono affatto codici di ritorno — sono i sotto-codici dell'addenda di R69, «Field Error(s)». La domanda a cui un codice risponde davvero è se sia possibile reinviare l'entry: un ritorno non autorizzato (R05, R07, R10, R29, R51) non può essere reinizializzato senza una nuova autorizzazione, mentre R11 — pur essendo un codice non autorizzato — può essere corretto e reinviato.

Valida il tuo file subito

Gratis, istantaneo e 100% nel browser - nessun file viene mai caricato.

Apri il ACH / NACHA Validator

Dove risiede davvero il codice nel file

Un ritorno non è un messaggio che si riceve accanto al pagamento. È un'entry, dentro un file ACH, che porta un record addenda di tipo 99. Il codice si trova alle posizioni 4-6 di quel record da 94 caratteri — ecco perché un ritorno è qualcosa che si analizza, non qualcosa che si legge in una email.

799R01 091000010000001      091000019100001...
 │ │  └── positions 4-6: the return reason code
 │ └───── positions 2-3: addenda type 99 = a return
 └─────── position 1: record type 7 = addenda

Due conseguenze che vengono sbagliate, entrambe costose. Un ritorno è un'entry reale: il denaro torna indietro. Una Notification of Change, addenda di tipo 98, è un'entry a zero dollari: il pagamento è andato a buon fine, e la banca vi sta chiedendo di correggere i vostri dati per la prossima volta. Trattare un NOC come un pagamento fallito e reinviarlo paga due volte la stessa fattura.

E i campi di un ritorno non vengono riscritti. Nacha afferma che ogni campo di un ritorno o di un NOC resta invariato rispetto all'entry originale. Non esiste alcun codice SEC chiamato «RET»; il Company Entry Description non diventa «RETURN» né «SOFTWARE». I file di ritorno reali portano ciò che portava l'originale — «TRANSFER», «Vendor Pay». Un parser che cerca quei marcatori non troverà nulla, e concluderà, a torto, che il file non è un ritorno.

I codici che contano davvero

Su settanta, una manciata rappresenta la stragrande maggioranza dei ritorni — e la Federal Reserve li raggruppa per voi, per nome, nel suo ACH Return Reason Report.

R01 — Insufficient Funds

Il conto è valido e aperto; semplicemente il denaro non c'era al momento della contabilizzazione. Torna indietro entro due giorni lavorativi bancari. È anche uno dei pochi codici che si possono reinizializzare, alle condizioni fissate dalle regole Nacha: Company Name, Company ID e importo identici, e «RETRY PYMT» nel Company Entry Description.

R02, R03, R04 — ciò che la Fed stessa chiama gli Invalid/Admin Returns

Conto chiuso; conto inesistente o impossibile da individuare; numero di conto non valido. Sono problemi di dati, non di denaro: la vostra registrazione del conto del cliente è errata, e reinviare la stessa entry fallirà allo stesso modo. Correggete il mandato, non i tempi.

R05, R07, R10, R11, R29, R51 — il gruppo Unauthorized Returns della Fed

È il gruppo che comporta un rischio regolamentare, perché un tasso di ritorni non autorizzati superiore alla soglia Nacha mette in gioco la vostra capacità di originare. È anche il gruppo in cui reinizializzare non è un nuovo tentativo ma una violazione delle regole — con la sola eccezione di R11, qui sotto.

R14 e R15 — un decesso

Il rappresentante del beneficiario o il titolare del conto è deceduto. Sono i due soli codici che portano una Date of Death, alle posizioni 22-27 dell'addenda 99. Su ogni altro codice di ritorno quel campo è vuoto — e un parser che lo legga comunque produrrà una data dal nulla.

I miti — e uno di essi era nostro

Questa sezione esiste perché i contenuti gratuiti sui codici di ritorno ACH sono, in alcuni punti, semplicemente falsi, e gli errori vengono ripetuti da società di pagamento grandi e rispettabili. Abbiamo riverificato tutti e settanta i codici sulla guida di mapping ISO 20022 di Nacha, sull'ACH Return Reason Report della Federal Reserve e sul Green Book del Tesoro statunitense. Quattro constatazioni.

R63, R64, R65 e R66 non sono codici di ritorno

L'elenco ufficiale passa da R62 direttamente a R67 — tanto nella guida di Nacha quanto nel report della Fed. Ciò che viene pubblicato come «R63 — Incorrect Dollar Amount» è in realtà il sotto-codice 03 dell'addenda di R69, così come lo stampa il Green Book. Se avete costruito una tabella di lookup dalla pagina di un fornitore, contiene quattro codici che non arriveranno mai, e le manca il meccanismo che li produce.

R11 non è un «Checksum Abbreviation Error»

La pagina pubblica di Stripe dice che lo è. È falso, e ribalta il consiglio. R11 significa che il cliente dichiara che l'addebito non era conforme ai termini dell'autorizzazione — importo errato, addebito troppo anticipato. Dal 2020 è l'unico codice non autorizzato che si può correggere: correggete l'errore di fondo e inviate una nuova entry entro 60 giorni dalla data di regolamento del ritorno, senza bisogno di una nuova autorizzazione.

R85 non è un codice IAT

Da R80 a R84 si applicano alle entry IAT in uscita. L'ambito di R85, nella tabella stessa di Nacha, è ogni codice SEC TRANNE IAT: si tratta di un'entry codificata come domestica che il gateway riconosce come un pagamento internazionale in uscita, che avrebbe dovuto essere un IAT fin dall'inizio. Mettere R80-R85 nello stesso mucchio come «i codici IAT» capovolge proprio quello che conta.

R44 esiste — e qui gli sbagliati eravamo noi

«Invalid Individual ID Number», per le entry ENR. È nella guida di Nacha e nel report della Fed. Lo avevamo deliberatamente escluso da questo sito, perché le pagine dei fornitori da cui l'avevamo tratto si contraddicevano tra loro — abbiamo scambiato l'assenza di una fonte affidabile per l'assenza di un codice. Ora è pubblicato, e questa pagina esiste anche per dirlo.

R69, «Field Error(s)», non nomina il campo difettoso nel codice. Lo nomina nell'addenda, come sotto-codice a due cifre — e questo elenco è l'intera ragione per cui R63-R66 sembrano reali a chiunque li abbia visti fuori contesto (fonte: Green Book, di pubblico dominio):

  • 01Return contains incorrect DFI Account Number
  • 02Return contains incorrect Original Entry Trace Number
  • 03Return contains incorrect dollar amount
  • 04Return contains incorrect Individual Identification Number / Identification Number
  • 05Return contains incorrect Transaction Code
  • 06Return contains incorrect Company Identification Number
  • 07Return contains an invalid Effective Entry Date

Tutti i 70 codici di ritorno ACH

Raggruppati per argomento, i più frequenti per primi. Ogni codice rimanda alla sua pagina: cosa significa, cosa lo provoca, la finestra di ritorno quando una fonte ufficiale la indica, e se sia possibile reinviare l'entry. Questa tabella è generata dagli stessi dati che usa il nostro validatore, quindi non può divergere dallo strumento.

Codici che non esistono, qualunque cosa dica un risultato di ricerca: R48, R49, da R54 a R60, da R63 a R66, R78, R79, e tutto ciò che sta oltre R85. Un codice nuovo è in arrivo: R90, «Entry Returned Due to RDFI's Sanctions Compliance Obligations», entra in vigore il 17 marzo 2028 — e lo stesso giorno R16 perde la sua metà OFAC e torna a significare soltanto «Account Frozen».

Cosa fare quando arriva un ritorno

Nell'ordine. I primi due passi richiedono un minuto, e sono i due che evitano gli errori costosi.

  1. 1Leggete le posizioni 4-6 dell'addenda 99. Quello è il codice — non l'etichetta che il portale della vostra banca ha deciso di appiccicargli.
  2. 2Ponetevi l'unica domanda che conta davvero: è un ritorno non autorizzato? R05, R07, R10, R29 e R51 non possono essere reinizializzati. Reinviare l'entry non è un nuovo tentativo, è una violazione delle regole.
  3. 3Se è R11, potete correggere e reinviare — entro 60 giorni dalla data di regolamento del ritorno, senza nuova autorizzazione. È l'eccezione alla regola precedente, e vale denaro vero.
  4. 4Se è R69, aprite l'addenda. Il sotto-codice a due cifre vi dice quale campo l'ODFI considera errato, e sono sette.
  5. 5Se è R01 o R09, la reinizializzazione è consentita dalle regole Nacha: Company Name, Company ID e importo devono essere identici, e «RETRY PYMT» deve comparire nel Company Entry Description. Le regole limitano anche quante volte e per quanto tempo — quelle cifre esatte sono pubblicate solo nel rulebook a pagamento, e non citiamo numeri che non possiamo documentare.

Poi validate il file corretto prima di inviarlo. Un secondo ritorno sulla stessa entry non è gratuito, e sui codici non autorizzati non è nemmeno consentito.

Validate un file ACH prima che torni indietro

Trascinate un file NACHA nel validatore: struttura dei record, check digit ABA, entry hash, totali di controllo di batch e di file — e le addenda decodificate, inclusi i ritorni (99), le notifiche di modifica (98) e l'IAT (da 10 a 18). Funziona interamente nel vostro browser; il file non lascia mai la vostra macchina.

Apri il validatore ACH

Fonti ufficiali — e ciò che ci rifiutiamo di dire

Il libro delle Nacha Operating Rules è protetto da copyright e viene venduto. Non lo abbiamo acquistato e non ne riproduciamo il testo. Tutto ciò che sta in questa pagina è verificato su pubblicazioni ufficiali gratuite: la guida di mapping ISO 20022 di Nacha, che riporta la tabella completa dei codici; l'ACH Return Reason Report della Federal Reserve, che elenca i codici che elabora con e senza attività — ed è ciò che lo rende decisivo su quali codici esistano; e il Green Book del Tesoro statunitense, che è di pubblico dominio. Dove solo il rulebook a pagamento indica un numero — le finestre dei ritorni respinti (dishonored) e contestati (contested), i limiti esatti di reinizializzazione — questa pagina dice che la regola esiste e non inventa la cifra.

Domande frequenti

Quanti codici di ritorno ACH esistono?

Settanta. Da R01 a R47, da R50 a R53, R61, R62, da R67 a R77, e da R80 a R85. La guida di mapping ISO 20022 di Nacha e l'ACH Return Reason Report della Federal Reserve elencano lo stesso insieme, e il report della Fed è decisivo perché enumera i codici che elabora con e senza attività — un codice che vi manca è un codice che non esiste.

R63 è un vero codice di ritorno ACH?

No. E non lo sono nemmeno R64, R65 e R66. L'elenco ufficiale passa da R62 direttamente a R67. Ciò che altrove viene pubblicato come «R63 — Incorrect Dollar Amount» è il sotto-codice 03 dell'addenda associata a R69, «Field Error(s)». La confusione è comprensibile — l'elenco dei sotto-codici si legge esattamente come un elenco di codici di ritorno — ma un R63 non arriverà mai nel vostro file.

Qual è la differenza tra R10 e R11?

Sono entrambi ritorni non autorizzati ed entrambi hanno una finestra di 60 giorni. R10 significa che il cliente dichiara che l'addebito non era affatto autorizzato. R11 significa che il cliente dichiara che l'addebito non ha rispettato i termini di un'autorizzazione che invece esiste — un importo errato, un addebito preso troppo presto. La differenza pratica è decisiva: con R11 potete correggere l'errore e inviare una nuova entry entro 60 giorni dalla data di regolamento del ritorno, senza ottenere una nuova autorizzazione. Con R10 non potete.

Posso reinviare un'entry che è stata restituita?

Dipende interamente dal codice. R01 e R09 (fondi) possono essere reinizializzati secondo le regole Nacha, con Company Name, Company ID e importo identici e «RETRY PYMT» nel Company Entry Description. I codici non autorizzati — R05, R07, R10, R29, R51 — no: richiedono una nuova autorizzazione, e reinviare è una violazione delle regole. R11 è l'eccezione: correggete e reinviate entro 60 giorni, senza nuova autorizzazione.

Dove si trova il codice di ritorno in un file ACH?

In un record addenda di tipo 99, alle posizioni 4-6 del record da 94 caratteri. La posizione 1 è il tipo di record («7» per un'addenda), le posizioni 2 e 3 sono il codice di tipo addenda («99» per un ritorno). Le posizioni 22-27 contengono una Date of Death, ma solo su R14 e R15 — su qualsiasi altro codice quel campo è vuoto.

Qual è la differenza tra un ritorno e una Notification of Change?

Un ritorno (addenda 99) rimanda indietro il denaro: il pagamento è fallito. Una Notification of Change (addenda 98) è un'entry a zero dollari: il pagamento è riuscito, e la banca ricevente vi sta dicendo che alcuni dei vostri dati — un numero di conto, un routing number, un codice di transazione — devono essere corretti per la prossima volta. Reinviare un NOC come pagamento paga due volte la stessa fattura.

Quanto tempo ha una banca per restituire un'entry ACH?

Due giorni lavorativi bancari è la norma amministrativa: il Green Book stabilisce che un ritorno deve essere ricevuto entro l'apertura del secondo giorno lavorativo bancario successivo alla data di regolamento dell'entry originale. Gli addebiti non autorizzati dei consumatori hanno una finestra estesa di 60 giorni di calendario. Le finestre esatte per i ritorni respinti (dishonored) e contestati (contested) sono pubblicate solo nel rulebook Nacha a pagamento — non citiamo cifre che non possiamo documentare, e R68 «Untimely Return» e R72 «Untimely Dishonored Return» esistono proprio per sanzionare una scadenza mancata.

Sta arrivando un nuovo codice di ritorno ACH?

Sì. R90, «Entry Returned Due to RDFI's Sanctions Compliance Obligations», entra in vigore il 17 marzo 2028. Lo stesso giorno, R16 perde la metà OFAC del suo significato e torna a essere soltanto «Account Frozen». Nessuno dei due cambiamenti è attivo oggi, e R90 non esiste ancora nella rete.