Book shipment

curl --request POST \
  --url https://api.quivo.co/v2/shipments/bookShopAsync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "shippingServiceGroupId": 123,
  "mailTo": "<string>",
  "shopId": 123,
  "orderIdentifiers": [
    "<string>"
  ],
  "parcelWeight": 1,
  "requestUUID": "<string>",
  "reference": "<string>",
  "shipFrom": {
    "name": "<string>",
    "company": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso2": "<string>",
    "street": "<string>",
    "street2": "<string>",
    "latitude": 123,
    "longitude": 123
  },
  "lengthM": 1,
  "widthM": 1,
  "heightM": 1,
  "parcelHeight": 1,
  "parcelWidth": 1,
  "parcelLength": 1,
  "contentWeight": 1,
  "exportFulfillment": true,
  "hideEmailAddress": true
}
'

import requests

url = "https://api.quivo.co/v2/shipments/bookShopAsync"

payload = {
    "shippingServiceGroupId": 123,
    "mailTo": "<string>",
    "shopId": 123,
    "orderIdentifiers": ["<string>"],
    "parcelWeight": 1,
    "requestUUID": "<string>",
    "reference": "<string>",
    "shipFrom": {
        "name": "<string>",
        "company": "<string>",
        "phone": "<string>",
        "email": "<string>",
        "zip": "<string>",
        "city": "<string>",
        "state": "<string>",
        "countryIso2": "<string>",
        "street": "<string>",
        "street2": "<string>",
        "latitude": 123,
        "longitude": 123
    },
    "lengthM": 1,
    "widthM": 1,
    "heightM": 1,
    "parcelHeight": 1,
    "parcelWidth": 1,
    "parcelLength": 1,
    "contentWeight": 1,
    "exportFulfillment": True,
    "hideEmailAddress": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    shippingServiceGroupId: 123,
    mailTo: '<string>',
    shopId: 123,
    orderIdentifiers: ['<string>'],
    parcelWeight: 1,
    requestUUID: '<string>',
    reference: '<string>',
    shipFrom: {
      name: '<string>',
      company: '<string>',
      phone: '<string>',
      email: '<string>',
      zip: '<string>',
      city: '<string>',
      state: '<string>',
      countryIso2: '<string>',
      street: '<string>',
      street2: '<string>',
      latitude: 123,
      longitude: 123
    },
    lengthM: 1,
    widthM: 1,
    heightM: 1,
    parcelHeight: 1,
    parcelWidth: 1,
    parcelLength: 1,
    contentWeight: 1,
    exportFulfillment: true,
    hideEmailAddress: true
  })
};

fetch('https://api.quivo.co/v2/shipments/bookShopAsync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.quivo.co/v2/shipments/bookShopAsync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'shippingServiceGroupId' => 123,
    'mailTo' => '<string>',
    'shopId' => 123,
    'orderIdentifiers' => [
        '<string>'
    ],
    'parcelWeight' => 1,
    'requestUUID' => '<string>',
    'reference' => '<string>',
    'shipFrom' => [
        'name' => '<string>',
        'company' => '<string>',
        'phone' => '<string>',
        'email' => '<string>',
        'zip' => '<string>',
        'city' => '<string>',
        'state' => '<string>',
        'countryIso2' => '<string>',
        'street' => '<string>',
        'street2' => '<string>',
        'latitude' => 123,
        'longitude' => 123
    ],
    'lengthM' => 1,
    'widthM' => 1,
    'heightM' => 1,
    'parcelHeight' => 1,
    'parcelWidth' => 1,
    'parcelLength' => 1,
    'contentWeight' => 1,
    'exportFulfillment' => true,
    'hideEmailAddress' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.quivo.co/v2/shipments/bookShopAsync"

	payload := strings.NewReader("{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.quivo.co/v2/shipments/bookShopAsync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.quivo.co/v2/shipments/bookShopAsync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}"

response = http.request(request)
puts response.read_body

This response has no body data.

POST

shipments

bookShopAsync

Book shipment

curl --request POST \
  --url https://api.quivo.co/v2/shipments/bookShopAsync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "shippingServiceGroupId": 123,
  "mailTo": "<string>",
  "shopId": 123,
  "orderIdentifiers": [
    "<string>"
  ],
  "parcelWeight": 1,
  "requestUUID": "<string>",
  "reference": "<string>",
  "shipFrom": {
    "name": "<string>",
    "company": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "state": "<string>",
    "countryIso2": "<string>",
    "street": "<string>",
    "street2": "<string>",
    "latitude": 123,
    "longitude": 123
  },
  "lengthM": 1,
  "widthM": 1,
  "heightM": 1,
  "parcelHeight": 1,
  "parcelWidth": 1,
  "parcelLength": 1,
  "contentWeight": 1,
  "exportFulfillment": true,
  "hideEmailAddress": true
}
'

import requests

url = "https://api.quivo.co/v2/shipments/bookShopAsync"

payload = {
    "shippingServiceGroupId": 123,
    "mailTo": "<string>",
    "shopId": 123,
    "orderIdentifiers": ["<string>"],
    "parcelWeight": 1,
    "requestUUID": "<string>",
    "reference": "<string>",
    "shipFrom": {
        "name": "<string>",
        "company": "<string>",
        "phone": "<string>",
        "email": "<string>",
        "zip": "<string>",
        "city": "<string>",
        "state": "<string>",
        "countryIso2": "<string>",
        "street": "<string>",
        "street2": "<string>",
        "latitude": 123,
        "longitude": 123
    },
    "lengthM": 1,
    "widthM": 1,
    "heightM": 1,
    "parcelHeight": 1,
    "parcelWidth": 1,
    "parcelLength": 1,
    "contentWeight": 1,
    "exportFulfillment": True,
    "hideEmailAddress": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    shippingServiceGroupId: 123,
    mailTo: '<string>',
    shopId: 123,
    orderIdentifiers: ['<string>'],
    parcelWeight: 1,
    requestUUID: '<string>',
    reference: '<string>',
    shipFrom: {
      name: '<string>',
      company: '<string>',
      phone: '<string>',
      email: '<string>',
      zip: '<string>',
      city: '<string>',
      state: '<string>',
      countryIso2: '<string>',
      street: '<string>',
      street2: '<string>',
      latitude: 123,
      longitude: 123
    },
    lengthM: 1,
    widthM: 1,
    heightM: 1,
    parcelHeight: 1,
    parcelWidth: 1,
    parcelLength: 1,
    contentWeight: 1,
    exportFulfillment: true,
    hideEmailAddress: true
  })
};

fetch('https://api.quivo.co/v2/shipments/bookShopAsync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.quivo.co/v2/shipments/bookShopAsync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'shippingServiceGroupId' => 123,
    'mailTo' => '<string>',
    'shopId' => 123,
    'orderIdentifiers' => [
        '<string>'
    ],
    'parcelWeight' => 1,
    'requestUUID' => '<string>',
    'reference' => '<string>',
    'shipFrom' => [
        'name' => '<string>',
        'company' => '<string>',
        'phone' => '<string>',
        'email' => '<string>',
        'zip' => '<string>',
        'city' => '<string>',
        'state' => '<string>',
        'countryIso2' => '<string>',
        'street' => '<string>',
        'street2' => '<string>',
        'latitude' => 123,
        'longitude' => 123
    ],
    'lengthM' => 1,
    'widthM' => 1,
    'heightM' => 1,
    'parcelHeight' => 1,
    'parcelWidth' => 1,
    'parcelLength' => 1,
    'contentWeight' => 1,
    'exportFulfillment' => true,
    'hideEmailAddress' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.quivo.co/v2/shipments/bookShopAsync"

	payload := strings.NewReader("{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.quivo.co/v2/shipments/bookShopAsync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.quivo.co/v2/shipments/bookShopAsync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"shippingServiceGroupId\": 123,\n  \"mailTo\": \"<string>\",\n  \"shopId\": 123,\n  \"orderIdentifiers\": [\n    \"<string>\"\n  ],\n  \"parcelWeight\": 1,\n  \"requestUUID\": \"<string>\",\n  \"reference\": \"<string>\",\n  \"shipFrom\": {\n    \"name\": \"<string>\",\n    \"company\": \"<string>\",\n    \"phone\": \"<string>\",\n    \"email\": \"<string>\",\n    \"zip\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"countryIso2\": \"<string>\",\n    \"street\": \"<string>\",\n    \"street2\": \"<string>\",\n    \"latitude\": 123,\n    \"longitude\": 123\n  },\n  \"lengthM\": 1,\n  \"widthM\": 1,\n  \"heightM\": 1,\n  \"parcelHeight\": 1,\n  \"parcelWidth\": 1,\n  \"parcelLength\": 1,\n  \"contentWeight\": 1,\n  \"exportFulfillment\": true,\n  \"hideEmailAddress\": true\n}"

response = http.request(request)
puts response.read_body

This response has no body data.

Authorizations

Authorization

string

header

required

Access token from POST /v2/oauth2/token, requested with an API credential. See https://api-docs.quivo.co/api-reference/authentication.

Body

application/json

Request body data for Book shipment

Request payload for booking shipments for shop orders asynchronously. Contains shop identifiers, order references, shipping configuration, and email notification settings.

shippingServiceGroupId

integer<int64>

required

shipping service group from which to load the shipping services to use.

mailTo

string

required

e-Mail address to which the results will be sent.
Muliple e-mail addresses can be specified by separating them with a comma.

shopId

integer<int64>

required

ID of the shop from which the order data can be retrieved.

orderIdentifiers

string[]

required

list of order identifiers for which the shipments need to get booked.
At least one order identifier needs to be specified.
Duplicate or empty order identifiers are not allowed.

Required array length: 1 - 2147483647 elements

parcelWeight

number

required

The weight of the packaging material used in kg.
Should not contain the weight of the shipment's content (eg: products).

Required range: x > 0

requestUUID

string

A unique identifier for the request.
Used for tracing and to prevent duplicate shipment bookings.
This value is optional, if not included, a random requestUUID is generated.

reference

string

A human readable reference for the request.
This will be included in the mail that is sent once the operation completes.
This value is optional, if not included, a random reference will be generated.

shipFrom

object

The

Show child attributes

lengthM

number

Optional length (in meters) of the shipment.

Required range: x > 0

widthM

number

Optional width (in meters) of the shipment.

Required range: x > 0

heightM

number

Optional height (in meters) of the shipment.

Required range: x > 0

parcelHeight

number

The height of the packaging material used in m.
Value is rounded to three decimal places.

Required range: x > 0

parcelWidth

number

The width of the packaging material used in m.
Value is rounded to three decimal places.

Required range: x > 0

parcelLength

number

The length of the packaging material used in m.
Value is rounded to three decimal places.

Required range: x > 0

contentWeight

number

Optional weight of the shipment's content in kg.
Should not contain the weight of the packaging material.
Use this field with care and in rare cases only, as it overrides the default weight calculation, which is based on the ordered product's weight.
Using this field can cause inconsistencies with the customs declaration and could result in errors during shipment booking.

Required range: x > 0

exportFulfillment

boolean

If set to true, the fulfillment data (tracking number and provider) are transmitted to the shop system after the label was created.

hideEmailAddress

boolean

If set to true, the shipment recipient's e-mail address is not transmitted to the carrier.
This means that the carrier is not able to contact the recipient of the shipment by e-mail.

Response

Bad request - the request payload is invalid, missing required fields, or contains invalid data.

Introduction

Endpoints

Book shipment

Authorizations

Body

Response