Truck Care Service API

Overview

The Truck Care Service API enables customers and partners to connect with Love's to both request service and access information around previous service engagements.

New services will be added over time and you can find a breakdown of the current capabilities below.

Onboarding

Love's secures our APIs using an OAuth flow. Credentials will be provided to you once approved for accessing this API.

Routes

/workOrders

GET /complete

• Takes in the following required query parameters:
  • customerNumber (comma separated list of IDs)
• Takes in the following Optional query parameters:
  • top
  • skip
  • toDate
  • fromDate
• Gets Completed Service Requests

POST /workOrders

• Creates a service request within Love's ecosystem
• Returns a service request number

Request

{
  "workOrders": {
    "serviceType": "Roadside",
    "serviceProviderNumber": "205",
    "partnerReferenceNumber": "EXT-12345",
    "serviceLocationDescription": "Off I-35S near MM 212",
    "serviceLocationLatitude": 123.456,
    "serviceLocationLongitude": 456.789,
    "serviceComments": "Please bring 2 mudflaps as well"
  },
  "authorization": {
    "authorizationRefNumber": "12345",
    "authorizationName": "John Doe"
  },
  "requestedServices": [
    {
      "partnerLineItemNumber": "0001",
      "complaintType": "Tire Replacement",
      "tirePosition": "LF",
      "axlePosition": "All Position",
      "newTireDOT": "D00001",
      "offTireDOT": "D00002",
      "unitServiced": "Tractor",
      "preferredProduct": {
        "productDescription": "215/75R15 XDT 180",
        "brand": "Michelin",
        "size": "275/80R22.5",
        "tireTreadDesign": "XT-01",
        "tireType": "Drive"
      }
    }
  ],
  "customer": {
    "identifierType": "DOT Number",
    "customerNumber": "913300",
    "customerName": "Gemini Motor Transport"
  },
  "driver": {
    "name": "John Doe",
    "phone": "405-555-1234",
    "email": "johndoe@test.com",
    "lovesLoyaltyNumber": 77785123456789
  },
  "payment": {
    "method": "Goodyear Preferred Fleet",
    "accountNumber": "12345"
  },
  "units": [
    {
      "vin": "4Y1SL65848Z411439",
      "type": "Tractor",
      "year": 2012,
      "make": "Freightliner",
      "model": "ModelName",
      "licensePlateNumber": "123ABCD",
      "licensePlateState": "OK",
      "unitNumber": "12345"
    },
    {
      "vin": "4Y1SL65848Z416437",
      "type": "Trailer",
      "year": 2016,
      "make": "Freightliner",
      "model": "ModelName",
      "licensePlateNumber": "123ZZZZ",
      "licensePlateState": "OK",
      "unitNumber": "12345"
    }
  ]
}

DELETE /workOrders/{workOrderNumber}

• Cancels an existing service request

Request

{
  "cancelReason": "Estimate Too High"
}