Amex
In questa pagina
American Express elabora transazioni di carte sulla propria rete e rapporti su di loro attraverso i file, non un API. Questo connettore è consegna file batch solo: Amex scrive rapporti GRRCN a un luogo di trasferimento file sicuro (SFT) una volta al giorno, e Athia li raccoglie e li analizza da lì.
Cosa ottieni#
Tutto arriva dentro il Relazioni GRRCN (Raw Data; Global Reconciliation Reports):
- Autorizzazione — dati relativi agli importi, alle date e ai sistemi.
- Settlements.
- Fees.
- Disputes.
Questo è il modo in cui il volume Amex — che non appare mai nei dati del tuo acquirente — si unisce al resto del tuo quadro di pagamento per la riconciliazione e l'analisi dei costi.
Prima di iniziare#
- Un account Amex con un relazione manager che può impostare il Trasferimento file sicuro (SFT) servizio per voi.
- Report GRRCN configurati per la consegna giornaliera a quella posizione SFT. Chiediamo a tutte le relazioni GRRCN disponibili — una relazione che non è mai stata richiesta non può essere riempita dalla parte di Athia.
- I dettagli di connessione SFT in mano. Amex li fornisce; non li crei.
Credentials Athia chiede#
Tutti e quattro i valori provengono da Amex con la configurazione SFT.
| Campo | Obbligatorio | Che cosa è / dove trovarlo |
|---|---|---|
| Nome | Sì. | La vostra etichetta per questo collegamento — nome così la fonte Amex è evidente più tardi |
| URL / Host | Sì. | L'host SFT Amex consegna ad esempio sft.americanexpress.com. Fornito dal vostro responsabile relazioni Amex |
| Porto di Porto | Sì. | Il porto SFT — 22 per SFTP. Fornito con l'host |
| Nome utente | Sì. | Il nome utente del conto SFT rilasciato da Amex |
| Password | Sì. | La password per quel conto SFT. Conservare e trasferirlo in modo sicuro |
Impostazione della connessione#
- Contatta il tuo Amex relaziona manager e chiedete loro di incastrare l'Amex Trasferimento file sicuro (SFT) service.
- Nella stessa conversazione, richiedi consegna giornaliera di tutti i rapporti GRRCN disponibili (Raw Data; Global Reconciliation Report) a quella posizione SFT.
- Raccogliere i dettagli SFT Amex ti dà: URL / Host, Porto di Porto, Nome utente e Password.
- Passate i dettagli alla vostra squadra di Athia, insieme ai conti mercantili che vi aspettate di vedere. Il vostro team di Athia completa la connessione e verifica che la posizione SFT è raggiungibile e un file campione può essere letto.
Il successo della connessione mostra come ACTIVE e la prima importazione viene eseguita contro i file già nella posizione SFT.
Webhook#
Amex non supporta webhooks e nessun API polling. Non c'è URL di notifica per registrare e nessun punto finale per sondaggio. Ogni campo su questo connettore arriva nel lotto giornaliero GRRCN.
Sincronizzazione della cadenza#
Quotidiano, fisso. La cadenza segue il programma di consegna di Amex, quindi non c'è Programma scegliere. Nulla su questo connettore è in tempo reale — una transazione è visibile in Athia dopo che appare in un file GRRCN.
Limiti e cose da sapere#
- Il filtraggio è limitato a ciò che i report contengono. Non c'è interfaccia di query dietro questo connettore, quindi se un campo non è in un rapporto GRRCN, non è disponibile.
- Solo produzione. Non c'è un percorso sandbox per questo connettore.
- Richiedete ogni rapporto GRRCN davanti. Aggiungere un tipo di report in seguito significa tornare al vostro responsabile delle relazioni e aspettare il prossimo ciclo giornaliero.
- Conti commerciali multipli. Assicurarsi che ogni account che ti interessa sia incluso nei rapporti GRRCN. Se Amex emette dei dettagli SFT separati per account, fornire ogni set al vostro team Athia.
- La storia prima della consegna è un carico separato. Percorso attraverso una caduta di file — vedere Integrazione di Athia.
- I dati della carta sono minimizzati. Dettaglio di livello di campo su ciò che Athia negozi è in Athia Data Dictionary.
Risoluzione dei problemi#
| Cosa vedi | Come causa | Cosa fare |
|---|---|---|
| La verifica non è riuscita ad accedere alla posizione SFT | host o porta sbagliato, o la password SFT è stata ruotata da Amex | Riconferma URL / Host, Porto di Porto, Nome utente e Password con il tuo manager di relazioni Amex e dare l'attuale set al tuo team Athia |
ACTIVE, ma nessun dato dopo la prima sincronizzazione | Nessun file GRRCN sono stati consegnati alla posizione | Confermare con il vostro responsabile del rapporto che i rapporti GRRCN sono configurati per la consegna quotidiana a quella posizione esatta, quindi attendere per il prossimo ciclo giornaliero |
| Le autorizzazioni arrivano ma le tasse, gli insediamenti o le controversie non fanno | Solo una parte del set di report GRRCN è stata configurata | Chiedi al tuo responsabile delle relazioni di aggiungere i restanti report GRRCN alla consegna giornaliera |
| Un conto commerciante manca completamente | Tale conto non è incluso nei rapporti GRRCN, o consegna ad un altro luogo SFT | Dite ad Amex di aggiungerlo ai rapporti, o di fornire i suoi dettagli SFT separati al vostro team di Athia |
| Le transazioni di oggi non sono visibili | Preveduto — la consegna è un lotto giornaliero | Attendere il prossimo file giornaliero. Non c'è un percorso più veloce su questo connettore |
Correlato#
- Connettori di Athia — il catalogo completo del connettore
- Integrazione di Athia — cadute di file, quote di magazzino e altri percorsi di integrazione
- Athia Data Dictionary — definizioni di campo