Introduction
Cette fonctionnalité offre aux utilisateurs la possibilité d’extraire des informations de la plateforme Currencycloud au format CSV (.csv).
Il existe deux types de rapports disponibles :
● Rapport de paiement
● Rapport de conversion
Autorisations de création de rapports
Il existe deux autorisations liées à la fonctionnalité de création de rapports sur Currencycloud Direct :
● Read Report (Lire le rapport) : cette autorisation permet aux utilisateurs correspondants d’accéder à la liste des rapports générés dans leur compte.
● Write Report (Rédiger un rapport) : cette autorisation permet à l’utilisateur correspondant de demander la création d’un nouveau rapport via l’API Currencycloud.
Créer un rapport
La création du rapport se fait à partir des pages Search (Rechercher) dans Payments (Paiements) ou Conversions (Conversions). Après avoir effectué une recherche de paiements ou de conversions, vous pouvez visualiser les résultats à l’écran. Vous pouvez filtrer les résultats en modifiant les critères de recherche et effectuer une nouvelle recherche en cliquant sur le bouton « Search » (Rechercher). Pour générer un rapport qui inclut les résultats affichés à l’écran, cliquez sur le bouton « Request Report » (Demander un rapport). Veuillez noter que la taille maximale d’un rapport sur les paiements ou les conversions est de 200 000 lignes. Si vous avez besoin d’un rapport plus volumineux, vous devrez générer plusieurs rapports et limiter le nombre de résultats dans chaque rapport à moins de 200 000 lignes.
Lorsque vous cliquez sur le bouton « Request Report » (Demander un rapport), un message de confirmation s’affiche à l’écran et l’écran est actualisé pour afficher les détails de la demande de rapport.
Rechercher un rapport
Toutes les demandes de rapport soumises dans un compte sont disponibles sous l’onglet Reports (Rapports) de la page Search (Rechercher) de l’application. L’accès à cet onglet est fourni via l’autorisation « Read Report » (Lire le rapport).
Les champs de recherche en haut de la page peuvent être utilisés pour filtrer la liste des rapports affichés à l’écran. Si le statut d’un rapport est « completed » (terminé), le fichier du rapport peut être téléchargé. Cliquez sur le bouton « Download » (Télécharger) correspondant pour télécharger le fichier .csv correspondant. Cliquez sur la référence du rapport pour afficher la page avec les détails du rapport comme indiqué ci-dessous.
Statuts du rapport
Processing (Traitement en cours) : état initial, ce qui signifie que votre demande est en cours de traitement (collecte de données, création du rapport, stockage du rapport).
Completed (Terminé) : le rapport dans cet état est généré avec succès et un lien permet d’accéder au rapport. Vous pouvez le récupérer par ID et voir toutes les informations relatives à ce rapport et une URL pour télécharger le rapport au format CSV.
Failed (Échec) : cet état signifie que quelque chose ne s’est pas déroulé correctement et que la génération du rapport a échoué. Le lien du rapport au format CSV est alors absent.
Expired (Expiré) : lorsqu’un rapport est généré avec succès, il expire après un jour.
Contenu du rapport
Rapport de paiement
Les fichiers des rapports de paiement contiennent les informations suivantes au format CSV.
| Entité | Champ | Titre de la colonne sur le rapport au format CSV |
|---|---|---|
| Contact | your_reference | Contact Reference (Référence du contact) |
| Contact | id | Contact ID (ID du contact) |
| Contact | login_id | Creator Login ID (ID de connexion du créateur) |
| Contact | first_name | Creator First Name (Prénom du créateur) |
| Contact | last_name | Creator Last Name (Nom de famille du créateur) |
| Contact | account_name | Creator Account Name (Nom du compte du créateur) |
| Donneur d’ordre/payeur | Id | Payer ID (ID du donneur d’ordre) |
| Donneur d’ordre/payeur | legal_entity_type | Payer Type (Type de donneur d’ordre) |
| Donneur d’ordre/payeur | company_name | Payer Company Name (Nom de la société du donneur d’ordre) |
| Donneur d’ordre/payeur | first_name | Payer First Name (Prénom du donneur d’ordre) |
| Donneur d’ordre/payeur | last_name | Payer Last Name (Nom de famille du donneur d’ordre) |
| Conversions | uuid | Conversion Unique ID (ID unique de la conversion) |
| Conversion | short_reference | Conversion Reference (Référence de la conversion) |
| Conversion | Unique_request_id | Conversion Unique Request ID (ID de demande unique de conversion) |
| Conversion | sell_currency | Sell Currency of Conversion (Devise de vente de la conversion) |
| Conversion | sell_amount | Sell Amount of the Conversion (Montant de vente de la conversion) (client_sell_amount) |
| Conversion | Order_sell_amount | Amount of currency sold for the specific line (Montant de la devise vendue pour la ligne spécifique) Il doit être égal à (montant du paiement / taux client). |
| Conversion | client_rate | Client Rate (Taux du client) |
| Conversion | Settlement_date | Conversion Settlement Date (Date de règlement de la conversion) |
| Conversion | Settlement_reference | Conversion Settlement short reference (Référence courte du règlement de la conversion) |
| Conversion | Conversion_date | Conversion Date (Date de la conversion) |
| Paiement | uuid | Payment Unique ID (ID unique du paiement) |
| Paiement | short_reference | Payment Short Reference (Référence courte du paiement) |
| Paiement | amount | Amount (Montant) |
| Paiement | Unique_request_id | Payment Unique Request ID (ID de demande unique de paiement) |
| Paiement | currency | Currency (Devise) |
| Paiement | status | Status (Statut) |
| Paiement | payment_type | Payment Type (Type de paiement) |
| Paiement | reference | Reference (Référence) |
| Paiement | reason | Reason (Motif) |
| Paiement | failure_reason | Failure Reason (Motif de l’échec) |
| Paiement | payment_group_id | Payment Group ID (ID du groupe de paiement) |
| Paiement | bulk_upload_reference | Bulk Upload reference (Référence Bulk Upload) |
| Paiement | payment_date | Payment Date (Date du paiement) |
| Paiement | created_at | Payment Creation Date (Date de création du paiement) |
| Bénéficiaire | name | Surnom du bénéficiaire |
| Bénéficiaire | beneficiary_entity_type | Beneficiary Entity Type (Type d’entité bénéficiaire) |
| Bénéficiaire | beneficiary_company_name | Beneficiary Company Name (Nom de la société bénéficiaire) |
| Bénéficiaire | beneficiary_first_name | Beneficiary First Name (Prénom du bénéficiaire) |
| Bénéficiaire | beneficiary_last_name | Beneficiary Last Name (Nom de famille du bénéficiaire) |
| Bénéficiaire | bank_account_holder_name | Beneficiary Bank Account Holder Name (Nom du titulaire du compte bancaire du bénéficiaire) |
| Bénéficiaire | beneficiary_address | Beneficiary Address (Adresse du bénéficiaire) |
| Bénéficiaire | beneficiary_city | Beneficiary City (Ville du bénéficiaire) |
| Bénéficiaire | beneficiary_postcode | Beneficiary Postcode (Code postal du bénéficiaire) |
| Bénéficiaire | beneficiary_state_or_province | Beneficiary State or Province (État ou province du bénéficiaire) |
| Bénéficiaire | beneficiary_country | Beneficiary Country (Pays du bénéficiaire) |
| Bénéficiaire | Beneficiary Email (Adresse e-mail du bénéficiaire) | |
| Bénéficiaire | beneficiary_date_of_birth | Beneficiary Date of Birth (Date de naissance du bénéficiaire) |
| Bénéficiaire | beneficiary_identification_type | Beneficiary ID type (Type d’ID du bénéficiaire) |
| Bénéficiaire | beneficiary_identification_value | Beneficiary ID Value (Valeur de l’ID du bénéficiaire) |
| Bénéficiaire | account_number | Beneficiary Account Number (Numéro de compte du bénéficiaire) |
| Bénéficiaire | routing_code_type_1 | Beneficiary Routing Type 1 (Type de routage du bénéficiaire 1) |
| Bénéficiaire | routing_code_value_1 | Beneficiary Routing Value 1 (Valeur de routage du bénéficiaire 1) |
| Bénéficiaire | routing_code_type_2 | Beneficiary Routing Type 2 (Type de routage du bénéficiaire 2) |
| Bénéficiaire | routing_code_value_2 | Beneficiary Routing Value 2 (Valeur de routage du bénéficiaire 2) |
| Bénéficiaire | bic_swift | BIC/Swift |
| Bénéficiaire | iban | IBAN |
| Bénéficiaire | bank_country | Beneficiary Bank Country (Pays de la banque du bénéficiaire) |
| Bénéficiaire | bank_name | Beneficiary Bank Name (Nom de la banque du bénéficiaire) |
| Bénéficiaire | bank_account_type | Beneficiary Bank Account Type (Type de compte bancaire du bénéficiaire) |
| Bénéficiaire | bank_address | Beneficiary Bank Address (Adresse de la banque du bénéficiaire) |
| Bénéficiaire | created_at | Beneficiary Created At (Bénéficiaire créé à) |
| Bénéficiaire | updated_at | Beneficiary Updated At (Bénéficiaire mis à jour à) |
Rapport de conversion
Les fichiers des rapports de conversion contiennent les informations suivantes au format CSV.
| Entité | Champ | Titre de la colonne sur le rapport au format CSV |
|---|---|---|
| Compte | account_name | Account Name (Nom du compte) |
| Compte | your_reference | Account Reference (Référence du compte) |
| Contact | login_id | Contact Login ID (ID de connexion du contact) |
| Contact | id | Contact ID (ID du contact) |
| Contact | your_reference | Contact Reference (Référence du contact) |
| Contact | first_name | Contact First Name (Prénom du contact) |
| Contact | last_name | Contact Last Name (Nom de famille du contact) |
| Conversion | uuid | Conversion Unique ID (ID unique de la conversion) |
| Conversion | short_reference | Conversion Reference (Référence de la conversion) |
| Conversion | Unique_request_id | Unique Request ID (ID de demande unique) |
| Conversion | settlement_date | Settlement Date (Date de règlement) |
| Conversion | conversion_date | Conversion Date (Date de la conversion) |
| Conversion | created_at | Conversion Creation Date (Date de création de la conversion) |
| Conversion | updated_at | Conversion Updated Date (Date de mise à jour de la conversion) |
| Conversion | client_status | Client Status (Statut du client) |
| Conversion | partner_status | Partner Status (Statut du partenaire) |
| Conversion | buy_currency | Buy Currency (Devise à l’achat) |
| Conversion | sell_currency | Sell Currency (Devise à la vente) |
| Conversion | fixed_side | Fixed Side (Côté fixe) |
| Conversion | partner_buy_amount | Partner Buy Amount (Montant d’achat du partenaire) |
| Conversion | partner_sell_amount | Partner Sell Amount (Montant de vente du partenaire) |
| Conversion | client_buy_amount | Client Buy Amount (Montant d’achat du client) |
| Conversion | client_sell_amount | Client Sell Amount (Montant de vente du client) |
| Conversion | core_rate | Core Rate (Taux de base) |
| Conversion | partner_rate | Partner Rate (Taux du partenaire) |
| Conversion | client_rate | Client Rate (Taux du client) |
| Conversion | unallocated_funds | Unallocated Funds (Fonds non alloués) |
| Conversion | deposit_required | Deposit Required (Dépôt obligatoire) |
| Conversion | deposit_amount | Deposit Amount (Montant du dépôt) |
| Conversion | deposit_currency | Deposit Currency (Devise de dépôt) |
| Conversion | deposit_status | Deposit Status (Statut du dépôt) |
| Conversion | deposit_required_at | Deposit Required At (Dépôt obligatoire à) |