Rose Rocket 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.

Base URLs:

https://platform.roserocket.com/api/v1

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
exchange_rates	manage exchange_rates

Bill Item Types

Find Bill Item Types

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/bill_item_types \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/bill_item_types 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/api/v1/bill_item_types',
  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/api/v1/bill_item_types',
{
  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/api/v1/bill_item_types',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/bill_item_types', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/bill_item_types");
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/api/v1/bill_item_types", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /bill_item_types

Search bill_item_types

Search all bill_item_types of organization

Parameters

Name	In	Type	Required	Description
search_term	query	string	false	Search term
names	query	array[string]	false	Bill Item Type names to filter by
offset	query	integer	false	Pagination offset
limit	query	integer	false	Pagination limit

Example responses

200 Response

{
  "bill_item_types": [
    {
      "id": "string",
      "external_id": "string",
      "qb_external_id": "string",
      "name": "string",
      "class": "string",
      "org_id": "string",
      "created_at": "2020-08-05T04:36:17Z",
      "updated_at": "2020-08-05T04:36:17Z"
    }
  ],
  "offset": 0,
  "limit": 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
» bill_item_types	[BillItemType]	false	none	[Represents a bill item type]
»» id	string(uuid)	false	read-only	Auto generated system ID
»» external_id	string	false	none	External ID representing the bill item type
»» qb_external_id	string	false	none	External ID representing the bill item type in quickbooks
»» name	string	false	none	The name of the bill item type
»» class	string	false	none	The class of the bill item type
»» org_id	string(uuid)	false	none	Id of the org to which the bill item type belongs to
»» created_at	string(date-time)	false	none	The time of the equipment type’s creation
»» updated_at	string(date-time)	false	none	The time of the equipment type’s last update
» offset	integer	false	none	none
» limit	integer	false	none	none
» total	integer	false	none	none

Bill

Find Bills

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/bills \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/bills 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/api/v1/bills',
  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/api/v1/bills',
{
  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/api/v1/bills',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/bills', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/bills");
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/api/v1/bills", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /bills

Search bills

Search all bills of organization

Parameters

Name	In	Type	Required	Description
in_manifest_ids	query	array[string]	false	Manifest ID’s to filter by
status_ids	query	array[string]	false	Status ID’s to filter by
created_start_at	query	string(date-time)	false	created_at date range (start)
created_end_at	query	string(date-time)	false	created_at date range (end)
update_start_at	query	string(date-time)	false	updated_at date range (start)
updated_end_at	query	string(date-time)	false	updated_at date range (end)
offset	query	integer	false	Pagination offset
limit	query	integer	false	Pagination limit

Enumerated Values

Parameter	Value
status_ids	draft
status_ids	saved
status_ids	sent
status_ids	edited
status_ids	paid

Example responses

200 Response

{
  "bills": [
    {
      "created_at": "2020-08-05T04:36:17Z",
      "updated_at": "2020-08-05T04:36:17Z",
      "id": "string",
      "created_by": "string",
      "org_id": "string",
      "status_id": "string",
      "currency_id": "string",
      "pay_term_id": "string",
      "master_trip_id": "string",
      "partner_carrier_id": "string",
      "full_id": "string",
      "external_id": "string",
      "qb_external_id": "string",
      "qb_error_msg": "string",
      "revision": 0,
      "bill_date": "2020-08-05T04:36:17Z",
      "due_date": "2020-08-05T04:36:17Z",
      "sent_at": "2020-08-05T04:36:17Z",
      "paid_at": "2020-08-05T04:36:17Z",
      "qb_exported_at": "2020-08-05T04:36:17Z",
      "send_to_email": "string",
      "cc_to_email": "string",
      "bill_to": {
        "company_name": "string",
        "contact_name": "string",
        "address_1": "string",
        "address_2": "string",
        "city": "string",
        "state": "string",
        "postal": "string",
        "country": "string"
      },
      "is_tax_on": true,
      "notes": "string",
      "remit_to": {
        "company_name": "string",
        "contact_name": "string",
        "address_1": "string",
        "address_2": "string",
        "city": "string",
        "state": "string",
        "postal": "string",
        "country": "string"
      },
      "reference_number": "string",
      "sub_total_amount": 0,
      "tax_amount": 0,
      "total_amount": 0
    }
  ],
  "offset": 0,
  "limit": 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
» bills	[Bill]	false	none	[Bill for an Order]
»» created_at	string(date-time)	false	none	The timestamp for the creation of the bill
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the bill
»» id	string(uuid)	false	none	ID of the Bill
»» created_by	string	false	none	none
»» org_id	string(uuid)	false	none	ID of associated org
»» status_id	string	false	none	ID of Bill Status
»» currency_id	string	false	none	ID of currency
»» pay_term_id	string	false	none	ID of bill pay term
»» master_trip_id	string(uuid)	false	none	ID of master trip related to the bill
»» partner_carrier_id	string(uuid)	false	none	Id of the partner/carrier that corresponds to the bill
»» full_id	string(uuid)	false	none	Full ID associated with, and used to reference the Bill
»» external_id	string	false	read-only	Customer external id. This field value can be null
»» qb_external_id	string	false	none	The exteErnal identifier for the partner carrier in QBO
»» qb_error_msg	string	false	none	Error message for QBO
»» revision	integer	false	none	The revision number of the payment
»» bill_date	string(date-time)	false	none	Bill creation date
»» due_date	string(date-time)	false	none	Due date for bill payment
»» sent_at	string(date-time)	false	none	Date the bill was sent
»» paid_at	string(date-time)	false	none	Date the bill was paid
»» qb_exported_at	string(date-time)	false	none	Date invoice was exported to QB
»» send_to_email	string	false	none	The email of the recipient of the payment
»» cc_to_email	string	false	none	The email of the cc recipient of the payment
»» bill_to	object	false	none	none
»»» company_name	string	false	none	The company name of the billing party
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» is_tax_on	boolean	false	none	none
»» notes	string	false	none	Notes associated to the Bill
»» remit_to	object	false	none	none
»»» company_name	string	false	none	The company name of the recipient of the payment
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» reference_number	string	false	none	Reference number associated to the Bill
»» sub_total_amount	integer	false	none	Bill sub total amount
»» tax_amount	integer	false	none	Amount of tax applied
»» total_amount	integer	false	none	Total amount for the bill
» offset	integer	false	none	none
» limit	integer	false	none	none
» total	integer	false	none	none

Get Bill

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/bills/{billID} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/bills/{billID} 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/api/v1/bills/{billID}',
  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/api/v1/bills/{billID}',
{
  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/api/v1/bills/{billID}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/bills/{billID}', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/bills/{billID}");
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/api/v1/bills/{billID}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /bills/{billID}

Get bill by Id

Parameters

Name	In	Type	Required	Description
billID	path	string	true	ID of the bill for an order. It could also be the external ID of the bill, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the bill’s external ID is test123 then the value of billID should be ext:test1234 or external_id:test1234.

Example responses

200 Response

{
  "bill": {
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "id": "string",
    "created_by": "string",
    "org_id": "string",
    "status_id": "string",
    "currency_id": "string",
    "pay_term_id": "string",
    "master_trip_id": "string",
    "partner_carrier_id": "string",
    "full_id": "string",
    "external_id": "string",
    "qb_external_id": "string",
    "qb_error_msg": "string",
    "revision": 0,
    "bill_date": "2020-08-05T04:36:17Z",
    "due_date": "2020-08-05T04:36:17Z",
    "sent_at": "2020-08-05T04:36:17Z",
    "paid_at": "2020-08-05T04:36:17Z",
    "qb_exported_at": "2020-08-05T04:36:17Z",
    "send_to_email": "string",
    "cc_to_email": "string",
    "bill_to": {
      "company_name": "string",
      "contact_name": "string",
      "address_1": "string",
      "address_2": "string",
      "city": "string",
      "state": "string",
      "postal": "string",
      "country": "string"
    },
    "is_tax_on": true,
    "notes": "string",
    "remit_to": {
      "company_name": "string",
      "contact_name": "string",
      "address_1": "string",
      "address_2": "string",
      "city": "string",
      "state": "string",
      "postal": "string",
      "country": "string"
    },
    "reference_number": "string",
    "sub_total_amount": 0,
    "tax_amount": 0,
    "total_amount": 0
  },
  "created_by": "string",
  "bill_item": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "bill_id": "string",
    "bill_item_type_id": "string",
    "manifest_payment_item_id": "string",
    "unit_price": 0,
    "quantity": 0,
    "total_amount": 0,
    "description": "string"
  },
  "pay_term": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "org_id": "string",
    "number_of_days": 0,
    "name": "string",
    "qb_external_id": "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
» bill	Bill	false	none	Bill for an Order
»» created_at	string(date-time)	false	none	The timestamp for the creation of the bill
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the bill
»» id	string(uuid)	false	none	ID of the Bill
»» created_by	string	false	none	none
»» org_id	string(uuid)	false	none	ID of associated org
»» status_id	string	false	none	ID of Bill Status
»» currency_id	string	false	none	ID of currency
»» pay_term_id	string	false	none	ID of bill pay term
»» master_trip_id	string(uuid)	false	none	ID of master trip related to the bill
»» partner_carrier_id	string(uuid)	false	none	Id of the partner/carrier that corresponds to the bill
»» full_id	string(uuid)	false	none	Full ID associated with, and used to reference the Bill
»» external_id	string	false	read-only	Customer external id. This field value can be null
»» qb_external_id	string	false	none	The exteErnal identifier for the partner carrier in QBO
»» qb_error_msg	string	false	none	Error message for QBO
»» revision	integer	false	none	The revision number of the payment
»» bill_date	string(date-time)	false	none	Bill creation date
»» due_date	string(date-time)	false	none	Due date for bill payment
»» sent_at	string(date-time)	false	none	Date the bill was sent
»» paid_at	string(date-time)	false	none	Date the bill was paid
»» qb_exported_at	string(date-time)	false	none	Date invoice was exported to QB
»» send_to_email	string	false	none	The email of the recipient of the payment
»» cc_to_email	string	false	none	The email of the cc recipient of the payment
»» bill_to	object	false	none	none
»»» company_name	string	false	none	The company name of the billing party
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» is_tax_on	boolean	false	none	none
»» notes	string	false	none	Notes associated to the Bill
»» remit_to	object	false	none	none
»»» company_name	string	false	none	The company name of the recipient of the payment
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» reference_number	string	false	none	Reference number associated to the Bill
»» sub_total_amount	integer	false	none	Bill sub total amount
»» tax_amount	integer	false	none	Amount of tax applied
»» total_amount	integer	false	none	Total amount for the bill
» created_by	string	false	none	none
» bill_item	BillItem	false	none	List of Items in a Bill
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The time of the item’s creation
»» updated_at	string(date-time)	false	none	The time the item was last updated
»» bill_id	string(uuid)	false	none	ID of the associated Bill
»» bill_item_type_id	string(uuid)	false	none	ID of Item Type
»» manifest_payment_item_id	string(uuid)	false	none	ID of Manifest Payment Item
»» unit_price	integer	false	none	Unit price for the item
»» quantity	integer	false	none	Quantity of the commodity
»» total_amount	integer	false	none	Total amount for the specified item
»» description	string	false	none	Description of the item
» pay_term	InvoicePayTerm	false	none	Pay term for Invoice
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The time of the event’s creation
»» updated_at	string(date-time)	false	none	The time the event was last updated
»» org_id	string(uuid)	false	none	ID of the associated organization
»» number_of_days	integer	false	none	Number of days in the pay term
»» name	string	false	none	Name of the partner carrier
»» qb_external_id	string	false	none	The external identifier for the partner carrier in QBO

Update Bill

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/v1/bills/{billID} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

PUT https://platform.roserocket.com/api/v1/bills/{billID} 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/api/v1/bills/{billID}',
  method: 'put',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "id": "string",
  "created_by": "string",
  "org_id": "string",
  "status_id": "string",
  "currency_id": "string",
  "pay_term_id": "string",
  "master_trip_id": "string",
  "partner_carrier_id": "string",
  "full_id": "string",
  "qb_external_id": "string",
  "qb_error_msg": "string",
  "revision": 0,
  "bill_date": "2020-08-05T04:36:17Z",
  "due_date": "2020-08-05T04:36:17Z",
  "sent_at": "2020-08-05T04:36:17Z",
  "paid_at": "2020-08-05T04:36:17Z",
  "qb_exported_at": "2020-08-05T04:36:17Z",
  "send_to_email": "string",
  "cc_to_email": "string",
  "bill_to": {
    "company_name": "string",
    "contact_name": "string",
    "address_1": "string",
    "address_2": "string",
    "city": "string",
    "state": "string",
    "postal": "string",
    "country": "string"
  },
  "is_tax_on": true,
  "notes": "string",
  "remit_to": {
    "company_name": "string",
    "contact_name": "string",
    "address_1": "string",
    "address_2": "string",
    "city": "string",
    "state": "string",
    "postal": "string",
    "country": "string"
  },
  "reference_number": "string",
  "sub_total_amount": 0,
  "tax_amount": 0,
  "total_amount": 0
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'

};

fetch('https://platform.roserocket.com/api/v1/bills/{billID}',
{
  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/api/v1/bills/{billID}',
  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/api/v1/bills/{billID}', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/bills/{billID}");
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/api/v1/bills/{billID}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /bills/{billID}

Update an Bill by ID

Body parameter

{
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "id": "string",
  "created_by": "string",
  "org_id": "string",
  "status_id": "string",
  "currency_id": "string",
  "pay_term_id": "string",
  "master_trip_id": "string",
  "partner_carrier_id": "string",
  "full_id": "string",
  "qb_external_id": "string",
  "qb_error_msg": "string",
  "revision": 0,
  "bill_date": "2020-08-05T04:36:17Z",
  "due_date": "2020-08-05T04:36:17Z",
  "sent_at": "2020-08-05T04:36:17Z",
  "paid_at": "2020-08-05T04:36:17Z",
  "qb_exported_at": "2020-08-05T04:36:17Z",
  "send_to_email": "string",
  "cc_to_email": "string",
  "bill_to": {
    "company_name": "string",
    "contact_name": "string",
    "address_1": "string",
    "address_2": "string",
    "city": "string",
    "state": "string",
    "postal": "string",
    "country": "string"
  },
  "is_tax_on": true,
  "notes": "string",
  "remit_to": {
    "company_name": "string",
    "contact_name": "string",
    "address_1": "string",
    "address_2": "string",
    "city": "string",
    "state": "string",
    "postal": "string",
    "country": "string"
  },
  "reference_number": "string",
  "sub_total_amount": 0,
  "tax_amount": 0,
  "total_amount": 0
}

Parameters

Name	In	Type	Required	Description
billID	path	string	true	ID of the bill for an order. It could also be the external ID of the bill, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the bill’s external ID is test123 then the value of billID should be ext:test1234 or external_id:test1234.
body	body	Bill	true	Bill object

Example responses

200 Response

{
  "bill": {
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "id": "string",
    "created_by": "string",
    "org_id": "string",
    "status_id": "string",
    "currency_id": "string",
    "pay_term_id": "string",
    "master_trip_id": "string",
    "partner_carrier_id": "string",
    "full_id": "string",
    "external_id": "string",
    "qb_external_id": "string",
    "qb_error_msg": "string",
    "revision": 0,
    "bill_date": "2020-08-05T04:36:17Z",
    "due_date": "2020-08-05T04:36:17Z",
    "sent_at": "2020-08-05T04:36:17Z",
    "paid_at": "2020-08-05T04:36:17Z",
    "qb_exported_at": "2020-08-05T04:36:17Z",
    "send_to_email": "string",
    "cc_to_email": "string",
    "bill_to": {
      "company_name": "string",
      "contact_name": "string",
      "address_1": "string",
      "address_2": "string",
      "city": "string",
      "state": "string",
      "postal": "string",
      "country": "string"
    },
    "is_tax_on": true,
    "notes": "string",
    "remit_to": {
      "company_name": "string",
      "contact_name": "string",
      "address_1": "string",
      "address_2": "string",
      "city": "string",
      "state": "string",
      "postal": "string",
      "country": "string"
    },
    "reference_number": "string",
    "sub_total_amount": 0,
    "tax_amount": 0,
    "total_amount": 0
  },
  "created_by": "string",
  "bill_item": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "bill_id": "string",
    "bill_item_type_id": "string",
    "manifest_payment_item_id": "string",
    "unit_price": 0,
    "quantity": 0,
    "total_amount": 0,
    "description": "string"
  },
  "pay_term": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "org_id": "string",
    "number_of_days": 0,
    "name": "string",
    "qb_external_id": "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
» bill	Bill	false	none	Bill for an Order
»» created_at	string(date-time)	false	none	The timestamp for the creation of the bill
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the bill
»» id	string(uuid)	false	none	ID of the Bill
»» created_by	string	false	none	none
»» org_id	string(uuid)	false	none	ID of associated org
»» status_id	string	false	none	ID of Bill Status
»» currency_id	string	false	none	ID of currency
»» pay_term_id	string	false	none	ID of bill pay term
»» master_trip_id	string(uuid)	false	none	ID of master trip related to the bill
»» partner_carrier_id	string(uuid)	false	none	Id of the partner/carrier that corresponds to the bill
»» full_id	string(uuid)	false	none	Full ID associated with, and used to reference the Bill
»» external_id	string	false	read-only	Customer external id. This field value can be null
»» qb_external_id	string	false	none	The exteErnal identifier for the partner carrier in QBO
»» qb_error_msg	string	false	none	Error message for QBO
»» revision	integer	false	none	The revision number of the payment
»» bill_date	string(date-time)	false	none	Bill creation date
»» due_date	string(date-time)	false	none	Due date for bill payment
»» sent_at	string(date-time)	false	none	Date the bill was sent
»» paid_at	string(date-time)	false	none	Date the bill was paid
»» qb_exported_at	string(date-time)	false	none	Date invoice was exported to QB
»» send_to_email	string	false	none	The email of the recipient of the payment
»» cc_to_email	string	false	none	The email of the cc recipient of the payment
»» bill_to	object	false	none	none
»»» company_name	string	false	none	The company name of the billing party
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» is_tax_on	boolean	false	none	none
»» notes	string	false	none	Notes associated to the Bill
»» remit_to	object	false	none	none
»»» company_name	string	false	none	The company name of the recipient of the payment
»»» contact_name	string	false	none	Contact Name
»»» address_1	string	false	none	Address line 1
»»» address_2	string	false	none	Address line 2
»»» city	string	false	none	City name
»»» state	string	false	none	State name
»»» postal	string	false	none	Postal code
»»» country	string	false	none	Country
»» reference_number	string	false	none	Reference number associated to the Bill
»» sub_total_amount	integer	false	none	Bill sub total amount
»» tax_amount	integer	false	none	Amount of tax applied
»» total_amount	integer	false	none	Total amount for the bill
» created_by	string	false	none	none
» bill_item	BillItem	false	none	List of Items in a Bill
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The time of the item’s creation
»» updated_at	string(date-time)	false	none	The time the item was last updated
»» bill_id	string(uuid)	false	none	ID of the associated Bill
»» bill_item_type_id	string(uuid)	false	none	ID of Item Type
»» manifest_payment_item_id	string(uuid)	false	none	ID of Manifest Payment Item
»» unit_price	integer	false	none	Unit price for the item
»» quantity	integer	false	none	Quantity of the commodity
»» total_amount	integer	false	none	Total amount for the specified item
»» description	string	false	none	Description of the item
» pay_term	InvoicePayTerm	false	none	Pay term for Invoice
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The time of the event’s creation
»» updated_at	string(date-time)	false	none	The time the event was last updated
»» org_id	string(uuid)	false	none	ID of the associated organization
»» number_of_days	integer	false	none	Number of days in the pay term
»» name	string	false	none	Name of the partner carrier
»» qb_external_id	string	false	none	The external identifier for the partner carrier in QBO

Connector Orgs

Update a Connector Org

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

PUT https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID} 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/api/v1/connectors_orgs/{connectorOrgID}',
  method: 'put',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{
  "id": "string",
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "connector_id": "string",
  "org_id": "string",
  "app_id": "string",
  "integration_user_id": "string",
  "external_id": "string",
  "is_active": true,
  "activated_by_user_id": "string",
  "activated_at": "2020-08-05T04:36:17Z",
  "deactivated_by_user_id": "string",
  "deactivated_at": "2020-08-05T04:36:17Z",
  "config": {}
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'

};

fetch('https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID}',
{
  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/api/v1/connectors_orgs/{connectorOrgID}',
  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/api/v1/connectors_orgs/{connectorOrgID}', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID}");
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/api/v1/connectors_orgs/{connectorOrgID}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /connectors_orgs/{connectorOrgID}

Update a Connector org by Id

Body parameter

{
  "id": "string",
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "connector_id": "string",
  "org_id": "string",
  "app_id": "string",
  "integration_user_id": "string",
  "external_id": "string",
  "is_active": true,
  "activated_by_user_id": "string",
  "activated_at": "2020-08-05T04:36:17Z",
  "deactivated_by_user_id": "string",
  "deactivated_at": "2020-08-05T04:36:17Z",
  "config": {}
}

Parameters

Name	In	Type	Required	Description
connectorOrgID	path	string	true	ID of the connector org. It could also be the external ID of the connectorOrg, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the connector org’s external ID is test123 then the value of connectorOrgID should be ext:test1234 or external_id:test1234.
body	body	ConnectorOrg	true	Connector Org object

Example responses

200 Response

{
  "connector_org": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "connector_id": "string",
    "org_id": "string",
    "app_id": "string",
    "integration_user_id": "string",
    "external_id": "string",
    "is_active": true,
    "activated_by_user_id": "string",
    "activated_at": "2020-08-05T04:36:17Z",
    "deactivated_by_user_id": "string",
    "deactivated_at": "2020-08-05T04:36:17Z",
    "config": {}
  }
}

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
» connector_org	ConnectorOrg	false	none	Connector Org
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The timestamp for the creation of the connector org
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the connector org
»» connector_id	string(uuid)	false	none	Id for the connector
»» org_id	string(uuid)	false	none	ID of the organization
»» app_id	string(uuid)	false	none	ID of the associated application
»» integration_user_id	string(uuid)	false	none	asdfasdf
»» external_id	string(uuid)	false	none	External ID
»» is_active	boolean	false	none	none
»» activated_by_user_id	string(uuid)	false	none	User ID of the user who activated the connector org. This field value can be null
»» activated_at	string(date-time)	false	none	The timestamp for the activation of the connector org. This field value can be null
»» deactivated_by_user_id	string(uuid)	false	none	User ID of the user who deactivated the connector org. This field value can be null
»» deactivated_at	string(date-time)	false	none	The timestamp for the de-activation of the connector org. This field value can be null
»» config	object	false	none	JSON Configuration file

Get a Connector Org

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID} 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/api/v1/connectors_orgs/{connectorOrgID}',
  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/api/v1/connectors_orgs/{connectorOrgID}',
{
  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/api/v1/connectors_orgs/{connectorOrgID}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID}', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/connectors_orgs/{connectorOrgID}");
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/api/v1/connectors_orgs/{connectorOrgID}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /connectors_orgs/{connectorOrgID}

Get a Connector org by Id

Parameters

Name	In	Type	Required	Description
connectorOrgID	path	string	true	ID of the connector org. It could also be the external ID of the connectorOrg, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the connector org’s external ID is test123 then the value of connectorOrgID should be ext:test1234 or external_id:test1234.

Example responses

200 Response

{
  "connector_org": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "connector_id": "string",
    "org_id": "string",
    "app_id": "string",
    "integration_user_id": "string",
    "external_id": "string",
    "is_active": true,
    "activated_by_user_id": "string",
    "activated_at": "2020-08-05T04:36:17Z",
    "deactivated_by_user_id": "string",
    "deactivated_at": "2020-08-05T04:36:17Z",
    "config": {}
  }
}

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
» connector_org	ConnectorOrg	false	none	Connector Org
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The timestamp for the creation of the connector org
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the connector org
»» connector_id	string(uuid)	false	none	Id for the connector
»» org_id	string(uuid)	false	none	ID of the organization
»» app_id	string(uuid)	false	none	ID of the associated application
»» integration_user_id	string(uuid)	false	none	asdfasdf
»» external_id	string(uuid)	false	none	External ID
»» is_active	boolean	false	none	none
»» activated_by_user_id	string(uuid)	false	none	User ID of the user who activated the connector org. This field value can be null
»» activated_at	string(date-time)	false	none	The timestamp for the activation of the connector org. This field value can be null
»» deactivated_by_user_id	string(uuid)	false	none	User ID of the user who deactivated the connector org. This field value can be null
»» deactivated_at	string(date-time)	false	none	The timestamp for the de-activation of the connector org. This field value can be null
»» config	object	false	none	JSON Configuration file

Get a Connector Org by Company ID

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/connectors_orgs/by_company_id/{companyID} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/connectors_orgs/by_company_id/{companyID} 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/api/v1/connectors_orgs/by_company_id/{companyID}',
  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/api/v1/connectors_orgs/by_company_id/{companyID}',
{
  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/api/v1/connectors_orgs/by_company_id/{companyID}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/connectors_orgs/by_company_id/{companyID}', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/connectors_orgs/by_company_id/{companyID}");
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/api/v1/connectors_orgs/by_company_id/{companyID}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /connectors_orgs/by_company_id/{companyID}

Get a Connector org by company Id

Parameters

Name	In	Type	Required	Description
companyID	path	string	true	ID of the company. It could also be the external ID of the companyID, but in order to use external ID it has to follow this format: ext:{externalID} or external_id:{externalID}. So for example if the company’s external ID is test123 then the value of companyID should be ext:test1234 or external_id:test1234.

Example responses

200 Response

{
  "connector_org": {
    "id": "string",
    "created_at": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "connector_id": "string",
    "org_id": "string",
    "app_id": "string",
    "integration_user_id": "string",
    "external_id": "string",
    "is_active": true,
    "activated_by_user_id": "string",
    "activated_at": "2020-08-05T04:36:17Z",
    "deactivated_by_user_id": "string",
    "deactivated_at": "2020-08-05T04:36:17Z",
    "config": {}
  }
}

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
» connector_org	ConnectorOrg	false	none	Connector Org
»» id	string(uuid)	false	none	none
»» created_at	string(date-time)	false	none	The timestamp for the creation of the connector org
»» updated_at	string(date-time)	false	none	The timestamp for the last update of the connector org
»» connector_id	string(uuid)	false	none	Id for the connector
»» org_id	string(uuid)	false	none	ID of the organization
»» app_id	string(uuid)	false	none	ID of the associated application
»» integration_user_id	string(uuid)	false	none	asdfasdf
»» external_id	string(uuid)	false	none	External ID
»» is_active	boolean	false	none	none
»» activated_by_user_id	string(uuid)	false	none	User ID of the user who activated the connector org. This field value can be null
»» activated_at	string(date-time)	false	none	The timestamp for the activation of the connector org. This field value can be null
»» deactivated_by_user_id	string(uuid)	false	none	User ID of the user who deactivated the connector org. This field value can be null
»» deactivated_at	string(date-time)	false	none	The timestamp for the de-activation of the connector org. This field value can be null
»» config	object	false	none	JSON Configuration file

Order

Create Order

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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/api/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/api/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/api/v1/customers/{customerID}/orders', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "pickup_start_at": "2020-08-05T04:36:17Z",
    "pickup_end_at": "2020-08-05T04:36:17Z",
    "pickup_appt_start_at": "2020-08-05T04:36:17Z",
    "pickup_appt_end_at": "2020-08-05T04:36:17Z",
    "delivery_start_at": "2020-08-05T04:36:17Z",
    "delivery_end_at": "2020-08-05T04:36:17Z",
    "delivery_appt_start_at": "2020-08-05T04:36:17Z",
    "delivery_appt_end_at": "2020-08-05T04:36:17Z",
    "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
»»» email	string	false	none	Email
»»» 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
»» port_of_entry	string	false	none	Port of entry in cross-border order
»» 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

Create Order Problem

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/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/api/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/api/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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/problems', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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 a problem on an 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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "pickup_start_at": "2020-08-05T04:36:17Z",
    "pickup_end_at": "2020-08-05T04:36:17Z",
    "pickup_appt_start_at": "2020-08-05T04:36:17Z",
    "pickup_appt_end_at": "2020-08-05T04:36:17Z",
    "delivery_start_at": "2020-08-05T04:36:17Z",
    "delivery_end_at": "2020-08-05T04:36:17Z",
    "delivery_appt_start_at": "2020-08-05T04:36:17Z",
    "delivery_appt_end_at": "2020-08-05T04:36:17Z",
    "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": "2020-08-05T04:36:17Z",
    "updated_at": "2020-08-05T04:36:17Z",
    "order_id": "string",
    "type": "string",
    "title": "string",
    "description": "string",
    "created_by": "string",
    "resolved_by": "string",
    "resolved_at": "2020-08-05T04:36:17Z"
  }
}

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
»»» email	string	false	none	Email
»»» 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
»» port_of_entry	string	false	none	Port of entry in cross-border order
»» 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

Upsert Order by External ID

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/upsert', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/v1/customers/{customerID}/orders/{orderID}/upsert", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /customers/{customerID}/orders/{orderID}/upsert

Upsert an 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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "pickup_start_at": "2020-08-05T04:36:17Z",
    "pickup_end_at": "2020-08-05T04:36:17Z",
    "pickup_appt_start_at": "2020-08-05T04:36:17Z",
    "pickup_appt_end_at": "2020-08-05T04:36:17Z",
    "delivery_start_at": "2020-08-05T04:36:17Z",
    "delivery_end_at": "2020-08-05T04:36:17Z",
    "delivery_appt_start_at": "2020-08-05T04:36:17Z",
    "delivery_appt_end_at": "2020-08-05T04:36:17Z",
    "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
»»» email	string	false	none	Email
»»» 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
»» port_of_entry	string	false	none	Port of entry in cross-border order
»» 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

Revise Order

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/revise', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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 an Order by Customer and Order 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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "status": "new",
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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

Edit Order After Dispatched

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

PUT https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched 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/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched',
  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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched',
{
  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/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched',
  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/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched");
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/api/v1/customers/{customerID}/orders/{orderID}/edit_after_dispatched", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /customers/{customerID}/orders/{orderID}/edit_after_dispatched

Edit an order after it has been dispatched

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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "status": "new",
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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

Mark Order In Transit

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/mark_in_transit \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST https://platform.roserocket.com/api/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/api/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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/mark_in_transit', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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 as “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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "status": "new",
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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

Mark Order as Delivered

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered 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/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered',
  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/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered',
{
  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/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered");
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/api/v1/customers/{customerID}/orders/{orderID}/mark_delivered", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /customers/{customerID}/orders/{orderID}/mark_delivered

Mark order as “Delivered”

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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "status": "new",
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "pickup_start_at": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "pickup_appt_start_at": "2020-08-05T04:36:17Z",
  "pickup_appt_end_at": "2020-08-05T04:36:17Z",
  "delivery_start_at": "2020-08-05T04:36:17Z",
  "delivery_end_at": "2020-08-05T04:36:17Z",
  "delivery_appt_start_at": "2020-08-05T04:36:17Z",
  "delivery_appt_end_at": "2020-08-05T04:36:17Z",
  "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

Bulk Create Orders

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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/api/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/api/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/api/v1/customers/{customerID}/orders/bulk_create', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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	Bulk_Create_OrdersBody	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
»»» email	body	string	false	Email
»»» 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
»» port_of_entry	body	string	false	Port of entry in cross-border order
»» 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/api/v1/customers/{customerID}/orders/multistop_orders \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders/multistop_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/api/v1/customers/{customerID}/orders/multistop_orders',
  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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "stops": [
    {
      "external_id": "string",
      "term": "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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/api/v1/customers/{customerID}/orders/multistop_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/api/v1/customers/{customerID}/orders/multistop_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/api/v1/customers/{customerID}/orders/multistop_orders', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/multistop_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/api/v1/customers/{customerID}/orders/multistop_orders", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /customers/{customerID}/orders/multistop_orders

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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "stops": [
    {
      "external_id": "string",
      "term": "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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	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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "stops": [
      {
        "id": "string",
        "sequence_id": 0,
        "external_id": "string",
        "term": "string",
        "public_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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "status": "new",
        "billing_option": "prepaid",
        "notes": "string",
        "po_num": "string",
        "tender_num": "string",
        "ref_num": "string",
        "custom_broker": "string",
        "port_of_entry": "string",
        "declared_value": 0,
        "declared_value_currency": "cad",
        "pickup_start_at": "2020-08-05T04:36:17Z",
        "pickup_end_at": "2020-08-05T04:36:17Z",
        "pickup_appt_start_at": "2020-08-05T04:36:17Z",
        "pickup_appt_end_at": "2020-08-05T04:36:17Z",
        "delivery_start_at": "2020-08-05T04:36:17Z",
        "delivery_end_at": "2020-08-05T04:36:17Z",
        "delivery_appt_start_at": "2020-08-05T04:36:17Z",
        "delivery_appt_end_at": "2020-08-05T04:36:17Z",
        "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	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
»»» email	string	false	none	Email
»»» 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
»» port_of_entry	string	false	none	Port of entry in cross-border order
»» declared_value	number(float)	false	none	Declared value
»» declared_value_currency	string	false	none	Declared value currency
»» stops	[OrderStop]	false	none	[Customer’s multistop orders’s stop 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
»»» term	string	false	none	Billing period
»»» public_id	string	false	read-only	Auto generated human readable ID
»»» customer	OrderCustomer	false	none	Customer
»»» origin	OrderAddress	true	none	Order address
»»» 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
»»» port_of_entry	string	false	none	Port of entry in cross-border order
»»» 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
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

Update Multistop Order

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/v1/customers/{customerID}/orders/multistop_orders \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

PUT https://platform.roserocket.com/api/v1/customers/{customerID}/orders/multistop_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/api/v1/customers/{customerID}/orders/multistop_orders',
  method: 'put',

  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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "stops": [
    {
      "external_id": "string",
      "term": "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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/api/v1/customers/{customerID}/orders/multistop_orders',
{
  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/api/v1/customers/{customerID}/orders/multistop_orders',
  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/api/v1/customers/{customerID}/orders/multistop_orders', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/multistop_orders");
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/api/v1/customers/{customerID}/orders/multistop_orders", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /customers/{customerID}/orders/multistop_orders

Update 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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  },
  "billing_option": "prepaid",
  "notes": "string",
  "po_num": "string",
  "tender_num": "string",
  "ref_num": "string",
  "custom_broker": "string",
  "port_of_entry": "string",
  "declared_value": 0,
  "declared_value_currency": "cad",
  "stops": [
    {
      "external_id": "string",
      "term": "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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	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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "stops": [
      {
        "id": "string",
        "sequence_id": 0,
        "external_id": "string",
        "term": "string",
        "public_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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "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": "2020-08-05T04:36:17Z",
          "bus_hours_end_at": "2020-08-05T04:36:17Z"
        },
        "status": "new",
        "billing_option": "prepaid",
        "notes": "string",
        "po_num": "string",
        "tender_num": "string",
        "ref_num": "string",
        "custom_broker": "string",
        "port_of_entry": "string",
        "declared_value": 0,
        "declared_value_currency": "cad",
        "pickup_start_at": "2020-08-05T04:36:17Z",
        "pickup_end_at": "2020-08-05T04:36:17Z",
        "pickup_appt_start_at": "2020-08-05T04:36:17Z",
        "pickup_appt_end_at": "2020-08-05T04:36:17Z",
        "delivery_start_at": "2020-08-05T04:36:17Z",
        "delivery_end_at": "2020-08-05T04:36:17Z",
        "delivery_appt_start_at": "2020-08-05T04:36:17Z",
        "delivery_appt_end_at": "2020-08-05T04:36:17Z",
        "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	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
»»» email	string	false	none	Email
»»» 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
»» port_of_entry	string	false	none	Port of entry in cross-border order
»» declared_value	number(float)	false	none	Declared value
»» declared_value_currency	string	false	none	Declared value currency
»» stops	[OrderStop]	false	none	[Customer’s multistop orders’s stop 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
»»» term	string	false	none	Billing period
»»» public_id	string	false	read-only	Auto generated human readable ID
»»» customer	OrderCustomer	false	none	Customer
»»» origin	OrderAddress	true	none	Order address
»»» 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
»»» port_of_entry	string	false	none	Port of entry in cross-border order
»»» 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
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

Get Order Proof of Pickup

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pop \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pop 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/api/v1/customers/{customerID}/orders/{orderID}/pop',
  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/api/v1/customers/{customerID}/orders/{orderID}/pop',
{
  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/api/v1/customers/{customerID}/orders/{orderID}/pop',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pop', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pop");
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/api/v1/customers/{customerID}/orders/{orderID}/pop", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /customers/{customerID}/orders/{orderID}/pop

Get proof of pickup order with orderID and customerID

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

{
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "deleted_at": "2020-08-05T04:36:17Z",
  "id": "string",
  "Customer": "string",
  "Status": "string",
  "type": "string",
  "Date": "2020-08-05T04:36:17Z",
  "Signee": "string",
  "Latitude": "string",
  "Longitude": "string",
  "FileURL": "string",
  "SigFileURL": "string",
  "UploadedAt": "string",
  "UploadedBy": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	successful operation	OrderProof
400	Bad Request	Bad request	ApiError

Get Order Proof of delivery

Code samples

# You can also use wget
curl -X GET https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pod \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pod 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/api/v1/customers/{customerID}/orders/{orderID}/pod',
  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/api/v1/customers/{customerID}/orders/{orderID}/pod',
{
  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/api/v1/customers/{customerID}/orders/{orderID}/pod',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pod', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/pod");
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/api/v1/customers/{customerID}/orders/{orderID}/pod", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /customers/{customerID}/orders/{orderID}/pod

Get proof of Delivery order with orderID and customerID

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

{
  "created_at": "2020-08-05T04:36:17Z",
  "updated_at": "2020-08-05T04:36:17Z",
  "deleted_at": "2020-08-05T04:36:17Z",
  "id": "string",
  "Customer": "string",
  "Status": "string",
  "type": "string",
  "Date": "2020-08-05T04:36:17Z",
  "Signee": "string",
  "Latitude": "string",
  "Longitude": "string",
  "FileURL": "string",
  "SigFileURL": "string",
  "UploadedAt": "string",
  "UploadedBy": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	successful operation	OrderProof
400	Bad Request	Bad request	ApiError

Bulk Create Quotes

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "est_delivery_start_at": "2020-08-05T04:36:17Z",
      "est_delivery_end_at": "2020-08-05T04:36:17Z",
      "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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/quotes/create_bulk', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "est_delivery_start_at": "2020-08-05T04:36:17Z",
      "est_delivery_end_at": "2020-08-05T04:36:17Z",
      "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": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "est_delivery_start_at": "2020-08-05T04:36:17Z",
      "est_delivery_end_at": "2020-08-05T04:36:17Z",
      "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

Select Order Quote

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST https://platform.roserocket.com/api/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/api/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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/quotes/{quoteID}/select', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
  "pickup_end_at": "2020-08-05T04:36:17Z",
  "est_delivery_start_at": "2020-08-05T04:36:17Z",
  "est_delivery_end_at": "2020-08-05T04:36:17Z",
  "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

Bulk Create Booked Orders

Code samples

# You can also use wget
curl -X POST https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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/api/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/api/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/api/v1/customers/{customerID}/bulk_create_booked_order', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "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": "2020-08-05T04:36:17Z",
        "bus_hours_end_at": "2020-08-05T04:36:17Z"
      },
      "billing_option": "prepaid",
      "notes": "string",
      "po_num": "string",
      "tender_num": "string",
      "ref_num": "string",
      "custom_broker": "string",
      "port_of_entry": "string",
      "declared_value": 0,
      "declared_value_currency": "cad",
      "pickup_start_at": "2020-08-05T04:36:17Z",
      "pickup_end_at": "2020-08-05T04:36:17Z",
      "pickup_appt_start_at": "2020-08-05T04:36:17Z",
      "pickup_appt_end_at": "2020-08-05T04:36:17Z",
      "delivery_start_at": "2020-08-05T04:36:17Z",
      "delivery_end_at": "2020-08-05T04:36:17Z",
      "delivery_appt_start_at": "2020-08-05T04:36:17Z",
      "delivery_appt_end_at": "2020-08-05T04:36:17Z",
      "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	Bulk_Create_OrdersBody	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
»»» email	body	string	false	Email
»»» 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
»» port_of_entry	body	string	false	Port of entry in cross-border order
»» 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

Revise Order Origin

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  }
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'

};

fetch('https://platform.roserocket.com/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/revise_origin', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  }
}

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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "pickup_start_at": "2020-08-05T04:36:17Z",
    "pickup_end_at": "2020-08-05T04:36:17Z",
    "pickup_appt_start_at": "2020-08-05T04:36:17Z",
    "pickup_appt_end_at": "2020-08-05T04:36:17Z",
    "delivery_start_at": "2020-08-05T04:36:17Z",
    "delivery_end_at": "2020-08-05T04:36:17Z",
    "delivery_appt_start_at": "2020-08-05T04:36:17Z",
    "delivery_appt_end_at": "2020-08-05T04:36:17Z",
    "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_book_id": "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_book_id": "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": "2020-08-05T04:36:17Z",
      "origin_end_at": "2020-08-05T04:36:17Z",
      "origin_appt_start_at": "2020-08-05T04:36:17Z",
      "origin_appt_end_at": "2020-08-05T04:36:17Z",
      "destination_start_at": "2020-08-05T04:36:17Z",
      "destination_end_at": "2020-08-05T04:36:17Z",
      "destination_appt_start_at": "2020-08-05T04:36:17Z",
      "destination_appt_end_at": "2020-08-05T04:36:17Z",
      "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": "2020-08-05T04:36:17Z",
        "origin_in_at": "2020-08-05T04:36:17Z",
        "origin_pickedup_at": "2020-08-05T04:36:17Z",
        "origin_out_at": "2020-08-05T04:36:17Z",
        "destination_arrived_at": "2020-08-05T04:36:17Z",
        "destination_in_at": "2020-08-05T04:36:17Z",
        "destination_delivered_at": "2020-08-05T04:36:17Z",
        "destination_out_at": "2020-08-05T04:36:17Z"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	successful operation	OrderAndLegsResponse
400	Bad Request	Bad request	ApiError

Revise Order Destination

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/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/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  }
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'

};

fetch('https://platform.roserocket.com/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/revise_destination', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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": "2020-08-05T04:36:17Z",
    "bus_hours_end_at": "2020-08-05T04:36:17Z"
  }
}

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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",
    "billing_option": "prepaid",
    "notes": "string",
    "po_num": "string",
    "tender_num": "string",
    "ref_num": "string",
    "custom_broker": "string",
    "port_of_entry": "string",
    "declared_value": 0,
    "declared_value_currency": "cad",
    "pickup_start_at": "2020-08-05T04:36:17Z",
    "pickup_end_at": "2020-08-05T04:36:17Z",
    "pickup_appt_start_at": "2020-08-05T04:36:17Z",
    "pickup_appt_end_at": "2020-08-05T04:36:17Z",
    "delivery_start_at": "2020-08-05T04:36:17Z",
    "delivery_end_at": "2020-08-05T04:36:17Z",
    "delivery_appt_start_at": "2020-08-05T04:36:17Z",
    "delivery_appt_end_at": "2020-08-05T04:36:17Z",
    "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_book_id": "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_book_id": "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": "2020-08-05T04:36:17Z",
      "origin_end_at": "2020-08-05T04:36:17Z",
      "origin_appt_start_at": "2020-08-05T04:36:17Z",
      "origin_appt_end_at": "2020-08-05T04:36:17Z",
      "destination_start_at": "2020-08-05T04:36:17Z",
      "destination_end_at": "2020-08-05T04:36:17Z",
      "destination_appt_start_at": "2020-08-05T04:36:17Z",
      "destination_appt_end_at": "2020-08-05T04:36:17Z",
      "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": "2020-08-05T04:36:17Z",
        "origin_in_at": "2020-08-05T04:36:17Z",
        "origin_pickedup_at": "2020-08-05T04:36:17Z",
        "origin_out_at": "2020-08-05T04:36:17Z",
        "destination_arrived_at": "2020-08-05T04:36:17Z",
        "destination_in_at": "2020-08-05T04:36:17Z",
        "destination_delivered_at": "2020-08-05T04:36:17Z",
        "destination_out_at": "2020-08-05T04:36:17Z"
      }
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	successful operation	OrderAndLegsResponse
400	Bad Request	Bad request	ApiError

Revise Order Commodities

Code samples

# You can also use wget
curl -X PUT https://platform.roserocket.com/api/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/api/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/api/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/api/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/api/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/api/v1/customers/{customerID}/orders/{orderID}/revise_commodities', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://platform.roserocket.com/api/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/api/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 order 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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "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": "2020-08-05T04:36:17Z",
      "bus_hours_end_at": "2020-08-05T04:36:17Z"
    },
    "status": "new",