Introduzione
Questa funzione consente di estrarre informazioni dalla piattaforma Currencycloud in formato CSV (.csv).
Sono disponibili 2 tipi di report:
● Report di pagamento
● Report di conversione
Autorizzazioni per i report
Per consultare o creare report su Currencycloud Direct, occorre richiedere queste due autorizzazioni:
● Read Report (Consultazione report): questa autorizzazione consente di accedere all’elenco dei report generati sul proprio conto.
● Write Report (Creazione report): questa autorizzazione consente di richiedere la creazione di un nuovo report tramite le API di Currencycloud.
Creazione di report
Per iniziare a creare un report, accedi alla pagina Search (Cerca) nelle sezioni Payments (Pagamenti) e Conversions (Conversioni). Dopo aver effettuato una ricerca in queste pagine, compare una schermata con i risultati. Se desideri filtrarli ulteriormente, modifica i criteri di ricerca, quindi effettuane una nuova cliccando sul pulsante “Search” (Cerca). Per creare un report contenente i risultati visualizzati sullo schermo, clicca sul pulsante “Request Report” (Richiedi report). Tieni presente che i report di pagamento o di conversione possono contenere un massimo di 200.000 righe. Se non sono sufficienti, occorre creare più report e limitare il numero di risultati in ciascun report a meno di 200.000 righe.
Dopo aver cliccato sul pulsante “Request Report” (Richiedi report), compare un messaggio di conferma e la schermata viene aggiornata con i dettagli relativi alla richiesta del report.
Ricerca di report
Tutte le richieste di report inviate dal conto possono essere consultate nella scheda Reports (Report) della pagina Search (Cerca) dell’applicazione. Per accedere a questa scheda, occorre ottenere l’autorizzazione “Read Report” (Consultazione report).
I campi di ricerca nella parte superiore della pagina possono essere utilizzati per filtrare l’elenco dei report visualizzati sullo schermo. Se lo stato di un report è “Completed” (Completato), il file è disponibile per il download. Per scaricarlo in formato .csv, clicca sul pulsante “Download” (Scarica). Se clicchi sul riferimento del report, puoi visualizzare la pagina con i relativi dettagli, come illustrato di seguito.
Stati del report
Processing (In elaborazione): è lo stato iniziale. Indica che la richiesta è in fase di elaborazione (acquisizione dei dati, creazione e salvataggio del report).
Completed (Completato): questo stato indica che il report è stato creato correttamente e include un link di accesso al file. Puoi recuperare il report tramite l’ID, visualizzare tutte le informazioni correlate e ottenere un URL per scaricarlo in formato CSV.
Failed (Non riuscito): questo stato indica che si è verificato un errore e la creazione del report non è andata a buon fine. Il link al file CSV non è disponibile.
Expired (Scaduto): una volta creato, il report scade il giorno successivo.
Contenuto dei report
Report di pagamento
I report di pagamento sono file CSV contenenti le seguenti informazioni.
| Entità | Campo | Titolo della colonna nel report CSV |
|---|---|---|
| Contatto | your_reference | Contact Reference (Riferimento contatto) |
| Contatto | id | Contact ID (ID contatto) |
| Contatto | login_id | Creator Login ID (ID accesso autore) |
| Contatto | first_name | Creator First Name (Nome autore) |
| Contatto | last_name | Creator Last Name (Cognome autore) |
| Contatto | account_name | Creator Account Name (Nome conto autore) |
| Ordinante | id | Payer ID (ID ordinante) |
| Ordinante | legal_entity_type | Payer Type (Tipo ordinante) |
| Ordinante | company_name | Payer Company Name (Nome azienda ordinante) |
| Ordinante | first_name | Payer First Name (Nome ordinante) |
| Ordinante | last_name | Payer Last Name (Cognome ordinante) |
| Conversioni | uuid | Conversion Unique ID (ID univoco conversione) |
| Conversione | short_reference | Conversion Reference (Riferimento conversione) |
| Conversione | Unique_request_id | Conversion Unique Request ID (ID univoco richiesta conversione) |
| Conversione | sell_currency | Sell Currency of Conversion (Valuta di vendita conversione) |
| Conversione | sell_amount | Sell Amount of the Conversion (client_sell_amount) (Importo di vendita conversione) |
| Conversione | Order_sell_amount | Importo della valuta venduta per una specifica riga. Deve corrispondere a quello di Payment Amount/Client Rate (Importo pagamento/Tasso cliente) |
| Conversione | client_rate | Client Rate (Tasso cliente) |
| Conversione | Settlement_date | Conversion Settlement Date (Data regolamento conversione) |
| Conversione | Settlement_reference | Conversion Settlement short reference (Breve riferimento del regolamento della conversione) |
| Conversione | Conversion_date | Conversion Date (Data di conversione) |
| Pagamento | uuid | Payment Unique ID (ID univoco pagamento) |
| Pagamento | short_reference | Payment Short Reference (Breve riferimento pagamento) |
| Pagamento | amount | Amount (Importo) |
| Pagamento | Unique_request_id | Payment Unique Request ID (ID univoco richiesta pagamento) |
| Pagamento | currency | Currency (Valuta) |
| Pagamento | status | Status (Stato) |
| Pagamento | payment_type | Payment Type (Tipo di pagamento) |
| Pagamento | reference | Reference (Riferimento) |
| Pagamento | reason | Reason (Causale) |
| Pagamento | failure_reason | Failure Reason (Causa errore) |
| Pagamento | payment_group_id | Payment Group ID (ID gruppo pagamento) |
| Pagamento | bulk_upload_reference | Bulk Upload reference (Riferimento caricamento massivo) |
| Pagamento | payment_date | Payment Date (Data pagamento) |
| Pagamento | created_at | Payment Creation Date (Data di creazione pagamento) |
| Beneficiario | name | Beneficiary Nickname (Soprannome beneficiario) |
| Beneficiario | beneficiary_entity_type | Beneficiary Entity Type (Tipo di entità beneficiario) |
| Beneficiario | beneficiary_company_name | Beneficiary Company Name (Nome azienda beneficiario) |
| Beneficiario | beneficiary_first_name | Beneficiary First Name (Nome beneficiario) |
| Beneficiario | beneficiary_last_name | Beneficiary Last Name (Cognome beneficiario) |
| Beneficiario | bank_account_holder_name | Beneficiary Bank Account Holder Name (Nome titolare del conto corrente beneficiario) |
| Beneficiario | beneficiary_address | Beneficiary Address (Indirizzo beneficiario) |
| Beneficiario | beneficiary_city | Beneficiary City (Città beneficiario) |
| Beneficiario | beneficiary_postcode | Beneficiary Postcode (Codice postale beneficiario) |
| Beneficiario | beneficiary_state_or_province | Beneficiary State or Province (Stato o provincia beneficiario) |
| Beneficiario | beneficiary_country | Beneficiary Country (Paese beneficiario) |
| Beneficiario | Beneficiary Email (Email beneficiario) | |
| Beneficiario | beneficiary_date_of_birth | Beneficiary Date of Birth (Data di nascita beneficiario) |
| Beneficiario | beneficiary_identification_type | Beneficiary ID type (Tipo ID beneficiario) |
| Beneficiario | beneficiary_identification_value | Beneficiary ID Value (Numero ID beneficiario) |
| Beneficiario | account_number | Beneficiary Account Number (Numero conto beneficiario) |
| Beneficiario | routing_code_type_1 | Beneficiary Routing Type 1 (Routing beneficiario di tipo 1) |
| Beneficiario | routing_code_value_1 | Beneficiary Routing Value 1 (Routing beneficiario 1) |
| Beneficiario | routing_code_type_2 | Beneficiary Routing Type 2 (Routing beneficiario di tipo 2) |
| Beneficiario | routing_code_value_2 | Beneficiary Routing Value 2 (Routing beneficiario 2) |
| Beneficiario | bic_swift | BIC/Swift |
| Beneficiario | iban | IBAN |
| Beneficiario | bank_country | Beneficiary Bank Country (Paese della banca beneficiario) |
| Beneficiario | bank_name | Beneficiary Bank Name (Nome della banca beneficiario) |
| Beneficiario | bank_account_type | Beneficiary Bank Account Type (Tipo conto corrente beneficiario) |
| Beneficiario | bank_address | Beneficiary Bank Address (Indirizzo banca beneficiario) |
| Beneficiario | created_at | Beneficiary Created At (Orario creazione beneficiario) |
| Beneficiario | updated_at | Beneficiary Updated At (Orario aggiornamento beneficiario) |
Report di conversione
I report di conversione sono file CSV contenenti le seguenti informazioni:
| Entità | Campo | Titolo della colonna nel report CSV |
|---|---|---|
| Account | account_name | Account Name (Nome conto) |
| Account | your_reference | Account Reference (Riferimento conto) |
| Contatto | login_id | Contact Login ID (ID accesso contatto) |
| Contatto | id | Contact ID (ID contatto) |
| Contatto | your_reference | Contact Reference (Riferimento contatto) |
| Contatto | first_name | Contact First Name (Nome contatto) |
| Contatto | last_name | Contact Last Name (Cognome contatto) |
| Conversione | uuid | Conversion Unique ID (ID univoco conversione) |
| Conversione | short_reference | Conversion Reference (Riferimento conversione) |
| Conversione | Unique_request_id | Unique Request ID (ID univoco richiesta) |
| Conversione | settlement_date | Settlement Date (Data di regolamento) |
| Conversione | conversion_date | Conversion Date (Data di conversione) |
| Conversione | created_at | Conversion Creation Date (Data di creazione conversione) |
| Conversione | updated_at | Conversion Updated Date (Data di aggiornamento conversione) |
| Conversione | client_status | Client Status (Stato cliente) |
| Conversione | partner_status | Partner Status (Stato partner) |
| Conversione | buy_currency | Buy Currency (Valuta di acquisto) |
| Conversione | sell_currency | Sell Currency (Valuta di vendita) |
| Conversione | fixed_side | Fixed Side (Parte fissa) |
| Conversione | partner_buy_amount | Partner Buy Amount (Importo di acquisto partner) |
| Conversione | partner_sell_amount | Partner Sell Amount (Importo di vendita partner) |
| Conversione | client_buy_amount | Client Buy Amount (Importo di acquisto cliente) |
| Conversione | client_sell_amount | Client Sell Amount (Importo di vendita cliente) |
| Conversione | core_rate | Core Rate (Tasso di base) |
| Conversione | partner_rate | Partner Rate (Tasso partner) |
| Conversione | client_rate | Client Rate (Tasso cliente) |
| Conversione | unallocated_funds | Unallocated Funds (Fondi non allocati) |
| Conversione | deposit_required | Deposit Required (Deposito richiesto) |
| Conversione | deposit_amount | Deposit Amount (Importo del deposito) |
| Conversione | deposit_currency | Deposit Currency (Valuta del deposito) |
| Conversione | deposit_status | Deposit Status (Stato del deposito) |
| Conversione | deposit_required_at | Deposit Required At (Orario di richiesta deposito) |