Tendering, Tracking, and Managing Documents with the SMC3 EVA integration is completed with a series of API calls.
Carrier Quoting
See each section below for more specific call information.
The SMC3 EVA integration only supports 2 Stop Loads. If more than 2 Stop locations are included on a Load, no information returns.
SMC3 EVA does not support the same location for Pickup and Delivery Stops. If the same location is used as a Pickup and Delivery, users receive an error.
Carrier Quoting
Quoting Loads with SMC3 EVA includes two separate endpoints. Carrier pricing information is returned to the TMS and matched to the appropriate Carrier Services and Rate Entries to generate Carrier Quote records.
Aggregate Pricing
3PL/Broker Pricing
Loads are rated when any of the following occurs.
A user navigates to the Freight Quote Assistant for the first time.
A user refreshes quotes on the Carrier Quote Builder of the FQA.
A user clicks the Rerate action on the Customer Quote Builder of the FQA.
A user refreshes quotes on the Carrier Quote List LWC.
Users create Loads with the Quote Wizard in the Customer Portal.
Creating Loads with the LTL Pricing Workbench.
Creating Loads with the TMSLoadService web service.
A new Load is saved with the Save & Rate feature enabled.
When Save & Rate is enabled, Loads are rated when any of the following occurs.
By clicking Save & Rate as part of new Load creation.
When Loads are cloned and Save & Rate is checked.
When inbound EDI 204 LTL Load tenders are received.
Troubleshoot Load quoting issues with the following two components.
API Quote Log LWC contains descriptions of errors when quoting a Load.
Load Match Test LWC provides specific Rate Entry discrepancies for the Load.
Note the following criteria for quoting Loads.
Carrier Connect terminal information is automatically included in quoting responses and populated on Carrier Quote records.
Pricing information is returned in three supported currencies, USD, CAN, and MXN.
Quoting only supports whole numbers. Any decimal conversions are completed in the TMS and rounded up to the nearest whole number.
Packaging Units are not included in quoting requests. Only Handling Units are sent.
Aggregate
The Aggregate Pricing endpoint provides LTL quotes for multiple carrier/account combinations in a single request. Contract, Dynamic, or Volume pricing requests. Carrier Quotes are created from the pricing information returned from SMC3 EVA.
Responses are filtered to determine which Carrier Service is added to the Carrier Quote. For example, if two Carrier Services (Dynamic and VLTL) exist with the same Carrier SCAC, the pricing type for the quote is matched to the Carrier Service. As a result, Dynamic Carrier Services are paired to Carrier Quotes for dynamic pricing and Volume Carrier Services to volume pricing.
The Carrier Account Number, Payer, Payment Terms, or Bill To is populated on the Carrier Quote from the associated Rate Entry or Carrier Service.
TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
TMS operations that request quotes | EVA Aggregate Pricing | POST | 200: Success 400: Bad Request 401: Unauthorized 404: Not Found 405: Method Not Allowed |
TMS Fields included in Aggregate Pricing Request Payload
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Account | Account Name | Name | billTo → name, origin → name, destination → name |
Account | *Shipping Address | Address | address, city, country, postalCode, stateProvince |
API Accessorial | Code | Name | accessorials → codes |
Carrier Service | *Dynamic, VLTL, none | Checkbox | pricingType |
Contact | |||
Contact | Name | Name | contact.name, hazardousContact → name |
Contact | Phone | Phone | phone, hazardousContact → phone |
Document Options | Payer | Picklist | payment → payer |
Document Options | Payment Terms | Picklist | payment → terms |
Line Item | Handling Units | Picklist | packagingType |
Line Item | **HazMat Contact | Lookup(Contact) | If HAZ accessorial present |
Line Item | Height | Number(16, 2) | height |
Line Item | Height (sum of all Line Items) | Number(16, 2) | totalHeight |
Line Item | HU Count | Number(18, 0) | pieces |
Line Item | Item Description | Text(255) | description |
Line Item | Length | Number(16, 2) | length |
Line Item | NMFC Class | Picklist | commodities → classification |
Line Item | NMFC Number | Text(20) | nmfc, nmfcSub |
Line Item | Stackable | Checkbox | stackable |
Line Item | *Weight | Number(18, 0) | commodities → weight |
Line Item | Width | Number(16, 2) | width |
Line Item | Width (sum of all Line Items) | Number(16, 2) | totalWidth |
Load | **COD Amount | Currency(16, 2) | cod.amount |
Load | Expected Ship Date | Formula (Date) | transit → pickupDate |
Load | Linear Feet | Number(10, 2) | linearLength x Volume Pricing Type |
Load | Total Weight | Number(18, 0) | totalWeight |
Load | Weight Units | Picklist | unitsOfMeasure → weight |
Rate Entry | Bill To Override | Text(80) | billTo → name |
Rate Entry | *Carrier Account Number | Text(50) | billTo → account |
Rate Entry | *Payer | Picklist | payment → payer |
Rate Entry | *Payment Terms | Picklist | payment → terms |
Transportation Profile | *Customer API Access Id | Text(100) | evaAccessId |
Transportation Profile | *SCAC | Text(6) | scac |
User | contact → email | ||
User | Name | Name | contact → name |
User | Company Name | Text(80) | requestor → name |
User | Phone | Phone | contact → phone |
Line Item dimensions converted to inches by the TMS | unitsOfMeasure → dimensions | ||
SMC3 EVA Credentials Card | **Test Mode | Checkbox | isTest |
*Fields marked with an asterisk are required to successfully return quote information.
Line Item weights/weight units are converted to the Load Weight Units prior to sending the request.
Account Shipping Postal Code and Country field values are required to request quotes.
**Several fields are only included for specific Load requirements. When the scenarios below are selected, the fields are included in the quote request.
Load includes Checked HazMat field and/or Hazardous Material Handling accessorial.
Line Item HazMat Contact is required and included.
Line Item Item Description is required and included.
Load includes Collect on Delivery accessorial.
Load COD Amount field is included.
Requests only include the Test Mode field when Checked on the credentials card.
Sample Aggregate Quoting Request Payload
{
"carriers": [
{
"scac": "PYLE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "AACT",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "ABFS",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "AESY",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "AVRT",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "BTVP",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "BGET",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "BGLF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RBTW",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "CRHM",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "CIEQ",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "CTII",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "CLNI",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "AATJ",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "CCYQ",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DTST",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DAYR",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SDCR",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DYLT",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DAFG",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DPHE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DLDS",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DHRN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DOLR",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DBDE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "DUBL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "EXLA",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FXFE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FXNL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FMXE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FLOK",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FWDN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FCSY",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "FRZF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
}
],
"pricingTypes": [
"CONTRACT"
],
"serviceLevels": [
"All"
],
"transit": {
"pickupDate": "20260514"
},
"unitOfMeasure": {
"weight": "Pounds",
"dimensions": "Inches"
},
"commodities": [
{
"classification": "150",
"weight": "4265",
"description": "Mixed Cargo",
"length": 48,
"width": 48,
"height": 48,
"pieces": "12",
"packagingType": "PAT",
"stackable": "N"
}
],
"shipmentInfo": {
"totalWidth": 48,
"totalHeight": 48,
"totalWeight": 4265
},
"accessorials": {
"codes": [
"LTDAP"
]
},
"origin": {
"name": "SMC3 EVA Customer",
"address": "2333 Waukegan Rd.",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA"
},
"destination": {
"name": "Boston Beans",
"address": "526 Beacon Street",
"city": "Boston",
"stateProvince": "MA",
"postalCode": "02215",
"country": "USA"
},
"requestor": {
"name": "Scratch2-SC-US-tmsMain/packages/tmsMain-NAMESPACE",
"contact": {
"name": "User User",
"email": "testuser@revenova.com"
}
}
}TMS Field Updates from Aggregate Pricing Response Payload
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Carrier Quote | Accessorial Charges | Currency(16, 2) | totalChargeDetails → accessorialsTotal |
Carrier Quote | Billable Weight | Number(16, 2) | shipmentInfo → weight |
Carrier Quote | Carrier Quote Reference | Text(100) | quote → quoteId |
Carrier Quote | CurrencyIsoCode | Picklist | shipmentInfo → currency |
Carrier Quote | Deficit Charge | Currency(10, 2) | totalChargeDetails → deficitAmount |
Carrier Quote | Deficit Rate | Currency(10, 2) | shipmentInfo → deficitRate |
Carrier Quote | Deficit Weight | Number(12, 0) | shipmentInfo → deficitWeight |
Carrier Quote | Destination Movement Type | Picklist | movementInfo → movementTypeDestination |
Carrier Quote | Destination Terminal Code | Text(50) | terminals → destination → code |
Carrier Quote | Destination Terminal Email | terminals → destination → contact | |
Carrier Quote | Destination Terminal Location | Text Area(255) | terminals → destination → address, city, country, postalCode, stateProvince |
Carrier Quote | Destination Terminal Phone | Phone | terminals → destination → contact, terminals → destination → phone |
Carrier Quote | Direct/Interline | Picklist | movementInfo → movementType |
Carrier Quote | Discount | Currency(16, 2) | totalChargeDetails → discountAmount |
Carrier Quote | Effective Date | Date | quote → effectiveDate |
Carrier Quote | Estimated Delivery Date | Date | movementInfo → estimatedDeliveryDate |
Carrier Quote | Estimated Pickup Date | Date | transit → pickupDate |
Carrier Quote | Estimated Transit Time (Days) | Number(3, 0) | movementInfo → estimatedDeliveryDate |
Carrier Quote | *Expiration Date | Date/Time | quote → expirationDate |
Carrier Quote | External Quote Id | Text(80) | carrierResults → transactionId |
Carrier Quote | Freight Charges | Currency(16, 2) | totalChargeDetails → lineHaulGrossCharge |
Carrier Quote | Fuel Surcharge | Currency(16, 2) | totalChargeDetails → fuelSurcharge |
Carrier Quote | Net Freight Charges | Currency(16, 2) | totalChargeDetails → lineHaulNetCharge |
Carrier Quote | Origin Movement Type | Formula (Text) | movementInfo → movementTypeOrigin |
Carrier Quote | Origin Terminal Code | Text(50) | terminals → origin → code |
Carrier Quote | Origin Terminal Email | terminals → origin → contact | |
Carrier Quote | Origin Terminal Phone | Phone | terminals → origin → contact |
Carrier Quote | Rate Type | Text(40) | totalChargeDetails → rateType |
Carrier Quote | Service Class | Text(255) | service → level |
Carrier Quote Accessorial | Charge | Currency(16, 2) | accessorials → chargeAmount, totalChargeDetails → unItemizedAmount |
Carrier Quote Accessorial | Name | Text(80) | accessorials → description |
*SMC3 EVA provides a date in the response. The time for the field is set to 11:59 PM UTC.
Sample Aggregate Quoting Response Payload
{
"carriers": [
{
"scac": "JMMM",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "JEEL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "MTVL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "GELJ",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "GTJN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "HRCF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "KRLI",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "KYTT",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "KIDY",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "LREC",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "LTIN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "MGUL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "MFGN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "MANI",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "MWDP",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "NMTF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "NOPK",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "OAKH",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "ODFL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "13954260",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "PENS",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "PFEG",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "PITD",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RLCA",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RDFS",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RDTF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RSUT",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "RUDE",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SAIA",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SMCA",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SEFL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SMTL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "SUON",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "STDF",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "TFIN",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
},
{
"scac": "TVTX",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Prepaid",
"payer": "Shipper"
}
}
],
"pricingTypes": [
"CONTRACT"
],
"serviceLevels": [
"All"
],
"transit": {
"pickupDate": "20260514"
},
"unitOfMeasure": {
"weight": "Pounds",
"dimensions": "Inches"
},
"commodities": [
{
"classification": "150",
"weight": "4265",
"description": "Mixed Cargo",
"length": 48,
"width": 48,
"height": 48,
"pieces": "12",
"packagingType": "PAT",
"stackable": "N"
}
],
"shipmentInfo": {
"totalWidth": 48,
"totalHeight": 48,
"totalWeight": 4265
},
"accessorials": {
"codes": []
},
"origin": {
"name": "SMC3 EVA Customer",
"address": "2333 Waukegan Rd.",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA"
},
"destination": {
"name": "Boston Beans",
"address": "526 Beacon Street",
"city": "Boston",
"stateProvince": "MA",
"postalCode": "02215",
"country": "USA"
},
"requestor": {
"name": "Scratch2-SC-US-tmsMain/packages/tmsMain-NAMESPACE",
"contact": {
"name": "User User",
"email": "testuser@revenova.com"
}
}
}3PL/Broker Pricing
The 3PL/Broker Pricing endpoint provides LTL quotes from 3PL and other Brokers with a synchronous, request-response transaction. Note the following criteria for requesting quote information from the 3PL/Broker endpoint.
The Broker SCAC is included in the request so that only one broker is included per request. The response contains any Carrier Service or quote for that Broker SCAC.
If a Carrier Service with a given SCAC doesn’t exist, a Carrier Quote record is not created.
The Vendor field on the Carrier Quote is populated with the Broker Account.
TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
TMS operations that request quotes | SMC3 EVA 3PL/Broker Pricing | POST | 200: Success 400: Bad Request 401: Unauthorized 404: Not Found 405: Method Not Allowed |
Sample Broker Pricing Request Payload
{
"carriers": [
{
"scac": "JEEL",
"evaAccessId": "Revenova-126351",
"billTo": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"address2": "",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe Revenova HQ",
"phone": "3129997777",
"email": "testuser@revenova.com"
}
},
"payment": {
"terms": "Third Party",
"payer": "Shipper"
}
}
],
"pricingTypes": [
"CONTRACT"
],
"serviceLevels": [
"All"
],
"transit": {
"pickupDate": "20260531"
},
"unitOfMeasure": {
"weight": "Pounds",
"dimensions": "Inches"
},
"commodities": [
{
"classification": "50",
"weight": "1500",
"description": "Mixed Cargo",
"length": 24,
"width": 48,
"height": 48,
"nmfc": "3667",
"pieces": "1",
"packagingType": "PAT",
"stackable": "N"
},
{
"classification": "92.5",
"weight": "4410",
"description": "Bananas",
"length": 12,
"width": 24,
"height": 26,
"pieces": "2",
"packagingType": "BCH",
"stackable": "N"
}
],
"shipmentInfo": {
"totalWidth": 72,
"totalHeight": 74,
"totalWeight": 5909
},
"accessorials": {
"codes": [
"LFTP",
"HAZ"
],
"hazardousContact": {
"name": "Joe Revenova HQ",
"phone": "3129997777"
}
},
"origin": {
"account": "0123456789",
"name": "Revenova HQ",
"address": "2333 Waukegan Rd.",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA"
},
"destination": {
"name": "Denver Deli Meats",
"address": "1435 Fox St.",
"city": "Denver",
"stateProvince": "CO",
"postalCode": "80204",
"country": "USA"
},
"requestor": {
"name": "Scratch2-SC-US-tmsMain/packages/tmsMain-NAMESPACE",
"contact": {
"name": "User User",
"email": "test@revenova.com"
}
}
}TMS Fields included in Broker Pricing Request Payload
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Account | Account Name | Name | billTo → name, origin → name, destination → name |
Account | *Shipping Address | Address | address, city, country, postalCode, stateProvince |
API Accessorial | **Code | Text(80) | accessorials → codes |
API Accessorial | **Subcode | Text(50) | limitedAccessType.origin, limitedAccessType.destination |
Document Options or Rate Entry | Payer | Picklist | payment → payer |
Document Options or Rate Entry | Payment Terms | Picklist | payment → terms |
Line Item | *Item Description | Text(255) | commodities → description, hazardousDetails → description |
Line Item | Handling Units | Picklist | packagingType |
Line Item | Height | Number(16, 2) | height |
Line Item | HazMat Contact | Lookup(Contact) | hazardousContact, hazardousDetails → emergencyContact → phone |
Line Item | *HU Count | Number(18, 0) | commodities → pieces |
Line Item | Length | Number(16, 2) | length |
Line Item | *NMFC Class | Picklist | commodities → classification |
Line Item | **NMFC Number | Text(20) | commodities → nmfc, nmfcSub |
Line Item | Stackable | Checkbox | commodities → stackable |
Line Item | *Weight | Number(18, 0) | commodities → weight |
Line Item | Width | Number(16, 2) | width |
Load | **Cargo Value | Currency(16, 2) | insuranceDetails → monetaryValue |
Load | *Expected Delivery Date | Formula (Date) | transit → deliveryDate |
Load | Expected Ship Date | Formula (Date) | transit → pickupDate |
Load | HazMat | Checkbox | commodities → hazardous |
Load | **Insurance Amount | Currency(16, 2) | addtlInsuranceAmount |
Load | **Linear Feet | Number(10, 2) | shipmentTotals → linearLength |
Load | PO Number | Text(100) | commodities → po |
Load | Weight Units | Picklist | commodities → weightUnit |
Rate Entry | Carrier Account Number | Text(50) | customerAccountId |
Rate Entry | Payments Terms | Picklist | payment → Terms |
User | contact → email | ||
User | Name | Name | contact → name |
User | Company Name | Text(80) | requestor → name |
User | Phone | Phone | contact → phone |
Line Item dimensions converted to inches by the TMS | commodities → dimensionsUnit | ||
Line Item total dimensions included in inches. | shipmentTotals → dimensions | ||
SMC3 EVA Credentials Card | **Test Mode | Checkbox | isTest |
*Fields marked with an asterisk are required to successfully return quote information.
Line Item weights/weight units are converted to the Load Weight Units prior to sending the request.
Account Shipping Postal Code and Country field values are required to request quotes.
**Several fields are only included for specific Load requirements. When the scenarios below are selected, the fields are included in the quote request.
Line Item contains NMFC Number.
Line Item NMFC Number is included.
Load Pickup and Delivery locations include address and city values.
Load location Shipping Street and Shipping City values are included.
Load includes All Risk Insurance accessorial.
Load Cargo Value and Insurance Amount fields are required and included.
Load includes Limited Access Accessorial for pickup or delivery.
API Accessorial Code and Subcode fields are required and included.
Load includes Checked HazMat field and/or Hazardous Material Handling accessorial.
Line Item HazMat Contact is required and included.
Line Item Item Description is required and included.
Load includes calculated Linear Feet field value.
Load Linear Feet is included.
Requests only include the Test Mode field when Checked on the credentials card.
Sample Broker Pricing Response Payload
{
"transactionId": "3667-3667",
"brokerScac": "SMCA",
"brokerName": "Southern Motor Carriers Rate Conference, Inc.",
"brokerReferenceId": "12345678",
"carrierQuotes": [
{
"carrierScac": "JEEL",
"carrierName": "Southern Motor Carriers Rate Conference, Inc.",
"quoteId": "3667",
"effectiveDate": "20260102",
"expirationDate": "20260106",
"billTo": "Any Company, 123 Some Street, Atlanta GA 30313",
"service": {
"description": "Indirect Point"
},
"shipmentInfo": {
"weight": "1500",
"discountPercent": "56.0000",
"deficitWeight": "15",
"deficitRate": "14.99",
"deficitClass": "55",
"totalCharge": "1825.71",
"currency": "USD",
"carrierLiability": [
{
"type": "Machine",
"amount": "225.00"
}
],
"totalChargeDetails": {
"rateType": "CLASS",
"lineHaulGrossCharge": "14221.02",
"deficitAmount": "93.32",
"discountAmount": "12983.79",
"lineHaulNetCharge": "1237.23",
"fuelSurcharge": "533.49",
"accessorialsTotal": "45.00",
"unItemizedAmount": "9.99"
}
},
"accessorials": [
{
"code": "HAZ",
"description": "Hazardous material",
"chargeAmount": "45.00"
}
],
"transit": {
"pickupDate": "20260102",
"estimatedDeliveryDate": "20260103",
"estimatedTransitDays": "3",
"serviceDetail": {
"origin": "ATL",
"destination": "STL",
"service": "DIRECT"
}
}
}
],
"commodities": [
{
"itemNumber": "0000001",
"classification": "65",
"weight": "1500"
}
],
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}TMS Field Updates from Broker Pricing Response Payload
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Carrier Quote | Accessorial Charges | Currency(16, 2) | totalChargeDetails → accessorialsTotal |
Carrier Quote | Billable Weight | Number(16, 2) | shipmentInfo → weight |
Carrier Quote | Carrier Quote Reference | Text(100) | quote → quoteId |
Carrier Quote | CurrencyIsoCode | Picklist | shipmentInfo → currency |
Carrier Quote | Deficit Charge | Currency(10, 2) | totalChargeDetails → deficitAmount |
Carrier Quote | Deficit Rate | Currency(10, 2) | shipmentInfo → deficitRate |
Carrier Quote | Deficit Weight | Number(12, 0) | shipmentInfo → deficitWeight |
Carrier Quote | Destination Movement Type | Picklist | movementInfo → movementTypeDestination |
Carrier Quote | Destination Terminal Code | Text(50) | terminals → destination → code |
Carrier Quote | Destination Terminal Email | terminals → destination → contact | |
Carrier Quote | Destination Terminal Location | Text Area(255) | terminals → destination → address, city, country, postalCode, stateProvince |
Carrier Quote | Destination Terminal Phone | Phone | terminals → destination → contact, terminals → destination → phone |
Carrier Quote | Direct/Interline | Picklist | movementInfo → movementType |
Carrier Quote | Discount | Currency(16, 2) | totalChargeDetails → discountAmount |
Carrier Quote | Effective Date | Date | quote → effectiveDate |
Carrier Quote | Estimated Delivery Date | Date | movementInfo → estimatedDeliveryDate |
Carrier Quote | Estimated Pickup Date | Date | transit → pickupDate |
Carrier Quote | Estimated Transit Time (Days) | Number(3, 0) | movementInfo → estimatedDeliveryDate |
Carrier Quote | Expiration Date | Date/Time | quote → expirationDate |
Carrier Quote | External Quote Id | Text(80) | carrierResults → transactionId |
Carrier Quote | Freight Charges | Currency(16, 2) | totalChargeDetails → lineHaulGrossCharge |
Carrier Quote | Fuel Surcharge | Currency(16, 2) | totalChargeDetails → fuelSurcharge |
Carrier Quote | Net Freight Charges | Currency(16, 2) | totalChargeDetails → lineHaulNetCharge |
Carrier Quote | Origin Movement Type | Formula (Text) | movementInfo → movementTypeOrigin |
Carrier Quote | Origin Terminal Code | Text(50) | terminals → origin → code |
Carrier Quote | Origin Terminal Email | terminals → origin → contact | |
Carrier Quote | Origin Terminal Phone | Phone | terminals → origin → contact |
Carrier Quote | Rate Type | Text(40) | totalChargeDetails → rateType |
Carrier Quote | Service Class | Text(255) | service → level |
Carrier Quote Accessorial | Charge | Currency(16, 2) | accessorials → chargeAmount, totalChargeDetails → unItemizedAmount |
Carrier Quote Accessorial | Name | Text(80) | accessorials → description |
The Carrier Name returned from SMC3 EVA in the Broker Pricing call determines the Carrier Service record for the generated quote.
Automated PRO Assignment
The Automated PRO Assignment call requests a PRO Number from the Carrier. The PRO Number is included on the Bill of Lading to assist in tracking the Load. When a PRO Number is returned, that is used to create a barcode. The TMS has an integration with TEC-IT to generate barcodes based on the PRO Number. See the barcode integration documentation here.
The Request PRO Number checkbox field on the Carrier Service record determines whether this call is made or not for a given Load. This field is only visible when Carrier Services created with SMC3EVA credentials are added to the Carrier quote on the FQA.
The Request PRO Number field only displays if the Carrier Service contains SMC3 EVA credentials.
When Request PRO Number is Checked, the Automated PRO Assignment call occurs when the Assign or Tender action is completed on the FQA.
The Carrier Service assigned to the Load and the Origin City, State, Zip on the load are sent to acquire the PRO Number.
Carrier Services with SMC3EVA credentials call to the SMC3 RateWare integration for quoting purposes. Quoting with AccuFRATE, Banyan, or Project44 does not allow tendering, tracking, and managing documents with the SMC3EVA integration.

TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
Request a PRO Number | Automated PRO Assignment | POST | 200: Success 400: Malformed Request 500: Unexpected Error |
Sample Automated PRO Assignment Request Payload
{
"isTest": "true",
"origin": {
"city": "Louisville",
"stateProvince": "KY",
"postalCode": "40213",
"country": "USA"
}
}TMS Fields Included in PRO Assignment Request
Object | Field | Type | SMC3 Field |
|---|---|---|---|
(1P) Stop | City | Text(40) | city |
(1P) Stop | Country | Picklist | stateProvince |
(1P) Stop | Postal Code | Text(20) | postalCode |
(1P) Stop | State/Province | Picklist | country |
Transportation Profile | *SCAC | Text(6) | scac |
*Fields marked with an asterisk are required to request a PRO Number.
Sample Automated PRO Assignment Response Payload
{
"transactionId": "0a000a00-aaa0-00aa-000a-00aa00a00000",
"scac": "SMCA",
"proNumber": "12345678",
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}TMS Field Updates from PRO Assignment Response
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Load | PRO Number | Text(40) | proNumber |
Dispatch
Once a Carrier Service is Assigned to the Load, the Dispatch call tenders the Load to the Carrier.
Tendering the Load to a Carrier requires the PRO Number returned from the Automated PRO Assignment call.
When quoting with Rateware, the Carrier Quote Service Level field is auto-populated from the Rate Entry.
The Dispatch call is sent when the following actions are taken.
The Tender button on the FQA is clicked.
The Tender method on the Carrier Service is API.
The Carrier Service Credentials field matches a set of SMC3 EVA API credentials.
The following information is required to successfully send the Dispatch call and tender the Load.
Contact information is required for the first Stop and included automatically when present on the Account record.
All Stops require a Location account.
The first Stop Location account must have a value for the Shipping/Receiving Contact field. If the Shipping/Receiving Contact field is blank, an error is generated.
Any accessorial charges must be configured correctly.
Accessorial charges may be added to the Carrier quote after the quotes are returned from SMC3.
Accessorial charges added from the Carrier Quote record or related list - or from the Carrier Quote Builder - are not included in the Dispatch call when tendering the Load to the Carrier.
Accessorial charges added to the Load Accessorials related list on the Load Lightning Record Page are included in the Dispatch call when tendering the Load to the Carrier.
SMC3 EVA must support the accessorial charge(s) to include when tendering to a Carrier with the Dispatch call. Any unsupported accessorial codes included when dispatching generate an error.
The TMS does not include any accessorial charges with the EXCL API Accessorial code as part of the Dispatch call.
Follow the steps above for all unsupported accessorials and add EXCL as the API Accessorial code for the SMC3 EVA API Accessorials.
See SMC3 documentation for a list of supported Accessorial codes for dispatching.
Include any special pickup or delivery information in the Stop Instructions field to send in the Dispatch call.
When sending Hazmat information, the TMS first checks the Line Item Hazmat Contact and Hazmat Contact Phone fields. If no values are present, the TMS checks the Account for Hazmat Contact and Phone fields.
Included in the Dispatch call is any API Accessorial codes from accessorial charges added to the Load. The API Accessorial code must be supported by SMC3 EVA. Any unsupported codes generate an error.
The first and last Stop Instructions fields are combined and sent in the Dispatch call.
When the Service Level field on the Carrier quote is blank, the default Standard value is sent in the Dispatch call.
When no Expected Delivery Date is included on the Load, no date is sent in the Dispatch call.
TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
Tender Load to Carrier | Dispatch | POST | 200: Success 400: Request Error 500: Unexpected Error |
TMS Fields Included in the Dispatch Request
Object | Field | Type | SMC3 Field |
|---|---|---|---|
*‘TEST’ or ‘CREATE’ | dispatchCode | ||
Account | *Name | Name | billTo → name |
Account (CarrierBillTo) | *TMS Type | Picklist (Multi-Select) | payer |
Account (shipFrom) | *Account Name | Name | origin → name |
Account (shipTo) | *Account Name | Name | destination → name |
Account | *Billing Address | Address | billTo → address, city, country, postalCode, stateProvince |
Account (shipFrom) | *Shipping Address | Address | origin → address, city, country, postalCode, stateProvince |
Account (shipTo) | *Shipping Address | Address | destination → address, city, country, postalCode, stateProvince |
API Accessorial | Code | Text(80) | accessorial → codes |
Carrier Quote | Carrier Quote Reference | Text(100) | referenceNumbers → estimate |
Carrier Quote | *Service Class | Text(255) | service → level |
Contact (shipFrom) | *Account Name | Name | contact → name |
Contact (shipFrom) | *Phone | Phone | contact → phone |
Contact (shipFrom) | contact → email | ||
Contact (shipTo) | Name | Name | contact → name |
Line Item | *Handling Units | Picklist | packagingType |
Line Item | Hazmat Contact | Lookup(Contact) | hazardousContact → name, phone |
Line Item | Height | Number(16, 2) | height |
Line Item | *HU Count | Number(18, 0) | pieces |
Line Item | *Item Description | Text(255) | description |
Line Item | Length | Number(16, 2) | length |
Line Item | *NMFC Class | Picklist | classification |
Line Item | *Weight | Number(18, 0) | weight |
Line Item | Width | Number(16, 2) | width |
Load | Bill of Lading Number | Text(55) | referenceNumbers → bol |
Load | Expected Delivery Date | Formula (Date) | delivery → date |
Load | *Expected Ship Date | Formula (Date) | pickupAvailability → date |
Load | *Payment Terms | Picklist | terms |
Load | PO Number | Text(100) | referenceNumbers → po |
Load | PRO Number | Text(40) | referenceNumbers → pro |
Stop (first) | *Appointment Time | Text(11) | pickupAvailability → startTime, endTime, closeTime |
Stop | Instructions | Long Text Area (2000) | shipmentComments |
User | *Company Name | Text(80) | name → requestor |
User | *Email Sender Address | requestor → contact → email | |
User | *Name | Name | requestor → contact → name |
User | *Phone | Phone | requestor → contact → phone |
*Fields marked with an asterisk are required to send a Dispatch request.
The Service Level included in the dispatch request follows the following cascade logic.
Carrier Quote Service Class field.
The Service Level field returned for the API Service Level related list. This setting allows for compatibility with RateWare quotes.
If both above contain no value, the STND code is used.
Sample Dispatch request Payload
{
"dispatchCode": "CREATE",
"service": {
"level": "STND",
"delivery": {
"date": "20240320"
}
},
"shipmentComments": "PU: Pickup Instructions. Dlvy: Delivery Instructions",
"payment": {
"terms": "Third Party",
"payer": "Third Party"
},
"pickupAvailability": {
"date": "20240314",
"startTime": "090000",
"endTime": "220000",
"closeTime": "220000"
},
"commodities": [
{
"packagingType": "PAT",
"pieces": "3",
"classification": "250",
"weight": "650",
"length": "48",
"width": "48",
"height": "48",
"description": "Mixed"
}
],
"accessorials": {
"codes": []
},
"referenceNumbers": {
"bol": "214236691",
"pro": "24601-42"
},
"origin": {
"name": "SMC3 EVA Customer",
"address": "2333 Waukegan Rd.",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"contact": {
"name": "Joe SMC3 EVA Customer",
"phone": "3129997777",
"email": "donotreply@revenova.com"
}
},
"destination": {
"name": "Boston Beans",
"address": "526 Beacon Street",
"city": "Boston",
"stateProvince": "MA",
"postalCode": "02215",
"country": "USA",
"contact": {
"name": "Joe Boston Beans",
"phone": "3129997777",
"email": "donotreply@revenova.com"
}
},
"requestor": {
"name": "Test Requestor",
"contact": {
"name": "User User",
"phone": "8002723425",
"email": "donotreply@revenova.com"
},
"billTo": {
"account": "001RL000008rAcKYAU",
"name": "SMC3 EVA Customer",
"address": "2333 Waukegan Rd.",
"city": "Bannockburn",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA"
}
}
}Sample Dispatch Response Payload
{
"transactionId": "4e3b80b7-ce48-443a-ad82-1c84e43efcde",
"scac": "SMCA",
"referenceNumbers": [
{
"assignedBy": "Carrier",
"type": "pickup",
"number": "55667788"
},
{
"assignedBy": "Customer",
"type": "pro",
"number": "1234578"
}
],
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}TMS Field Updates from the Dispatch response
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Load | API Load Id | Text(40) | transactionId |
Stop (1P) | Pickup/Delivery Number | Text(200) | referenceNumbers → number |
Cancel Dispatch
Loads that were dispatched to a Carrier may be cancelled with the Cancel Dispatch API call.
The Cancel Dispatch request is sent when one of the following occurs.
The Carrier is removed from a Load from the Carrier Banner LWC.
The Load Status is set to Canceled.
Add the PRO Number and Bill of Lading Number fields to the Load TMS15 Field Set. When the PRO Number and Bill of Lading Number are included in the Field Set they are cleared when a Carrier is removed from the Load.
TMS Fields Included in the Dispatch Cancel Request
Object | Field | Type | SMC3 Field |
|---|---|---|---|
*’TEST’ or ‘CANCEL’ | dispatchCode | ||
Stop (1P) | *Pickup Delivery Number | Text(200) | cancelUpdateInformation → pickupNumber |
Carrier Quote | Removal Reason | Picklist | cancelReason |
Load | Expected Ship Date | Formula (Date) | scheduledPickupDate |
Load | PRO Number | Text(40) | proNumber |
*Fields marked with an asterisk are required to cancel a dispatch.
Sample Cancel Dispatch Request Payload
{
"dispatchCode": "CANCEL",
"cancelUpdateInformation": {
"pickupNumber": "55667788",
"scheduledPickupDate": "20240314",
"proNumber": "1234578"
}
}Sample Cancel Dispatch Response Payload
{
"transactionId": "4e3b80b7-ce48-443a-ad82-1c84e43efcde",
"scac": "SMCA",
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}No TMS field updates from the Cancel Dispatch call.
The Load Status field returns to Quotes Received.
Status Notifications
The TMS requests Status Notifications for Loads and SMC3 EVA returns updates as push notifications to the TMS. Load status sessions may be configured to begin automatically or manually.
Load reference numbers are included in the request to identify the shipment in the SMC3 EVA environment. The field order for matching follows the order below.
PRO Number
Bill of Lading Number
PO Number
Pickup Number
If all four reference numbers do not match, an error is generated that shows each reference number that did not match.
When a reference number matches a Load in the SMC3 EVA environment, a success message displays. The Carrier Status Comments field updates to include, “Load Tracking Started - Matched on [Reference Number].”
Manual Tracking
Manually begin tracking a Load by selecting SMC3 EVA from the Tracking Provider picklist on the Load Tracking Administration modal. The Load Tracking Administration modal is located on the Carrier Banner.
![]()
Begin tracking the Load by selecting the On button. Tracking updates are automatically retrieved based on the schedule set in TMS Admin → Configuration.
LTL Loads not dispatched with SMC3 EVA may also receive status notifications. Select SMC3 EVA as the Tracking Provider and set the tracking to On.
SMC3 EVA does not support ad hoc status update requests.
Tracking sessions begin automatically one day prior to the Load Expected Ship Date field. If tendering on the Expected Ship Date or the day before, the Load status session begins immediately.
SMC3 has a 20 day polling period for tracking and documents that begins when tracking is initiated. When manually beginning a Load status session, it is recommended to begin one day prior to the Expected Ship Date. If the Expected Ship Date updates after the session has started, the 20 day period does NOT change.
If the ship date for a Load changes, the current tracking session is ended and a new session is created. A new transactionId field is returned for the new status notification session for the Load. Any status notifications received for the previous tracking session are ignored by the TMS.
Automatic Tracking
Tracking sessions are automatically enabled by the SMC3EVAJob. This job runs twice daily, every 12 hours.
The job also runs when a Load is created and has an SMC3 EVA Carrier Service AND the Expected Ship Date is more than one day in the future.
The SMC3EVAJob identifies Loads with the following field values to determine when to begin a Status and Document session. All of the following criteria are required for the job to send the request for the Load.
Tracking Provider must be set to SMC3 EVA.
Tracking Number does not have a value.
The Load Expected Ship Date must be today or tomorrow.
The Tracking Number is set by the value returned from SMC3 EVA in the response.
View the status of the job in the Job Monitor LWC.
If a status session fails to initiate, the
transactionIdfield is captured from the error message. The Load Tracking Number field is updated so status notifications are associated with the correct Load.
The Carrier Status Comments field contains information regarding the scheduled or start of a tracking session. A Stop pickup date is not always provided as part of any Tracking Notifications. Pickup or Dropoff dates are only populated if provided as part of a Tracking Notification from SMC3.
Status Codes are sent from SMC3 EVA regarding Load actions. When a Status Code is received the following status fields are set accordingly.
Picked Up, In Transit, Delivered, or Out For Delivery, the first Stop Status is set to Departed.
Out for Delivery or In Transit, the last Stop Status is set to En Route.
Delivered, the last Stop Status is set to Departed.
In order to update missing Stop information, the historical status element from SMC3 is processed and updates the following fields.
Historical status updates are processed when they are sent by SMC3 as either a PICKED UP or DELIVERED status. All other status values are not processed by the TMS.
Load statuses are updated with the status payload elements.
Stop statuses are updated with the statusHistory payload elements.
Not all Carriers send historical status updates in the
statusHistoryelement. These values are processed and stored in the TMS when the Carrier supports the functionality and includes values in Status payloads.
Stop Departure Date and Departure Time fields are populated from status updates when the fields contain no values.
When the status code is PICKED UP, the following values are set.
The first Stop Status is set to Departed if not already set.
The Stop Departure Date and Departure Time fields are set when the fields contain no values.
The Departure Date must match the value entered on the Load. If the values do not match, the value is not set on the Stop.
When the status code is DELIVERED, the following values are set.
The final Stop Status is set to Departed if not already set.
The Stop Departure Date and Departure Time fields are set when the fields contain no values.
The Departure Date must match the value entered on the Load. If the values do not match, the value is not set on the Stop.
Status values do not overwrite existing field values.
Inbound status notifications are processed as Platform Events.
TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
Request Load Status Updates | Status Notifications | GET | 200: Success 400: Request Error 500: Unexpected Error |
TMS fields included in the Status Notifications Request
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Load | *Bill of Lading Number | Text(55) | bol |
Load | *Expected Ship Date | Formula (Date) | pickupDate |
Load | *PO Number | Text(100) | po |
Load | *PRO Number | Text(40) | proNumber |
Stop | *Address | Address | destination → country, postalCode |
Stop | *Address | Address | origin → country, postalCode |
Stop | *Pickup/Delivery Number | Text(200) | pickup |
*Fields marked with an asterisk are required.
Sample Status Notifications Request Payload
{
"transactionId": "3f5bd03f-7aa2-44a7-98e4-cd6e06787b18",
"scac": "SMCA",
"referenceNumbers": {
"proNumber": "123456789",
"bol": "444555678"
},
"shipmentInfo": {
"weight": "6400"
},
"origin": {
"postalCode": "60015"
},
"destination": {
"postalCode": "02215"
},
"transit": {
"pickupDate": "20240226",
"delivery": {
"estimatedDate": "20240229",
"estimatedTime": "130000",
"signature": "Joe Murphy",
"appointment": {
"date": "20240229",
"startTime": "134700",
"endTime": "134700",
"notes": "string"
}
}
},
"status": {
"code": "IN TRANSIT",
"date": "20240229",
"time": "105900",
"carrierDescription": "Shipment is in tansit",
"city": "Dayton",
"stateProvince": "OH"
},
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}Sample Status Notifications Response and Push Notification Payload
{
"transactionId": "3f5bd03f-7aa2-44a7-98e4-cd6e06787b18",
"scac": "SMCA",
"referenceNumbers": {
"proNumber": "123456789",
"bol": "444555678"
},
"shipmentInfo": {
"weight": "1750"
},
"origin": {
"postalCode": "30269"
},
"destination": {
"postalCode": "40213"
},
"transit": {
"pickupDate": "20260518",
"delivery": {
"estimatedDate": "20260518",
"estimatedTime": "130000",
"actualDate": "20260518",
"actualTime": "134700",
"signature": "Joe Murphy",
"appointment": {
"date": "20260518",
"startTime": "134700",
"endTime": "134700",
"notes": "string"
}
}
},
"status": {
"code": "DELIVERED",
"date": "20260518",
"time": "105900",
"utc": "2026-05-18T01:50:54.708Z",
"carrierDescription": "Shipment has been delivered to consignee",
"city": "LOUISVILLE",
"stateProvince": "KY"
},
"statusHistory": [
{
"code": "DELIVERED",
"date": "20260518",
"time": "105900",
"utc": "2026-05-18T01:50:54.708Z",
"carrierDescription": "Shipment has been delivered to consignee",
"city": "LOUISVILLE",
"stateProvince": "KY"
},
{
"code": "IN TRANSIT",
"date": "20260518",
"time": "064500",
"utc": "2026-05-18T01:50:54.708Z",
"carrierDescription": "Shipment in transit at terminal",
"city": "NASHVILLE",
"stateProvince": "TN"
},
{
"code": "PICKED UP",
"date": "20260518",
"time": "023200",
"utc": "2026-05-18T01:50:54.708Z",
"carrierDescription": "Shipment has been picked up from consignor",
"city": "PEACHTREE CITY",
"stateProvince": "GA"
}
],
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}TMS field updates from the Status Notification Response
Object | Field | Type | SMC3 Field |
|---|---|---|---|
Load | Last Reported City | Text(40) | city |
Load | Last Reported State/Province | Picklist | stateProvince |
Load | Load Status Comments | Text(255) | carrierDescription |
Load | *PRO Number | Text(40) | proNumber |
Load | Tracking Number | Text(40) | transactionId |
Stop | **Appointment Time | Text(11) | transit → delivery → appointment → startTime, endTime |
Stop | Carrier ETA Date | Date | transit → delivery → estimatedDate |
Stop | Carrier ETA Time | Text(5) | transit → delivery → estimatedDeliveryTime |
Stop | ***Carrier Status as of | Date/Time | status → utc |
Stop | Departure Date | Date | transit → delivery → pickupDate, actualDate |
Stop | Departure Time | Text(5) | transit → delivery → actualTime |
Stop | Stop Status | Picklist | status → code |
* The PRO Number field is only updated if the Carrier submits a different PRO Number in a status notification.
** The Stop Appointment Time field is only updated if blank on the last Stop.
*** The Carrier Status as of field is determined by the time zone returned from SMC3 EVA. Tracking updates are displayed on the Load page in the Load Tracking Tracking Log LWC. The TMS adjusts the time to the local Stop time zone for Pickup or Delivered tracking updates. Tracking updates that are not Pickup or Delivered are displayed in the user’s time zone.
SMC3 Status Codes | Stop 1 Pick Up Status | Stop 2 Drop Off Status |
|---|---|---|
Delivered | Departed | Departed |
Exception | N/A | N/A |
In Transit | Departed | En Route |
Info | N/A | N/A |
Out for Delivery | Departed | En Route |
Picked Up | Departed | En Route |
Unknown | N/A | N/A |
Time zone information is processed from the utc value provided in the Status Notification response. The Account Timezone field for a Stop location is evaluated to determine the value to parse. If no Timezone value is present on the Account, the date and time values from the response are parsed instead of the utc value. Add the appropriate Timezone field value to each Account to insure proper date and time processing.
There is no call to end a tracking session with SMC3 EVA. When a tracking session is ended in the TMS, all incoming status notifications are ignored.
In cases when a new tracking session is created, the original tracking session remains active. A new transactionId field is generated and sent from SMC3 EVA for the new tracking session. Reasons for creating a new tracking session are any of the following.
Shipping Date changes on the Load.
The Carrier is removed from the Load and tendered to a new Carrier.
The Load is cancelled.
Error Logs are created for every status notification received for the original tracking session. The message in the Error Log indicates the reason for the notification.
See SMC3 EVA status documentation here.
Documents
The TMS requests documents for Loads and SMC3 EVA returns documents as push notifications to the TMS in a .PNG format.
Document sessions begin automatically when the Status Notifications session begins to track the Load. Once received, documents are stored on the associated Load record.
Documents are received in the TMS as a .PNG format and are eligible for processing by the Customer Invoice Documents feature to easily attach them to Customer Invoices. Configure the Customer Invoice Documents settings to name documents appropriately and add them to invoices.
When a document is processed by the Customer Invoice Documents settings, additional Load fields may update as configured. For example, when a document is processed as a delivery receipt, the Load POD Received field is Checked.
The following document types may be received from SMC3 EVA.
Bill of Lading (BL)
Delivery Receipt (DR)
Invoice (INV)
Weight & Inspection Certificate (WC)
Inbound documents from SMC3 EVA are processed as Platform Events.
The request to begin receiving documents for a Load is sent when the Load is tendered to the Carrier or by the SMC3EVAJob.
TMS Operation | SMC3 Endpoint | Request Type | Response |
|---|---|---|---|
| Document Image Notifications | GET | 200: Success 400: Request Error 401: No callback URL defined 404: Endpoint Resource URI Not Found 500: Unexpected Error |
TMS Fields Included in Document Notification Request
Object | Field | Type | SMC3 Field |
|---|---|---|---|
‘BL,’ ‘DR,’ ‘INV,’ or ‘WC’ | documentType | ||
Load | *PRO Number | Text(40) | proNumber |
Transportation Profile | *SCAC | Text(6) | scac |
Sample Document Notifications Request URL
https://eva.smc3.com/notifications/v1/app/document/SMCA?documentType=BL&proNumber=204380071201&bol=444555678&fileType=PNG&pickupDate=20260429&originPostalCode=60601&destinationPostalCode=40214API Document Type | Value |
|---|---|
BL | Bill of Lading |
DR | Delivery Receipt |
INV | Invoice |
WC | Weight & Inspection Certificate |
If a document session fails to initiate, the transactionId field is captured from the error message. The Load Tracking Number field is updated so documents are added to the correct Load.
Sample Document Notifications Response Payload
{
"transactionId": "3f5bd03f-7aa2-44a7-98e4-cd6e06787b18",
"scac": "SMCA",
"proNumber": "204380071201",
"documentType": "BL",
"fileType": "PNG",
"images": [
"Base 64 encoded strings like: iVBORw0KGgoAAAANSUhEUgAA...UK1bFMLFAAAAAElFTkSuQmCC"
],
"messageStatus": {
"code": "10000191",
"message": "Your transaction has been received and is currently being processed.",
"resolution": "Indicates that your request has been received and is currently being processed.",
"status": "PASS",
"information": []
}
}No TMS fields are updated by the response or receiving documents.
If documents are larger than 12 MB, they are processed and the contents of the documents are replaced with the following.
Documents received are saved on the Load Documents section as .PNG files. If the file is too large for Salesforce to import an error message is displayed to the user.
When a new document session is created, the existing session remains active. A new
transactionIdis generated and sent from SMC3 EVA for the new session. Reasons for creating a new session are any of the following.
Shipping Date changes on the Load.
The Carrier is removed from the Load and tendered to a new Carrier.
The Load is cancelled.
Error Logs are created for every status notification received for the original session. The message in the Error Log indicates the reason for the notification.
See additional SMC3 EVA document information here.
Invoices
Carriers submit invoice information for Loads and SMC3 EVA pushes the invoice information to the TMS and a Vendor Invoice record is generated. The invoice record is then stored on the associated Load record.
Invoice information is received via a session that begins automatically when the Status Notifications session begins to track the Load.
Once received, the TMS attempts to match invoice information to the appropriate Load.
Load Matching
Vendor Invoice records are associated with the appropriate Load. The TMS matches invoice information to a Load according to the order below for each of the listed reference values.
Multiple invoices may match to a single Load.
Order | SMC3 EVA Payload Element | TMS Object | TMS Field |
|---|---|---|---|
1 |
| Transportation Profile (for the Carrier on the Load) | SCAC |
2 |
| Load | PRO Number |
3 |
| Load | PRO Number |
4 |
| Load | PRO Number |
5 |
| Load | Bill of Lading Number |
6 |
| Stop (1) | Pickup/Delivery Number |
7 |
| Load | PO Number |
8 |
| Carrier Quote (for the accepted quote) | Carrier Quote Reference |
To associate Invoice data with a Load, the match must be unique. If no match or multiple matches occur, the next option in the list above is attempted as a matching criteria. If the SCAC does not match any Carrier Transportation Profile in the TMS, no invoice data is stored in the TMS and a Queued Transaction record is created to log the error.
Invoice data that matches a SCAC field, but does not match (or matches multiple Loads) on any of the remaining reference field values generates an Unmatched Invoice Transaction record. These records may be manually matched to a Load withe the Unmatched Invoice Transaction Lightning Web Component (LWC).
Once invoice data is matched to a Load, the invoice → number is compared to any existing Vendor Invoice records on the Load to determine if the information is new or an update. Existing Vendor Invoices are matched by the Payee Reference field. The following occurs when invoice data matches an existing invoice on the Load based on the Invoice Status field value.
When the Invoice Status is Pending, the invoice record is updated with new information.
When the Invoice Status is any value except Pending, a Queued Transaction record is created in an Invalid Status. See the Error Handling section below.
Invoices that contain accessorial charges are matched to API Accessorial records in the TMS. If no API Accessorial matches, the charge is set to the Default Accessorial record on TMS Admin → Configuration.
The following formula fields are calculated in the TMS from the received invoice values.
Invoice Total
Net Freight Charges
Error Handling
Inbound invoice packets that fail to process are stored in the TMS as Queued Transaction records with an Invalid Status. Set the Queued Transaction Status to Failed to attempt to retry processing the invoice packet. If the packet processes successfully, the Status updates to Processed.
When the records are rerun from an Invalid status and still do not process, an Error Log record is created and the Status updates to Retry Failed. View Queued Transaction and Error Log records for troubleshooting issues with payloads that fail to generate invoices.
The examples below each generate Invalid records.
Incoming payload does not match any SCAC values in the TMS.
An invoice is generated for a Load without a Carrier Service assigned.
Invoice updates for an invoice that is not Pending fail.
An invoice currency is not supported in the TMS.
If an invoice is deleted from a Load, the Unmatched Invoice Transaction remains and the status is set to Pending.
See SMC3 EVA invoice information including supported accessorial charges here.
Sample Inbound Invoice Payload
{
"transactionId": "210-SMCA-781799411-1830-0001-159130378",
"scac": "SMCA",
"paymentTerms": "Third Party",
"invoice": {
"number": "159130380",
"date": "2026-06-25",
"correctionIndicator": ""
},
"transit": {
"pickupDate": "2026-06-25",
"delivery": {
"date": "2026-06-29",
"signature": "",
"time": ""
}
},
"shipmentInfo": {
"totalWeight": 255,
"totalPieces": 1,
"currency": "USD",
"totalCharge": "12000.27",
"totalChargeDetails": {
"lineHaulGrossCharge": "11867.45",
"minimumCharge": "N",
"discountPercent": "0.00",
"discountAmount": "0.00",
"lineHaulNetCharge": "11867.45",
"fuelSurcharge": "132.82",
"accessorialsTotal": "0.00"
},
"comments": []
},
"referenceNumbers": [
{
"referenceType": "bol",
"referenceValue": "1258714466"
},
{
"referenceType": "quoteId",
"referenceValue": "LHGQRZ0966A"
},
{
"referenceType": "customerReference",
"referenceValue": "API"
},
{
"referenceType": "customerReference",
"referenceValue": "RTSPT022645369"
},
{
"referenceType": "customerReference",
"referenceValue": "WWW9282664"
},
{
"referenceType": "customerReference",
"referenceValue": "048988675"
},
{
"referenceType": "customerReference",
"referenceValue": "5646024"
},
{
"referenceType": "customerReference",
"referenceValue": "LHGQRZ0966A"
},
{
"referenceType": "po",
"referenceValue": "RTSPT022645369"
}
],
"origin": {
"name": "SMC3 EVA CUSTOMER",
"address1": "2333 WAUKEGAN RD",
"address2": "",
"city": "BANNOCKBURN",
"stateProvince": "IL",
"postalCode": "60015",
"country": "USA",
"account": ""
},
"destination": {
"name": "DENVER DELI MEATS",
"address1": "1435 FOX ST",
"address2": "SUITE 200",
"city": "DENVER",
"stateProvince": "CO",
"postalCode": "80204",
"country": "USA",
"account": ""
},
"billTo": {
"name": "CARRIER BILL TO COMPANY",
"address1": "123 Main Street",
"address2": "",
"city": "CHICAGO",
"stateProvince": "IL",
"postalCode": "60605",
"country": "USA",
"account": ""
},
"unitOfMeasure": {
"weight": "Not Specified/Unknown",
"dimensions": "Not Specified/Unknown"
},
"commodities": [
{
"packagingType": "Pallet",
"pieces": 3,
"classification": 0,
"nmfc": "",
"nmfcSub": "",
"weight": 255,
"charges": {
"rate": "11867.45",
"rateType": "Flat Charge",
"total": "11867.45",
"tariffCode": "",
"tariffDate": ""
},
"description": "Mixed Cargo",
"length": 0,
"width": 0,
"height": 0
}
],
"accessorials": [
{
"code": "LDG",
"description": "LUMPER FEES - DESTINATION",
"chargeAmount": "120.00",
"smc3Code": "MISC",
"smc3Description": "LUMPER FEES - DESTINATION"
}
],
"messageStatus": {
"status": "PASS",
"code": "10000000",
"message": "Transaction was successful.",
"resolution": "",
"information": []
}
}TMS field updates from inbound Invoice payloads
Object | Field | Type | SMC3 Field |
|---|---|---|---|
API Accessorial | Code | Text(80) | *accessorials → smc3code |
Transportation Profile | SCAC | Type(6) | scac |
Vendor Invoice | Accessorial Charges | Currency(16, 2) | shipmentInfo → totalChargeDetails → accessorialsTotal |
Vendor Invoice | Carrier Bill To City | Text(40) | billTo → city |
Vendor Invoice | Carrier Bill To Country | Picklist | billTo → country |
Vendor Invoice | Carrier Bill To Name | Text(80) | billTo → name |
Vendor Invoice | Carrier Bill To Postal Code | Text(20) | billTo → postalCode |
Vendor Invoice | Carrier Bill To State | Picklist | billTo → stateProvince |
Vendor Invoice | Carrier Bill To Street | Text Area(255) | billTo → address1 |
Vendor Invoice | Discount | Currency(16, 2) | shipmentInfo → totalChargeDetails → discountAmount |
Vendor Invoice | Discount Percent | Percentage(3, 2) | shipmentInfo → totalChargeDetails → discountPercent |
Vendor Invoice | Destination City | Text(40) | destination → city |
Vendor Invoice | Destination Country | Picklist | destination → country |
Vendor Invoice | Destination Name | Text(80) | destination → name |
Vendor Invoice | Destination Postal Code | Text(20) | destination → postalCode |
Vendor Invoice | Destination State | Picklist | destination → stateProvince |
Vendor Invoice | Destination Street | Text Area(255) | destination → address1 |
Vendor Invoice | Freight Charges | Currency(16, 2) | shipmentInfo → totalChargeDetails → lineHaulGrossCharge |
Vendor Invoice | Fuel Surcharge | Currency(16, 2) | shipmentInfo → totalChargeDetails → fuelSurcharge |
Vendor Invoice | Incoming Net Freight Charge | Currency(16, 2) | shipmentInfo → totalChargeDetails → lineHaulNetCharge |
Vendor Invoice | Invoice Date | Date | invoice → date |
Vendor Invoice | Invoice Total | Formula (Currency) | shipmentInfo → totalCharge |
Vendor Invoice | Origin City | Text(40) | origin → city |
Vendor Invoice | Origin Country | Picklist | origin → country |
Vendor Invoice | Origin Name | Text(80) | origin → name |
Vendor Invoice | Origin Postal Code | Text(20) | origin → postalCode |
Vendor Invoice | Origin State | Picklist | origin → stateProvince |
Vendor Invoice | Origin Street | Text Area(255) | origin → address1 |
Vendor Invoice | Payee Reference | Text(100) | invoice → number |
Vendor Invoice | Transaction Id | Text(80) | transactionId |
Vendor Invoice Accessorial | Charge | Currency(16, 2) | accessorials → chargeAmount |
Vendor Invoice Accessorial | Name | Text(80) | accessorials → smc3description |
Vendor Invoice Freight Charge Item | Freight Charge | Currency(16, 2) | commodities → charges → total |
Vendor Invoice Freight Charge Item | Item Description | Text(255) | commodities → description |
Vendor Invoice Freight Charge Item | NMFC Class (Rated As) | Picklist | commodities → classification |
Vendor Invoice Freight Charge Item | Quantity | Number(16, 2) | commodities → pieces |
Vendor Invoice Freight Charge Item | Rate | Currency(10, 2) | commodities → charges → rate |
Vendor Invoice Freight Charge Item | Unit | Picklist | commodities → charges → rateType |
Vendor Invoice Freight Charge Item | Weight | Number(18, 0) | commodities → weight |
Vendor Invoice Freight Charge Item | Weight Units | Picklist | unitOfMeasure → weight |
*The smc3code field is matched to Vendor Invoice Accessorial records in the TMS. Any codes that do not match a TMS API Accessorial records are added to the Vendor Invoice as an Other accessorial.