Bulk Money Movement Initiation

The Bulk Movement feature lets you process multiple payments in a single upload, saving time and reducing manual effort. Instead of creating payments one by one, you can prepare a file with all your transactions and upload it to Cobre for automatic validation and processing.

This is ideal for payroll runs, vendor payments, recurring disbursements, or any scenario where you need to move money to multiple recipients at once.

Before You Begin

Make sure you have the following ready:

Active Account Permissions: Your account must have Creator or Admin role to upload bulk payments.

A Prepared Payment File: Your file should be in one of the supported formats (CSV, XLSX, TXT, or JSON) with all required fields completed.

Source Account ID: You'll need the ID of the account from which payments will be sent. Find this in the Accounts section under the ID column.

Tip: Download Cobre's templates for the fastest setup. They include the correct formatting and column headers, reducing errors and speeding up validation.

Supported File Formats

Cobre supports multiple file formats to fit your existing workflows:

Format	Bank/Type	Extension
Plantilla Cobre Col (Payouts)	Cobre	.csv, .xlsx
Plantilla Cobre Mex (Payouts)	Cobre	.csv, .xlsx
Plantilla Cobre General	Cobre	.json
PAB Bancolombia	Bancolombia	.txt
SAP Bancolombia	Bancolombia	.txt
DISFON	Banco de Bogotá	.txt
BBVA	BBVA Colombia	.txt
Banco de Occidente	Banco de Occidente	.txt
Davivienda	Davivienda	.txt, .xlsx

Accessing Bulk Movement

You can start a bulk payment directly from the Cobre Portal Home page:

On the Home page, locate the movement type buttons in the top-right area.

Click Bulk movement to begin.

The Home page displays your current balances in MXN and COP, along with Quick Access shortcuts for common actions.

Step-by-Step: Creating a Bulk Payment

Step 1: Open the Bulk Movement Screen

After clicking Bulk movement, you'll see the Massive Movement upload screen. This is where you'll upload your payment file.

The screen includes a helpful tip box with a link to download a sample template if you need one.

Step 2: Prepare Your File

If you don't already have a file ready, click Download Cobre Template at the bottom of the upload area. Choose the template that matches your payment geography (Mexico or Colombia).

Your file must meet these requirements:

Maximum file size: 15MB

Allowed formats: CSV, TXT, XLSX, XLS, or JSON

Required fields: Source ID, Destination details, Amount

Step 3: Upload Your File

Drag and drop your file into the upload area, or click Upload to browse your computer.

Once uploaded, the system automatically detects the file type. If the detection doesn't match your file format, use the File type dropdown to select the correct option.

Step 4: Configure Approval Settings

Before continuing, decide whether this batch needs approval from another user:

Toggle ON: The batch will require approval before processing (recommended for large payments or when dual control is required).

Toggle OFF: The batch will process immediately after validation (available for Admins only).

Step 5: Click Continue

Click Continue to submit your file for validation. The system will check:

File format and structure

Required fields are present

Data formats are correct (amounts, IDs, account numbers)

Account and counterparty information is valid

Step 6: Review Validation Results

If validation finds errors, you'll see a detailed modal listing each issue. Errors are displayed 50 per page, and you can navigate through them to identify what needs fixing. Common issues include:

Missing required fields

Invalid account numbers or bank codes

Incorrect amount formats

Unrecognized counterparty IDs

Fix the errors in your file and re-upload.

Step 7: Review Summary and Confirm

Once validation passes, you'll see a summary screen showing:

Total transaction amount

Number of payments in the batch

Uploaded file name

A table listing each individual payment for verification

Review the details carefully. You can also download the uploaded file from this view for your records.

Step 8: Submit the Batch

Click to finalize. What happens next depends on your role and settings:

Creator: Batch is marked as pending approval ("por aprobar").

Admin: Batch is approved and begins processing immediately.

Admin with Dual Control: Batch requires approval from another user.

Batch Processing Statuses

After submission, your batch moves through these statuses:

Status	Meaning
Validating	Initial state—the system is checking your file format and data.
Failed	Validation found errors. Review the error details and re-upload a corrected file.
Processing	Validation passed and individual payments are being executed.
Completed	All payments in the batch have been processed.

Counterparty Handling

When uploading bulk payments, you have two options for specifying recipients:

Option 1: Use an existing counterparty ID
If the counterparty is already saved in Cobre, just include their ID (e.g., cp_5YFeIDhNkz) in the Destination ID field. No other destination details are needed.

Option 2: Provide full counterparty details
If you don't have a counterparty ID, include the full details: name, ID type, ID number, account type, account number, and bank code. The system will automatically create a counterparty record and use idempotency checks to prevent duplicates.

💡 Tip: Using existing counterparty IDs speeds up validation and reduces errors. Consider creating counterparties in advance for recipients you pay regularly.

Roles and Permissions

Role	Upload Files	Approve Batches	View Batches
Viewer	✗	✗	✓
Approver	✗	✓	✓
Creator	✓	✗	✓
Admin	✓	✓	✓
Admin (Dual Control)	✓	Requires another user	✓

Best Practices

Use Cobre templates to ensure your file has the correct structure and formatting from the start.

Validate your data before uploading—check for missing fields, correct amount formats (use decimal point, no thousand separators), and valid bank codes.

Start with smaller batches when testing a new file format or workflow.

Review the summary carefully before final submission, especially for large payment amounts.

Save counterparties for recipients you pay regularly to streamline future uploads.

Troubleshooting

Issue	Solution
File upload fails immediately	Check file size (max 15MB) and format (CSV, TXT, XLSX, XLS, or JSON).
Validation errors on amounts	Use decimal point notation (1000.00) without thousand separators.
"Invalid Source ID" error	Verify the Source ID exists in your Accounts section and matches exactly.
Batch stuck in "Validating"	Large files may take longer. If it persists, contact Cobre support.
Can't approve my own batch	Dual Control is enabled—another user must approve the batch.

Need Help?

For additional support or questions about file formats and templates, contact our team through the help section in the portal or if you prefer email, you can reach the support team directly at soporte@cobre.co.

Bulk Money Movement Initiation

Before You Begin#

Supported File Formats#

Accessing Bulk Movement#

Step-by-Step: Creating a Bulk Payment#

Step 1: Open the Bulk Movement Screen#

Step 2: Prepare Your File#

Step 3: Upload Your File#

Step 4: Configure Approval Settings#

Step 5: Click Continue#

Step 6: Review Validation Results#

Step 7: Review Summary and Confirm#

Step 8: Submit the Batch#

Batch Processing Statuses#

Counterparty Handling#

Roles and Permissions#

Best Practices#

Troubleshooting#

Need Help?#

Before You Begin

Supported File Formats

Accessing Bulk Movement

Step-by-Step: Creating a Bulk Payment

Step 1: Open the Bulk Movement Screen

Step 2: Prepare Your File

Step 3: Upload Your File

Step 4: Configure Approval Settings

Step 5: Click Continue

Step 6: Review Validation Results

Step 7: Review Summary and Confirm

Step 8: Submit the Batch

Batch Processing Statuses

Counterparty Handling

Roles and Permissions

Best Practices

Troubleshooting

Need Help?