Turvo's Triumph Business Capital (TBC) integration

Triumph Business Capital (TBC) is an invoice factoring company that works to get your marginal revenue in advance while gathering the accounts receivable (AR) and executing the accounts payable (AP) via Triumph Pay (TPay).

How the integration works

When a customer and carrier invoice in Turvo is changed to the Approved status, it is shared with TBC via an sFTP integration. Turvo sends all invoice documentation as a single .pdf to TBC. TBC follows up with the brokers' customer, bills them, and lets TriumphPay know that they can issue the payment to the carrier. Turvo exports the carrier master data to TriumphPay to handle the carrier payables. The sFTP export is configured for every 1 hr and in most cases processed at the top of each hour. Once Turvo generates the report it can still take up to 15 mins before invoices are viewable in TBC. 

Important Note: TBC will ONLY bill your customer if you have the “presentment setting” enabled for that particular customer. 

Enablement prerequisites

Before initiating a connection between your Turvo tenant and TBC, you must first create an account with TBC. You can reach out to connect@tbcap.com for assistance with this setup. 

Next, reach out to TBC to obtain the following credentials to enter into Turvo to establish the connection:

• Ask TBC to provide the default username and password for the sFTP connection.
• Collect the following credentials from your TBC account: 
  • Carrier sftp domain: sftp://sftp.triumphpay.com
  • Carrier sftp port: 22
  • Carrier sftp username: Turvo_Customer -  username provided by TBC
  • Carrier sftp password: XXXXXXX password provided by TBC
  • Carrier sftp destination folder path: 
    • The default carrier sftp destination folder is /TMS_INPUT/CARRIERS/. If you have questions regarding the carrier sftp destination folder, reach out to TBC to confirm. 
  • Carrier prefix file name:
    • • The default carrier prefix is <Username>carrier. E.g. Turvo_carrier. If you have questions regarding the standard carrier prefix, reach out to TBC to confirm.
  • Invoice sftp domain: sftp://files.triumphbcap.com 
  • Invoice sftp port: 22
  • Invoice sftp username: Turvo_Customer -  username provided by TBC
  • Invoice sftp password: XXXXXXX default username provided by TBC
  • Invoice sftp destination folder path:
    • The default invoice sftp destination folder is /TMS_INPUT/. If you have questions regarding the invoice sftp destination folder, reach out to TBC to confirm. 
  • Invoice prefix file name:
    • The default invoice prefix is <Username>Invoice. E.g. Turvo_Invoice. If you have questions regarding the standard carrier prefix, reach out to TBC to confirm.
• In addition to the above requirements, TBC will share with you a document listing the integration details, Triumph Notice of Assignment Wording, and Database Key Conversion. You will use this information later in the setup process.

Enable Triumph Business Capital in Integration hub

1. Log into your Turvo tenant and navigate to the Admin console via the Profile icon at the top right corner of the screen.
   
   
   Important Note: We recommended you enable this integration in Turvo Production. TBC will not process invoices until a successful test has been completed in production. Additional steps may be required if enabled in my-sandbox. 
   
   
2. Click the Integration hub tile.
   
   
   
3. Scroll down to the Payment integrations section of the Available Integrations tab and click the TBC tile.
   
   
   
4. In the Integrate tab, enter the credentials obtained from TBC in the enablement prerequisites.
   
   
   
5. After the credentials are entered, the CONNECT button at the bottom corner of the screen changes from grey to blue. Click CONNECT to establish the connection. 
   
   
   Important Note: If you receive an “Invalid credentials” error message please contact your Turvo and TBC representatives for assistance.
   
   
6. Copy and paste the Triumph Notice of Assignment Wording to the bottom of the Terms and Conditions section of the customer invoice in Admin Console > Document templates. Refer to the document that TBC provided to you during the Enablement Prerequisite steps for the exact wording. It will be similar to the below example:
   

   Triumph Notice of Assignment Wording

   NOTICE OF ASSIGNMENT

   THIS INVOICE HAS BEEN ASSIGNED TO AND MUST BE PAID DIRECTLY TO,

   TRIUMPH FINANCIAL SERVICES, LLC d/b/a TRIUMPH BUSINESS CAPITAL LLC

   P.O. BOX 610028 Dallas, TX 75261-0028

Test the integration

Once the integration is enabled, you’ll verify that TBC is receiving the data using the steps below:

Create a Turvo test shipment with the following criteria:

• Customer and Carrier
• Customer External ID Reference #. 
  • Note: This maps to PO# in TBC.
• Customer and Carrier costs
• Documents: 
  • Customer Rate confirmation
  • BOL
  • POD 
  • Other 
  • Carrier Invoice 
  • Carrier Rate Confirmation
  • Customer Invoice

Move the customer and carrier invoice to the Approved status. 

Data transfer occurs at the top of every hour. It can take up to 15 minutes for an invoice to appear in TBC. 

• If you do not want data to transfer, move the customer invoice back to a non-approved status before the top of the next hour. 
• Once data transfer occurs it is final. You will need to work with TBC to stop any processing. 

Once TBC confirms data was transmitted, It may be required that you also perform a database key conversion. If TBC requests this be filled out please see the next step. If not, they will update your account to auto-process invoices received from Turvo.

Database Key Conversion

TBC will share a report with you listing all carriers setup in TBC. TBC will then ask you to provide the associated carrier key (or Payee key). In Turvo, this is the Carrier internal ID. This ID can be found in the URL of the carrier account, shown in the image below. 

This data should be extracted in the following ways:

• <100 carriers: Manually obtain and copy into the TBC report
• >100 carriers: Extract from Turvo Analytics (Carrier Internal ID) and map based on the name of the carrier, DOT, or MC. 

How does the integration work?

Once the Triumph Business Capital integration is enabled for your tenant, Turvo sends the following information to TBC:

• Carrier profile data
• Invoice data
  • Carrier payments: The information in the .csv provides the details that TBC needs to review, the customer that they need to gather payment from, and the associated carrier on that load that will receive payment via TriumphPay.
  • Customer payments: Once the invoice data .csv is reviewed, TBC follows up with your customer. They bill the customer and let TriumphPay know that they can issue the payment to the carrier.
  • Broker payments: Additionally, TBC pays the marginal revenue to you in advance.
    • As an example, the customer rate is $1,500, and the carrier rate is $1,000; TBC would pay you the margin of $500 in advance.
• Invoice documentation - sent out as a single pdf
  • Customer Invoice
    • Invoice to the shipper/customer
    • Rate confirmation from shipper/customer
    • Bill of Ladiing/Proof of Delivery
    • Lumper receipts, Scale tickets, Pallet exchanges
  • Carrier Invoice
    • Factor NOA/Factor release letters
    • Invoice from the carrier
    • Rate confirmation from the broker

Note: Exports to TBC are scheduled to happen at the top of every hour. 

Important considerations for data transfer

• Both the carrier and the customer invoice must be in Approved status. The invoices will sync after that latest invoice is approved. 
• All carrier updates are included in the report to TriumphPay.
• New carriers are included in the report to TriumphPay.

Information maps from Turvo to Triumph Business Capital in the following ways:

Carrier Profile Data

Customer Invoice Information

Carrier Invoice Information

Important considerations regarding the TBC integration

• How are invoice updates handled?
  • If you want to make invoice adjustments, you’ll need to add a letter at the end of the invoice number.
• What if Turvo sends TBC an invoice already received? 
  • TBC flags these as duplicates and reviews them manually to see if it’s a true duplicate or if there was an update.
• How is a customer approved/declined by TBC?
  • TBC has defined its own approval process based on aging and credit history and assesses the customers' ability for repayment. TBC can decline your customer of participation in TBC.