1 Get Location ID by External ID
- 1.1 Request example
- 1.2 Request parameters
- 1.3 Response Example
- 1.4 Response parameters
2 Simplified Search
- 2.1 Request example
- 2.2 Request parameters
- 2.3 Response example
- 2.4 Response parameters
3 Get/Refresh Token (Orders Auth)
- 3.1 Request Example
- 3.2 Request parameters
- 3.3 Response Example
- 3.4 Response Parameters
4 Get PO# by location
- 4.1 Request Example
- 4.2 Request parameters
- 4.3 Response Example
- 4.4 Response Parameters
5 Simplified Ordering
- 5.1 Request example
- 5.2 Request parameters
- 5.3 Response example
- 5.4 Response parameters

Demo API key: 89341dcdebfa37018f24ea227a5ca591

Get Location ID by External ID

Request example

curl --location 'https://devdemo.tireconnect.ca/api/v2/location/by_external_id/025?key=89341dcdebfa37018f24ea227a5ca591' \

Request parameters

Parameter	Value

Parameter

Value

key

^query

API key

^Required

external_id

^query

Location external ID

^Required

Response Example

{
    "notice": "Success",
    "data": {
        "locations": [
            {
                "id": 13118,
                "is_active": true,
                "name": "BJS WHSL B025",
                "address_line_1": "3805 HARTZDALE DR",
                "address_line_2": "",
                "city": "CAMP HILL",
                "latitude": 40.217,
                "longitude": -76.9359,
                "province": "Pennsylvania",
                "province_code": "PA",
                "postal_code": "17011-7810",
                "phone": "717-763-9550",
                "contact_name": "Myrah St-Onge",
                "logo": "https://devdemo.tireconnect.ca/uploads/dealer/d06755d1e86461435360ccb2f19072dcd1559cc8.png",
                "dealer_id": 11840,
                "external_id": "025",
                "bs_account_number": "777391",
                "holidays": null,
                "working_hours": null,
                "country": "United States",
                "country_code": "US",
                "mobile_phone": null,
                "email": "bjs0025@bjs.com"
            }
        ]
    }
}

Response parameters

id ^int	Location id
is_active ^boolean	Shows whether the location is active or not
name ^string	Location name
address_line_1 ^string	Address line 1
address_line_2 ^string	Address line 2
city ^string	Location city
latitude ^decimal	Location latitude
longitude ^decimal	Location longitude
province ^string	Location province
province_code ^string	Location province code
postal_code ^string	Location zip/postal code
phone ^string	Location phone number
contact_name ^string	Contact name
logo ^string	Dealer’s logo
dealer_id ^int	Dealer id
external_id ^string	Location external id
bs_account_number ^array	Location Bridgestone account number
holidays ^array	Array with location’s holidays. Can be null
working_hours ^string	Array with location’s working hours
country ^string	Location country
country_code ^string	Location country code
mobile_phone ^string	Location mobile phone
email ^string	Location email

Simplified Search

Request example

curl --location 'https://devdemo.tireconnect.ca/api/v2/tire/search/simplifiedSearch?key=89341dcdebfa37018f24ea227a5ca591' \
--header 'accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'location_id=13118' \
--data-urlencode 'part_numbers%5B0%5D=178720' \
--data-urlencode 'part_numbers%5B1%5D=332104' \
--data-urlencode 'quantity=4'

Request parameters

Parameter	Value

Parameter

Value

key

^string

API key

^Required

location_id

^integer

Location id

^Required

part_numbers[]

^array

Array of part numbers

^Required

quantity

^integer

Desired Quantity. Used to determine suppliers and their branches with enough quantity

^Required

Response example

Response parameters

Parameter	Value

Parameter	Value
notice ^string	Response status
nb_results ^integer	Number of found tires
part_number ^string	Tire part number
brand ^string	Tire brand
stock[] ^array	Stock information
tire_id ^string	Tire ID
quantity ^integer	Tire quantity
supplier ^string	Supplier id
supplier_name ^string	Supplier name
price ^integer	Tire price
tax ^integer	Tax
cost ^integer	Tire cost
fet ^integer	FET
fet_source ^string	Shows if FET comes from supplier or it’s calculated on TC side. Can be: tireconnect vendor
branches[] ^array	An array with stock per branch
branch ^string	Deprecated parameter
id ^string	Branch ID
quantity ^integer	Tire quantity
name ^string	Branch name
delivery_date_time ^object	Estimated delivery information specific for this branch
date ^string	Estimated delivery date
time ^string	Estimated delivery time
timezone ^string	Time zone
notes ^string	Information about estimated delivery
cutoff ^object	Information about cut off date&time for current branch
date ^string	Cut-off date
time ^string	Cut-off time
timezone ^string	Cut-off time zone

Get/Refresh Token (Orders Auth)

Request Example

Request parameters

dealer_location_id
^int

Dealer location

^required

pin_code
^int

Pin Code

^required

key
^string

API key

^required

Response Example

Response Parameters

token ^string	Authorisation token
expire ^int	expire time

Get PO# by location

Request Example

Request parameters

token
^query

Dealer location

^required

Response Example

Response Parameters

poNumber ^string	PO Number

Simplified Ordering

Request example

Request parameters

token ^string	Authorisation token
tires ^array	Array of tires. Please note that you can place several tires in one orders only in case they have same supplier.
tire_id ^string	Tire ID
quantity ^int	Tire quantity
branch ^string	Supplier branch. You should take this value from `branches.id` in search method
po_number ^string	PO Number

Response example

Response parameters

order_id ^int	Order ID in TireConnect system
invoice ^string	Invoice ID returned by supplier
shipping_cost ^int	Shipping cost of order
tires ^array	Array of tires
id ^string	Tire ID
part_number ^string	Tire part number
quantity_demand ^int	Requested tire quantity
quantity_ordered ^int	Ordered tire quantity
price ^int	Requested tire price
price_ordered ^int	Ordered tire price
status ^string	Tire status in order
message ^string	Message returned by supplier for each tire
status ^string	Order status
message ^string	Message returned by supplier for whole order
delivery_date_time ^object	Estimated Delivery Date & Time provided by the supplier

TireConnect Public

Simplified search & ordering flow for BJ's

Analytics

Get Location ID by External ID

Request example

Request parameters

Response Example

Response parameters

Simplified Search

Request example

Request parameters

Response example

Response parameters

Get/Refresh Token (Orders Auth)

Request Example

Request parameters

Response Example

Response Parameters

Get PO# by location

Request Example

Request parameters

Response Example

Response Parameters

Simplified Ordering

Request example

Request parameters

Response example

Response parameters

Related content