FAQs: LTL Rating
Do I need to use certain units when passing length and width of my load to be compatible with the capacity provider?
When the API Configuration enable unit conversion field (apiConfiguration.enableUnitConvsersion) is set to “true,” you can pass in any weight/length unit you currently use and it will be automatically converted to the unit the capacity provider requires. If the field is set to “false,” and units are not what the capacity provider requires, the request will fail capacity provider validation and error will be returned. Work with your project44 implementation team to get this set up.
Do I need to enter a capacity account group code when requesting a quote for rates or transit times?
You only need to enter a value for capacityAccountGroupCode.accounts.code in a POST: Query for rate quotes or a POST: Query for transit time quotes if you want a quote from a specific capacity provider. If you want quotes for rate and transit times from multiple capacity providers, create a rating request with either no capacity provider specified in the accounts array or with multiple capacity providers specified in the accounts array of the POST request. If no capacity provider is specified, project44 will use all capacity providers in the specified account group. If multiple capacity providers are specified, project44 will rate only those capacity providers. project44 will take the stored credentials for those capacity providers and the account group combination to send a request to each capacity provider.
How do I compare rate and transit time quotes from multiple carriers/capacity providers?
When you submit an API request for rate or transit time quotes (POST: Query for rate quotes or a POST: Query for transit time quotes, respectively), you can either:
- Not enter anything for the field capacityAccountGroupCode.account.code, or
- Specify multiple providers for the field capacityAccountGroupCode.account.code
If no capacity provider is specified, project44 will use all capacity providers in the specified account group. If multiple capacity providers are specified, project44 will rate only those capacity providers.
What fields are required when submitting a request for a quote?
When submitting a quote request, you will need the following information:
-
For POST: Query for rate quotes:
- Postal code of the origin address
- Postal code of the destination address
- Package dimensions (length, width, height)
-
For POST: Query for transit time quotes:
- Postal code of the origin address
- Postal code of the destination address
How quickly will I receive responses for my quote request?
Ten seconds. The API configuration timeout parameter determines how long to wait for all LTL capacity providers to respond before sending the response back to you. The default for this is 10 seconds. For example: if a rate is requested for an account group containing 6 capacity providers, 5 respond within 10 seconds, and 1 capacity provider responds at the 12 second mark – the response sent back to you will contain 5 rate response and 1 error message stating the vendor timed out in sending a response to us.
While many capacity providers will respond within the 2-5 second range, we wait the full timeout length for every carrier for every carrier to respond. If one carrier is taking longer, will wait for them to respond before sending all rate responses to you or your TMS. Therefore, when requesting rates for multiple carriers the response time will only be as fast as the slowest carrier to respond.
Am I able to adjust the timeout for rating?
You can adjust the timeout for rating only if you are using project44’s API. In your POST: Query for rate quotes or POST: Query for transit time quotes, you can change the number of seconds to wait for a capacity provider to return a transit time quote in the apiConfiguration.time field. The default is 10 seconds.
You cannot adjust the timeout for rating in the VOC.
Why are my rates taking longer than usual to return?
We wait the full timeout length for every carrier to respond. If one carrier is taking longer, we will wait for them to respond before sending all rate responses to you or your TMS. Therefore, when requesting rates for multiple carriers the response time will only be as fast as the slowest carrier to respond.
What carriers do you support?
You can confirm whether project44 supports specific carriers based on your ability to add a carrier to the Capacity Providers Page in the Carriers Portal. To add carriers, please see the Managing Capacity Providers in the VOC section of the LTL and VLTL Products & Services User Guide.
Why am I not seeing all LTL rates being returned?
When running rates, only valid rates will be returned initially. The system filters out invalid results that show error messages. To see these, check the box “Show Error Messages Returned” to return all rates including those with error messages.