📋 Applies to: Admins · Partner Admins · Support staff (setup and configuration); users with the "Billing" permission (batch submission and report uploads) · Module: Management > Integrations · Accounting > Factoring Upload · Reports > Financial Reports > Factoring · Owner: Support team · Last reviewed: 2026-06
What This Integration Does
The WinFactor FTP integration (also called WinFactor factoring or invoice factoring via FTP) transmits invoice batches from Alvys to WinFactor automatically via FTP when you submit a batch from the Factoring Upload page. WinFactor reviews and funds the invoices, then makes purchase and payment reports available in their portal. You download those reports and upload them to Alvys to update the status of factored loads. Synonyms: invoice factoring, accounts receivable financing.
Provider: WinFactor · Integration type: One-way · Sync direction: Alvys to WinFactor (outbound FTP batch); purchase and payment report data uploaded manually by user.
Prerequisites
Before configuring this integration, confirm the following:
You hold an Admin, Partner Admin, or Support role to add the Notice of Assignment and configure integration credentials.
You hold the "Billing" permission to submit batches and upload reports.
Your subsidiaries are created in Alvys. Credentials must be configured separately for each subsidiary that uses WinFactor FTP.
You have received your FTP host address, username, and password from WinFactor. Contact WinFactor directly if you have not received these credentials.
You have received the Notice of Assignment text from WinFactor to add to your invoices.
Connect / Authenticate
Add your Notice of Assignment. The Notice of Assignment (NOA) declares to your customers that WinFactor has the right to collect payment on the invoices you factor. It must appear on every invoice submitted through this integration.
Click the Profile button in the upper right corner and select Management to open your Company Profile.
In the Document Configuration section, click the plus sign (+) button. The Manage Important Info window will appear.
In the drop-down menu, select Notice of Assignment.
Paste the NOA text provided by WinFactor into the text box.
Click Save.
Enter your WinFactor FTP credentials. You must configure FTP credentials for each subsidiary that will submit batches to WinFactor.
Navigate to Management and open the Integrations page.
Under the Factoring section, find WinFactor FTP.
In the subsidiary list, click the pencil icon next to the subsidiary you want to configure.
Enter the FTP Host, Username, and Password provided by WinFactor.
Click Save.
Repeat for each additional subsidiary that uses WinFactor FTP.
Field & Data Mapping
WinFactor FTP uses two specific CSV report formats for reconciliation:
Purchase Report: downloaded from the WinFactor portal as the DetailHistorywithfees CSV. This report contains funded invoice records. When uploaded to Alvys, it moves loads to Financed status.
Payment Report: downloaded from the WinFactor portal as the ReceiptHistoryDetail CSV. This report contains payment records. When uploaded to Alvys, it moves loads to Completed status.
Both files must be downloaded from the WinFactor portal in their original CSV format. Do not modify the file before uploading to Alvys.
Sync Behavior
This integration is one-way and outbound. Alvys transmits batch files to WinFactor via FTP when you submit a batch from the Factoring Upload page. There is no automatic inbound sync from WinFactor to Alvys; purchase and payment reports must be downloaded from the WinFactor portal and uploaded to Alvys manually after each funding and payment event.
How to Submit a Batch
Navigate to Accounting > Factoring Upload.
Select the subsidiary you are submitting for.
Select all loads in Queued status that you want to include in the batch.
Click Submit Batch.
Stay on the page until the submission completes. Navigating away during submission may interrupt the FTP transfer.
After submission, loads will update to Invoiced status.
How to Upload Your Purchase Report
After WinFactor funds the invoices in a batch, download the purchase report and upload it to Alvys.
Log in to the WinFactor portal and download the DetailHistorywithfees CSV for the relevant funding period.
Go to Reports > Financial Reports > Factoring in Alvys.
Click the Upload Purchase Report button in the bottom right corner of the page.
Select the DetailHistorywithfees CSV file from your device and click Upload. Loads included in the report will update to Financed status.
How to Upload Your Payment Report
When WinFactor confirms payment has been collected, download the payment report and upload it to Alvys.
Log in to the WinFactor portal and download the ReceiptHistoryDetail CSV for the relevant payment period.
Go to Reports > Financial Reports > Factoring in Alvys.
Click the Upload Payment Report button.
Select the ReceiptHistoryDetail CSV file from your device.
Click Upload. Loads included in the report will update to Completed status.
Verify It's Working
After submitting a batch, loads should move to Invoiced status within a few minutes of a successful batch submission. If a load remains in Queued status after submission, see the Troubleshooting section below. After uploading the purchase report, loads included in the report should move to Financed status. After uploading the payment report, loads included in the report should move to Completed status.
Troubleshooting
Batch does not submit or loads remain in Queued status
Confirm you stayed on the Factoring Upload page until the submission completed. Navigating away during submission can interrupt the FTP transfer. Retry the submission if the batch did not complete.
Verify that the FTP credentials in Management > Integrations are correct for the subsidiary. Re-enter the host, username, and password from WinFactor if needed and retry.
Confirm with WinFactor that the FTP server is available and your credentials are active.
Contact Alvys support if the batch continues to fail after verifying credentials.
Purchase or Payment Report upload does not process or loads do not update
Confirm you are uploading the correct file type: the DetailHistorywithfees CSV for the purchase report, the ReceiptHistoryDetail CSV for the payment report.
Confirm the CSV file has not been modified or re-saved in a different format before uploading. Upload the file as downloaded from the WinFactor portal.
Contact Alvys support if the upload continues to fail.
Limits / Unsupported
Automatic inbound sync from WinFactor to Alvys is not supported. Purchase and payment reports must be uploaded manually.
Each subsidiary requires its own set of FTP credentials. A single credential set cannot be shared across multiple subsidiaries.
Only loads in Queued status can be included in a batch submission.
FAQs
Q: What happens if I navigate away from the Factoring Upload page during submission?
A: The FTP transfer may be interrupted and the batch may not complete. Stay on the Factoring Upload page until the submission confirmation appears before navigating away.
Q: Which file should I download from WinFactor for the purchase report?
A: Download the DetailHistorywithfees CSV from the WinFactor portal. This is the file Alvys expects when you upload a purchase report.
Q: Which file should I download from WinFactor for the payment report?
A: Download the ReceiptHistoryDetail CSV from the WinFactor portal. This is the file Alvys expects when you upload a payment report.