Applies to: Admins · Partner Admins · Support staff (integration setup); all users with the "Billing" permission (batch submission and report uploads)
Module: Management > Integrations; Accounting > Factoring Upload; Reports > Factoring
Provider: Compass Funding Solutions · Integration type: One-way (FTP) · Sync direction: Alvys submits invoice batches to Compass Funding via FTP; purchase report data returns through manual uploads
Last reviewed: 2026-08 · Owner: Support team
Compass Funding Solutions connects to Alvys via FTP to automate invoice batch submission. Purchase reports are downloaded from the Compass Funding client portal and uploaded into Alvys. Synonyms: Compass Funding, Compass factoring.
What This Integration Does
Compass Funding Solutions is an FTP-based factoring integration. Alvys submits invoice batches to Compass Funding via FTP using your client username and password. You then download the purchase report from the Compass Funding client portal and upload it into Alvys to update load statuses. Synonyms: Compass Funding, Compass factoring.
Prerequisites
Active account with Compass Funding Solutions
Client username and password from the Compass Funding client portal
Admin, Partner Admin, or Support access to configure the integration
"Billing" permission to submit batches and upload reports
Connect / Authenticate
Navigate to Management > Integrations.
Select Factoring from the list of integration types to filter the list.
Click the pencil icon next to Compass Funding to open the integration configuration.
Select the desired subsidiary. The Add Integration dialog appears with fields for your username and password.
Screenshot with the Integration page and the Factoring field
Enter your Compass Funding username and password. Click the blue Save button. Repeat the subsidiary selection and credential entry steps for each subsidiary if needed.
Field & Data Mapping
Alvys generates a batch file containing invoice data for the selected loads and submits it to Compass Funding via FTP. No manual data entry is required for the batch file.
Sync Behavior
Batch submission is initiated manually from Accounting > Factoring Upload. Purchase report data returns via manual upload from the Compass Funding client portal. There is no automated nightly sync.
Submit a Batch
Navigate to Accounting > Factoring Upload.
Select the correct subsidiary from the subsidiary selector.
Screenshot with the Factoring Upload page within Accounting module and uploading by Subsidiary option highlighted.
Select the loads to include in the batch.
Screenshot with the loads selecting in Factoring Upload
Click the blue Submit Batch button.
Wait until the submission is complete. The system will notify you when the batch submission has finished. Do not close this page or navigate away before the notification appears; doing so may disrupt the submission.
Screenshot with the Factoring Upload submission
Upload Your Purchase Report
Download the purchase report for the submitted batch from the Compass Funding client portal.
In Alvys, navigate to Reports > Factoring under the Operational Reports section.
Screenshot with Factoring Report option highlighted from Operational Reports section, Reports sidebar
Screenshot with the Factoring Report with the upload Purchase Report highlighted
Find the respective batch and select it. Click the blue upload button in the lower-right corner of the page.
Drag and drop the report file into the upload area, or click to select it from your device.
Screenshot with the Purchase Report upload option
Click Upload.
Repeat this process for each subsidiary if you submitted batches for multiple subsidiaries.
Verify It's Working
After submitting a batch, confirm the batch appears in the Compass Funding client portal. After uploading the purchase report, verify that load statuses have updated in Alvys as expected.
Troubleshooting
Load not showing on Factoring Upload
Confirm the load status is Queued.
Confirm the load’s invoicing settings use Factoring Upload as the delivery method.
Confirm the invoice and required documents were merged, either automatically or manually.
Confirm the load was not already included in another factoring batch.
Batch submission does not complete
Confirm you did not navigate away from Accounting > Factoring Upload before the system completion notification appeared. If you did, return to the page and check whether the loads still show a pre-submission status.
Confirm the subsidiary has valid FTP credentials configured. Navigate to Management > Integrations, locate Compass Funding, and verify the username and password are saved.
Contact Alvys support if the batch continues to fail after confirming credentials.
“Unable to locate file”
This error usually means the invoice file is no longer available.
To resolve it:
Review the load number shown in the error message.
Open that load in Alvys.
Regenerate the invoice.
Try submitting the factoring batch again.
Screenshot with uploading failing due to unable to locate file error message
“SFTP Authorization Error — Permission Denied (Password)”
This error usually means the credentials used to set up the integration are incorrect.
To resolve it:
Review the credentials entered in the factoring integration setup.
Confirm the password is correct.
If the integration uses FTP/SFTP credentials from the factoring provider, make sure the customer is using those credentials — not their personal portal login.
Screenshot with uploading failing due to incorrect credentials for factoring integration set up
“Duplicate batch or invoice numbers”
This can happen if the page is refreshed, closed, or reopened while a batch is being submitted.
This issue cannot be fixed manually by the customer. Contact the Support team so they can review and adjust the batch if needed.
Upload button is not visible on the Factoring report page
Confirm you have the "Billing" permission. Users without this permission cannot see the upload button.
Confirm the batch appears in Reports > Factoring. If it does not appear, confirm the batch was submitted from Accounting > Factoring Upload and that the system completion notification was received before navigating away.
Contact Alvys support if the batch was submitted and the notification was received, but the batch does not appear in Reports > Factoring.
Purchase/payment report upload issues
If a purchase or payment report fails to upload, review the file format and the error message. The message usually identifies what is missing or incorrect.
Make sure the file includes the load number as the unique identifier. Without the load number, Alvys cannot match the report to the correct load or update the load as financed/completed.
Screenshot with payment report failed due to invoice number from alvys missing
Slow large batch submissions
Large files or batches with a high volume of loads may take longer to upload.
If the upload is taking too long, try submitting a smaller batch. The Alvys team is also monitoring and improving performance for large batch submissions.
Screenshot with uploading loading for factoring message
Limits / Unsupported
Separate credentials must be configured for each subsidiary. One set of credentials cannot cover multiple subsidiaries.
Compass Funding does not support Payment Report uploads through this integration. Only Purchase Reports are uploaded in Alvys.
There is no automated or scheduled sync. All batch submissions and report uploads are initiated manually.
FAQs
Q: Where do I download the purchase report?
A: Download the purchase report from the Compass Funding client portal for the submitted batch. Then upload it to Alvys from Reports > Factoring.
Q: Can I use one set of credentials for multiple subsidiaries?
A: No. Each subsidiary requires its own username and password configured separately in Management > Integrations.
Q: What happens if I navigate away during batch submission?
A: Navigating away before the system sends a completion notification may disrupt the submission. Wait on the Accounting > Factoring Upload page until the notification appears before moving to another page.
Q: Do I need to repeat the upload process for each subsidiary?
A: Yes. If you submitted batches for multiple subsidiaries, download the purchase report for each subsidiary from the Compass Funding client portal and upload each one separately in Reports > Factoring.