JP Express Integration Guide

Connect FTM to JP Express for instant LTL rate lookups using secure SOAP-based requests.

---

Overview

JP Express offers direct rate quoting for Less-than-Truckload (LTL) shipments via SOAP API. With this integration, brokers and shippers using FTM can:

• Instantly fetch accurate freight rates using JP Express credentials
• Include detailed shipment parameters such as weight, class, pallet count, COD, and accessorials
• Display rates directly in the FTM Load or Quote creation view

---

How It Works

FTM constructs a secure SOAP XML request with your JP Express credentials and shipment info, then sends it to JP’s endpoint for rating.

The system will:

1. Send a structured SOAP request with all required fields
2. Receive a real-time rate response
3. Log the response in FTM for use in quoting or booking

---

Authentication & Endpoint

• Endpoint:
   https://webapi.myjpexpress.com/JpeWs.asmx
• Request Method:
   POST
• Content-Type:
   text/xml

---

Required Parameters

Your JP Express account must provide the following:

Field	Description
userName	JP Express username
password	JP Express password
rateAccount	Your account ID for rating
payee	Usually Shipper or Consignee
paymentMethod	e.g., PrePaid, Collect, etc.
originZip	Origin ZIP code
destZip	Destination ZIP code
parameters	List of RateParameter records
isCod	Boolean, true/false for COD
codAmount	COD amount (string)
accessorials	List of additional services

RateParameter Object Structure

Each RateParameter includes:

• Weight (lbs)
• Class (NMFC class code)
• Pallets (number of pallets)

FTM supports multiple parameters per request.

---

Sample XML Request (Auto-Generated)

This is handled internally by Apex classes. Example snippet:

<soap:Envelope xmlns:xsi="..." xmlns:xsd="..." xmlns:soap="...">
  <soap:Body>
    <GetRates xmlns="http://jpxpress.com/">
      <userName>YourUsername</userName>
      <password>YourPassword</password>
      ...
    </GetRates>
  </soap:Body>
</soap:Envelope>

---

Apex Integration Snippet

The integration logic is written in Apex and uses the native HttpRequest class to post the XML.

HttpRequest request = new HttpRequest();
request.setEndpoint('https://webapi.myjpexpress.com/JpeWs.asmx');
request.setMethod('POST');
request.setHeader('Content-Type', 'text/xml');
request.setBody(xmlRequest);
Http http = new Http();
HttpResponse response = http.send(request);

---

Where It Appears in FTM

This integration typically appears in:

• Quote Builder screen (broker side)
• Load creation if rating is required before booking
• Rate comparison tools within FTM
  
  

---

FAQs

1.  Can I add multiple RateParameters in one request?
    Yes. The integration supports multiple entries with different weights, classes, and pallet counts.

2.  What if I get an authentication error?
    Double-check your userName, password, and rateAccount in the static resource or named credentials setup.

3. Does this integration support live booking?
    No. This integration is for rate retrieval only. Booking must be completed manually.

Need Help?

Contact the FTM team at:  [email protected]