MyEZClaim is the only web-based platform that allows logistics service providers and carriers to manage the full life cycle of cargo claims. MyEZClaim works to streamline the claims process through automating follow-up tasks/alerts, scheduled reports, and system integration through robust web services (APIs). Their cloud-based software allows users to manage freight claims, carrier claims, vendor claims, overcharge claims and overage, shortage, & damage (OS&D) incident management.
By integrating your Turvo tenant with your MyEZClaim account, your shipment data seamlessly transfers from Turvo into MyEZClaim so you can quickly manage your claims in the same place.
This article covers
- How to enable MyEZClaim for your tenant
- How the integration works
- Checking your claim creation status in the Product issue exception
Enabling MyEZClaim for your tenant
To enable MyEZClaim for your tenant, it’s important to have an established contract with MyEZClaims before enabling the connection with your Turvo tenant. Once you have the contract, be sure to obtain the following credentials:
- Client ID
- Client secret
- Account ID
- URL
Then, login to your Turvo tenant and navigate to the Profile icon at the top right corner of your page. Then, select Admin console from the drop-down menu.
Click the Integration Hub card.
Then, in the Available Integrations tab, scroll down to the Carrier tools integrations section and click the MyEZClaims tile.
On the Integrate tab, enter the following credentials collected from MyEZClaims into the appropriate fields in Turvo:
- ClientID
- Client secret
- Account ID
- URL
Finally, click the blue CONNECT button at the bottom right corner to establish the connection between Turvo and MyEZClaims.
How does it work?
Once your tenant is integrated with MyEZClaim, Turvo pushes the shipment and product issue exception information into MyEZClaim. The data sync triggers whenever a Product issue exception* is logged on a shipment in Turvo, creating a claim in MyEZClaim.
*Note: If any other exception type is created, data will not be sent to MyEZClaim. MyEZClaim only creates claims for Product issue exceptions.
Updates made to the Product issue exception in Turvo will send a message to MyEZClaim, updating the claim. However, resolving an exception in Turvo will not close the claim in MYEZClaim. Closing claims in the MyEZClaim platform needs to be performed separately.
Information from Turvo maps to a MyEZClaim claim in the following ways:
|
MyEZClaim field |
Turvo field |
Notes |
|
Fields with an asterisk (*) next to them are required in MyEZClaim |
||
|
Claim number |
Shipment ID |
Shipment ID is located in the Shipment block > Overview > IDs segment of the shipment in Turvo or in the breadcrumbs bar of the shipment (EX: Shipments > Plan > #12345-6789) |
|
Bill of lading Carrier |
Shipment ID |
Value is the same as the Claim number (or the Shipment ID in Turvo). |
|
Claim type* |
--- |
Defaults to “Loss and Damage” when integrated with Turvo. |
|
Status |
--- |
Defaults to POD for “Pending” when integrated with Turvo. |
|
Reason |
--- |
Defaults to D for “Damaged when integrated with Turvo. |
|
Bill of Lading date (date-time) |
Appointment date for the first pickup location on the route of the shipment. |
Timezone is not required; System timestamps are in Eastern timezone. Date-time format is the following: (yyyy-mm-dd hh:mm:ss). |
|
Delivery date (date-time) |
Appointment date for the last delivery location on the route of the shipment. |
|
|
PO number |
PO number |
PO number in Turvo is located in the IDs segment of the Customers block of the shipment. |
|
Vehicle number |
Trailer ID |
Trailer ID in Turvo is located in the IDs segment of the Carriers block of the shipment. |
|
Claim representative |
Defaults to “Turvo”. |
|
|
Company* |
Exception in Turvo is logged at shipment level: Pulls first customer on the shipment. Exception in Turvo is logged at stop level: Pulls fist customer, carrier, and all items associated with that stop (unless otherwise specified). |
|
|
Company code |
Customer ID |
Customer ID is the ID of the customer found in the Turvo URL. To find the ID, navigate to the customer profile in Turvo and look for the numbers listed after accounts/ in the URL. |
|
Company name |
Customer name |
|
|
Company email |
Customer email |
Optional–Not displayed in the claims within MyEZClaim. |
|
Primary contact name |
Primary contact |
Optional–Not displayed in the claims within MyEZClaim. |
|
Primary contact email |
Primary contact email |
Optional–Not displayed in the claims within MyEZClaim. |
|
Company address |
Customer address |
Primary address–Includes address line 1, city, state, country, and postal code. Optional–Not displayed in the claims within MyEZClaim. |
|
Company phone |
Customer phone |
Primary phone Optional–Not displayed in the claims within MyEZClaim. |
|
Carrier |
Exception in Turvo logged at shipment level: Pulls first carrier on the shipment. Exception in Turvo logged at stop level: Pulls the carrier associated with the route segment of the stop with all items, unless otherwise specified. |
|
|
Carrier code |
Carrier ID or Carrier’s Accounting ID (if using Dynamic GP) |
If your tenant uses Dynamic GP, the Carrier code maps to the Accounting ID available in the Carrier’s Turvo profile. The Accounting ID is available in the Details tab > Accounting segment of the Carrier’s Turvo profile. For more information on the Accounting ID, see our Viewing and editing carrier details article. If your tenant does not use Dynamic GP, the Carrier code maps to the Carrier ID. The Carrier ID is the ID of the carrier located in the Turvo URL. To locate a Carrier ID, navigate to the carrier’s profile in Turvo and look for the numbers listed after accounts/ in the URL. |
|
Carrier SCAC |
Carrier SCAC |
First SCAC for the carrier. Optional–Not displayed in the claims within MyEZClaim. |
|
Carrier name |
Carrier name |
|
|
Carrier email |
Carrier email |
Carrier’s primary email in Turvo. Optional--Not displayed in the claims within MyEZClaim. |
|
Primary contact name |
Primary contact name |
Optional–Not displayed in the claims within MyEZClaim. |
|
Primary contact email |
Primary contact email |
Optional–Not displayed in the claims within MyEZClaim. |
|
Carrier address |
Carrier address |
Primary address–Includes address line 1, city, state, country, and postal code. Optional–Not displayed in the claims within MyEZClaim. |
|
Carrier phone |
Carrier phone |
Carrier’s primary phone number. Optional–Not displayed in the claims within MyEZClaim. |
|
Products |
--- |
Exception logged in Turvo at shipment level: Pulls all items on the shipment, unless otherwise specified. Exception logged in Turvo at stop level: Pulls all items associated to the stop unless specified on the exception.* *Note: If there are no items associated with the stop, then all items in the shipment are pulled. |
|
Product code |
Item number |
Item number is located within the Details tab of the Item entity in Turvo. Go to Details > IDs or Summary > Item card > Item ID. |
|
Product* |
Item name |
|
|
Product quantity* |
Item quantity |
Product quantity will default to 0 if no quantity is available. MyEZClaim does not transfer units of measure from Turvo. |
|
Product weight* |
Item gross weight |
Weight will default to 0 if no value is available. |
|
Product price* |
Item value |
Price will default to 0 if no value is available. No calculation expected for claim costing. |
|
Product reason |
--- |
Defaults to D for “Damaged” when integrated with Turvo. |
|
Claimant* |
--- |
|
|
Claimant address code |
Tenant ID |
Tenant ID is the ID of your organization’s Turvo tenant located in the Turvo URL. To locate your tenant ID, navigate to your dashboard in Turvo and look for the numbers listed after app.turvo.com/#/ in the URL. |
|
Claimant full name |
Tenant name |
Tenant name is the name of your organization. |
|
Claimant address |
Tenant address |
Your organization’s address located in the Company profile tile of the Admin console–Includes address line 1, city, state, country, and postal code. |
|
Consignee* |
Consignee is the last stop-location on the shipment in Turvo, unless otherwise specified. |
|
|
Consignee address |
Location ID |
Location ID is the ID of the location found in the Turvo URL. To locate the location ID, navigate to the location’s profile in Turvo and look for the numbers listed after location/ in the URL. |
|
Consignee name |
Location name |
|
|
Consignee address |
Location address |
Primary address–Includes address line 1, city, state, country, and postal code. |
|
Shipper* |
The Shipper on a claim is the first stop-location on the shipment in Turvo, unless otherwise specified. |
|
|
Shipper address |
Location ID |
Location ID is the ID of the location found in the Turvo URL. To locate the location ID, navigate to the location’s profile in Turvo and look for the numbers listed after location/ in the URL. |
|
Shipper name |
Location name |
|
|
Shipper address |
Location address |
Primary address–Includes address line 1, city, state, country, and postal code. |
Checking your claim creation status in the Product issue exception
You can quickly view the status of your claim’s creation in MyEZClaim by accessing the Production issue exception, either from the shipment or from Workbench.
From the shipment, click the Fast Action Button (FAB) and select Exception. All exceptions associated with the shipment will be displayed. The Product issue exception with an attached MyEZClaim will display the claim’s creation status in blue, to the right of the MyEZClaim logo. Hover over the status text to see the date the claim was created in MyEZClaim.
Upon opening the exception from the FAB or from Workbench, the Claim status will display the claim’s creation status, either Claim created or Claim failed. The Claim created field will display a timestamp for the claim creation status update.
Note: These fields will only appear on Product issue exceptions where the tenant is integrated with MyEZClaim.
<%= heading %>