Introducción
Las funciones de generación de informes te permiten extraer datos de la plataforma de Currencycloud en formato CSV (.csv).
Hay dos tipos de informes:
● Payment Report (Informe sobre pagos)
● Conversion Report (Informe sobre conversiones)
Permisos para gestionar informes
En Currencycloud Direct hay dos permisos relativos a los informes:
● Read Report (Lectura de informes): los usuarios con este permiso pueden acceder a la lista de informes que se hayan generado en su cuenta.
● Write Report (Generación de informes): los usuarios con este permiso pueden solicitar la creación de informes mediante la API de Currencycloud.
Crear un informe
Para crear un informe, ve a la pestaña "Payments" (Pagos) o a la pestaña "Conversions" (Conversiones) de la página "Search" (Buscar). Busca los pagos o las conversiones que te interesen y los resultados de la búsqueda se mostrarán en pantalla. Para filtrar los resultados, cambia los criterios y haz clic en el botón "Search" (Buscar) para hacer una nueva búsqueda. Para generar un informe que incluya los resultados que se muestran en pantalla, haz clic en el botón "Request Report" (Solicitar informe). Ten en cuenta que el tamaño máximo de los informes sobre pagos o sobre conversiones es de 200 000 líneas. Si necesitas obtener más datos, tendrás que crear varios informes y limitar el número máximo de líneas de cada uno de ellos para que sea menor que 200 000 líneas.
Tras hacer clic en el botón "Request Report" (Solicitar informe), aparecerá un mensaje de confirmación en pantalla. A continuación, la pantalla se actualizará para mostrar los detalles de la solicitud del informe.
Buscar un informe
Todos los informes que se hayan solicitado desde una cuenta estarán disponibles en la pestaña "Reports" (Informes) de la página "Search" (Buscar) de la aplicación. Para acceder a esta pestaña, los usuarios deben tener el permiso "Read Report" (Lectura de informes).
Los campos de búsqueda que aparecen en la parte superior de la página pueden usarse para filtrar la lista de informes que aparecen en pantalla. Si un informe tiene el estado "Completed" (Completado), significa que el archivo del informe puede descargarse. Haz clic en el botón "Download" (Descargar) del informe correspondiente. El informe se descargará como un archivo CSV. Si haces clic en la referencia del informe ("Reference"), se mostrará su página de detalles, como la que puedes ver en la imagen de abajo.
Estados de los informes
Processing (En procesamiento): es el estado inicial, lo que significa que la solicitud se está procesando (el sistema está recogiendo datos, generando el informe y almacenándolo).
Completed (Completado): este estado indica que el informe se ha generado correctamente, y puedes hacer clic sobre él para acceder al informe en sí. Si buscas el informe por su ID, se mostrarán todos los datos relacionados con él, así como una URL en la que puedes hacer clic para descargarlo en formato CSV.
Failed (Error): este estado significa que se ha producido algún error y que no se ha podido generar el informe. En este caso, no habrá ningún enlace para descargar el informe en formato CSV.
Expired (Caducado): los informes caducan un día después de haberse generado.
Contenido de los informes
Informes sobre pagos
Los informes sobre pagos contienen la siguiente información en formato CSV:
| Entidad | Campo | Nombre de la columna en el informe CSV |
|---|---|---|
| Contacto | your_reference | Contact Reference (Referencia del contacto) |
| Contacto | id | Contact ID (ID del contacto) |
| Contacto | login_id | Creator Login ID (ID de inicio de sesión del creador) |
| Contacto | first_name | Creator First Name (Nombre del creador) |
| Contacto | last_name | Creator Last Name (Apellidos del creador) |
| Contacto | account_name | Creator Account Name (Nombre de la cuenta del creador) |
| Pagador | Id | Payer ID (ID del pagador) |
| Pagador | legal_entity_type | Payer Type (Tipo de pagador) |
| Pagador | company_name | Payer Company Name (Nombre de la empresa del pagador) |
| Pagador | first_name | Payer First Name (Nombre del pagador) |
| Pagador | last_name | Payer Last Name (Apellidos del pagador) |
| Conversión | uuid | Conversion Unique ID (ID único de la conversión) |
| Conversión | short_reference | Conversion Reference (Referencia de la conversión) |
| Conversión | unique_request_id | Conversion Unique Request ID (ID de solicitud único de la conversión) |
| Conversión | sell_currency | Sell Currency of Conversion (Divisa de venta de la conversión) |
| Conversión | sell_amount | Sell Amount of the Conversion (client_sell_amount): Cantidad de venta de la conversión |
| Conversión | order_sell_amount | Amount of currency sold for the specific line (Cantidad de la divisa vendida correspondiente a esa línea específica): debería ser igual al resultado de dividir la cantidad del pago entre el tipo de divisa del cliente |
| Conversión | client_rate | Client Rate (Tipo de divisa del cliente) |
| Conversión | settlement_date | Conversion Settlement Date (Fecha de liquidación de la conversión) |
| Conversión | settlement_reference | Conversion Settlement short reference (Referencia corta de la liquidación de la conversión) |
| Conversión | conversion_date | Conversion Date (Fecha de la conversión) |
| Pago | uuid | Payment Unique ID (ID único del pago) |
| Pago | short_reference | Payment Short Reference (Referencia corta del pago) |
| Pago | amount | Amount (Cantidad) |
| Pago | unique_request_id | Payment Unique Request ID (ID único de la solicitud del pago) |
| Pago | currency | Currency (Divisa) |
| Pago | status | Status (Estado) |
| Pago | payment_type | Payment Type (Tipo de pago) |
| Pago | reference | Reference (Referencia) |
| Pago | reason | Reason (Motivo) |
| Pago | failure_reason | Failure Reason (Motivo del fallo) |
| Pago | payment_group_id | Payment Group ID (ID del grupo de pagos) |
| Pago | bulk_upload_reference | Bulk Upload reference (Referencia de la subida en bloque) |
| Pago | payment_date | Payment Date (Fecha del pago) |
| Pago | created_at | Payment Creation Date (Fecha de creación del pago) |
| Beneficiario | name | Beneficiary Nickname (Apodo del beneficiario) |
| Beneficiario | beneficiary_entity_type | Beneficiary Entity Type (Tipo de entidad beneficiaria) |
| Beneficiario | beneficiary_company_name | Beneficiary Company Name (Nombre de la empresa beneficiaria) |
| Beneficiario | beneficiary_first_name | Beneficiary First Name (Nombre del beneficiario) |
| Beneficiario | beneficiary_last_name | Beneficiary Last Name (Apellidos del beneficiario) |
| Beneficiario | bank_account_holder_name | Beneficiary Bank Account Holder Name (Nombre del titular de la cuenta bancaria beneficiaria) |
| Beneficiario | beneficiary_address | Beneficiary Address (Dirección del beneficiario) |
| Beneficiario | beneficiary_city | Beneficiary City (Ciudad del beneficiario) |
| Beneficiario | beneficiary_postcode | Beneficiary Postcode (Código postal del beneficiario) |
| Beneficiario | beneficiary_state_or_province | Beneficiary State or Province (Estado o provincia del beneficiario) |
| Beneficiario | beneficiary_country | Beneficiary Country (País del beneficiario) |
| Beneficiario | Beneficiary Email (Dirección electrónica del beneficiario) | |
| Beneficiario | beneficiary_date_of_birth | Beneficiary Date of Birth (Fecha de nacimiento del beneficiario) |
| Beneficiario | beneficiary_identification_type | Beneficiary ID type (Tipo de ID del beneficiario) |
| Beneficiario | beneficiary_identification_value | Beneficiary ID Value (Valor de ID del beneficiario) |
| Beneficiario | account_number | Beneficiary Account Number (Número de la cuenta del beneficiario) |
| Beneficiario | routing_code_type_1 | Beneficiary Routing Type 1 (Tipo de enrutamiento 1 del beneficiario) |
| Beneficiario | routing_code_value_1 | Beneficiary Routing Value 1 (Valor de enrutamiento 1 del beneficiario) |
| Beneficiario | routing_code_type_2 | Beneficiary Routing Type 2 (Tipo de enrutamiento 2 del beneficiario) |
| Beneficiario | routing_code_value_2 | Beneficiary Routing Value 2 (Valor de enrutamiento 2 del beneficiario) |
| Beneficiario | bic_Swift | BIC/Swift |
| Beneficiario | iban | IBAN |
| Beneficiario | bank_country | Beneficiary Bank Country (País del banco beneficiario) |
| Beneficiario | bank_name | Nombre del banco beneficiario |
| Beneficiario | bank_account_type | Beneficiary Bank Account Type (Tipo de cuenta bancaria del beneficiario) |
| Beneficiario | bank_address | Beneficiary Bank Address (Dirección del banco beneficiario) |
| Beneficiario | created_at | Beneficiary Created At (Hora de creación del beneficiario) |
| Beneficiario | updated_at | Beneficiary Updated At (Hora de modificación del beneficiario) |
Informes sobre conversiones
Los informes sobre conversiones contienen la siguiente información en formato CSV:
| Entidad | Campo | Nombre de la columna en el informe CSV |
|---|---|---|
| Cuenta | account_name | Account Name (Nombre de la cuenta) |
| Cuenta | your_reference | Account Reference (Referencia de la cuenta) |
| Contacto | login_id | Contact Login ID (ID de inicio de sesión del contacto) |
| Contacto | id | Contact ID (ID del contacto) |
| Contacto | your_reference | Contact Reference (Referencia del contacto) |
| Contacto | first_name | Contact First Name (Nombre del contacto) |
| Contacto | last_name | Contact Last Name (Apellidos del contacto) |
| Conversión | uuid | Conversion Unique ID (ID único de la conversión) |
| Conversión | short_reference | Conversion Reference (Referencia de la conversión) |
| Conversión | unique_request_id | Unique Request ID (ID único de la solicitud) |
| Conversión | settlement_date | Fecha de liquidación |
| Conversión | conversion_date | Conversion Date (Fecha de la conversión) |
| Conversión | created_at | Conversion Creation Date (Fecha de creación de la conversión) |
| Conversión | updated_at | Conversion Updated Date (Fecha de modificación de la conversión) |
| Conversión | client_status | Client Status (Estado del cliente) |
| Conversión | partner_status | Partner Status (Estado del socio) |
| Conversión | buy_currency | Buy Currency (Divisa de compra) |
| Conversión | sell_currency | Sell Currency (Divisa de venta) |
| Conversión | fixed_side | Fixed Side (Parte fija) |
| Conversión | partner_buy_amount | Partner Buy Amount (Cantidad que compra el socio) |
| Conversión | partner_sell_amount | Partner Sell Amount (Cantidad que vende el socio) |
| Conversión | client_buy_amount | Client Buy Amount (Cantidad que compra el cliente) |
| Conversión | client_sell_amount | Client Sell Amount (Cantidad que vende el cliente) |
| Conversión | core_rate | Core Rate (Tipo de divisa principal) |
| Conversión | partner_rate | Partner Rate (Tipo de divisa del socio) |
| Conversión | client_rate | Client Rate (Tipo de divisa del cliente) |
| Conversión | unallocated_funds | Unallocated Funds (Fondos sin asignar) |
| Conversión | deposit_required | Deposit Required (Depósito requerido) |
| Conversión | deposit_amount | Deposit Amount (Cantidad del depósito |
| Conversión | deposit_currency | Deposit Currency (Divisa del depósito) |
| Conversión | deposit_status | Deposit Status (Estado del depósito) |
| Conversión | deposit_required_at | Deposit Required At (Hora a la que se ha solicitado el depósito) |