Rose Rocket Platform REST API v1.0.0
Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.
The Platform REST API lets you integrate with Rose Rocket applications using simple HTTP methods, in JSON formats, making this an ideal API for developing mobile applications or external clients.
A sample implementation has been provided and can be access by clicking on this sample link.
Base URLs:
Terms of service Email: Support
Authentication
API Key (jwt)
- Parameter Name: Authorization, in: header.
oAuth2 authentication.
- Flow: password
- Token URL = https://auth.roserocket.com/oauth2/token
| Scope | Scope Description |
|---|---|
| orders | manage orders |
| customers | manage customers |
| legs | manage legs |
| manifests | manage manifests |
| emanifests | manage emanifests |
| invoices | manage invoice |
| users | manage users |
| bills | manage bills |
| services | manage services |
| partner_portal | manage partner portal |
| connectors_orgs | manage connector orgs |
| equipment | manage equipment |
| bill_item_types | manage bill_item_types |
order
Manage orders
createOrder
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders
Create new customer’s order
Body parameter
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | Order | true | Order object |
Example responses
200 Response
{
"customer": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » customer | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
createProblem
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"title": "string",
"description": "string"
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/problems", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/problems
Create problem on order event
Body parameter
{
"title": "string",
"description": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | OrderProblemRequest | true | Create problem request object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"problem": {
"id": "string",
"created_at": "2019-10-11T01:17:18Z",
"updated_at": "2019-10-11T01:17:18Z",
"order_id": "string",
"type": "string",
"title": "string",
"description": "string",
"created_by": "string",
"resolved_by": "string",
"resolved_at": "2019-10-11T01:17:18Z"
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
| » problem | OrderProblem | false | none | Order Problem |
| »» id | string(uuid) | false | none | none |
| »» created_at | string(date-time) | false | none | The timestamp for the creation of the problem |
| »» updated_at | string(date-time) | false | none | The timestamp for the last update of the problem |
| »» order_id | string | false | none | Related order ID |
| »» type | string | false | none | Type of problem |
| »» title | string | false | none | title for problem |
| »» description | string | false | none | description of problem |
| »» created_by | string(uuid) | false | none | The id of the user who created the problem |
| »» resolved_by | string(uuid) | false | none | The id of the user who resolved the problem |
| »» resolved_at | string(date-time) | false | none | The timestamp for the resolution of the problem |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
upsertByExternalID
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/upsert", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/upsert
Create/Update order by External ID
Body parameter
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | Order | true | Order object |
Example responses
200 Response
{
"customer": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » customer | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
reviseOrder
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}/revise
Revise Order
Body parameter
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | Order | true | Order object |
Example responses
200 Response
{
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Order |
| 400 | Bad Request | Bad request | ApiError |
markInTransit
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit',
{
method: 'POST',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/mark_in_transit", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/mark_in_transit
Mark order in transit
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
Example responses
200 Response
{
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Order |
| 400 | Bad Request | Bad request | ApiError |
bulkCreateOrder
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"orders": [
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_create", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/bulk_create
Bulk create orders for a given customer.
Body parameter
{
"orders": [
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | bulkCreateOrderBody | true | Bulk create request object |
| » orders | body | [Order] | false | [Customer’s order] |
| »» id | body | string(uuid) | false | Auto generated system ID |
| »» sequence_id | body | integer | false | Auto generated sequence ID per customer |
| »» external_id | body | string | false | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | body | string | false | Auto generated human readable ID |
| »» tender_id | body | string | false | Tender ID that is related to the order. This field can be null |
| »» customer | body | OrderCustomer | false | Customer |
| »»» id | body | string(uuid) | false | Auto generated customer id |
| »»» external_id | body | string | false | Customer external id. This field value can be null |
| »»» short_code | body | string | false | Customer’s short code |
| »» origin | body | OrderAddress | true | Order address |
| »»» address_book_id | body | string(uuid) | false | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | body | string(uuid) | false | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | body | string | false | Organization name |
| »»» contact_name | body | string | false | Contact name |
| »»» address_1 | body | string | false | Address line 1 |
| »»» address_2 | body | string | false | Address line 2 |
| »»» suite | body | string | false | Suite number |
| »»» city | body | string | false | City |
| »»» state | body | string | false | State / Province |
| »»» country | body | string | false | Country (2 letter ISO) |
| »»» postal | body | string | false | Postal / Zip code |
| »»» phone | body | string | false | Phone number |
| »»» phone_ext | body | string | false | Phone extension |
| body | string | false | ||
| »»» fax | body | string | false | Fax |
| »»» latitude | body | number(float) | false | Coordinate (latitude). This field value can be null |
| »»» longitude | body | number(float) | false | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | body | string(date-time) | false | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | body | string(date-time) | false | Business hours range (end). This field value can be null |
| »» destination | body | OrderAddress | true | Order address |
| »» billing | body | OrderAddress | true | Order address |
| »» status | body | string | false | Order Status |
| »» billing_option | body | string | false | Billing Option |
| »» notes | body | string | false | Notes that will appear on BOL |
| »» po_num | body | string | false | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | body | string | false | Tender number |
| »» ref_num | body | string | false | Reference number |
| »» custom_broker | body | string | false | Custom broker information |
| »» declared_value | body | number(float) | false | Declared value |
| »» declared_value_currency | body | string | false | Declared value currency |
| »» pickup_start_at | body | string(date-time) | false | Pickup time range (start) |
| »» pickup_end_at | body | string(date-time) | false | Pickup time range (end) |
| »» pickup_appt_start_at | body | string(date-time) | false | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | body | string(date-time) | false | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | body | string(date-time) | false | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | body | string(date-time) | false | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | body | string(date-time) | false | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | body | string(date-time) | false | Delivery appointment time range (end). This field value can be null |
| »» dim_type | body | string | false | Dimension type |
| »» default_measurement_unit_id | body | string | false | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | body | string | false | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | body | [Commodity] | false | Commodities items |
| »»» id | body | string(uuid) | false | Auto generated commodity id |
| »»» measurement_unit | body | string | false | Measurement unit |
| »»» weight_unit | body | string | false | Weight unit |
| »»» freight_class | body | string | false | Freight class |
| »»» commodity_type | body | string | false | Commodity type |
| »»» commodity_type_other | body | string | false | If commodity type is set to other, then this field must have value |
| »»» description | body | string | false | Description of the commodity |
| »»» feet | body | number(float) | false | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | body | number(float) | false | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | body | number(float) | false | Length of the commodity |
| »»» width | body | number(float) | false | Width of the commodity |
| »»» height | body | number(float) | false | Height of the commodity |
| »»» weight | body | number(float) | false | Weight of the commodity |
| »»» nmfc | body | string | false | NMFC number |
| »»» is_stackable | body | boolean | false | Is this commodity can be stacked? |
| »»» quantity | body | integer | false | Quantity of the commodity |
| »»» pieces | body | integer | false | Total number of pieces. This field value can be null |
| »»» sku | body | string | false | SKU number |
| »» accessorials | body | [string] | false | none |
Enumerated Values
| Parameter | Value |
|---|---|
| »» status | new |
| »» status | saved |
| »» status | cancelled |
| »» status | quoting |
| »» status | quoted |
| »» status | no-quote |
| »» status | spot-quote-requested |
| »» status | pending-dispatch |
| »» status | dispatched |
| »» status | in-transit |
| »» status | delivered |
| »» status | archived |
| »» status | invoice-created |
| »» status | invoice-sent |
| »» status | invoice-paid |
| »» status | claim |
| »» status | draft-quick-quote |
| »» status | quick-quoting |
| »» status | quick-quoted |
| »» status | no-quick-quote |
| »» status | spot-qq-requested |
| »» status | pickup-request |
| »» status | rejected |
| »» billing_option | prepaid |
| »» billing_option | collect |
| »» billing_option | thirdparty |
| »» declared_value_currency | cad |
| »» declared_value_currency | usd |
| »» dim_type | ltl |
| »» dim_type | ftl |
| »» dim_type | volume |
| »»» measurement_unit | inch |
| »»» measurement_unit | cm |
| »»» weight_unit | lb |
| »»» weight_unit | kg |
| »»» commodity_type | skid |
| »»» commodity_type | other |
Example responses
200 Response
{
"job_id": "string",
"message": "string"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | BulkOrderCreateResponse |
| 400 | Bad Request | Bad request | ApiError |
Create Multistop Order
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad"
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/multistop", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/multistop
Create a multistop order
Body parameter
{
"external_id": "string",
"customer": {},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | MultistopOrder | true | Multistop Order object |
Example responses
200 Response
{
"customer": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad"
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » customer | MultistopOrder | false | none | Customer’s multistop order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» billing | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
Bulk Create Multistop Orders
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"orders": [
{
"order": {
"external_id": "string",
"customer": {},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad"
}
}
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/bulk_multistop", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/bulk_multistop
Create a multistop order in bulk
Body parameter
{
"orders": [
{
"order": {
"external_id": "string",
"customer": {},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad"
}
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | object | false | Multistop Orders |
| » orders | body | [object] | false | none |
| »» order | body | MultistopOrder | false | Customer’s multistop order |
| »»» id | body | string(uuid) | false | Auto generated system ID |
| »»» sequence_id | body | integer | false | Auto generated sequence ID per customer |
| »»» external_id | body | string | false | External ID for mapping the order to an external system. This field value can be null |
| »»» public_id | body | string | false | Auto generated human readable ID |
| »»» customer | body | OrderCustomer | false | Customer |
| »»»» id | body | string(uuid) | false | Auto generated customer id |
| »»»» external_id | body | string | false | Customer external id. This field value can be null |
| »»»» short_code | body | string | false | Customer’s short code |
| »»» billing | body | OrderAddress | true | Order address |
| »»»» address_book_id | body | string(uuid) | false | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»»» address_book_external_id | body | string(uuid) | false | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»»» org_name | body | string | false | Organization name |
| »»»» contact_name | body | string | false | Contact name |
| »»»» address_1 | body | string | false | Address line 1 |
| »»»» address_2 | body | string | false | Address line 2 |
| »»»» suite | body | string | false | Suite number |
| »»»» city | body | string | false | City |
| »»»» state | body | string | false | State / Province |
| »»»» country | body | string | false | Country (2 letter ISO) |
| »»»» postal | body | string | false | Postal / Zip code |
| »»»» phone | body | string | false | Phone number |
| »»»» phone_ext | body | string | false | Phone extension |
| body | string | false | ||
| »»»» fax | body | string | false | Fax |
| »»»» latitude | body | number(float) | false | Coordinate (latitude). This field value can be null |
| »»»» longitude | body | number(float) | false | Coordinate (longitude). This field value can be null |
| »»»» bus_hours_start_at | body | string(date-time) | false | Business hours range (start). This field value can be null |
| »»»» bus_hours_end_at | body | string(date-time) | false | Business hours range (end). This field value can be null |
| »»» status | body | string | false | Order Status |
| »»» billing_option | body | string | false | Billing Option |
| »»» notes | body | string | false | Notes that will appear on BOL |
| »»» po_num | body | string | false | Purchase order numbers (if multiple use comma separated values) |
| »»» tender_num | body | string | false | Tender number |
| »»» ref_num | body | string | false | Reference number |
| »»» custom_broker | body | string | false | Custom broker information |
| »»» declared_value | body | number(float) | false | Declared value |
| »»» declared_value_currency | body | string | false | Declared value currency |
Enumerated Values
| Parameter | Value |
|---|---|
| »»» status | new |
| »»» status | saved |
| »»» status | cancelled |
| »»» status | quoting |
| »»» status | quoted |
| »»» status | no-quote |
| »»» status | spot-quote-requested |
| »»» status | pending-dispatch |
| »»» status | dispatched |
| »»» status | in-transit |
| »»» status | delivered |
| »»» status | archived |
| »»» status | invoice-created |
| »»» status | invoice-sent |
| »»» status | invoice-paid |
| »»» status | claim |
| »»» status | draft-quick-quote |
| »»» status | quick-quoting |
| »»» status | quick-quoted |
| »»» status | no-quick-quote |
| »»» status | spot-qq-requested |
| »»» status | pickup-request |
| »»» status | rejected |
| »»» billing_option | prepaid |
| »»» billing_option | collect |
| »»» billing_option | thirdparty |
| »»» declared_value_currency | cad |
| »»» declared_value_currency | usd |
Example responses
200 Response
{
"customer": {
"response": [
{
"order_id": "string",
"stop_ids": "string",
"status": "string",
"error": "string"
}
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » customer | BulkMultiStopOrders | false | none | Bulk response for multistop orders |
| »» response | [object] | false | none | none |
| »»» order_id | string | false | none | Order ID of multistop order |
| »»» stop_ids | string | false | none | none |
| »»» status | string | false | none | none |
| »»» error | string | false | none | none |
consolidateExistingOrder
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate',
{
method: 'PUT',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/consolidate", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}/consolidate
Create a multistop order with stop from an existing order.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234 |
Example responses
200 Response
{
"job_id": "string",
"message": "string"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | BulkOrderCreateResponse |
| 400 | Bad Request | Bad request | ApiError |
bulkCreateQuotes
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"quotes": [
{
"order_id": "string",
"currency": "cad",
"customer_service_id": "string",
"is_expired": true,
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"est_delivery_start_at": "2019-10-11T01:17:18Z",
"est_delivery_end_at": "2019-10-11T01:17:18Z",
"notes": "string",
"error_message": "string",
"status": "quote-success",
"charges": {
"freight": 0,
"fuel": 0,
"accessorials": 0,
"total": 0
}
}
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/quotes/create_bulk
Bulk create quotes for a given customer.
Body parameter
{
"quotes": [
{
"order_id": "string",
"currency": "cad",
"customer_service_id": "string",
"is_expired": true,
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"est_delivery_start_at": "2019-10-11T01:17:18Z",
"est_delivery_end_at": "2019-10-11T01:17:18Z",
"notes": "string",
"error_message": "string",
"status": "quote-success",
"charges": {
"freight": 0,
"fuel": 0,
"accessorials": 0,
"total": 0
}
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | object | true | Bulk create quote request object |
| » quotes | body | [Quote] | false | [Quote] |
| »» id | body | string(uuid) | false | Auto generated quote id |
| »» order_id | body | string(uuid) | false | Order id this quote is associated to |
| »» currency | body | string | false | Declared value currency |
| »» customer_service_id | body | string(uuid) | false | Customer’s service of this quote generated from |
| »» is_expired | body | boolean | false | Is this quote has expired? |
| »» pickup_start_at | body | string(date-time) | false | Pickup time range (start) |
| »» pickup_end_at | body | string(date-time) | false | Pickup time range (end) |
| »» est_delivery_start_at | body | string(date-time) | false | Estimated delivery time range (start). This field value can be null |
| »» est_delivery_end_at | body | string(date-time) | false | Estimated delivery time range (end). This field value can be null |
| »» notes | body | string | false | Notes |
| »» error_message | body | string | false | Error message |
| »» status | body | string | false | Status |
| »» charges | body | object | false | none |
| »»» type | body | string(uuid) | false | Type |
| »»» quote_id | body | string(uuid) | false | Quote id this item is associated to |
| »»» description | body | string | false | Description |
| »»» quantity | body | integer | false | Unit quantity |
| »»» unit_price | body | integer | false | Unit price |
| »»» total | body | integer | false | Total |
| »» freight | body | number(float) | false | Freight charge |
| »» fuel | body | number(float) | false | Fuel charge |
| »» accessorials | body | number(float) | false | Accessorials charge |
| »» total | body | number(float) | false | Total charge |
Enumerated Values
| Parameter | Value |
|---|---|
| »» currency | cad |
| »» currency | usd |
| »» status | quote-success |
| »» status | quote-pending |
| »» status | quote-rejected |
| »» status | quote-error |
| »» status | dispatch-success |
| »» status | dispatch-pending |
| »» status | dispatch-rejected |
| »» status | dispatch-error |
| »»» type | freight |
| »»» type | freight-cwt |
| »»» type | freight-cwt-min |
| »»» type | freight-spot |
| »»» type | freight-pallets |
| »»» type | freight-pallets-min |
| »»» type | accessorial |
| »»» type | fuel |
| »»» type | misc |
Example responses
200 Response
{
"quotes": [
{
"id": "string",
"order_id": "string",
"currency": "cad",
"customer_service_id": "string",
"is_expired": true,
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"est_delivery_start_at": "2019-10-11T01:17:18Z",
"est_delivery_end_at": "2019-10-11T01:17:18Z",
"notes": "string",
"error_message": "string",
"status": "quote-success",
"charges": {
"freight": 0,
"fuel": 0,
"accessorials": 0,
"total": 0
}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » quotes | [Quote] | false | none | [Quote] |
| »» id | string(uuid) | false | read-only | Auto generated quote id |
| »» order_id | string(uuid) | false | none | Order id this quote is associated to |
| »» currency | string | false | none | Declared value currency |
| »» customer_service_id | string(uuid) | false | none | Customer’s service of this quote generated from |
| »» is_expired | boolean | false | none | Is this quote has expired? |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» est_delivery_start_at | string(date-time) | false | none | Estimated delivery time range (start). This field value can be null |
| »» est_delivery_end_at | string(date-time) | false | none | Estimated delivery time range (end). This field value can be null |
| »» notes | string | false | none | Notes |
| »» error_message | string | false | none | Error message |
| »» status | string | false | none | Status |
| »» charges | object | false | none | none |
| »»» type | string(uuid) | false | none | Type |
| »»» quote_id | string(uuid) | false | read-only | Quote id this item is associated to |
| »»» description | string | false | none | Description |
| »»» quantity | integer | false | none | Unit quantity |
| »»» unit_price | integer | false | none | Unit price |
| »»» total | integer | false | none | Total |
| »» freight | number(float) | false | none | Freight charge |
| »» fuel | number(float) | false | none | Fuel charge |
| »» accessorials | number(float) | false | none | Accessorials charge |
| »» total | number(float) | false | none | Total charge |
Enumerated Values
| Property | Value |
|---|---|
| currency | cad |
| currency | usd |
| status | quote-success |
| status | quote-pending |
| status | quote-rejected |
| status | quote-error |
| status | dispatch-success |
| status | dispatch-pending |
| status | dispatch-rejected |
| status | dispatch-error |
| type | freight |
| type | freight-cwt |
| type | freight-cwt-min |
| type | freight-spot |
| type | freight-pallets |
| type | freight-pallets-min |
| type | accessorial |
| type | fuel |
| type | misc |
selectQuote
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select',
{
method: 'POST',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select
Select a quote for a given customer, order and quote.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| quoteID | path | string | true | ID of the quote to select. |
Example responses
200 Response
{
"id": "string",
"order_id": "string",
"currency": "cad",
"customer_service_id": "string",
"is_expired": true,
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"est_delivery_start_at": "2019-10-11T01:17:18Z",
"est_delivery_end_at": "2019-10-11T01:17:18Z",
"notes": "string",
"error_message": "string",
"status": "quote-success",
"charges": {
"freight": 0,
"fuel": 0,
"accessorials": 0,
"total": 0
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Quote |
| 400 | Bad Request | Bad request | ApiError |
bulkCreateBookedOrder
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"orders": [
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/bulk_create_booked_order", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/bulk_create_booked_order
Bulk create booked orders for a given customer.
Body parameter
{
"orders": [
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | bulkCreateOrderBody | true | Bulk create request object |
| » orders | body | [Order] | false | [Customer’s order] |
| »» id | body | string(uuid) | false | Auto generated system ID |
| »» sequence_id | body | integer | false | Auto generated sequence ID per customer |
| »» external_id | body | string | false | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | body | string | false | Auto generated human readable ID |
| »» tender_id | body | string | false | Tender ID that is related to the order. This field can be null |
| »» customer | body | OrderCustomer | false | Customer |
| »»» id | body | string(uuid) | false | Auto generated customer id |
| »»» external_id | body | string | false | Customer external id. This field value can be null |
| »»» short_code | body | string | false | Customer’s short code |
| »» origin | body | OrderAddress | true | Order address |
| »»» address_book_id | body | string(uuid) | false | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | body | string(uuid) | false | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | body | string | false | Organization name |
| »»» contact_name | body | string | false | Contact name |
| »»» address_1 | body | string | false | Address line 1 |
| »»» address_2 | body | string | false | Address line 2 |
| »»» suite | body | string | false | Suite number |
| »»» city | body | string | false | City |
| »»» state | body | string | false | State / Province |
| »»» country | body | string | false | Country (2 letter ISO) |
| »»» postal | body | string | false | Postal / Zip code |
| »»» phone | body | string | false | Phone number |
| »»» phone_ext | body | string | false | Phone extension |
| body | string | false | ||
| »»» fax | body | string | false | Fax |
| »»» latitude | body | number(float) | false | Coordinate (latitude). This field value can be null |
| »»» longitude | body | number(float) | false | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | body | string(date-time) | false | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | body | string(date-time) | false | Business hours range (end). This field value can be null |
| »» destination | body | OrderAddress | true | Order address |
| »» billing | body | OrderAddress | true | Order address |
| »» status | body | string | false | Order Status |
| »» billing_option | body | string | false | Billing Option |
| »» notes | body | string | false | Notes that will appear on BOL |
| »» po_num | body | string | false | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | body | string | false | Tender number |
| »» ref_num | body | string | false | Reference number |
| »» custom_broker | body | string | false | Custom broker information |
| »» declared_value | body | number(float) | false | Declared value |
| »» declared_value_currency | body | string | false | Declared value currency |
| »» pickup_start_at | body | string(date-time) | false | Pickup time range (start) |
| »» pickup_end_at | body | string(date-time) | false | Pickup time range (end) |
| »» pickup_appt_start_at | body | string(date-time) | false | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | body | string(date-time) | false | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | body | string(date-time) | false | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | body | string(date-time) | false | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | body | string(date-time) | false | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | body | string(date-time) | false | Delivery appointment time range (end). This field value can be null |
| »» dim_type | body | string | false | Dimension type |
| »» default_measurement_unit_id | body | string | false | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | body | string | false | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | body | [Commodity] | false | Commodities items |
| »»» id | body | string(uuid) | false | Auto generated commodity id |
| »»» measurement_unit | body | string | false | Measurement unit |
| »»» weight_unit | body | string | false | Weight unit |
| »»» freight_class | body | string | false | Freight class |
| »»» commodity_type | body | string | false | Commodity type |
| »»» commodity_type_other | body | string | false | If commodity type is set to other, then this field must have value |
| »»» description | body | string | false | Description of the commodity |
| »»» feet | body | number(float) | false | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | body | number(float) | false | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | body | number(float) | false | Length of the commodity |
| »»» width | body | number(float) | false | Width of the commodity |
| »»» height | body | number(float) | false | Height of the commodity |
| »»» weight | body | number(float) | false | Weight of the commodity |
| »»» nmfc | body | string | false | NMFC number |
| »»» is_stackable | body | boolean | false | Is this commodity can be stacked? |
| »»» quantity | body | integer | false | Quantity of the commodity |
| »»» pieces | body | integer | false | Total number of pieces. This field value can be null |
| »»» sku | body | string | false | SKU number |
| »» accessorials | body | [string] | false | none |
Enumerated Values
| Parameter | Value |
|---|---|
| »» status | new |
| »» status | saved |
| »» status | cancelled |
| »» status | quoting |
| »» status | quoted |
| »» status | no-quote |
| »» status | spot-quote-requested |
| »» status | pending-dispatch |
| »» status | dispatched |
| »» status | in-transit |
| »» status | delivered |
| »» status | archived |
| »» status | invoice-created |
| »» status | invoice-sent |
| »» status | invoice-paid |
| »» status | claim |
| »» status | draft-quick-quote |
| »» status | quick-quoting |
| »» status | quick-quoted |
| »» status | no-quick-quote |
| »» status | spot-qq-requested |
| »» status | pickup-request |
| »» status | rejected |
| »» billing_option | prepaid |
| »» billing_option | collect |
| »» billing_option | thirdparty |
| »» declared_value_currency | cad |
| »» declared_value_currency | usd |
| »» dim_type | ltl |
| »» dim_type | ftl |
| »» dim_type | volume |
| »»» measurement_unit | inch |
| »»» measurement_unit | cm |
| »»» weight_unit | lb |
| »»» weight_unit | kg |
| »»» commodity_type | skid |
| »»» commodity_type | other |
Example responses
200 Response
{
"job_id": "string",
"message": "string"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | BulkOrderCreateResponse |
| 400 | Bad Request | Bad request | ApiError |
reviseOrderOriginByID
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"address": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
}
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_origin", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}/revise_origin
Revise the origin of an order by ID
Body parameter
{
"address": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
}
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | OrderAddressReviseRequest | true | Revise order address request object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"legs": [
{
"id": "string",
"sequence_id": 0,
"version": 0,
"external_id": "string",
"public_id": "string",
"order_id": "string",
"manifest_id": "string",
"origin_stop_id": "string",
"destination_stop_id": "string",
"origin": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"status": "available",
"origin_start_at": "2019-10-11T01:17:18Z",
"origin_end_at": "2019-10-11T01:17:18Z",
"origin_appt_start_at": "2019-10-11T01:17:18Z",
"origin_appt_end_at": "2019-10-11T01:17:18Z",
"destination_start_at": "2019-10-11T01:17:18Z",
"destination_end_at": "2019-10-11T01:17:18Z",
"destination_appt_start_at": "2019-10-11T01:17:18Z",
"destination_appt_end_at": "2019-10-11T01:17:18Z",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
],
"history": {
"origin_arrived_at": "2019-10-11T01:17:18Z",
"origin_in_at": "2019-10-11T01:17:18Z",
"origin_pickedup_at": "2019-10-11T01:17:18Z",
"origin_out_at": "2019-10-11T01:17:18Z",
"destination_arrived_at": "2019-10-11T01:17:18Z",
"destination_in_at": "2019-10-11T01:17:18Z",
"destination_delivered_at": "2019-10-11T01:17:18Z",
"destination_out_at": "2019-10-11T01:17:18Z"
}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | OrderAndLegsResponse |
| 400 | Bad Request | Bad request | ApiError |
reviseOrderDestinationByID
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"address": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
}
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_destination", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}/revise_destination
Revise the destination of an order by ID
Body parameter
{
"address": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
}
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | OrderAddressReviseRequest | true | Revise order address request object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"legs": [
{
"id": "string",
"sequence_id": 0,
"version": 0,
"external_id": "string",
"public_id": "string",
"order_id": "string",
"manifest_id": "string",
"origin_stop_id": "string",
"destination_stop_id": "string",
"origin": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"status": "available",
"origin_start_at": "2019-10-11T01:17:18Z",
"origin_end_at": "2019-10-11T01:17:18Z",
"origin_appt_start_at": "2019-10-11T01:17:18Z",
"origin_appt_end_at": "2019-10-11T01:17:18Z",
"destination_start_at": "2019-10-11T01:17:18Z",
"destination_end_at": "2019-10-11T01:17:18Z",
"destination_appt_start_at": "2019-10-11T01:17:18Z",
"destination_appt_end_at": "2019-10-11T01:17:18Z",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
],
"history": {
"origin_arrived_at": "2019-10-11T01:17:18Z",
"origin_in_at": "2019-10-11T01:17:18Z",
"origin_pickedup_at": "2019-10-11T01:17:18Z",
"origin_out_at": "2019-10-11T01:17:18Z",
"destination_arrived_at": "2019-10-11T01:17:18Z",
"destination_in_at": "2019-10-11T01:17:18Z",
"destination_delivered_at": "2019-10-11T01:17:18Z",
"destination_out_at": "2019-10-11T01:17:18Z"
}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | OrderAndLegsResponse |
| 400 | Bad Request | Bad request | ApiError |
reviseOrderCommoditiesByID
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/revise_commodities", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}/revise_commodities
Revise the commodities of an order by ID
Body parameter
{
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | CommodityReviseRequest | true | Revise order commodities request object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"legs": [
{
"id": "string",
"sequence_id": 0,
"version": 0,
"external_id": "string",
"public_id": "string",
"order_id": "string",
"manifest_id": "string",
"origin_stop_id": "string",
"destination_stop_id": "string",
"origin": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"status": "available",
"origin_start_at": "2019-10-11T01:17:18Z",
"origin_end_at": "2019-10-11T01:17:18Z",
"origin_appt_start_at": "2019-10-11T01:17:18Z",
"origin_appt_end_at": "2019-10-11T01:17:18Z",
"destination_start_at": "2019-10-11T01:17:18Z",
"destination_end_at": "2019-10-11T01:17:18Z",
"destination_appt_start_at": "2019-10-11T01:17:18Z",
"destination_appt_end_at": "2019-10-11T01:17:18Z",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
],
"history": {
"origin_arrived_at": "2019-10-11T01:17:18Z",
"origin_in_at": "2019-10-11T01:17:18Z",
"origin_pickedup_at": "2019-10-11T01:17:18Z",
"origin_out_at": "2019-10-11T01:17:18Z",
"destination_arrived_at": "2019-10-11T01:17:18Z",
"destination_in_at": "2019-10-11T01:17:18Z",
"destination_delivered_at": "2019-10-11T01:17:18Z",
"destination_out_at": "2019-10-11T01:17:18Z"
}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | OrderAndLegsResponse |
| 400 | Bad Request | Bad request | ApiError |
getAuditHistory
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"internal_note": "string"
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/events/internal_notes
Create an order note
Body parameter
{
"internal_note": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | InternalNote | true | Note Text |
Example responses
200 Response
{
"order_note": {
"id": "string",
"created_at": "2019-10-11T01:17:18Z",
"updated_at": "2019-10-11T01:17:18Z",
"user_id": "string",
"order_id": "string",
"data": {}
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order_note | OrderAuditEvent | false | none | An order audit event |
| »» id | string(uuid) | false | none | none |
| »» created_at | string(date-time) | false | none | The timestamp for the creation of the order file |
| »» updated_at | string(date-time) | false | none | The timestamp for the last update of the order file |
| »» user_id | string(uuid) | false | none | none |
| »» order_id | string(uuid) | false | none | none |
| »» data | object | false | none | none |
GetAuditHistory
Code samples
# You can also use wget
curl -X GET https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
method: 'get',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
{
method: 'GET',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.get 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.get('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("GET", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/internal_notes", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
GET /customers/{customerID}/orders/{orderID}/events/internal_notes
Get an internal event by orderID
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
Example responses
200 Response
{
"order_audit_history": [
{
"id": "string",
"created_at": "2019-10-11T01:17:18Z",
"updated_at": "2019-10-11T01:17:18Z",
"user_id": "string",
"order_id": "string",
"data": {}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order_audit_history | [OrderAuditEvent] | false | none | [An order audit event] |
| »» id | string(uuid) | false | none | none |
| »» created_at | string(date-time) | false | none | The timestamp for the creation of the order file |
| »» updated_at | string(date-time) | false | none | The timestamp for the last update of the order file |
| »» user_id | string(uuid) | false | none | none |
| »» order_id | string(uuid) | false | none | none |
| »» data | object | false | none | none |
createComment
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"comment": "string"
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/events/comments", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/events/comments
Create comment on order event
Body parameter
{
"comment": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | Comment | true | Create internal note request object |
Example responses
200 Response
{
"order_audit_history": [
{
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order_audit_history | [Order] | false | none | [Customer’s order] |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
getOrderByID
Code samples
# You can also use wget
curl -X GET https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
method: 'get',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
{
method: 'GET',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.get 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.get('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("GET", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
GET /customers/{customerID}/orders/{orderID}
Get customer’s order by ID
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
updateOrderByID
Code samples
# You can also use wget
curl -X PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
PUT https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
method: 'put',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.put 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.put('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("PUT", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
PUT /customers/{customerID}/orders/{orderID}
Update customer’s order by ID
Body parameter
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
| body | body | Order | true | Order object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
deleteOrderByID
Code samples
# You can also use wget
curl -X DELETE https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
DELETE https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID} HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
method: 'delete',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
{
method: 'DELETE',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.delete 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.delete('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("DELETE");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("DELETE", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
DELETE /customers/{customerID}/orders/{orderID}
Delete customer’s order by ID
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
book
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book HTTP/1.1
Host: platform.roserocket.com
Accept: application/json
var headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const headers = {
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book',
{
method: 'POST',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/orders/{orderID}/book", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/orders/{orderID}/book
Book an existing Order
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| orderID | path | string(uuid) | true | ID of the order. It could also be the external ID of the order, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the order’s external ID is test123 then the value of orderID should be ext:test1234 or external_id:test1234. |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"quote": {
"id": "string",
"order_id": "string",
"currency": "cad",
"customer_service_id": "string",
"is_expired": true,
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"est_delivery_start_at": "2019-10-11T01:17:18Z",
"est_delivery_end_at": "2019-10-11T01:17:18Z",
"notes": "string",
"error_message": "string",
"status": "quote-success",
"charges": {
"freight": 0,
"fuel": 0,
"accessorials": 0,
"total": 0
}
},
"legs": [
{
"id": "string",
"sequence_id": 0,
"version": 0,
"external_id": "string",
"public_id": "string",
"order_id": "string",
"manifest_id": "string",
"origin_stop_id": "string",
"destination_stop_id": "string",
"origin": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"status": "available",
"origin_start_at": "2019-10-11T01:17:18Z",
"origin_end_at": "2019-10-11T01:17:18Z",
"origin_appt_start_at": "2019-10-11T01:17:18Z",
"origin_appt_end_at": "2019-10-11T01:17:18Z",
"destination_start_at": "2019-10-11T01:17:18Z",
"destination_end_at": "2019-10-11T01:17:18Z",
"destination_appt_start_at": "2019-10-11T01:17:18Z",
"destination_appt_end_at": "2019-10-11T01:17:18Z",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
],
"history": {
"origin_arrived_at": "2019-10-11T01:17:18Z",
"origin_in_at": "2019-10-11T01:17:18Z",
"origin_pickedup_at": "2019-10-11T01:17:18Z",
"origin_out_at": "2019-10-11T01:17:18Z",
"destination_arrived_at": "2019-10-11T01:17:18Z",
"destination_in_at": "2019-10-11T01:17:18Z",
"destination_delivered_at": "2019-10-11T01:17:18Z",
"destination_out_at": "2019-10-11T01:17:18Z"
}
}
]
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | successful operation | Inline |
| 400 | Bad Request | Bad request | ApiError |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » order | Order | false | none | Customer’s order |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» external_id | string | false | none | External ID for mapping the order to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» tender_id | string | false | read-only | Tender ID that is related to the order. This field can be null |
| »» customer | OrderCustomer | false | none | Customer |
| »»» id | string(uuid) | false | read-only | Auto generated customer id |
| »»» external_id | string | false | read-only | Customer external id. This field value can be null |
| »»» short_code | string | false | read-only | Customer’s short code |
| »» origin | OrderAddress | true | none | Order address |
| »»» address_book_id | string(uuid) | false | read-only | Auto generated address book id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_id, you must leave address_book_external_id empty. |
| »»» address_book_external_id | string(uuid) | false | none | Address book external id. This field value can be null. Leave this field as null if you want to manually specify the address. If you want to populate the address using address_book_external_id, you must leave address_book_id empty. |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »»» bus_hours_start_at | string(date-time) | false | none | Business hours range (start). This field value can be null |
| »»» bus_hours_end_at | string(date-time) | false | none | Business hours range (end). This field value can be null |
| »» destination | OrderAddress | true | none | Order address |
| »» billing | OrderAddress | true | none | Order address |
| »» status | string | false | read-only | Order Status |
| »» billing_option | string | false | none | Billing Option |
| »» notes | string | false | none | Notes that will appear on BOL |
| »» po_num | string | false | none | Purchase order numbers (if multiple use comma separated values) |
| »» tender_num | string | false | none | Tender number |
| »» ref_num | string | false | none | Reference number |
| »» custom_broker | string | false | none | Custom broker information |
| »» declared_value | number(float) | false | none | Declared value |
| »» declared_value_currency | string | false | none | Declared value currency |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» pickup_appt_start_at | string(date-time) | false | none | Pickup appointment time range (start). This field value can be null |
| »» pickup_appt_end_at | string(date-time) | false | none | Pickup appointment time range (end). This field value can be null |
| »» delivery_start_at | string(date-time) | false | none | Expected delivery time range (start). This field value can be null |
| »» delivery_end_at | string(date-time) | false | none | Expected delivery time range (end). This field value can be null |
| »» delivery_appt_start_at | string(date-time) | false | none | Delivery appointment time range (start). This field value can be null |
| »» delivery_appt_end_at | string(date-time) | false | none | Delivery appointment time range (end). This field value can be null |
| »» dim_type | string | false | none | Dimension type |
| »» default_measurement_unit_id | string | false | none | Identifying ID for the default unit of measurement for this order. Can be ‘cm’ or ‘inch’ |
| »» default_weight_unit_id | string | false | none | Identifying ID for the default unit of weight for this order. Can be ‘kg’ or ‘lb’ |
| »» commodities | [Commodity] | false | none | Commodities items |
| »»» id | string(uuid) | false | read-only | Auto generated commodity id |
| »»» measurement_unit | string | false | none | Measurement unit |
| »»» weight_unit | string | false | none | Weight unit |
| »»» freight_class | string | false | none | Freight class |
| »»» commodity_type | string | false | none | Commodity type |
| »»» commodity_type_other | string | false | none | If commodity type is set to other, then this field must have value |
| »»» description | string | false | none | Description of the commodity |
| »»» feet | number(float) | false | none | Total feet in length of the truck the commodity is occupying. This field must have value if order’s dimension type is set to ftl |
| »»» volume | number(float) | false | none | Total volume of the commodity item. This field must have value if order’s dimension type is set to volume |
| »»» length | number(float) | false | none | Length of the commodity |
| »»» width | number(float) | false | none | Width of the commodity |
| »»» height | number(float) | false | none | Height of the commodity |
| »»» weight | number(float) | false | none | Weight of the commodity |
| »»» nmfc | string | false | none | NMFC number |
| »»» is_stackable | boolean | false | none | Is this commodity can be stacked? |
| »»» quantity | integer | false | none | Quantity of the commodity |
| »»» pieces | integer | false | none | Total number of pieces. This field value can be null |
| »»» sku | string | false | none | SKU number |
| »» accessorials | [string] | false | none | none |
| » quote | Quote | false | read-only | Quote |
| »» id | string(uuid) | false | read-only | Auto generated quote id |
| »» order_id | string(uuid) | false | none | Order id this quote is associated to |
| »» currency | string | false | none | Declared value currency |
| »» customer_service_id | string(uuid) | false | none | Customer’s service of this quote generated from |
| »» is_expired | boolean | false | none | Is this quote has expired? |
| »» pickup_start_at | string(date-time) | false | none | Pickup time range (start) |
| »» pickup_end_at | string(date-time) | false | none | Pickup time range (end) |
| »» est_delivery_start_at | string(date-time) | false | none | Estimated delivery time range (start). This field value can be null |
| »» est_delivery_end_at | string(date-time) | false | none | Estimated delivery time range (end). This field value can be null |
| »» notes | string | false | none | Notes |
| »» error_message | string | false | none | Error message |
| »» status | string | false | none | Status |
| »» charges | object | false | none | none |
| »»» type | string(uuid) | false | none | Type |
| »»» quote_id | string(uuid) | false | read-only | Quote id this item is associated to |
| »»» description | string | false | none | Description |
| »»» quantity | integer | false | none | Unit quantity |
| »»» unit_price | integer | false | none | Unit price |
| »»» total | integer | false | none | Total |
| »» freight | number(float) | false | none | Freight charge |
| »» fuel | number(float) | false | none | Fuel charge |
| »» accessorials | number(float) | false | none | Accessorials charge |
| »» total | number(float) | false | none | Total charge |
| » legs | [Leg] | false | none | [Leg] |
| »» id | string(uuid) | false | read-only | Auto generated system ID |
| »» sequence_id | integer | false | read-only | Auto generated sequence ID per customer |
| »» version | integer | false | read-only | Auto generated version number (incremental) |
| »» external_id | string | false | none | External ID for mapping the leg to an external system. This field value can be null |
| »» public_id | string | false | read-only | Auto generated human readable ID |
| »» order_id | string | false | read-only | Related order ID |
| »» manifest_id | string | false | none | Related manifest ID (assigned). This field value can be null |
| »» origin_stop_id | string | false | read-only | Stop ID of the origin (only if this leg has been assigned to a manifest). This field value can be null |
| »» destination_stop_id | string | false | read-only | Stop ID of the destination (only if this leg has been assigned to a manifest). This field value can be null |
| »» origin | LegAddress | false | none | Leg address |
| »»» terminal_id | string(uuid) | false | none | Related terminal ID. This field value can be null |
| »»» org_name | string | false | none | Organization name |
| »»» contact_name | string | false | none | Contact name |
| »»» address_1 | string | false | none | Address line 1 |
| »»» address_2 | string | false | none | Address line 2 |
| »»» suite | string | false | none | Suite number |
| »»» city | string | false | none | City |
| »»» state | string | false | none | State / Province |
| »»» country | string | false | none | Country (2 letter ISO) |
| »»» postal | string | false | none | Postal / Zip code |
| »»» phone | string | false | none | Phone number |
| »»» phone_ext | string | false | none | Phone extension |
| string | false | none | ||
| »»» fax | string | false | none | Fax |
| »»» latitude | number(float) | false | none | Coordinate (latitude). This field value can be null |
| »»» longitude | number(float) | false | none | Coordinate (longitude). This field value can be null |
| »» destination | LegAddress | false | none | Leg address |
| »» status | string | false | read-only | Leg Status |
| »» origin_start_at | string(date-time) | false | none | Origin ready time range (start) |
| »» origin_end_at | string(date-time) | false | none | Origin ready time range (end) |
| »» origin_appt_start_at | string(date-time) | false | none | Origin appointment time range (start). This field value can be null |
| »» origin_appt_end_at | string(date-time) | false | none | Origin appointment time range (end). This field value can be null |
| »» destination_start_at | string(date-time) | false | none | Destination expected time range (start). This field value can be null |
| »» destination_end_at | string(date-time) | false | none | Destination expected time range (end). This field value can be null |
| »» destination_appt_start_at | string(date-time) | false | none | Destination appointment time range (start). This field value can be null |
| »» destination_appt_end_at | string(date-time) | false | none | Destination appointment time range (end). This field value can be null |
| »» commodities | [Commodity] | false | none | Commodities items |
| »» accessorials | [string] | false | none | none |
| »» history | LegHistory | false | read-only | Historical timestamps of a leg |
| »»» origin_arrived_at | string(date-time) | false | none | The timestamp of when the driver/partner arrived at origin |
| »»» origin_in_at | string(date-time) | false | none | The timestamp of when the driver/partner in at origin |
| »»» origin_pickedup_at | string(date-time) | false | none | The timestamp of when the driver/partner picked up at origin |
| »»» origin_out_at | string(date-time) | false | none | The timestamp of when the driver/partner out at origin |
| »»» destination_arrived_at | string(date-time) | false | none | The timestamp of when the driver/partner arrived at destination |
| »»» destination_in_at | string(date-time) | false | none | The timestamp of when the driver/partner in at destination |
| »»» destination_delivered_at | string(date-time) | false | none | The timestamp of when the driver/partner delievered up at destination |
| »»» destination_out_at | string(date-time) | false | none | The timestamp of when the driver/partner out at destination |
Enumerated Values
| Property | Value |
|---|---|
| status | new |
| status | saved |
| status | cancelled |
| status | quoting |
| status | quoted |
| status | no-quote |
| status | spot-quote-requested |
| status | pending-dispatch |
| status | dispatched |
| status | in-transit |
| status | delivered |
| status | archived |
| status | invoice-created |
| status | invoice-sent |
| status | invoice-paid |
| status | claim |
| status | draft-quick-quote |
| status | quick-quoting |
| status | quick-quoted |
| status | no-quick-quote |
| status | spot-qq-requested |
| status | pickup-request |
| status | rejected |
| billing_option | prepaid |
| billing_option | collect |
| billing_option | thirdparty |
| declared_value_currency | cad |
| declared_value_currency | usd |
| dim_type | ltl |
| dim_type | ftl |
| dim_type | volume |
| measurement_unit | inch |
| measurement_unit | cm |
| weight_unit | lb |
| weight_unit | kg |
| commodity_type | skid |
| commodity_type | other |
| currency | cad |
| currency | usd |
| status | quote-success |
| status | quote-pending |
| status | quote-rejected |
| status | quote-error |
| status | dispatch-success |
| status | dispatch-pending |
| status | dispatch-rejected |
| status | dispatch-error |
| type | freight |
| type | freight-cwt |
| type | freight-cwt-min |
| type | freight-spot |
| type | freight-pallets |
| type | freight-pallets-min |
| type | accessorial |
| type | fuel |
| type | misc |
| status | available |
| status | pending |
| status | dispatched |
| status | arrived_origin |
| status | in_origin |
| status | loaded |
| status | departed_origin |
| status | arrived_destination |
| status | in_destination |
| status | unloaded |
| status | departed_destination |
| status | cancelled |
| status | problem |
createBookedOrder
Code samples
# You can also use wget
curl -X POST https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order HTTP/1.1
Host: platform.roserocket.com
Content-Type: application/json
Accept: application/json
var headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
$.ajax({
url: 'https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order',
method: 'post',
headers: headers,
success: function(data) {
console.log(JSON.stringify(data));
}
})
const fetch = require('node-fetch');
const inputBody = '{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization':'Bearer {access-token}'
};
fetch('https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
require 'rest-client'
require 'json'
headers = {
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {access-token}'
}
result = RestClient.post 'https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order',
params: {
}, headers: headers
p JSON.parse(result)
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.post('https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order', params={
}, headers = headers)
print r.json()
URL obj = new URL("https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
package main
import (
"bytes"
"net/http"
)
func main() {
headers := map[string][]string{
"Content-Type": []string{"application/json"},
"Accept": []string{"application/json"},
"Authorization": []string{"Bearer {access-token}"},
}
data := bytes.NewBuffer([]byte{jsonReq})
req, err := http.NewRequest("POST", "https://platform.roserocket.com/v1/customers/{customerID}/create_booked_order", data)
req.Header = headers
client := &http.Client{}
resp, err := client.Do(req)
// ...
}
POST /customers/{customerID}/create_booked_order
Create a booked order
Body parameter
{
"external_id": "string",
"customer": {},
"origin": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customerID | path | string(uuid) | true | ID of the customer that creates the order. It could also be the external ID of the customer, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the customer’s external ID is test123 then the value of customerID should be ext:test1234 or external_id:test1234. |
| body | body | Order | true | Order object |
Example responses
200 Response
{
"order": {
"id": "string",
"sequence_id": 0,
"external_id": "string",
"public_id": "string",
"tender_id": "string",
"customer": {
"id": "string",
"external_id": "string",
"short_code": "string"
},
"origin": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"destination": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"billing": {
"address_book_id": "string",
"address_book_external_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0,
"bus_hours_start_at": "2019-10-11T01:17:18Z",
"bus_hours_end_at": "2019-10-11T01:17:18Z"
},
"status": "new",
"billing_option": "prepaid",
"notes": "string",
"po_num": "string",
"tender_num": "string",
"ref_num": "string",
"custom_broker": "string",
"declared_value": 0,
"declared_value_currency": "cad",
"pickup_start_at": "2019-10-11T01:17:18Z",
"pickup_end_at": "2019-10-11T01:17:18Z",
"pickup_appt_start_at": "2019-10-11T01:17:18Z",
"pickup_appt_end_at": "2019-10-11T01:17:18Z",
"delivery_start_at": "2019-10-11T01:17:18Z",
"delivery_end_at": "2019-10-11T01:17:18Z",
"delivery_appt_start_at": "2019-10-11T01:17:18Z",
"delivery_appt_end_at": "2019-10-11T01:17:18Z",
"dim_type": "ltl",
"default_measurement_unit_id": "string",
"default_weight_unit_id": "string",
"commodities": [
{
"id": "string",
"measurement_unit": "inch",
"weight_unit": "lb",
"freight_class": "string",
"commodity_type": "skid",
"commodity_type_other": "string",
"description": "string",
"feet": 0,
"volume": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"nmfc": "string",
"is_stackable": true,
"quantity": 0,
"pieces": 0,
"sku": "string"
}
],
"accessorials": [
"string"
]
},
"legs": [
{
"id": "string",
"sequence_id": 0,
"version": 0,
"external_id": "string",
"public_id": "string",
"order_id": "string",
"manifest_id": "string",
"origin_stop_id": "string",
"destination_stop_id": "string",
"origin": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"terminal_id": "string",
"org_name": "string",
"contact_name": "string",
"address_1": "string",
"address_2": "string",
"suite": "string",
"city": "string",
"state": "string",
"country": "string",
"postal": "string",
"phone": "string",
"phone_ext": "string",
"email": "string",
"fax": "string",
"latitude": 0,
"longitude": 0
},
"status": "available",
"origin_start_at": "2019-10-11T01:17:18Z",
"origin_end_at": "2019-10-11T01:17:18Z",
"origin_appt_start_at": "2019-10-11T01:17:18Z",
"origin_appt_end_at": "2019-10-11T01:17:18Z",
"destination_start_at": "2019-10-11T01:17:18Z",
"destination_end_at": "2019-10-11T01:17:18Z",
"destination_appt_start_at": "2019-10-11T01:17:18Z",
"destination_appt_end_at": "2019-10-11T01:17:18Z",
"commodities"