Turvo Integration - MyCarrierPackets

Turvo Integration - MyCarrierPackets

Enabling MyCarrier Packets in the portal
2. Click the hamburger symbol in the top left corner, and click on Integration Tools from the left hand menu


3.Click "Add Integration" under the Integrations section.



4. In the menu that populates, select Turvo from the list. Once selected, another menu will populate requesting you to create integration credentials for Turvo. Create a username and password.




Enabling MyCarrier Packets in Integration hub

Note: When RMIS is enabled in the Integration hub, MCP requires a support ticket to enable. 

  1. Log into your Turvo tenant. 

  2. Navigate to the Admin console via the Profile icon at the top right corner of the screen.

    image2.png

  3. Click the Integration hub tile.

    image1.png

  4. Scroll down to the Carrier tools integrations section of the Available Integrations tab and click the My Carrier Packets tile.

    image4.png

  5. On the Integrate tab, enter the following credentials obtained from MyCarrier Packets as described in the prerequisites section of this article:
    • Username
    • Password
  6. After the credentials are entered, the CONNECT button at the bottom corner of the screen changes from blue to grey. Click CONNECT to establish the connection. 

    image7.png

Set up Payment and Terms mapping

Note: If you do not want 'Payment and terms mapping' to sync from MyCarrier packets, skip this step and complete the setup process. Indicate No in Step 2 of the Post Setup Support Ticket step below. 

To map Payment and terms from MyCarrier Packets: 

  1. Toggle ON the desired terms.
  2. Copy and paste the exact payment text that you received from MyCarrier Packets in the corresponding payment terms field.
  3. Click SAVE.

When you complete and save all enablement configurations , click COMPLETE SETUP at the bottom right of the screen to finish establishing the MyCarrier Packets connection. 

Post Setup Support Ticket

Once you have completed MCP setup in Integration hub, open a Turvo Support ticket and include the details listed below:

  • Copy and paste this text: We have enabled MyCarrier Packets using Integration hub in the Turvo UI. We need you to complete the necessary steps to sync carrier accounts created via Turvo UI/Public API
  • Payment methods and terms mapping sync from MCP to Turvo: Indicate Yes or No

MyCarrier Packets status in Turvo

Important Note: A prerequisite for any information to be ingested into Turvo is the MCP Carrier Agreement. If the Carrier Agreement is not present then Turvo will not update the status or other info.

To view the status of the carrier that got synced from MyCarrier Packets in Turvo, navigate to the carrier Details tab and then click General > Status.


image6.png

The status will map to Turvo as either Active or Inactive. This Relates to the DOT Status of Active or Inactive in MCP. As long as the Carrier Agreement is available, the status will map as follows. If the Carrier Agreement is not available, the update from MCP is disregarded.

  • Active: The entity’s US DOT number is active.
  • Inactive:
    • OUT-OF-SERVICE: Carrier is under any type of out-of-service order and is not authorized to operate.
    • Inactive USDOT Number: Inactive per 49 CFR 390.19(b)(4); The biennial update of MCS-150 data has not been completed.
    • NOT AUTHORIZED: The entity’s USDOT number is active. However, the carrier does not have any operating authority and is not authorized to operate as an interstate, for-hire carrier.

How the MyCarrier Packet integration works

Once your tenant is configured with MyCarrier Packets, the workflow works as follows:

  1. In MyCarrier Packets, send the intellivite to your carrier so they can register and submit their information.

  2. After the carrier completes the packet, the information provided by the carrier will then be sent to your Turvo tenant. Information syncs from MyCarrier Packets and Turvo every 5 minutes.

    Carrier information is mapped from MyCarrier Packets to Turvo based on their DOT. If the carrier already exists in your tenant, Turvo will update the carrier’s profile with any new information provided in the completed packet. 

Important notes:

  • Data received from MyCarrier Packets will overwrite any manual changes that have been entered into Turvo.
  • For 1099 carriers, Turvo pulls Tax ID (TIN) information from MCP.

MyCarrier Packets carrier fields ingested into Turvo

The following table contains the fields that are mapped from MyCarrier Packets (MCP) into Turvo. Any fields not presented in this table are currently not mapped via the integration and require you to enter them into Turvo manually. 

Note: We attached a PDF version of the MyCarrier Packets carrier fields ingested into Turvo table. You can find this download at the bottom of the article, just below the table.

Important notes:

  • Various carrier profiles in MyCarrier Packets may have different fields completed. If you find a field is not mapping in Turvo, it's likely it is not present or completed in MyCarrier Packets.
  • Equipment size will always map to Turvo as Other because the field is not available in MyCarrier Packets.
  • The following information is not available in MyCarrier Packets and cannot be mapped to Turvo:
    • ARB
    • Exceptions contact
    • Offers contact
    • Claims address
    • Mode service type
  • Lanes are not mapped from MyCarrier Packets into Turvo.
  • There are no documents stored in the Carrier profile such as the insurance cert pdf.
  • Dispatcher information is not pulled into Turvo from MyCarrier Packets, even if it is available.
  • If the carrier does not have an SCAC, leave the field blank. Entering filler text like "XXXX" or
    "- - - -" results in Turvo identifying the SCAC as a duplicate and the carrier is not ingested.
  • There is an available configuration to block the ingestion of payment methods and terms into Turvo from MCP. Contact your Turvo representative to enable this configuration.

Carrier profile

Field in Turvo

Field in MyCarrier Packets (MCP)

Name

Company name

SCAC

Note: In cases where the SCAC isn’t provided by the carrier in MCP, the field will be blank in Turvo.

SCAC

DOT

DOT Number

MC

MC Number

Tax ID

TIN

Status

DOT Status

MCP statuses that will translate to Inactive in Turvo:

  • OUT-OF-SERVICE
  • Inactive USDOT Number
  • NOT AUTHORIZED

An ACTIVE status in MCP will translate to an Active status in Turvo.

Website

Website

 

Addresses

Main Address

Field in Turvo

Field in MyCarrier Packets (MCP)

Line 1

Address1

Line 2

Address2

City

City

State

State

Zip

Zip Code

Type > Main

N/A


Note: Main addresses in MCP do not need to be manually adjusted. They’re just listed as “address”.

Note: Mailing address may also be mapped from MCP into Turvo, if available. 

Billing Address

Line 1

Carrier Remit Address 1

Line 2

Carrier Remit Address 2

City

Carrier Remit City

State

Carrier Remit State Province

Zip

Carrier Remit Zip Code

Type > Billing

N/A

Important note: The general billing address will surface the Carrier's billing address, even if they are factored. The Pay-to fields (outlined below) are the source of truth for remit details.

 

Emails

Main Email

Field in Turvo

Field in MyCarrier Packets (MCP)

Email

Email

Type > Main

Billing Email

Field in Turvo

Field in MyCarrier Packets (MCP)

Email

Carrier Payment Info > Remit Email

Type > Billing

 

Phones

Main phone

Field in Turvo

Field in MyCarrier Packets (MCP)

Phone

Phone

Type > Main

Billing phone

Field in Turvo

Field in MyCarrier Packets (MCP)

Phone

If the Carrier is factored: The FactoringPhone number will be mapped to Turvo. 

If not factored: The SignaturePersonPhoneNumber will map to Turvo.

Type > Billing

Fax

Field in Turvo

Field in MyCarrier Packets (MCP)

Phone

Fax

Type > Fax

After hours phone

Field in Turvo

Field in MyCarrier Packets (MCP)

Phone

Weekday After Hours Support and/or Weekend After Hours Support

Type > After hours

Note: If the Weekday After Hours Support and Weekend After Hours Support phone numbers in MCP are the same, they will both be pulled into Turvo as the After hours phone, showing the same number twice.

 

Authority

Field in Turvo

Field in MyCarrier Packets (MCP)

Common authority

Authority

Contract authority

Broker authority

Note: The status of the Authority is also mapped into Turvo as either Active, Inactive, or None. The appropriate status will be brought into Turvo accordingly. 

 

Billing contact

Field in Turvo

Field in MyCarrier Packets (MCP)

Email

If factored: Factoring Company and Factors Remittance Instructions > Email

If NOT factored: Remit Info on File > Carrier Remit Info > Email

Phone

If factored: Factoring Company and Factors Remittance Instructions > Phone (if available)

If NOT factored: No Remit phone number available in MCP

 

Claims contact

Field in Turvo

Field in MyCarrier Packets (MCP)

Email

Contact Info > Claims Contact Email

Phone

Contact Info > Claims Contact Phone

Important note: Claims contact information may not be provided in every Carrier Packet completed in MCP. These fields will only translate to Turvo if they were completed by the Carrier. There is also no contact provided for Exceptions or Offers in MCP to map to Turvo.

 

Equipment

Important note: Accuracy of equipment information mapped from MCP to Turvo is currently under investigation. The mapping chart will be improved as updates become available.

Field in Turvo

Field in MyCarrier Packets (MCP)

Trailer type

Equipment

Van

NumberofVans

Reefer

NumberOfReefers

Power Unit-Tractor

NumberOfTractors

Flatbed

NumberOfFlats

StepDeck

NumberOfStepDecks

Tanker

NumberOfTanks

Quantity

Quantity

 

Mode

Field in Turvo

Field in MyCarrier Packets (MCP)

LTL

Modes > CarrierMode.LessThanTruckLoad

TL

Modes > CarrierMode.Truckload

Air

Modes > CarrierMode.Air

Drayage

Modes > CarrierMode.Intermodal

Ocean

Modes > CarrierMode.Ocean

Rail

Modes > CarrierMode.Rail

Parcel

Modes > CarrierMode.Partial 

Note: There is not a service type associated with modes when they are mapped into the carrier profile.

 

Insurance

Field in Turvo

Field in MyCarrier Packets (MCP)

Insurance type

Insurance

Liability

Auto Liability

Cargo

Cargo

Worker’s Comp

Worker’s Compensation

General

General Liability

Refrigeration breakdown coverage (For Cargo insurance only)

Cargo Liability w/ Refer Breakdown

Note: Cargo Liability w/ Refer Breakdown will translate into Turvo as Cargo insurance with the “Refrigeration breakdown coverage” checkbox selected.

Insurance amount

Coverage Limit

Expiration date

Expiration date

Provider

Underwriter

Producer

Agent

State

State

Policy number

Policy Number

 

Payments

Field in Turvo

Field in MyCarrier Packets (MCP)

Methods

Carrier Packet > Payment Options*

*Important note: There is an available configuration to block the ingestion of payment methods and terms into Turvo from MCP. Reach out to your Turvo representative to enable this configuration.

Terms

Advances

N/A

Important note: Advances do not reside in MCP and are only configurable in Turvo.

Pay to 

If the Carrier is factored: Factor name c/o Carrier Name, address for factoring comes from Carrier Packet > Factoring Company and Factors Remittance Instructions.

If non-factored: The pay to is listed as the Carrier and the address is found in the Carrier Packet > Remit Info on File.

 


    • Related Articles

    • Turvo Intergration - TruckStop / ITS

      Step 1: Enabling ITS via Integration hub in Turvo Log into your Turvo tenant and navigate to the Admin console via the Profile icon at the top right corner of the screen. In the Admin console, click the Integration hub tile. Then, scroll down to the ...
    • Turvo - Filter a Group from shipment/dashboard view

      1. On either the Dashboard or shipment screen, click "My filters" and then click create new filter 2. Under Visibility groups, select "is not" and then enter the group(s) that you want to filter, and then click save as 3. Enter a name for the new ...
    • How to Bill a Customer

    • Adding user to TFW database

      To add a user to the TFW database, you will first need to open up SQL. Once this is complete, you will see this homepage: Select "Databases" and then click on "Security and open the "Logins" folder as shown below: You will need to right click on ...
    • Setting up a new user in Okta/TecMFA

      1. Go to drivefs.okta.com and sign in 2. Click on Admin in the top right corner 3. On the left hand side menu, click on Directory Integrations under Directory. 4. You should see a list of active directories. Click on the FS.Rushville.local directory. ...