Introduzione
Questa funzione consente di estrarre informazioni dalla piattaforma di Currencycloud in formato CSV (.csv).
Sono disponibili 2 diversi tipi di report:
● Report di pagamento
● Report di conversione
Autorizzazioni per i report
Per accedere ai report o crearli su Currencycloud Direct, occorre ottenere le seguenti autorizzazioni:
● Read Report (Accesso ai report): questa autorizzazione consente di accedere all’elenco dei report generati sul proprio conto.
● Write Report (Creazione di 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 sezione Search (Cerca) e poi alle pagine Payments (Pagamenti) e Conversions (Conversioni). Dopo aver effettuato una ricerca in queste pagine, compare una schermata con i risultati. Se desideri filtrarli ancora, 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 massimo 200.000 righe. Se non sono sufficienti, occorre creare più report e poi cercarli nei risultati impostando un numero di righe inferiore a 200.000.
Dopo aver cliccato sul pulsante “Request Report” (Richiedi report), compare una schermata con un messaggio di conferma, la quale viene poi aggiornata con i dettagli relativi alla richiesta del report.
Individuazione 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” (Accesso ai report).
I campi di ricerca nella parte superiore della pagina possono essere utilizzati per filtrare l’elenco dei report visualizzati sullo schermo. Se un report si trova sullo stato “Completed” (Completato), il file è disponibile per il download. Per scaricare il relativo file .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. Per consultarlo, clicca sul link integrato. Puoi recuperare il report tramite l’ID e visualizzare tutte le informazioni correlate, nonché ottenere un URL per scaricare il relativo file CSV.
Failed (Non riuscito): questo stato indica che si è verificato un errore, quindi la creazione del report non è riuscita. Il link al file CSV non è disponibile.
Expired (Scaduto): una volta creato, il report scade il giorno successivo.
Contenuto del 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) |
| Pagatore | id | Payer ID (ID pagatore) |
| Pagatore | legal_entity_type | Payer Type (Tipo pagatore) |
| Pagatore | company_name | Payer Company Name (Nome azienda pagatore) |
| Pagatore | first_name | Payer First Name (Nome pagatore) |
| Pagatore | last_name | Payer Last Name (Cognome pagatore) |
| 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 della conversione) |
| Conversione | sell_amount | Sell Amount of the Conversion (client_sell_amount) (Importo di vendita della conversione) |
| Conversione | Order_sell_amount | Importo della valuta venduta per una specifica riga. Dovrebbe 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 del 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à del beneficiario) |
| Beneficiario | beneficiary_company_name | Beneficiary Company Name (Nome azienda del 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 of Province (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 del beneficiario) |
| Beneficiario | account_number | Beneficiary Account Number (Numero conto del 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 numero 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 numero 2) |
| Beneficiario | bic_swift | BIC/SWIFT |
| Beneficiario | iban | IBAN |
| Beneficiario | bank_country | Beneficiary Bank Country (Paese della banca del beneficiario) |
| Beneficiario | bank_name | Beneficiary Bank Name (Nome della banca del beneficiario) |
| Beneficiario | bank_account_type | Beneficiary Bank Account Type (Tipo conto corrente del beneficiario) |
| Beneficiario | bank_address | Beneficiary Bank Address (Indirizzo banca del 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 del contatto) |
| Contatto | last_name | Contact Last Name (Cognome del 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 della conversione) |
| Conversione | updated_at | Conversion Updated Date (Data di aggiornamento della 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 del partner) |
| Conversione | partner_sell_amount | Partner Sell Amount (Importo di vendita del partner) |
| Conversione | client_buy_amount | Client Buy Amount (Importo di acquisto del cliente) |
| Conversione | client_sell_amount | Client Sell Amount (Importo di vendita del cliente) |
| Conversione | core_rate | Core Rate (Tasso principale) |
| Conversione | partner_rate | Partner Rate (Tasso del 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) |