New API v2

The new API v2 are being released, featuring new functionalities and a new, more secure authentication method.

Introduction

APIs provide the possibility to integrate Qapla' both for reading and writing with your own ecommerce system or for an e-commerce to which a plugin or connector has not yet been implemented.

Qapla' API is based on REST.
Accepts GET, POST, PUT and DELETE JSON encoded requests.
Returns JSON encoded values.
The reference time zone is CEST, which corresponds to UTC + 2 when daylight saving time is in effect, or UTC + 1 when standard time is in effect.

Latest version available

This is the latest version of the APIs. Not all APIs have been migrated to version 1.3 yet; as new features are added, they will be updated.

APIs that haven't been updated yet still refer to version 1.2

Previous versions

Previous versions of this API are still active, but considered as deprecated.

Webhook

Qapla' also has a Webhook service which is an integral part of the API.

API Key

In oder to use the APIs, it is necessary to know the Private API Keys assigned to your channel(s), available on the Control Panel in the section:

Settings \ [CHANNEL_NAME]

This API key must be protected and kept secret.

Endpoint

https://api.qapla.it/[API_VERSION]/[ENDPOINT]

[API_VERSION]	It is the version value of the API.
[ENDPOINT]	It is the endpoint you need to invoke.

Response

The JSON response to a Request uses this standard format

[API_NAME]	The name of the API consumed
[OK/KO]	OK in case of a positive answer, KO In case of an error
[ERROR_MESSAGE]	It is null in case of OK and will contain the error in case of KO

Rate limiting

The system uses the TokenBucket algorithm with the following parameters:

Bucket capacity	120	Maximum of 120 requests
Tokens per second	2	Refilling at a rate of 2 per second

Warning
A multiple request (e.g. pushShipment or pushOrder with 100 shipments or orders) is evaluated as 100 tokens.

HTTP Response Status Codes

Exceeding the limit will lead to the following HTTP response

429 Too Many Requests

and the following response error by any API involved

"error": "Too Many Requests"

Abuse

The abuse of the use will lead to a BAN of the API Key.

Sandbox

There isn't any proper sandbox environment. However you can use the sandbox field in the API methods (where supported) to use the test infrastructure, without having operational effects (like costs, picking requests sent to the carries, etc...)

Test

Once the API Key has been obtained, a connection test can be immediately performed using the API getChannel.

Postman Collection

A Postman Collection is available.

Shipments

The primary key to identify a shipment is:

Channel, represented by API Key
Courier, "courier"
Tracking number, "trackingNumber"

pushShipment

pushShipment allows you to upload one or more shipments through a POST of data in JSON format.

In combination with the Webhook creates an integrated shipping management system.

POSThttps://api.qapla.it/1.3/pushShipment/

REQUEST
RESPONSE

Request

In this example, two shipments are loaded, one in "minimum" and one "complete" format.

{
  "apiKey": "[API_KEY]",
  "pushShipment": [
    {
      "trackingNumber": "123987299",
      "courier": "DHL",
      "shipDate": "2014-08-01"
    },
    {
      "trackingNumber": "1Z0V5V416840696736",
      "courier": "UPS",
      "shipDate": "2014-08-02",
      "reference": "ord. # 1674",
      "orderDate": "2014-07-30",
      "parcels": [{
        "weight": 1.3,
        "length": 10,
        "width": 15,
        "height": 5,
        "boxCode": null,
        "content": null,
        "originCountry": null
      }],
      "name": "Pepito Sbazzeguti",
      "street": "Via Aieie, 99",
      "city": "Parnazza",
      "ZIP": "12345",
      "state": "MZ",
      "country": "IT",
      "email": "name@domain.ext",
      "telephone": "02342522",
      "agent": "agent@company.ext",
      "amount": 150.00,
      "pod": false,
      "shipping": 8.00,
      "custom1": "valore custom 1",
      "custom2": "valore custom 2",
      "custom3": "valore custom 3",
      "note": "This is a note",
      "language": "it",
      "deliveryDate": "2014-07-31",
      "latestShipDate": "2014-08-03",
      "latestDeliveryDate": "2014-08-05",
      "tag": "customer1",
      "isTrackingNumber": false,
      "origin": "magento",
      "isReturnable": true,
      "platformOrderID": "1234567890",
      "rows": [
        {
          "sku": "BAR-301",
          "name": "Barrette di Crusca d'Avena con Cioccolato (4 pezzi) 120g",
          "qty": 1,
          "weight": 1.5,
          "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
          "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
          "price": 6.35,
          "total": 6.35,
          "isReturnable": true,
          "customsCode": null,
          "originCountry": null,
          "netWeight": null,
          "unitOfMeasurement": null,
          "parcelID": null,
          "transparencyCodes": [
            "ABC123",
            "DEF456"
          ]
        },
        {
          "sku": "BEV-001",
          "name": "Bevanda al mango in polvere 9g",
          "qty": 5,
          "weight": 1,
          "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
          "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
          "price": 0.38,
          "total": 1.9,
          "isReturnable": true,
          "customsCode": null,
          "originCountry": null,
          "netWeight": null,
          "unitOfMeasurement": null,
          "parcelID": null
        }
      ]
    }
  ]
}

Parameters

There are 3 types of shipment loading modes.

"minimum" containing 3 mandatory fields^*
"necessary" to activate additional communication services to the customer such as transactional emails, etc.^•
"complete" always with the first 3 mandatory fields, but containing all the information

^*Mandatory parameter

^•Parameter required to activate transactional emails and / or SMS

⚠
The maximum number of shipments that can be sent for individual request is 100.

apiKey(string)

The API Key assigned to the channel into which you want to import shipments

pushShipment(array)

It is an array of maximum 100 shipments to load.

trackingNumber^*(string)

The tracking number / shipping number / waybill of the courier

courier^*(string)

The Qapla' courier code

shipDate^*(string)

Shipment date

reference^•(string)

Order reference

platformOrderID(string)

Optional numeric or alphanumeric ID, used as additional order reference

orderDate(string)

Order date

parcels(array)

Possible parcels of the delivery. Each shipment can be defined through an object composed as follows:

weight(float)	Potential weight of the order. Mandatory if the "boxCode" is not sent
length(float)	Potential measurements: length. Mandatory if the "boxCode" is not sent
width(float)	Potential measurements: width. Mandatory if the "boxCode" is not sent
height(float)	Potential measurements: height. Mandatory if the "boxCode" is not sent
boxCode(string)	Potential box code (if used, measurements will be taken from the box with the corresponding code)
originCountry(string)	Potential Country of origin of the package in ISO 3166-1 alpha-2 format (Example: IT)
content(string)	Potential description of the content

name^•(string)

Recipient Name

street(string)

Recipient address

city(string)

Recipient City

ZIP(string)

Recipient postal code

state(string)

Recipient province

country(string)

Recipient country in format ISO 3166-1 alpha-2 (Example: IT)

email^•(string)

Recipient email

telephone^•(string)

Recipient telephone

agent(string)

Email address of a customer business contact

amount(float)

Potential amount of the shipment (to be communicated to the customer. Ex: cash on delivery)

pod(boolean)

It is true if payment is cash on delivery

shipping(float)

Potential cost of shipment

custom1(string)

Custom value 1

custom2(string)

Custom value 2

custom3(string)

Custom value 3

note(string)

A note regarding the shipment (max 255 chars)

language(string)

Shipment language ( ISO 639-1 , ex: 'fr').
A null or unrecognized value will indicate the shipment as 'it'.

origin(string)

Origin of shipment, permitted values:

    ahlens, aliexpress, allegro, alltricks, amazon, animalis, anthropologie, asos, atlasformen, auchan, bandq, beerwulf, bestsecret,
    bhv, bigcommerce, bild, blackredwhite, blokker, boots, brandalley, bricobravo, bricodepot, bricomarche, bricoprive, bulevip, but, carrefour_es,
    carrefour_fr, casadellibro, castorama, cdiscount, commercelayer, conforama, creavea, cultura, darty, debenhams, decathlon, douglas, ebay, ecwid,
    elcorteingles, elkjop, ellos, empik, eprice, etsy, fanatics, feelunique, fnac, fonq, freepeople, fressnapf, gifi, greenweez_fr, handm, home24, ibs,
    incomedia, lafayette, laredoute, leroyMerlin_it, magento, magento2, maisonDuMonde_es, maisonDuMonde_it, manomano, manomano_de, manomano_es, manomano_fr,
    manomano_gb, manomano_it, matalan, mathon, maty, maykers, mediaMarkt_at, mediaMarkt_de, mediaMarkt_es, mediaMarkt_it, mediaMarkt_nl, miravia_es, modivo_pl,
    mountainwh, natureetdeco, newcart, nocibe, obelink, pandacola, pccomponentes, perfumesclub, phonehouse, pixmania, placedestend, planetahuerto, pourdebon,
    prestashop, printemps, privalia, privalia_es, privalia_it, privsportshop, public, quirumed, redcarepharmacy, rueducommerce, sarenza, shopapotheke, shopify,
    shopware6, showroomprive, slood, spartoo, spartoo_be, spartoo_bg, spartoo_cn, spartoo_com, spartoo_comhr, spartoo_couk, spartoo_cz, spartoo_de, spartoo_dk,
    spartoo_es, spartoo_fi, spartoo_fr, spartoo_gb, spartoo_gr, spartoo_hu, spartoo_it, spartoo_nl, spartoo_pl, spartoo_pt, spartoo_ro, spartoo_se, spartoo_si, spartoo_sk, sprinter_es,
    stadium, storeden¤, superdrug, teamsystemcommerce¤tiendanimal, tradeinn, truffaut, twil, ubaldi, urbanoutfitters, venca, venteunique, vivino, vtex, watchfinder,
    winesitting, woocommerce, wook, worten_es, worten_pt, yoox

^¤storeden and teamsystemcommerce can be used as synonyms

isReturnable(bool)

If it is true, it indicates the possibility of returning the entire shipment.

deliveryDate(string)

Potential delivery request date

latestShipDate(string)

To be shipped by this date in the YYYY-MM-DD format

latestDeliveryDate(string)

To be delivered by this date in the YYYY-MM-DD format

tag(string)

A "tag" to identify shipments belonging to a group.

isTrackingNumber(bool)

It is true when placed in the trackingNumber field it is the real tracking number of the shipment.

rows

It is an array of "order lines".

It is not mandatory, but if populated it has some data that is.

sku^*(string)

Article code

name^*(string)

Article description

qty^*(int)

Quantity

price^*(float)

Price

total(float)

Total price

weight(float)

Potential article weight

url(string)

The specific url of the product

imageUrl(string)

The url of the product image

notes(string)

Product notes

customsCode(string)

Potential code used for customs (HSCode, Taric, etc.)

originCountry(string)

Product's country of origin ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Potential net weight of the product

unitOfMeasurement(string)

Generale
DHL

Potential unit of measurement

Code	Description
BOX	Boxes
2GM	Centimeters
2M3	Cubic Centimeters
3M3	Cubic Feet
M3	Cubic Meters
DPR	Dozen Pairs
DOZ	Dozen
2NO	Each
PCS	Pieces
GM	Grams
GRS	Gross
KG	Kilograms
L	Liters
M	Meters
3GM	Milligrams
3L	Milliliters
X	No Unit Required
NO	Number
2KG	Ounces
PRS	Pairs
2L	Gallons
3KG	Pounds
CM2	Square Centimeters
2M2	Square Feet
3M2	Square Inches
M2	Square Meters
4M2	Square Yards
3M	Yards
CM	Centimeters
CONE	Cone
CT	Carat
EA	Each
LBS	Pounds
RILL	Rill
ROLL	Roll
SET	Set
TU	Time Unit
YDS	Yard

parcelID(int)

Potential progressive number, identifying the package number in which the product is shipped

transparencyCodes(string[])

Transparency Code array

Response Body`200`

Errors

In case of error, each shipping line will be reported:

getShipment

getShipment allows you to read the status of a shipment through the tracking number, the order reference or the ID.

For a total and integrated management of the update cycle of shipments, also evaluate the Webhook.

🛈
Remember the usage limits and also evaluate the Webhook.

GEThttps://api.qapla.it/1.3/getShipment/?apiKey=[API_KEY]&trackingNumber=[TRACKING_NUMBER]

GEThttps://api.qapla.it/1.3/getShipment/?apiKey=[API_KEY]&reference=[ORDER_REFERENCE]

GEThttps://api.qapla.it/1.3/getShipment/?apiKey=[API_KEY]&id=[SHIPMENT_ID]

GEThttps://api.qapla.it/1.3/getShipment/?apiKey=[API_KEY]&custom1=[CUSTOM1]

REQUEST
RESPONSE

Parameters

Parameter

Description

apiKey^*(string)

The API Key assigned to the channel we want to query

Exclusive parameters

trackingNumber(string)

The interested tracking number

reference(string)

The order reference

id(int)

Shipment ID

custom1, custom2, custom3(string)

The fields custom1, custom2, custom3

Optional parameters

lang

The language of the names of the Qapla' status (it, en, es), default: it.

Example:

&lang=en

data

The flag data specifies which and how much data we want to receive, by default it returns minimal data on the progress of the shipment.
It can have the following values:

Parameter	Description
	If no parameter is specified, it will be returned the minimum data
all	Minimum data + all the data to follow
consignee	Minimum data + recipient data
children	Minimum data + data of child shipments, if any
parent	Minimum data + data of the parent shipment, if any
flag	Minimum data + data relating to the report of the shipment, if any
notifications	Minimum data + notification data (email sms, webhook, qaplAPP)
history	Minimum data + shipment tracking history
rows	Minimum data + product rows
parcels	Minimum data + parcels information
deliveryInfo	Minimum data + information on shipping methods (ship by, delivery by)

The parameter can be combined separated by commas, for example

&data=consignee,history

in order to get only these data.

Response Body`200`

{
  "getShipment": {
    "result": "OK",
    "error": null,
    "version": "1.3.0",
    "lang": "it",
    "count": 1,
    "shipments": [
      {
        "id": 1690120025,
        "hash": "347513728eab0009bfc60cc47acaffd0",
        "url": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
        "reference": "RAD000UFPL",
        "trackingNumber": "080010017684806",
        "isDeleted": false,
        "isArchived": false,
        "origin": {
          "code": "magento",
          "name": "Magento",
          "icon": "https://cdn.qapla.it/origin/magento.svg"
        },
        "courier": {
          "code": "BRT",
          "name": "BRT",
          "icon": "https://cdn.qapla.it/courier/BRT.svg",
          "note": null,
          "estimatedDeliveryDate": null,
          "trackingURL": "https://brt.it/tracking/fooandnoes"
        },
        "status": {
          "date": "2019-06-14 06:15",
          "dateISO": "2019-06-14 06:15:00",
          "status": "ON_THE_ROAD",
          "place": "RIVALTA (TO) (IT)",
          "qaplaStatus": {
            "id": 3,
            "status": "IN TRANSIT",
            "detailID": 0,
            "detail": null,
            "color": "#1D76D8",
            "icon": "https://cdn.qapla.it/status/3.svg"
          },
          "dateUpd": "2019-06-14 15:53:15",
          "lastCheck": "2019-06-14 22:17:13"
        },
        "shipDate": "2019-06-13",
        "orderDate": "2019-01-31",
        "dateIns": "2019-06-14 15:49:18",
        "consignee": {
          "name": "Luca Cassia",
          "address": "Via Campazzino, 12",
          "city": "Milano",
          "state": "MI",
          "postCode": "20100",
          "country": "IT",
          "email": "adso@defanchisgiocattoli.it",
          "isAmazon": false,
          "phone": "02343522"
        },
        "language": "it",
        "newTrackingNumber": null,
        "oldTrackingNumber": null,
        "hasNewTrackingNumber": false,
        "isTrackingNumber": true,
        "returnTrackingNumber": null,
        "isReturnShipment": false,
        "isCOD": false,
        "amountText": null,
        "amount": null,
        "isDelivered": false,
        "isChild": true,
        "parent": {
          "id": "2010200",
          "reference": "AD000UFPL",
          "rackingNumber": "090010015489",
          "courier": "BRT",
          "url": "https://api.qapla.it/1.3/getShipment/?apiKey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&id=0000000"
        },
        "hasChildren": true,
        "children": [
          {
            "id": "121029109",
            "reference": "303-XX11XX-5621132",
            "trackingNumber": "0844!!!!7689193",
            "courier": "DPD",
            "url": "https://api.qapla.it/1.3/getShipment/?apiKey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&id=000001"
          }
        ],
        "trueTrackingNumber": null,
        "altTrackingNumber": null,
        "custom1": null,
        "custom2": null,
        "custom3": null,
        "deliveryMode": "pickup",
        "hasFlag": true,
        "latestShipDate": "2018-04-03",
        "latestDeliveryDate": "2018-04-05",
        "flag": {
          "description": "Ritardo Courier",
          "note": "telefonato a Pino"
        },
        "notifications": {
          "email": [
            {
              "result": "OK",
              "statusID": 3,
              "status": "IN TRANSIT",
              "date": "2019-06-14 16:00:08",
              "error": false,
              "isOpened": true
            }
          ],
          "sms": [
            {
              "result": "OK",
              "statusID": 20,
              "status": "PARTITO",
              "date": "2019-06-14 18:50:29"
            }
          ],
          "webhook": [
            {
              "statusID": 3,
              "date": "2019-06-14 23:51:06",
              "result": "OK",
              "status": "IN TRANSITO"
            }
          ],
          "qaplAPP": [
            {
              "statusID": 4,
              "result": "OK",
              "date": "2019-06-15 08:00:00",
              "status": "IN COSEGNA"
            },
            {
              "statusID": 3,
              "result": "OK",
              "date": "2019-06-14 19:15:09",
              "status": "IN TRANSITO"
            }
          ]
        },
        "trackingHistory": [
          {
            "date": "2019-06-14 06:15",
            "dateISO": "2019-06-14 06:15:00",
            "status": "IN TRANSIT",
            "place": "RIVALTA (TO) (IT)",
            "qaplaStatus": {
              "id": 3,
              "status": "IN TRANSIT",
              "detailID": 0,
              "detail": null,
              "color": "#1D76D8",
              "icon": "https://cdn.qapla.it/status/3.svg"
            }
          },
          {
            "date": null,
            "dateISO": null,
            "status": "PARCEL HANDED TO DPD",
            "place": null,
            "qaplaStatus": {
              "id": 20,
              "status": "DEPARTED",
              "detailID": 0,
              "detail": null,
              "color": "#8A2BE2",
              "icon": "https://cdn.qapla.it/status/20.svg"
            }
          }
        ]
      }
    ]
  }
}

Description

result

The result of the operation: OK or KO in case of error

error

The error in case of result: KO

version

The API version

lang

The required language / transferred as parameter (default: it)

count

Number of current shipments

shipments

It is an array that can contain more than one shipment

Shipment ID

hash

The hash of the shipment, used for example by the tracking page

url

Web address of the tracking page of this shipment

reference

Order reference

trackingNumber

The tracking number

isDeleted

It is true (boolean value) if the shipment is cancelled

isArchived

It is true (boolean value) if the shipment is filed

origin

The origin of the shipment if loaded (es: magento, prestashop, amazon, ecc)

courier

code	Courier code
name	Name of the courier
icon	Icon's URL of the courier
note	Possible notes from the courier on the shipment
estimatedDeliveryDate	Possible estimated date of expected delivery
url	Address URL of the courier
trackingURL	Tracking URL address of the courier for this shipment

status

Current status of the shipment

date

Status date, as reported by the courier

dateISO

The ISO version YYYY-MM-DD HH:MM:SS of the date communicated by the courier

status

Status communicated by the courier

place

Location communicated by the courier

qaplaStatus

The "translation" of the status of the courier in the status of Qapla'

id	The ID of the status
status	The description
detailID	ID of the possible detail
detail	Description of the possible detail
color	The color assigned by Qapla' to the status
icon	Status icon

dateUpd

The date in which the shipment status has been updated on Qapla'

lastCheck

The date of the last control of the shipment status

shipDate

The shipment date communicated when the shipment is loaded

orderDate

The order date communicated when the shipment is loaded

dateIns

The upload date of the shipment

consignee

Recipient data

name	Recipient name
address	Recipient address
city	Recipient city
state	Recipient province
country	Recipient country
email	Recipient email
isAmazon	It is true (boolean value) if the recipient email is from Amazon
phone	Recipient telephone number

language

The language in which the shipment will "speak" when notifications such as email or SMS are sent

newTrackingNumber

Possible new tracking number assigned to shipment

oldTrackingNumber

Possible old tracking number in case it has been populated the field newTrackingNumber

hasNewTrackingNumber

It is true (boolean value) if the shipment has obtained a new tracking number

isTrackingNumber

It is true (boolean value) if the trackingNumber value contains the true tracking number

trueTrackingNumber

It contains the potential "true" tracking number

altTrackingNumber

It contains an alternative tracking number in case the shipment has changed it for the same courier during the trip

returnTrackingNumber

It indicates any return tracking number if different from the outward one

isReturnShipment

It is true (boolean value) if the shipment is a return / restitution shipment

isCOD

It is true (boolean value) if the shipment is cash on delivery

amountText

The textual amount of the shipment

amount

The amount as a float number

isDelivered

It is true (boolean value) if the shipment is delivered

isChild

It is true (boolean value) if the shipment is "daughter" of another shipment, in this case the "parent" field will be populated

parent

The "father" shipment

id	Shipment ID
reference	The order reference of the shipment
trackingNumber	The order tracking number of the shipment
courier	The courier code of the shipment
url	The URL to this same API to call back the "father" shipment

hasChildren

It is true (boolean value) if the shipment has "children", in this case the "children" field will be populated

children

It is an array of "child" shipments

id	Shipment ID
reference	The order reference of the shipment
trackingNumber	The order tracking number of the shipment
courier	The courier code of the shipment
url	The URL to this same API to call back the "father" shipment

custom1

The custom1 value as imported

custom2

The custom2 value as imported

custom3

The custom3 value as imported

deliveryMode

It can assume the values "home" for a delivery direct to the recipient or "pickup" for a delivery direct to a collection point (Pickup point)

hasFlag

It is true (boolean value) if the shipment has been "reported", in this case the "flag" field is populated

flag

Description	The description of the flag
Note	The potential note

notifications

All notifications sent by status for this shipment. Obtainable using the data parameter=notifications and included if data=all

It is an array of sent email

result	It is OK if the email has been successful, otherwise KO
statusID	The Qapla' status for which the email has been sent
status	Description of the sent status
date	Sent date
error	Possible error
isOpened	It is true (boolean value) if the email has been opened / read

sms

It is an array of SMS sent

result	It is OK if the SMS has been successful, otherwise KO
statusID	The Qapla' Status for which SMS has been sent
status	Description of the sent status
date	Sent date

webhook

It is an array of sent webhook

result	It is OK if the email has been successful, otherwise KO
statusID	The Qapla' status for which the webhook has been sent
status	Description of the sent status
date	Sent date

qaplAPP

It is an array of sent notifications to qaplAPP

result	It is OK if the email has been successful, otherwise KO
statusID	The Qapla' status or which notification has been sent to qaplAPP
status	Description of the sent status
date	Notification date

trackingHistory

It is an array of following elements:

date

The date of the status as communicated by the courier

dateISO

The ISO version YYYY-MM-DD HH:MM:SS of the date communicated by the courier

status

Status communicated by the courier

place

The place

qaplaStatus

The "translation" of the status of the courier in the status of Qapla'

id	Status ID
status	The description
detailID	ID of the possible detail
detail	Description of the possible detail
color	The color assigned by Qapla' to the status
icon	Status icon

parcels

The parcels present in the shipment. Obtainable using the parameter data=parcels and included if data=all.

weight(float)	Potential weight of the order. Mandatory if the "boxCode" is not sent
length(float)	Potential measurements: length. Mandatory if the "boxCode" is not sent
width(float)	Potential measurements: width. Mandatory if the "boxCode" is not sent
height(float)	Potential measurements: height. Mandatory if the "boxCode" is not sent
boxCode(string)	Potential box code (if used, measurements will be taken from the box with the corresponding code)
originCountry(string)	Potential Country of origin of the package in ISO 3166-1 alpha-2 format (Example: IT)
content(string)	Potential description of the content

rows

The rows of the products present in the shipment. Obtainable using the parameter data=rows and included if data=all.

sku^*(string)

Article code

name^*(string)

Article description

qty^*(int)

Quantity

price^*(float)

Price

total(float)

Total price

weight(float)

Potential article weight

url(string)

The specific url of the product

imageUrl(string)

The url of the product image

notes(string)

Product notes

customsCode(string)

Potential code used for customs (HSCode, Taric, etc.)

originCountry(string)

Product's country of origin ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Potential net weight of the product

unitOfMeasurement(string)

Generale
DHL

Potential unit of measurement

Code	Description
BOX	Boxes
2GM	Centimeters
2M3	Cubic Centimeters
3M3	Cubic Feet
M3	Cubic Meters
DPR	Dozen Pairs
DOZ	Dozen
2NO	Each
PCS	Pieces
GM	Grams
GRS	Gross
KG	Kilograms
L	Liters
M	Meters
3GM	Milligrams
3L	Milliliters
X	No Unit Required
NO	Number
2KG	Ounces
PRS	Pairs
2L	Gallons
3KG	Pounds
CM2	Square Centimeters
2M2	Square Feet
3M2	Square Inches
M2	Square Meters
4M2	Square Yards
3M	Yards
CM	Centimeters
CONE	Cone
CT	Carat
EA	Each
LBS	Pounds
RILL	Rill
ROLL	Roll
SET	Set
TU	Time Unit
YDS	Yard

parcelID(int)

Potential progressive number, identifying the package number in which the product is shipped

Errors

In case of error the "result" field will contain "KO" and the "error" field the description of the error.

{
"getShipment": {
    "result": "KO",
    "error": "[ERROR_MESSAGE]"
}
}

getShipments

getShipments allows you to receive the list of shipments imported from Qapla' by input date, shipping date, order date.

GEThttps://api.qapla.it/1.2/getShipments/?apiKey=[API_KEY]&[DATE]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	the API Key assigned to the channel we want to query
[DATE]^*
shipDate	shipment date in format ISO 8601 "YYYY-MM-DD"
orderDate	order date in format ISO 8601 "YYYY-MM-DD"
dateIns	upload date in format ISO 8601 "YYYY-MM-DD"

^*If no parameter is set, it will be used by default dateIns and current date.

Response Body`200`

{"getShipments":{"result":"OK","error":null,"version":"1.2.8","search":"shipDate=2019-06-20","count":2,"shipments":[{"id":1000000000001,"getShipment":"https://api.qapla.it/1.2/getShipment/?apiKey=[API_KEY]&id=000000000002","reference":"0101000101002","trackingNumber":"XX000001","isDeleted":false,"isArchived":false,"origin":"spartoo_it","courier":"GLS-ITA","statusID":2,"statusDetailID":0,"shipDate":"2019-06-20","orderDate":"2019-06-19","dateIns":"2019-06-20 11:21:10","language":"it","custom1":null,"custom2":null,"custom3":null,"isCOD": true,"deliveredDate": null},{"id":2000000000002,"getShipment":"https://api.qapla.it/1.2/getShipment/?apiKey=[API_KEY]&id=000000000002","reference":"0101000101001","trackingNumber":"XX000002","isDeleted":false,"isArchived":false,"origin":"spartoo_it","courier":"BRT","statusID":3,"statusDetailID":0,"shipDate":"2019-06-20","orderDate":"2019-06-19","dateIns":"2019-06-20 11:21:10","language":"it","custom1":null,"custom2":null,"custom3":null,"isCOD": false,"deliveredDate": "2019-06-27 10:19:23"}]}}

Description

result(string)

The result of the operation: OK or KO in case of error

error(string)

The error in case of result: KO

version(string)

The API version

search(string)

The parameter ascribed as search

count(int)

Number of current shipments

shipments(array)

It is an array that can contain more than one shipment

id(int)	Numeric ID of the shipment
getShipment(string)	The url to the getShipment API for this shipment
reference(string)	The order reference
trackingNumber(string)	The tracking number
isDeleted(bool)	It is true (boolean value) if the shipment is cancelled
isArchived(bool)	It is true (boolean value) if the shipment is filed
origin(string)	Shipment origin platform
courier(string)	The courier code of the shipment
statusID(int)	The Qapla' status of the shipment
statusDetailID(int)	Possible Qapla' status of detail
shipDate(string)	Shipment date
orderDate(string)	Order date
dateIns(string)	Upload date to Qapla''
language(string)	Shipment language
custom1(string)	The custom1 value
custom2(string)	The custom2 value
custom3(string)	The custom3 value
isCOD(boolean)	It is true if payment is cash on delivery
deliveredDate(string)	Delivered date

Errors

updateShipment

updateShipment allows you to update a shipment.

PUThttps://api.qapla.it/1.2/updateShipment/

REQUEST
RESPONSE

Parameters

The same parameters of the pushShipment are sent considering that the primary key is composed by

trackingNumber
courier

Response Body`200`

deleteShipment

deteleShipment allows you to delete a shipment.

DELETEhttps://api.qapla.it/1.2/deleteShipment/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	the API Key assigned to the channel we want to query
courier^*(string)	shipment's courier code
trackingNumber^*(string)	shipment's tracking number

Response Body`200`

undeleteShipment

undeleteShipment allows you to restore a shipment.

PATCHhttps://api.qapla.it/1.2/undeleteShipment/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	the API Key assigned to the channel we want to query
courier^*(string)	shipment's courier code
trackingNumber^*(string)	shipment's tracking number

Response Body`200`

trackingByTimeFrame

trackingByTimeFrame allows you to obtain the list of shipments that have undergone an update of the tracking status included in the dateFrom/dateTo timeframe.

GEThttps://api.qapla.it/1.2/trackingByTimeFrame/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
Optional parameters
dateFrom(timestamp)	default: an hour ago. In format ISO 8601 "yyyy-mm-dd hh:mm:ss"
dateTo(timestamp)	in format ISO 8601 "yyyy-mm-dd hh:mm:ss"
lang	The language of the names of the Qapla' status (it, en, es), default: it. Example: &lang=en

Response Body`200`

{
	"trackingByTimeFrame": {
		"result": "OK",
		"error": null,
		"version": "1.2.4",
		"dateFrom": "2019-10-29 17:03:52",
		"dateTo": "2019-10-29 23:59:59",
		"lang": "it",
		"count": 2,
		"shipments": [{
			"id": "000000000001",
			"getShipment": "https://api.qapla.it/1.2/getShipment/?apiKey=[API_KEY]&id=000000000001",
			"reference": "0101000101002-A",
			"trackingNumber": "XX000001",
			"origin": "privalia_it",
			"courier": "GLS-ITA",
			"status": {
				"date": "29/10/19 14:07",
				"dateISO": "2019-10-29 14:07:00",
				"status": "CONSEGNATA",
				"place": "LUCCA",
				"qaplaStatus": {
					"id": 99,
					"status": "CONSEGNATO",
					"detailID": 0,
					"detail": null,
					"color": "#66CC00",
					"icon": "https://cdn.qapla.it/status/99.svg"
				},
				"dateUpd": "2019-10-29 17:13:07",
				"lastCheck": "2019-10-29 17:13:07"
			},
			"shipDate": "2019-10-28",
			"orderDate": "2019-10-13",
			"dateIns": "2019-10-28 17:14:45",
			"dateUpd": "2019-10-29 17:13:07",
			"custom1": null,
			"custom2": null,
			"custom3": null
		}, {
			"id": "000000000002",
			"getShipment": "https://api.qapla.it/1.2/getShipment/?apiKey=[API_KEY]&id=000000000001",
			"reference": "0101000101002-B",
			"trackingNumber": "XX000001",
			"origin": "privalia_it",
			"courier": "GLS-ITA",
			"status": {
				"date": "29/10/19 13:53",
				"dateISO": "2019-10-29 13:53:00",
				"status": "CONSEGNATA",
				"place": "SAVONA",
				"qaplaStatus": {
					"id": 99,
					"status": "CONSEGNATO",
					"detailID": 0,
					"detail": null,
					"color": "#66CC00",
					"icon": "https://cdn.qapla.it/status/99.svg"
				},
				"dateUpd": "2019-10-29 17:12:50",
				"lastCheck": "2019-10-29 17:12:50"
			},
			"shipDate": "2019-10-28",
			"orderDate": "2019-10-25",
			"dateIns": "2019-10-28 17:14:45",
			"dateUpd": "2019-10-29 17:12:50",
			"custom1": null,
			"custom2": null,
			"custom3": null
		}]
	}
}

Description

result	The result of the operation: OK or KO in case of error
error	The error in case of result: KO
version	The version of API
lang	The language requested / passed as a parameter (default: it)
count	Number of current shipments
shipments	The description of shipment

Orders

The primary key to identify an order is:

Channel, represented by API Key
Order reference, "reference"
Tracking number, "trackingNumber

An order update occurs if during a pushOrder, the date of update "updatedAt" is greater than the recorded date.

pushOrder

pushOrder allows you to upload one or more orders via a POST of data in JSON format.

POSThttps://api.qapla.it/1.3/pushOrder/

REQUEST
RESPONSE

{
  "apiKey": "[API_KEY]",
  "origin": "magento2",
  "pushOrder": [
    {
      "reference": "BAT-234241299",
      "orderID": 234241222,
      "courier": "GENERIC",
      "courierService": "P46",
      "status": "Processato",
      "createdAt": "2018-04-01 22:38:18",
      "updatedAt": "2018-04-01 22:40:41",
      "name": "Barbara Gordon",
      "street": "Via manin, 8",
      "city": "Vigonza",
      "state": "Padova",
      "postCode": "35010",
      "country": "IT",
      "email": "batgirl@qapla.it",
      "telephone": "3473425220",
      "amount": 109.25,
      "shippingCost": 9.35,
      "currencyCode": "EUR",
      "payment": "pp_hosted",
      "isCOD": false,
      "notes": "Consegnare solo se in costume",
      "parcels": [{
        "width": 20,
        "height": 7,
        "weight": 1.5,
        "length": 12,
        "boxCode": null,
        "content": null,
        "originCountry": null
      }, {
        "width": 22,
        "height": 10,
        "weight": 1.1,
        "length": 35,
        "boxCode": null,
        "content": null,
        "originCountry": null
      }],
      "isReturnable": true,
      "shippingCODPaymentOption": "",
      "shippingInsurance": "300.99",
      "shippingDeliveryOptions": "A,P",
      "shippingRequiredDeliveryDate": "2020-09-01",
      "latestShipDate": "2018-04-03",
      "latestDeliveryDate": "2018-04-05",
      "pickUpDate": "2020-08-30",
      "custom1": "custom value 1",
      "custom2": "custom value 2",
      "custom3": "custom value 3",
      "pickupPoint": "0201",
      "content": "The goods",
      "rows": [
        {
          "sku": "BAR-301",
          "name": "Barrette di Crusca d'Avena con Cioccolato (4 pezzi) 120g",
          "qty": 1,
          "weight": 1.5,
          "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
          "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
          "price": 6.35,
          "total": 6.35,
          "isReturnable": true,
          "notes": "this is a product note",
          "customsCode": null,
          "originCountry": null,
          "netWeight": null,
          "unitOfMeasurement": null,
          "parcelID": null,
          "transparencyCodes": [
            "ABC123",
            "DEF456"
          ]
        },
        {
          "sku": "BEV-001",
          "name": "Bevanda al mango in polvere 9g",
          "qty": 5,
          "weight": 1,
          "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
          "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
          "price": 0.38,
          "total": 1.9,
          "isReturnable": true,
          "customsCode": null,
          "originCountry": null,
          "netWeight": null,
          "unitOfMeasurement": null,
          "parcelID": null
        }
      ],
      "sender": {
        "code": "FEDO",
        "businessName": "fedò snc",
        "street": "Via I Maggio, 11",
        "city": "Vedano Olona",
        "state": "VA",
        "postCode": "21040",
        "country ": "IT",
        "email": "evelina@fedo.it",
        "telephone": "0332261261",
        "referent": "Evelina",
        "isDefault": false
      },
      "PUDO": {
        "id": "1234",
        "type": "LOCKER",
        "name": "Bar Mario snc",
        "address": "Via mario rossi",
        "city": "Varese",
        "state": "VA",
        "country": "IT",
        "postalCode": "21100",
        "description": "Note"
      },
      "invoice": {
        "number": "A00012345/2022",
        "date": "2022-11-01"
      },
      "goodsCode": "CODE123"
    }
  ]
}

Parameters

^*Mandatory parameter

⚠
The maximum number of orders that can be sent for each individual request is 100.

apiKey^*(string) The API Key assigned to the channel we want to query

origin(string)

Origin of order, permitted values:

    ahlens, aliexpress, allegro, alltricks, amazon, animalis, anthropologie, asos, atlasformen, auchan, bandq, beerwulf, bestsecret,
    bhv, bigcommerce, bild, blackredwhite, blokker, boots, brandalley, bricobravo, bricodepot, bricomarche, bricoprive, bulevip, but, carrefour_es,
    carrefour_fr, casadellibro, castorama, cdiscount, commercelayer, conforama, creavea, cultura, darty, debenhams, decathlon, douglas, ebay, ecwid,
    elcorteingles, elkjop, ellos, empik, eprice, etsy, fanatics, feelunique, fnac, fonq, freepeople, fressnapf, gifi, greenweez_fr, handm, home24, ibs,
    incomedia, lafayette, laredoute, leroyMerlin_it, magento, magento2, maisonDuMonde_es, maisonDuMonde_it, manomano, manomano_de, manomano_es, manomano_fr,
    manomano_gb, manomano_it, matalan, mathon, maty, maykers, mediaMarkt_at, mediaMarkt_de, mediaMarkt_es, mediaMarkt_it, mediaMarkt_nl, miravia_es, modivo_pl,
    mountainwh, natureetdeco, newcart, nocibe, obelink, pandacola, pccomponentes, perfumesclub, phonehouse, pixmania, placedestend, planetahuerto, pourdebon,
    prestashop, printemps, privalia, privalia_es, privalia_it, privsportshop, public, quirumed, redcarepharmacy, rueducommerce, sarenza, shopapotheke, shopify,
    shopware6, showroomprive, slood, spartoo, spartoo_be, spartoo_bg, spartoo_cn, spartoo_com, spartoo_comhr, spartoo_couk, spartoo_cz, spartoo_de, spartoo_dk,
    spartoo_es, spartoo_fi, spartoo_fr, spartoo_gb, spartoo_gr, spartoo_hu, spartoo_it, spartoo_nl, spartoo_pl, spartoo_pt, spartoo_ro, spartoo_se, spartoo_si, spartoo_sk, sprinter_es,
    stadium, storeden¤, superdrug, teamsystemcommerce¤tiendanimal, tradeinn, truffaut, twil, ubaldi, urbanoutfitters, venca, venteunique, vivino, vtex, watchfinder,
    winesitting, woocommerce, wook, worten_es, worten_pt, yoox

^¤storeden and teamsystemcommerce can be used as synonyms

pushOrder(array)

It is an array of maximum 100 orders to load.

reference^*(string) Order alphanumeric reference

orderID(int) Possible order numeric reference

courier^*(string) The Qapla' courier code. If the courier is not associated with the channel or does not generate shipments, it will be evaluated with 0.

courierService(string) Possible kind of courier service; for example it can be the contract code of GLS Italy. If the field is empty or not sent, the default is '0'.

status(string) Order status (processing, complete, ecc)

createdAt^*(YYYY-MM-DD HH:MM:S) Order creation date

updatedAt^*(YYYY-MM-DD HH:MM:SS) Order update date
Attention
This date is used to determine whether to update the order on Qapla'

name^*(string) Recipient name

street^*(string) Recipient address

city^*(string) Recipient city

state^*(string) Recipient province

postCode^*(string) Recipient postal code

country^*(string) Recipient country in formatISO 3166-1 alpha-2 (Example: IT)

email(string) Recipient email

telephone(string) Recipient telephone

amount(float) Shipment amount.
Specify only one separator (the dot) to indicate decimals, and do not use separators to indicate thousands. Give a maximum of two decimal digits. Example: 2340.23

shippingCost(float) Shipping Cost.
Specify only one separator (the dot) to indicate decimals, and do not use separators to indicate thousands. Give a maximum of two decimal digits. Example: 9.35

currencyCode(string) Currency code ISO 4217 (default: EUR)

payment Type of payment

isCOD(boolean) It is true if payment is cash on delivery

notes(string) Any order note

weight(float) Potential weight of the order

parcels(int)

Possible parcels of the delivery. Each shipment can be defined through an object composed as follows:

weight(float)	Potential weight of the order. Mandatory if the "boxCode" is not sent
length(float)	Potential measurements: length. Mandatory if the "boxCode" is not sent
width(float)	Potential measurements: width. Mandatory if the "boxCode" is not sent
height(float)	Potential measurements: height. Mandatory if the "boxCode" is not sent
boxCode(string)	Potential box code (if used, measurements will be taken from the box with the corresponding code)
originCountry(string)	Potential Country of origin of the package in ISO 3166-1 alpha-2 format (Example: IT)
content(string)	Potential description of the content

length(float) Potential measures: length

width(float) Potential measures: depth

height(float) Potential measures: height

isReturnable(bool) If it is true, it indicates the possibility of returning the entire order.

shippingCODPaymentOption(string) Payment method of cash on delivery if different from default settings (to be agreed)

shippingInsurance(float | string)

General
GLS-ITA
SDA
CRONO-PTI

Potential insured amount

ALL-IN: insert into "shippingDeliveryOptions" the following string: ALLIN

To generate directly with SDA, the value must be passed in the form of a string, specifying one of the following codes:

Code	Insurance type
	If no parameters are specified, no insurance type will be applied
AS01	UP TO EURO 258,23
AS02	UP TO EURO 516,46
AS03	UP TO EURO 1.549,37
AS04	UP TO EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE UP TO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX

To generate directly with CRONO PTI, the value must be passed in the form of a string, specifying one of the following codes:

Code	Insurance type
	If no parameters are specified, no insurance type will be applied
AS01	UP TO EURO 258,23
AS02	UP TO EURO 516,46
AS03	UP TO EURO 1.549,37
AS04	UP TO EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE UP TO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX
AS14	ASSICURATA CRONO INTERNAZIONALE

shippingDeliveryOptions(string | JSON)

General
PTI
BRT

If two values are to be used, they must be separated by commas
Example: A,P or 22,07

For PTI courier you need to use a JSON structured as follows

If two values are to be used, they must be separated by commas
Example: A,P or A,FRESH_YYYY-MM-DD

Nel caso di servizio fresh la data è opzionale:
Example: FRESH_YYYY-MM-DD, FRESH
Fresh with a date: The expiry date will be the one set
Fresh without a date: The expiry date will be equal to the label's creation date plus the eventual days set in the channel's configuration or, if none have been entered, 5 days.

Note: The courier does not accept dates less than the label's creation date plus 5 days.

shippingRequiredDeliveryDate(YYYY-MM-DD) The delivery request date in the format YYYY-MM-DD

latestShipDate(string) To be shipped by this date in the YYYY-MM-DD format

latestDeliveryDate(string) To be delivered by this date in the YYYY-MM-DD format

pickUpDate(YYYY-MM-DD) The collection date requested to the courier in format YYYY-MM-DD

custom1,1,3(string) Potential custom fields

pickupPoint(string) Possible code of a pickup point

content(string) The content of the goods that may be present on the label (depends on the courier)

rows(array)

It is an array of "order rows".

It is not mandatory, but if populated it has some mandatory data.

sku^*(string)

Article code

name^*(string)

Article description

qty^*(int)

Quantity

price^*(float)

Price

total(float)

Total price

weight(float)

Potential article weight

url(string)

The specific url of the product

imageUrl(string)

The url of the product image

notes(string)

Product notes

customsCode(string)

Potential code used for customs (HSCode, Taric, etc.)

originCountry(string)

Product's country of origin ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Potential net weight of the product

unitOfMeasurement(string)

Generale
DHL

Potential unit of measurement

Code	Description
BOX	Boxes
2GM	Centimeters
2M3	Cubic Centimeters
3M3	Cubic Feet
M3	Cubic Meters
DPR	Dozen Pairs
DOZ	Dozen
2NO	Each
PCS	Pieces
GM	Grams
GRS	Gross
KG	Kilograms
L	Liters
M	Meters
3GM	Milligrams
3L	Milliliters
X	No Unit Required
NO	Number
2KG	Ounces
PRS	Pairs
2L	Gallons
3KG	Pounds
CM2	Square Centimeters
2M2	Square Feet
3M2	Square Inches
M2	Square Meters
4M2	Square Yards
3M	Yards
CM	Centimeters
CONE	Cone
CT	Carat
EA	Each
LBS	Pounds
RILL	Rill
ROLL	Roll
SET	Set
TU	Time Unit
YDS	Yard

parcelID(int)

Potential progressive number, identifying the package number in which the product is shipped

transparencyCodes(string[])

Transparency Code array

assemblyTypes(array)

Possible list of assembly types, one per product, for couriers who support this information

General
FERCAM

code^*(string)	The code of the selected type of assembly

Available for the "courierService" 20 (HD). One element must be specified for each element of rows.

Available values for "code":

Code	Description
5	Appliance Activation
09	Built-in ovens/cookers with declaration of conformity
08	Built-in refrigerators
07	Built-in dishwashers and washing machines
11	DUAL Air Conditioning Installation with piping to be prepared
14	DUAL Air Conditioning Installation with pre-prepared piping
10	MONO Air Conditioning Installation with piping to be prepared
13	MONO Air Conditioning Installation with pre-prepared piping
12	TRIAL Air Conditioning Installation with piping to be prepared
15	TRIAL Air Conditioning Installation with pre-prepared piping
K	Basic HD Installation
Z	Complex HD Installation
Y	Medium HD Installation
W	Simple HD Installation
06	Wall-mounted TV Installation
20	Assembly of 30
17	Exercise Bike Assembly
18	Elliptical Assembly
4	Multifunctional Structure Assembly
16	Treadmill Assembly
1	Assembly of Treadmill, Exercise Bike, and Elliptical
2	Ping Pong Table Assembly
3	Rowing Machine Assembly

sender

It is the sender of the shipment if different from the contract holder.

code(string)	The code to assign to the sender for a better identification
businessName(string)	Business name
street(string)	Address
city(string)	City
state(string)	Province
postCode(string)	Postal code
country(string)	Country in format ISO 3166-1 alpha-2 (Example: IT)
email(string)	Sender email
telephone(string)	Sender telephone
referent(string)	Contact person of the sender
isDefault(bool)	It is true if the sender will be saved as default for all other shipments

PUDO(object)

Allows you to set a Pick-up or Drop-off point for the collection of goods. Each field must be completed according to the courier's need. Refer to the tables below

id^*(string)	PUDO identification
type(string)	Type of Service
name(string)	Service Name
address(string)	Address of the Pick-up or Drop-off point
city(string)	City of the Pick-up or Drop-off point
state(string)	Province of the Pick-up or Drop-off point
country(string)	Country of the Pick-up or Drop-off point
postalCode(string)	Postal code of the Pick-up or Drop-off point
description(string)	Description
harmonisedId(string)	Additional numeric ID of the Pick-up o Drop-off, derived from getPudos. Es. 104
keyword(string)	Keyword of the Pick-up o Drop-off, derived from getPudos. Es 'DHL Servicepoint'
psfKey(string)	PsfKey of the Pick-up o Drop-off, derived from getPudos. Es 'ES-0004240'
postnumber(string)	Postnumber of the Pick-up o Drop-off, only if 'packstation' type. It is a code that the end customer personally owns

**DHL / BRT / INPOST / FEDEX / MRW / SENDING**
Attribute	Value
id^*(string)	PUDO identification

**TNT ITA / GLS-ITA**
Attribute	Value
id^*(string)	Possible values: TNT: identification code of TNT point/Locker; GLS-IT: identification code called SHOP_ID;
type^*(string)	Possible values: TNT: 3 (TNT point) o 5 (TNT Locker); GLS-IT: identification code called PARTNER_SHOP_ID;

**PTI(Poste Italiane)**
Attribute	Value
id^*(string)	PUDO identification
type^*(string)	Possible values: `ConsegnaPuntoPoste` `ConsegnaUfficioPostale` `ConsegnaLocker` `ConsegnaPUDOUPS`
name^*(string)	Name of the Pick-up Point
address^*(string)	Address of the Pick-up Point
postalCode^*(string)	Postal Code of the Pick-up Point
city^*(string)	City/Location of the Pick-up Point
province^*(string)	Province of the Pick-up Point
country^*(string)	Country of the Pick-up Point

**UPS**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
name^*(string)	Name
postalCode^*(string)	Postal Code
state^*(string)	State

**SDA**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
name^*(string)	Name
postalCode^*(string)	Postal code
state^*(string)	State

**DHL-PAKET**
Attribute	Value
id^*(string)	PUDO identification
type^*(string)	Type of PUDO ("locker" or "postoffice")
city^*(string)	City
name^*(string)	Name of PUDO
country^*(string)	Country
postalCode^*(string)	Postal code
postnumber(string)	PostNumber. Mandatory for "postoffice"

**DHLPARCEL-ES**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal code
harmonisedId^*(string)	Harmonized Id
keyword^*(string)	Keyword
psfKey^*(string)	PsfKey
postnumber(string)	PostNumber

**CORREOS-EXPRESS**
Attribute	Value
id^*(string)	PUDO identifier
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal Code

**GLS-SPAIN**
Attribute	Value
id^*(string)	PUDO identification
name^*(string)	PUDO name
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal code

**SEUR**
Attribute	Value
id^*(string)	PUDO identification

**TIPSA**
Attribute	Value
id^*(string)	PUDO identifier
address^*(string)	Address
city^*(string)	City
name^*(string)	PUDO name
postalCode^*(string)	Postal Code

invoice(object)

It allows you to set information regarding the invoice associated with the shipment, useful for shipments that have to go through customs.
Mandatory for DHL

number^*(string)	Invoice number
date(string)	Invoice date (Use YYYY-MM-DD format)

goodsCode(string)

General
FERCAM

Eventual goods code

Specific codes to link different tariffs related to the type of goods (to be agreed with FERCAM).

Code	Value
	If no parameters are specified, no goods code will be applied.
BANC	Using pallet price list.

Response Body`200`

Description

version(string)

The number version of this API

result(string)

It is "OK" if the transmission was successful, "KO" in case of an error

error(string)

Possible error message in case of "KO" result

count(int)

Number of orders sent in the request

orders(array)

It is an array that corresponds to the number of orders sent in the request.

row(int)	Number of row
reference(string)	The order reference sent in the request
orderID(int)	Possible order numeric ID sent in the request
action(string)	It includes the following values: imp: imported order upd: updated order del: deleted order skp: no action taken ext: order already existing err: report an error
error(string)	Possible error on loading of this order

imported(int)

Counter of imported orders

updated(int)

Counter of updated orders

deleted(int)

Counter of deleted orders

skipped(int)

Counter of skipped orders

existing(int)

Counter of existing orders

Errors

The error message is reported in the "error" field.

getOrder

getOrder allows you to recover an order.

GEThttps://api.qapla.it/1.3/getOrder/?apiKey=[API_KEY]&reference=[ORDER_REFERENCE]

REQUEST
RESPONSE

Parameters

^* Mandatory parameter

^° At least one of the parameters is mandatory

Parameter

Description

apiKey^*(string)

The API Key assigned to the channel we want to query

reference^°(string)

The order reference

reference^°(string)

Alternative order reference

data

The flag data specifies which and how much data we want to receive, by default it returns minimal data on the progress of the shipment.
It can have the following values:

Parameter	Description
	If no parameter is specified, it will be returned the minimum data
all	Minimum data + all the data to follow
deliveryInfo	Minimum data + information on shipping methods (ship by, delivery by)

Response Body`200`

{
  "getOrder": {
    "result": "OK",
    "error": null,
    "version": "1.3.1",
    "count": 1,
    "orders": [
      {
        "reference": "BAT-234241299",
        "orderID": 234241222,
        "status": "Processato",
        "dateIns": "2023-10-23 15:48:27",
        "createdAt": "2018-04-01 22:38:18",
        "updatedAt": "2018-04-01 22:40:41",
        "isActive": true,
        "isDeleted": false,
        "isShipped": false,
        "origin": {
          "code": "magento2",
          "name": "Magento2",
          "icon": "https://cdn.qapla.it/origin/magento2.svg"
        },
        "courier": {
          "code": "GENERIC",
          "name": "[Generic Courier]",
          "icon": "https://cdn.qapla.it/courier/GENERIC.svg",
          "courierService": ""
        },
        "consignee": {
          "name": "Barbara Gordon",
          "address": "Via manin, 8",
          "city": "Vigonza",
          "state": "PD",
          "postCode": "35010",
          "country": "IT",
          "email": "batgirl@qapla.it",
          "phone": "3473425220"
        },
        "amount": 109.25,
        "payment": "pp_hosted",
        "isCOD": false,
        "notes": "Consegnare solo se in costume",
        "parcels": [
          {
            "width": 20,
            "height": 7,
            "length": 12,
            "weight": 1.5,
            "boxCode": null,
            "content": null,
            "originCountry": null
          },
          {
            "width": 22,
            "height": 10,
            "length": 35,
            "weight": 1.1,
            "boxCode": null,
            "content": null,
            "originCountry": null
          }
        ],
        "custom1": "custom value 1",
        "custom2": "custom value 2",
        "custom3": "custom value 3",
        "content": "The goods",
        "latestShipDate": "2018-04-03",
        "latestDeliveryDate": "2018-04-05",
        "rows": [
          {
            "sku": "BAR-301",
            "name": "Barrette di Crusca d'Avena con Cioccolato (4 pezzi) 120g",
            "qty": "1",
            "price": "6.35",
            "total": "6.35",
            "customsCode": null,
            "originCountry": null,
            "netWeight": null,
            "unitOfMeasurement": null,
            "parcelID": null
          },
          {
            "sku": "BEV-001",
            "name": "Bevanda al mango in polvere 9g",
            "qty": "5",
            "price": "0.38",
            "total": "1.9",
            "customsCode": null,
            "originCountry": null,
            "netWeight": null,
            "unitOfMeasurement": null,
            "parcelID": null
          }
        ],
        "PUDO": {
          "id": "1234",
          "courierID": 0,
          "type": "LOCKER",
          "name": "Bar Mario snc",
          "address": "Via mario rossi",
          "city": "Varese",
          "state": "VA",
          "country": "IT",
          "postalCode": "21100",
          "description": "Note",
          "psfKey": null,
          "keyword": null,
          "postnumber": null,
          "harmonisedId": null
        }
      }
    ]
  }
}

getOrders

getOrders allows you to receive the list of orders imported from Qapla'.

GEThttps://api.qapla.it/1.2/getOrders/?apiKey=[API_KEY]&[DATE]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
[DATE]
updatedAt	Order update date in format ISO 8601 "YYYY-MM-DD"
createdAt	Order date in format ISO 8601 "YYYY-MM-DD"
dateIns	Upload date in format ISO 8601 "YYYY-MM-DD"
dateFrom / dateTo	Date range for the value "updatedAt" in format ISO 8601 "yyyy-mm-dd hh:mm:ss"

If no [DATE] parameter is transferred the default is dateFrom = 1 hour ago at 00.

Response Body`200`

deleteOrder

deleteOrder allows you to delete an order.

DELETEhttps://api.qapla.it/1.2/deleteOrder/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
reference^*(string)	The order reference

Response Body`200`

updateOrder

updateOrder is replaced by the pushOrder setting and the updatedAt parameter is used to determine whether the order should be updated.

updatedAt^*(YYYY-MM-DD HH:MM:SS)	Order update date Attention This date is used to determine whether to update the order on Qapla', or if the order has already been imported from Qapla'. A more recent value in this field will cause Qapla' to treat it as an "updated order" and then update all previously imported data.

undeleteOrder

undeleteOrder allows you to restore a deleted order.

PATCHhttps://api.qapla.it/1.2/undeleteOrder/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
reference^*(string)	The order reference

Response Body`200`

detectOrderCourier

Attention

This API is currently being tested. Ask for activation to Customer Care.

detectOrderCourier allows you to get the courier to assign to the order, following preset rules (settings to be configured on the Control Panel).

Useful before of a createLabel to identify in advance the courier to use.

It is based on 3 rules to identify the courier according to weight, any cash on delivery amount and the destination zip code.

If you have clear rules such as the following:

weight	COD	CAP
less than or equal to 3Kg			GLS
greater than 3 Kg	less than 100 €		BRT
greater than 3 Kg	greater than 100 €	less than 70000 (north)	GLS
greater than 3 Kg	greater than 100 €	greater than 70000 (south)	BRT

it is possible to predetermine and pre-assign the courier to the order before the label is created, for example with the createLabel.

POSThttps://api.qapla.it/1.2/detectOrderCourier/

REQUEST
RESPONSE

Request

Parameters

^*Mandatory Parameter

Parameter	Description
apiKey^*(string)	The channel's API Key
country^*(string)	Recipient country in format ISO 3166-1 alpha-2 (Example: IT)
weight^*(float)	Potential weight of the order
cod(float)	Amount of the shipment, if the shipment is cash on delivery
postCode(string)	Recipient postal code

Response Body`200`

Parameter	Description
courier(json)	Contains id, code and name of the identified courier
rule(json)	Contains id, and name of the identified rule
request(json)	The parameters of the request

Errors

In case of error the "result" field will contain "KO" and the "error" field the description of the error.

Platforms

A series of tools to communicate directly with your platform / marketplace already configured on the channel, without going through Qapla'

fetchPlatformOrders

fetchPlatformOrders allows you to receive the list of orders on a platform.

GEThttps://api.qapla.it/1.2/fetchPlatformOrders/?apiKey=[API_KEY]&platform=[PLATFORM]&orderFormat=[ORDERFORMAT]&skip

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
platform(string)	The associated platform. If it is not indicated, the platform (CMS) associated with the channel is considered. If no platform is associated with the channel, the parameter becomes mandatory to indicate a marketplace. Possible values: amazon, carrefour, cdiscount, ebay, ecwid, eprice, ibs, magento, magento2, manomano, prestashop, privalia, shopify, spartoo, storeden^¤, teamsystemcommerce^¤, vtex, woocommerce, worten, leroymerlin, greenweez, maisondumonde, mediamarkt, bigcommerce, commercelayer, shopware6, aliexpress, allegro, sprinter, decathlon, bricobravo, miravia_es ^¤storeden and teamsystemcommerce can be used as synonyms
dateFrom / dateTo(timestamp)	Date range for the value "updatedAt" in format ISO 8601 "yyyy-mm-dd hh:mm:ss"
orderFormat(string)	If the value (platform) is passed, orders will be returned in original format. If no value is passed, the results will be returned in standard format (qapla).
skip(string)	Skip order statuses.

Response Body`200`

{
                "fetchPlatformOrders": {
                "version": "1.2.34",
                "result": "OK",
                "error": null,
                "platform": "ibs",
                "dateFrom": "2020-10-27 11:00:00",
                "dateTo": "2020-10-27 23:59:59",
                "format": "qapla",
                "count": 14,
                "orders": [
                {
                "source": "ibs",
                "reference": "44725530-A",
                "orderID": null,
                "courier": 0,
                "status": "SHIPPING",
                "createdAt": "2020-10-27 12:11:26",
                "updatedAt": "2020-10-27 12:45:13",
                "name": "Marty McFly",
                "address": "Via Sciesa, 10",
                "city": "Vedano Olona",
                "state": "VA",
                "postCode": "21040",
                "country": "IT",
                "email": null,
                "telephone": "3211234567",
                "amount": "EUR 15.1",
                "payment": "CC",
                "isCOD": false,
                "notes": null,
                "weight": null,
                "content": null,
                "rows": [
                {
                "sku": "IBSMP1234567",
                "name": "Ritorno al futuro",
                "qty": 1,
                "price": 10.2,
                "total": 15.1,
                "url": null,
                "imgUrl": null,
                "weight": null
                }
                ]
                }
                ]
                }
                }

Errors

In case of an error the "result" field will contain "KO" and the "error" field the description of the error.

{
"fetchPlatformOrders": {
    "result": "KO",
    "error": "[ERROR_MESSAGE]"
}
}

updatePlatformOrder

updatePlatformOrder allows you to update orders on a platform.

PUThttps://api.qapla.it/1.2/updatePlatformOrder/

REQUEST
RESPONSE

Authentication

Authentication takes place via the APIKey of the channel, passing Q-API-Key in the request header

Parameter	Description
Q-API-Key^*(string)	The channel's API Key

Parameters

Parameter	Description
platform^*(string)	The associated platform, for example a marketplace. Allowed values: magento, magento2, prestashop, shopify, woocommerce, amazon, ibs, manomano, spartoo, carrefour, leroymerlin, greenweez, maisondumonde, mediamarkt, bigcommerce, commercelayer, cdiscount, ecwid, shopware6, storeden^¤, teamsystemcommerce^¤, vtex, aliexpress, allegro, ebay, eprice, privalia, sprinter, worten, decathlon, bricobravo, miravia_es ^¤storeden and teamsystemcommerce can be used as synonyms
reference(string)	Order alphanumeric reference. To be entered, if required, based on the specific platform used.
orderID(int)	Order numeric reference. To be entered, if required, based on the specific platform used.
courier^*(string)	The Qapla' courier code
trackingNumber^*(string)	The tracking number of the order to be updated
setShipped(bool)	It is true if shipment is set. To be used according to the peculiarities of the platform used.
setDelivered(bool)	It is true if delivery is set. To be used according to the peculiarities of the platform used.
storeCountry(string)	The country code in ISO 2 format of the marketplace. (if requested)
trackingUrl(string)	An URL to view tracking information

Peculiarities

Miravia

Either setShipped or setDelivered is required.

The update request with setShipped and trackingNumber must be repeated twice with at least a 1-hour interval due to marketplace policy that requires a 1-hour interval between the Ready To Ship and Shipped statuses.

The update request with setDelivered must be made only once at least 12 hours after the second request with setShipped due to marketplace policy that requires a 12-hour interval between the Shipped and Delivered statuses.

Response Body`200`

Labels

createLabel

createLabel allows you to create a label in PDF or ZPL format (Settings should be configured on the control panel).

Attention

Ask for activation to Customer Care.

POSThttps://api.qapla.it/1.3/createLabel/

REQUEST
RESPONSE

Test

It is possible to obtain a test "dummy label" using the courier with GENERIC code.

Request

{
  "apiKey": "[API_KEY]",
  "sandbox": true,
  "createLabel": {
    "origin": "magento",
    "reference": "BAT-234241299",
    "orderID": 123213,
    "courier": "CRONO-PTI",
    "courierService": "P46",
    "name": "Barbara Gordon",
    "address": "Via manin, 8",
    "city": "Vigonza",
    "state": "PD",
    "postCode": "35010",
    "country": "IT",
    "email": "batgirl@yahoo.it",
    "telephone": "3473425220",
    "isCOD": false,
    "payment": "Foo",
    "amount": 109.25,
    "shippingCost": 9.35,
    "currencyCode": "EUR",
    "notes": "Consegnare solo se in costume nero",
    "parcels": [{
      "weight": 1.3,
      "length": 10,
      "width": 15,
      "height": 5,
      "boxCode": null,
      "content": null,
      "originCountry": null
    }],
    "shippingCODPaymentOption": "",
    "shippingInsurance": 300.99,
    "shippingDeliveryOptions": "A,P",
    "shippingRequiredDeliveryDate": "YYYY-MM-DD",
    "pickupDate": "YYYY-MM-DD",
    "gSpedPrinterID": 22,
    "content": "The goods",
    "custom1": "Custom 1",
    "custom2": "Custom 2",
    "custom3": "Custom 3",
    "sender": {
      "code": "FEDO",
      "businessName": "fedò snc",
      "street": "Via I Maggio, 11",
      "city": "Vedano Olona",
      "state": "VA",
      "postCode": "21040",
      "country ": "IT",
      "email": "evelina@fedo.it",
      "telephone": "0332261261",
      "referent": "Evelina",
      "isDefault": false
    },
    "tradeDocuments": [
      {
        "type": "CERTIFICATE_OF_ORIGIN",
        "name": "FILENAME.PDF",
        "content": "BASE64PDF"
      },
      {
        "type": "OTHER",
        "name": "FILENAME2.PDF",
        "content": "BASE64PDF"
      },
      {
        "type": "CERTIFICATE_OF_ORIGIN",
        "name": "FILENAME3.PDF",
        "content": "BASE64PDF"
      }
    ],
    "rows": [
      {
        "sku": "BAR-301",
        "name": "Barrette di Crusca d'Avena con Cioccolato (4 pezzi) 120g",
        "qty": 1,
        "weight": 1.5,
        "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
        "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
        "price": 6.35,
        "total": 6.35,
        "isReturnable": true,
        "notes": "this is a product note",
        "customsCode": "HSCode12345",
        "netWeight": "1",
        "originCountry": "IT",
        "unitOfMeasurement": null,
        "parcelID": 1,
        "transparencyCodes": [
          "ABC123",
          "DEF456"
        ]
      },
      {
        "sku": "BEV-001",
        "name": "Bevanda al mango in polvere 9g",
        "qty": 5,
        "weight": 1,
        "url": "https://www.iltuosito.it/alimenti/barretta-al-cocco",
        "imageUrl": "https://www.iltuosito.it/img/alimenti/barretta-al-cocco.jpg",
        "price": 0.38,
        "total": 1.9,
        "isReturnable": true,
        "customsCode": "HSCode12345",
        "netWeight": "1",
        "originCountry": "IT",
        "unitOfMeasurement": null,
        "parcelID": 1
      }
    ],
    "PUDO": {
      "id": "1234",
      "type": "LOCKER",
      "name": "Bar Mario snc",
      "address": "Via mario rossi",
      "city": "Varese",
      "state": "VA",
      "country": "IT",
      "postalCode": "21100",
      "description": "Note"
    },
    "invoice":{
      "number": "A00012345/2022",
      "date": "2022-11-01"
    },
    "dangerousGoods": [
        {
           "parcel":"1",
           "type":"battery",
           "batteryPackingType":"CONTAINED_IN_EQUIPMENT",
           "batteryMaterialType":"LITHIUM_METAL"
        }
     ],
    "goodsCode": "CODE123"
  }
}

Parameters

^*Mandatory Parameters

Parameter Description

apiKey^*(string) The channel's API Key

sandbox(boolean) It is true if using the sandbox (test mode)
Attention: this parameter works if the courier has already been set correctly on the channel.
Contact Qaplà's Customer Care.

origin(string)

Shipment origin, permitted values:

    ahlens, aliexpress, allegro, alltricks, amazon, animalis, anthropologie, asos, atlasformen, auchan, bandq, beerwulf, bestsecret,
    bhv, bigcommerce, bild, blackredwhite, blokker, boots, brandalley, bricobravo, bricodepot, bricomarche, bricoprive, bulevip, but, carrefour_es,
    carrefour_fr, casadellibro, castorama, cdiscount, commercelayer, conforama, creavea, cultura, darty, debenhams, decathlon, douglas, ebay, ecwid,
    elcorteingles, elkjop, ellos, empik, eprice, etsy, fanatics, feelunique, fnac, fonq, freepeople, fressnapf, gifi, greenweez_fr, handm, home24, ibs,
    incomedia, lafayette, laredoute, leroyMerlin_it, magento, magento2, maisonDuMonde_es, maisonDuMonde_it, manomano, manomano_de, manomano_es, manomano_fr,
    manomano_gb, manomano_it, matalan, mathon, maty, maykers, mediaMarkt_at, mediaMarkt_de, mediaMarkt_es, mediaMarkt_it, mediaMarkt_nl, miravia_es, modivo_pl,
    mountainwh, natureetdeco, newcart, nocibe, obelink, pandacola, pccomponentes, perfumesclub, phonehouse, pixmania, placedestend, planetahuerto, pourdebon,
    prestashop, printemps, privalia, privalia_es, privalia_it, privsportshop, public, quirumed, redcarepharmacy, rueducommerce, sarenza, shopapotheke, shopify,
    shopware6, showroomprive, slood, spartoo, spartoo_be, spartoo_bg, spartoo_cn, spartoo_com, spartoo_comhr, spartoo_couk, spartoo_cz, spartoo_de, spartoo_dk,
    spartoo_es, spartoo_fi, spartoo_fr, spartoo_gb, spartoo_gr, spartoo_hu, spartoo_it, spartoo_nl, spartoo_pl, spartoo_pt, spartoo_ro, spartoo_se, spartoo_si, spartoo_sk, sprinter_es,
    stadium, storeden¤, superdrug, teamsystemcommerce¤tiendanimal, tradeinn, truffaut, twil, ubaldi, urbanoutfitters, venca, venteunique, vivino, vtex, watchfinder,
    winesitting, woocommerce, wook, worten_es, worten_pt, yoox

^¤storeden and teamsystemcommerce can be used as synonyms

reference^*(string) Order's alphanumeric reference

orderID(string) Possible order's numeric reference

courier^*(string) The Qapla' courier code

courierService^*(string) Possible kind of courier service; for example it can be the contract code of GLS Italy. If the field is empty or not sent, the default is '0'.

name^*(string) Recipient name

address^*(string) Recipient address

city^*(string) Recipient city

state^*(string) Recipient province

postCode^*(string) Recipient Postal Code

country^*(string) Recipient country in format ISO 3166-1 alpha-2 (I.E.: IT)

email(string) Recipient email

telephone(string) Recipient telephone

amount(float) Shipment amount.
Specify only one separator (the dot) to indicate decimals, and do not use separators to indicate thousands. Give a maximum of two decimal digits. Example: 2340.23

shippingCost(float) Shipping Cost.
Specify only one separator (the dot) to indicate decimals, and do not use separators to indicate thousands. Give a maximum of two decimal digits. Example: 9.35

currencyCode(string) Currency code ISO 4217 (default: EUR)

isCOD(boolean) It is true if payment is cash on delivery

payment(string) Possible order's payment method. Can be set to CONTRASSEGNO only if isCOD is also set to true

notes(string) Any order note

parcels(int|array)

Possible parcels of the delivery. Each shipment can be defined through an object composed as follows:

weight(float)	Potential weight of the order. Mandatory if the "boxCode" is not sent
length(float)	Potential measurements: length. Mandatory if the "boxCode" is not sent
width(float)	Potential measurements: width. Mandatory if the "boxCode" is not sent
height(float)	Potential measurements: height. Mandatory if the "boxCode" is not sent
boxCode(string)	Potential box code (if used, measurements will be taken from the box with the corresponding code)
originCountry(string)	Potential Country of origin of the package in ISO 3166-1 alpha-2 format (Example: IT)
content(string)	Potential description of the content

weight(float) Potential weight of the order (not available when "parcels" is an array)

length(float) Potential measures: length (not available when "parcels" is an array)

width(float) Potential measures: width (not available when "parcels" is an array)

height(float) Potential measures: height (not available when "parcels" is an array)

shippingCODPaymentOption(string) Payment method of cash on delivery if different from default settings (to be agreed)

shippingInsurance(float | string)

General
GLS-ITA
SDA
CRONO-PTI

Potential insured amount

ALL-IN: insert into "shippingDeliveryOptions" the following string: ALLIN

To generate directly with SDA, the value must be passed in the form of a string, specifying one of the following codes:

Code	Insurance type
	If no parameters are specified, no insurance type will be applied
AS01	UP TO EURO 258,23
AS02	UP TO EURO 516,46
AS03	UP TO EURO 1.549,37
AS04	UP TO EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE UP TO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX

To generate directly with CRONO PTI, the value must be passed in the form of a string, specifying one of the following codes:

Code	Insurance type
	If no parameters are specified, no insurance type will be applied
AS01	UP TO EURO 258,23
AS02	UP TO EURO 516,46
AS03	UP TO EURO 1.549,37
AS04	UP TO EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE UP TO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX
AS14	ASSICURATA CRONO INTERNAZIONALE

shippingDeliveryOptions(string | JSON)

General
PTI
BRT

If two values are to be used, they must be separated by commas
Example: A,P or 22,07

For PTI courier you need to use a JSON structured as follows

If two values are to be used, they must be separated by commas
Example: A,P or A,FRESH_YYYY-MM-DD

Nel caso di servizio fresh la data è opzionale:
Example: FRESH_YYYY-MM-DD, FRESH
Fresh with a date: The expiry date will be the one set
Fresh without a date: The expiry date will be equal to the label's creation date plus the eventual days set in the channel config.

Note: The courier does not accept dates less than the label's creation date plus 5 days, so if the previous calculations result in an earlier date, the expiry date will be equal to the fifth day after the creation date.

shippingRequiredDeliveryDate(YYYY-MM-DD) The delivery request date in the format YYYY-MM-DD

latestShipDate(string) To be shipped by this date in the YYYY-MM-DD format

latestDeliveryDate(string) To be delivered by this date in the YYYY-MM-DD format

pickupDate(YYYY-MM-DD) The collection date requested to the courier in format YYYY-MM-DD

For the SDA courier, if this field is not specified when creating the label, during the transmission of the label it will be automatically assigned the working day following that of transmission.

gSpedPrinterID(int) Possible printer id (user_id) for the Gsped Labeling Machine (to be agreed)

printNodePrinterID(int | string) Possible id or name of the printer to be used with PrintNode (to be agreed)

forceReprint(int) If set to 1, it forces the label to be printed again via PrintNode; valid when used with "printNodePrinterID"

content(string) The content of the goods that may be present on the label (depends on the courier)

custom1(string) A custom field

custom2(string) A custom field

custom3(string) A custom field

sender

It is the sender of the shipment if different from the contract holder.

code(string)	The code to assign to the sender for a better identification
businessName(string)	Business name
street(string)	Address
city(string)	City
state(string)	Province
postCode(string)	Postal code
country(string)	Country in format ISO 3166-1 alpha-2 (Example: IT)
email(string)	Sender email
telephone(string)	Sender telephone
referent(string)	Contact person of the sender
isDefault(bool)	It is true if the sender will be saved as default for all other shipments

tradeDocuments

Electronic documents to be sent to the courier. You can upload more than one file per shipment. The maximum size of each file is 5 MB.

For the moment only available for DHL, FedEx and UPS couriers.

Passed as an array of objects, with three mandatory elements each:

type(string)	The type of the file, which varies according to the courier (see table)
name(string)	The name of the file
content(string)	File content in base64 encoding

	FEDEX	DHL	UPS
AUTHORIZATION_FORM		✓	✓
CERTIFICATE_OF_ORIGIN	✓	✓	✓
COMMERCIAL_INVOICE	✓	✓	✓
DECLARATION		✓	✓
EXPORT_ACCOMPANYING_DOCUMENT		✓	✓
EXPORT_LICENSE		✓	✓
IMPORT_PERMIT		✓	✓
NAFTA_CERTIFICATE_OF_ORIGIN	✓	✓
ONE_TIME_NAFTA		✓	✓
OTHER	✓	✓	✓
OTHER_DOCUMENT		✓	✓
PACKING_LIST		✓	✓
POWER_OF_ATTORNEY		✓	✓
PRO_FORMA_INVOICE	✓	✓
SED_DOCUMENT		✓	✓
SHIPPER_LETTER_OF_INSTRUCTION		✓	✓

rows(array)

It is an array of "order rows".

It is not mandatory, but if populated it has some mandatory data.

sku^*(string)

Article code

name^*(string)

Article description

qty^*(int)

Quantity

price^*(float)

Price

total(float)

Total price

weight(float)

Potential article weight

url(string)

The specific url of the product

imageUrl(string)

The url of the product image

notes(string)

Product notes

customsCode(string)

Potential code used for customs (HSCode, Taric, etc.)

originCountry(string)

Product's country of origin ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Potential net weight of the product

unitOfMeasurement(string)

Generale
DHL

Potential unit of measurement

Code	Description
BOX	Boxes
2GM	Centimeters
2M3	Cubic Centimeters
3M3	Cubic Feet
M3	Cubic Meters
DPR	Dozen Pairs
DOZ	Dozen
2NO	Each
PCS	Pieces
GM	Grams
GRS	Gross
KG	Kilograms
L	Liters
M	Meters
3GM	Milligrams
3L	Milliliters
X	No Unit Required
NO	Number
2KG	Ounces
PRS	Pairs
2L	Gallons
3KG	Pounds
CM2	Square Centimeters
2M2	Square Feet
3M2	Square Inches
M2	Square Meters
4M2	Square Yards
3M	Yards
CM	Centimeters
CONE	Cone
CT	Carat
EA	Each
LBS	Pounds
RILL	Rill
ROLL	Roll
SET	Set
TU	Time Unit
YDS	Yard

parcelID(int)

Potential progressive number, identifying the package number in which the product is shipped

transparencyCodes(string[])

Transparency Code array

assemblyTypes(array)

Possible list of assembly types, one per product, for couriers who support this information

General
FERCAM

code^*(string)	The code of the selected type of assembly

Available for the "courierService" 20 (HD). One element must be specified for each element of rows.

Available values for "code":

Code	Description
5	Appliance Activation
09	Built-in ovens/cookers with declaration of conformity
08	Built-in refrigerators
07	Built-in dishwashers and washing machines
11	DUAL Air Conditioning Installation with piping to be prepared
14	DUAL Air Conditioning Installation with pre-prepared piping
10	MONO Air Conditioning Installation with piping to be prepared
13	MONO Air Conditioning Installation with pre-prepared piping
12	TRIAL Air Conditioning Installation with piping to be prepared
15	TRIAL Air Conditioning Installation with pre-prepared piping
K	Basic HD Installation
Z	Complex HD Installation
Y	Medium HD Installation
W	Simple HD Installation
06	Wall-mounted TV Installation
20	Assembly of 30
17	Exercise Bike Assembly
18	Elliptical Assembly
4	Multifunctional Structure Assembly
16	Treadmill Assembly
1	Assembly of Treadmill, Exercise Bike, and Elliptical
2	Ping Pong Table Assembly
3	Rowing Machine Assembly

PUDO(object)

Allows you to set a Pick-up or Drop-off point for the collection of goods. Each field must be completed according to the courier's need. Refer to the tables below

id^*(string)	PUDO identification
type(string)	Type of Service
name(string)	Service Name
address(string)	Address of the Pick-up or Drop-off point
city(string)	City of the Pick-up or Drop-off point
state(string)	Province of the Pick-up or Drop-off point
country(string)	Country of the Pick-up or Drop-off point
postalCode(string)	Postal code of the Pick-up or Drop-off point
description(string)	Description
harmonisedId(string)	Additional numeric ID of the Pick-up o Drop-off, derived from getPudos. Es. 104
keyword(string)	Keyword of the Pick-up o Drop-off, derived from getPudos. Es 'DHL Servicepoint'
psfKey(string)	PsfKey of the Pick-up o Drop-off, derived from getPudos. Es 'ES-0004240'
postnumber(string)	Postnumber of the Pick-up o Drop-off, only if 'packstation' type. It is a code that the end customer personally owns

**DHL / BRT / INPOST / FEDEX / MRW / SENDING**
Attribute	Value
id^*(string)	PUDO identification

**TNT ITA / GLS-ITA**
Attribute	Value
id^*(string)	Possible values: TNT: identification code of TNT point/Locker; GLS-IT: identification code called SHOP_ID;
type^*(string)	Possible values: TNT: 3 (TNT point) o 5 (TNT Locker); GLS-IT: identification code called PARTNER_SHOP_ID;

**PTI(Poste Italiane)**
Attribute	Value
id^*(string)	PUDO identification
type^*(string)	Possible values: `ConsegnaPuntoPoste` `ConsegnaUfficioPostale` `ConsegnaLocker` `ConsegnaPUDOUPS`
name^*(string)	Name of the Pick-up Point
address^*(string)	Address of the Pick-up Point
postalCode^*(string)	Postal Code of the Pick-up Point
city^*(string)	City/Location of the Pick-up Point
province^*(string)	Province of the Pick-up Point
country^*(string)	Country of the Pick-up Point

**UPS**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
name^*(string)	Name
postalCode^*(string)	Postal Code
state^*(string)	State

**SDA**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
name^*(string)	Name
postalCode^*(string)	Postal code
state^*(string)	State

**DHL-PAKET**
Attribute	Value
id^*(string)	PUDO identification
type^*(string)	Type of PUDO ("locker" or "postoffice")
city^*(string)	City
name^*(string)	Name of PUDO
country^*(string)	Country
postalCode^*(string)	Postal code
postnumber(string)	PostNumber. Mandatory for "postoffice"

**DHLPARCEL-ES**
Attribute	Value
id^*(string)	PUDO identification
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal code
harmonisedId^*(string)	Harmonized Id
keyword^*(string)	Keyword
psfKey^*(string)	PsfKey
postnumber(string)	PostNumber

**CORREOS-EXPRESS**
Attribute	Value
id^*(string)	PUDO identifier
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal Code

**GLS-SPAIN**
Attribute	Value
id^*(string)	PUDO identification
name^*(string)	PUDO name
address^*(string)	Address
city^*(string)	City
country^*(string)	Country
postalCode^*(string)	Postal code

**SEUR**
Attribute	Value
id^*(string)	PUDO identification

**TIPSA**
Attribute	Value
id^*(string)	PUDO identifier
address^*(string)	Address
city^*(string)	City
name^*(string)	PUDO name
postalCode^*(string)	Postal Code

invoice(object)

It allows you to set information regarding the invoice associated with the shipment, useful for shipments that have to go through customs.
Mandatory for DHL

number^*(string)	Invoice number
date(string)	Invoice date (Use YYYY-MM-DD format)

dangerousGoods(JSON)

FEDEX

For FEDEX courier you need to use a JSON structured as follows

parcel: represents the number of the parcels that contains the dangerous goods (in the example a shipment with 3 parcels and only the first and the third contain dangerous goods)

type: battery

batteryPackingType: It can take 2 values

CONTAINED_IN_EQUIPMENT
PACKED_WITH_EQUIPMENT

batteryMaterialType: It can take 2 values

LITHIUM_METAL
LITHIUM_ION

forceLabelsOutput(int)

If set to 1, the "createLabel" API will return the generated labels even when printed with PrintNode or GLM. Can only be used if "printNodePrinterID" or "gSpedPrinterID" are also set. Default value: 0

goodsCode(string)

General
FERCAM

Eventual goods code

Specific codes to link different tariffs related to the type of goods (to be agreed with FERCAM).

Code	Value
	If no parameters are specified, no goods code will be applied.
BANC	Using pallet price list.

Response Body`200`

Parameter	Description
isShipped(boolean)	It istrue if the order has alredy been labeled and returns the label alredy created.
id(int)	Shipment ID. Important to invoke other APIs.
trackingNumber(string)	Shipment tracking number.
returnTrackingNumber(string)	If a returnn label is requested
format(string)	Label format: PDF (base64) JPG (base64) ZPL
labels(array)	An array with the base64 of the labels obtained (there may be multiple labels for multiple packages or returns, etc.). Or The ZPL for printing on Zebra, as configured on the Control Panel.

Errors

In case of error the "result" field will contain "KO" and the "error" field will contain the description of the error.

deleteLabel

deleteLabel allows you to delete a label created with createLabel.

Attention

This API is currently being tested. Ask for activation to Customer Care.

DELETEhttps://api.qapla.it/1.2/deleteLabel/

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
id^*(int)	The label id returned from createLabel

Response Body`200`

getLabel

getLabel allows you to download a label created on Qapla' in the orignal courier format (PDF, JPG or ZPL).

Warning: the getLabel does NOT work with dummy labels created with the GENERIC courier (even with the createLabel API).

GEThttps://api.qapla.it/1.2/getLabel/?apiKey=[API_KEY]&trackingNumber=[TRACKING_NUMBER]

GEThttps://api.qapla.it/1.2/getLabel/?apiKey=[API_KEY]&reference=[ORDER_REFERENCE]

GEThttps://api.qapla.it/1.2/getLabel/?apiKey=[API_KEY]&id=[SHIPMENT_ID]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
Exclusive parameters
trackingNumber(string)	Concerned tracking number
reference(string)	Order reference
parcel(int)	The parcel number corresponding to the label (default = 1) - Only for PDF labels
id(int)	the shipment id
json(string)	if used (eg: &json) force a JSON response
getReturnLabel(string)	if used (eg: &getReturnLabel) returns the contextual return label

Response Body`200`

The label with the proper content type (JPG, PDF or txt for ZPL)

Otherwise, if the &json param is used

Errori

In caso di errore il campo "result" conterrà "KO" ed il error la descrizione dell'errore.

Errors

In case of an error the "result" field will contain "KO" and the "error" field the description of the error.

checkLabel

checkLabel allows you to check the status of a previously created label.

GEThttps://api.qapla.it/1.2/checkLabel/?apiKey=[API_KEY]&trackingNumber=[TRACKING_NUMBER]

GEThttps://api.qapla.it/1.2/checkLabel/?apiKey=[API_KEY]&reference=[ORDER_REFERENCE]

GEThttps://api.qapla.it/1.2/checkLabel/?apiKey=[API_KEY]&id=[SHIPMENT_ID]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
Exclusive parameters
trackingNumber(string)	Concerned tracking number
reference(string)	Order reference
id(int)	The label id

Response Body`200`

Errori

In case of an error the "result" field will contain "KO" and the "error" field the description of the error.

confirmLabel

confirmLabel allows you to confirm and send to the courier labels created with createLabel and to obtain the Loading List (borderò / manifest) in PDF format.

Attention

Ask for activation to Customer Care.

POSThttps://api.qapla.it/1.3/confirmLabel/

REQUEST
RESPONSE

Request

Parameters

Attention Use "labelCreationDate" or "labelID".

^*Mandatory Parameter

Parameter	Description
apiKey^*(string)	The channel's API Key
courier^*(string)	The Qapla' courier code
labelCreationDate^*(date)	The label’s date of creation in ISO 8601 format is "YYYY-MM-DD"
labelID^*(array)	General GLS-AT An array of shipments ID obtained with createLabel Parameter not supported for this carrier, use labelCreationDate parameter only

Response Body`200`

Parameter	Description
courier(string)	Courier code
number(string)	Confirmation number
date(string)	Confirmation date
shipments(int)	Number of confirmed shipments
error(array\|string)	Errors found during confirmation
manifest(string)	Manifest in Base64 encoded PDF

Errors

In the event that all dispatches failed, the 'result' field will contain 'KO' and the 'error' field will be a string containing the description of the error.
Otherwise, the 'error' field will be an array containing the details of the individual errors.

Couriers

getCouriers

getCouriers allows to request the couriers' list both in total and by individual country/region.

GEThttps://api.qapla.it/1.2/getCouriers/?apiKey=[API_KEY]&country=[COUNTRY_LIST]&code=[COURIER_CODE]

REQUEST
RESPONSE

Parameters

Parameter

Description

apiKey

the API Key assigned to the channel we want to query

Optional parameters

country

empty for all couriers, or a comma-separated list of country values

country=it,fr,global

The available values are:

	at	Austria
	be	Belgium
	ch	Switzerland
	cn	China
	cy	Cyprus
	cz	Czech Republic
	de	Germany
	dk	Denmark
	ee	Estonia
	es	Spain
	eu
	fi	Finland
	fr	France
	gb	United Kingdom
	global
	gr	Greece
	hk	Hong Kong
	hr	Croatia
	hu	Hungary
	ie	Ireland
	it	Italy
	kr	South Korea
	lt	Lithuania
	lv	Latvia
	mt	Malta
	my	Malaysia
	nl	Netherlands
	pl	Poland
	pt	Portugal
	ru	Russia
	se	Sweden
	si	Slovenia
	us	USA
	za	South Africa

code

The Qapla' code of the courier

code=BRT

hasLabels

Returns couriers who have label generation on Qapla'

Response Body`200`

The following URL

GEThttps://api.qapla.it/1.2/getCouriers/?apiKey=[API_KEY]&country=global

will result:

{"getCouriers":{"result":"OK","error":null,"version":"1.2.5","count":12,"couriers":[{"code":"ARAMEX","name":"Aramex","country":"global","url":"http://www.aramex.com","trackingURL":"https://www.aramex.com/track-results-multiple.aspx?ShipmentNumber=[TRACKING_NUMBER]"},{"code":"DBSCHENKER","name":"DB Schenker","country":"global","url":"https://www.dbschenker.com/","trackingURL":"https://eschenker.dbschenker.com/nges-portal/public/en-GB_GB/#!/tracking/schenker-search?refNumber=[TRACKING_NUMBER]"},{"code":"DHL","name":"DHL Express","country":"global","url":"http://www.dhl.com/","trackingURL":"http://www.dhl.it/content/it/it/express/ricerca.shtml?brand=DHL&AWB=[TRACKING_NUMBER]"},{"code":"DHL-FREIGHT","name":"DHL Freight","country":"global","url":"https://www.logistics.dhl","trackingURL":"https://www.logistics.dhl/global-en/home/tracking/tracking-freight.html?tracking-id=[TRACKING_NUMBER]"},{"code":"DPD","name":"DPD","country":"global","url":"http://www.dpd.com/","trackingURL":"https://tracking.dpd.de/status/en_US/parcel/[TRACKING_NUMBER]"},{"code":"DSV","name":"DSV","country":"global","url":"http://www.dsv.com/","trackingURL":"https://www.tracktrace.dsv.com/newtracking/public/showShipment.jsp?mode=roaddetails&sid=[TRACKING_NUMBER]"},{"code":"FEDEX","name":"FedEx","country":"global","url":"http://www.fedex.com/","trackingURL":"https://www.fedex.com/apps/fedextrack/?action=track&cntry_code=it&trackingnumber=[TRACKING_NUMBER]"},{"code":"ONTRAC","name":"OnTrac","country":"global","url":"http://www.ontrac.com","trackingURL":"https://www.ontrac.com/trackingdetail.asp?run=&tracking=[TRACKING_NUMBER]"},{"code":"SKYNET","name":"SkyNet Worldwide Express","country":"global","url":"http://www.skynetwwe.com/","trackingURL":"https://iskynettrack.skynetwwe.info/ShipmentTrackSingle.aspx?textfield=[TRACKING_NUMBER]"},{"code":"TNT","name":"TNT","country":"global","url":"http://www.tnt.com","trackingURL":"https://www.tnt.com/express/it_it/site/home/applications/tracking.html?cons=[TRACKING_NUMBER]"},{"code":"TOLL","name":"Toll Group","country":"global","url":"https://www.tollgroup.com/","trackingURL":"https://www.mytoll.com/?externalSearchQuery=[TRACKING_NUMBER]"},{"code":"UPS","name":"UPS","country":"global","url":"http://www.ups.com/","trackingURL":"http://wwwapps.ups.com/WebTracking/track?HTMLVersion=5.0&loc=it_IT&Requester=UPSHome&WBPM_lid=homepage%2Fct1.html_pnl_trk&track.x=Ricerca&trackNums=[TRACKING_NUMBER]"}]}}

detectCourier

detectCourier tries to determine the courier from the tracking number provided, responding with a list of couriers.

GEThttps://api.qapla.it/1.2/detectCourier/?apiKey=[API_KEY]&trackingNumber=[TRACKING_NUMBER]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	The API Key assigned to the channel we want to query
trackingNumber	The tracking number to be identified

Response Body`200`

getPudos

getPudos allows you to request the list of PUDOs (Pick Up Drop Off points) of several couriers at the same time.

Attention

Ask for activation to Customer Care.

POSThttps://api.qapla.it/1.2/getPudos/

REQUEST
RESPONSE

Request

Parameters

^*Mandatory Parameters

Parameter	Description
apiKey^*(string)	The API Key of the channel. Alternatively, it can be provided as a query parameter in the request URL, always using the http POST method. Example: POSThttps://api.qapla.it/1.2/getPudos/?apiKey=[API_KEY]
postCode^*(string)	Postal code of the locality you intend to search for PUDOs
country^*(string)	ISO 3166-2 code of the country where the postcode is located. No quality control of the code is performed
couriers(array)	List of Qapla's "Courier Codes" whose PUDOs you want to know. Valid courier codes are BRT, DHL, DHL-PAKET, DHLPARCEL-ES, FEDEX, FERMOPOINT, GLS, INPOST, PTI, UPS, CORREOS, TIPSA, CORREOS, CORREOS-EXPRESS, MRW-ES, SEUR, NACEX-ES and SENDING. If this parameter is not specified or left empty, PUDO locations for all valid and configured couriers in Qapla' will be retrieved
province(string)	Province of the locality being searched
city(string)	Town/city of the location being searched (required for TIPSA)
street(string)	Address, complete with house number if applicable
radius(number)	Radius, expressed in KM, within which to limit the search for PUDOs. Specifying a value ≤ 0 is equivalent to specifying no radius
limit(number)	Number of PUDOs returned per courier. Specifying a value ≤ 0 is equivalent to specifying no limit, in which case the courier will return its default

Response Body`200`

{
  "getPudos": {
    "data": [
      {
        "courier": "DHLPARCEL-ES",
        "statusCode": 200,
        "servicePointList": [
          {
            "ID": "8055-ES-0005466",
            "name": "BLUE LINE technology",
            "businessDays": [
              {
                "day": 2,
                "dayName": "Tuesday",
                "dayNameIT": "martedì",
                "businessHours": [
                  {
                    "open": "09:30",
                    "close": "13:30"
                  },
                  {
                    "open": "17:30",
                    "close": "20:30"
                  }
                ]
              },
              {
                "day": 3,
                "dayName": "Wednesday",
                "dayNameIT": "mercoledì",
                "businessHours": [
                  {
                    "open": "09:30",
                    "close": "13:30"
                  },
                  {
                    "open": "17:30",
                    "close": "20:30"
                  }
                ]
              },
              {
                "day": 4,
                "dayName": "Thursday",
                "dayNameIT": "giovedì",
                "businessHours": [
                  {
                    "open": "09:30",
                    "close": "13:30"
                  },
                  {
                    "open": "17:30",
                    "close": "20:30"
                  }
                ]
              },
              {
                "day": 5,
                "dayName": "Friday",
                "dayNameIT": "venerdì",
                "businessHours": [
                  {
                    "open": "09:30",
                    "close": "13:30"
                  },
                  {
                    "open": "17:30",
                    "close": "20:30"
                  }
                ]
              },
              {
                "day": 6,
                "dayName": "Saturday",
                "dayNameIT": "sabato",
                "businessHours": [
                  {
                    "open": "10:00",
                    "close": "14:00"
                  }
                ]
              }
            ],
            "telephone": null,
            "distance": 0.664,
            "holidays": [],
            "notes": null,
            "availableServices": [
              {
                "serviceDescription": "parcel:pick-up"
              },
              {
                "serviceDescription": "franking"
              },
              {
                "serviceDescription": "handicapped-access"
              },
              {
                "serviceDescription": "cash-service"
              },
              {
                "serviceDescription": "parcel:drop-off"
              }
            ],
            "courierSpecific": [
              {
                "name": "harmonisedId",
                "value": "102"
              },
              {
                "name": "psfKey",
                "value": "ES-0005466"
              },
              {
                "name": "keyword",
                "value": "DHL Servicepoint"
              }
            ],
            "type": "SHOP",
            "pushOrderPUDO": {
              "id": "8055-ES-0005466",
              "courierID": 0,
              "type": null,
              "name": null,
              "address": "C/Salvado espriu 2",
              "city": "Sant Just Desvern",
              "state": null,
              "country": "ES",
              "postalCode": "08960",
              "description": null,
              "psfKey": "ES-0005466",
              "keyword": "DHL Servicepoint",
              "postnumber": "",
              "harmonisedId": "102"
            },
            "street": "C/Salvado espriu 2",
            "postCode": "08960",
            "city": "Sant Just Desvern",
            "province": null,
            "country": "ES",
            "coordinates": {
              "latitude": 41.37976,
              "longitude": 2.071
            }
          }
        ],
        "error": ""
      },
      {
        "courier": "UPS",
        "statusCode": 200,
        "servicePointList": [
          {
            "ID": "114732",
            "name": "ELECTRODOMESTICS A. MURCIANO",
            "businessDays": [
              {
                "day": 1,
                "dayName": "Monday",
                "dayNameIT": "lunedì",
                "businessHours": [
                  {
                    "open": "09:00",
                    "close": "13:30"
                  },
                  {
                    "open": "17:00",
                    "close": "20:00"
                  }
                ]
              },
              {
                "day": 2,
                "dayName": "Tuesday",
                "dayNameIT": "martedì",
                "businessHours": [
                  {
                    "open": "09:00",
                    "close": "13:30"
                  },
                  {
                    "open": "17:00",
                    "close": "20:00"
                  }
                ]
              },
              {
                "day": 3,
                "dayName": "Wednesday",
                "dayNameIT": "mercoledì",
                "businessHours": [
                  {
                    "open": "09:00",
                    "close": "13:30"
                  },
                  {
                    "open": "17:00",
                    "close": "20:00"
                  }
                ]
              },
              {
                "day": 4,
                "dayName": "Thursday",
                "dayNameIT": "giovedì",
                "businessHours": [
                  {
                    "open": "09:00",
                    "close": "13:30"
                  },
                  {
                    "open": "17:00",
                    "close": "20:00"
                  }
                ]
              },
              {
                "day": 5,
                "dayName": "Friday",
                "dayNameIT": "venerdì",
                "businessHours": [
                  {
                    "open": "09:00",
                    "close": "13:30"
                  },
                  {
                    "open": "17:00",
                    "close": "20:00"
                  }
                ]
              }
            ],
            "telephone": "",
            "distance": 0.6,
            "holidays": [],
            "notes": "At the end of c / Major, and next to La Mallola",
            "availableServices": [
              {
                "serviceCode": "001",
                "serviceDescription": "Direct To Retail"
              },
              {
                "serviceCode": "002",
                "serviceDescription": "Not In One ADL"
              },
              {
                "serviceCode": "004",
                "serviceDescription": "Retail to Retail"
              },
              {
                "serviceCode": "007",
                "serviceDescription": "PUDO"
              },
              {
                "serviceCode": "010",
                "serviceDescription": "DCO DCR intercept accepted"
              },
              {
                "serviceCode": "011",
                "serviceDescription": "Accepts Payments"
              },
              {
                "serviceCode": "012",
                "serviceDescription": "Pay-At-Store"
              },
              {
                "serviceCode": "015",
                "serviceDescription": "Accepts Mobile Barcodes"
              }
            ],
            "courierSpecific": [],
            "type": "SHOP",
            "pushOrderPUDO": {
              "id": "114732",
              "courierID": 0,
              "type": null,
              "name": "ELECTRODOMESTICS A. MURCIANO",
              "address": "CL MARAGALL, 2",
              "city": "SANT JUST DESVERN",
              "state": null,
              "country": "ES",
              "postalCode": "08960",
              "description": null,
              "psfKey": null,
              "keyword": null,
              "postnumber": null,
              "harmonisedId": null
            },
            "street": "CL MARAGALL, 2",
            "postCode": "08960",
            "city": "SANT JUST DESVERN",
            "province": null,
            "country": "ES",
            "coordinates": {
              "latitude": 41.3818016,
              "longitude": 2.081099987
            }
          }
        ],
        "error": ""
      }
    ],
    "result": "OK"
  }
}

Parameter

Description

result(string)

Indicates whether the operation was successful, possible values are 'OK' and 'KO'

error(string)

Contains the description of the error, if any, that was raised, empty if result = 'OK'

data(array)

Array of objects containing the list of PUDOs. Each element of the array corresponds to the response obtained from a courier

statusCode(int)

Error code, result of the query made to the courier

200(int)	OK/No error
404(int)	NOT FOUND; the courier's webservice returned an empty list of PUDOs
408(int)	TIMEOUT; the courier's webservice took too long to respond
500(int)	GENERIC ERROR;
501(int)	EMPTY RESPONSE; the courier's webservice did not return a response
522(int)	UNPROCESSABLE RESPONSE; the courier webservice returned an output that could not be interpreted (e.g. invalid JSON or XML)
599(int)	CUSTOM ERROR; the webservice replied with an error specific to the courier queried, more information on the error can be found in the 'error' field

courier(string)

Code of the courier company queried (e.g. GLS, DHL, PTI, etc.)

error(string)

Possible description of the error if one was raised during the query of the individual courier

servicePointList(array)

Array of objects containing the list of PUDOs. Each element of the array corresponds to the response obtained from a courier

ID(string)	Internal identifier used by the courier
name(string)	Name of exercise/shop/locker
type(string)	Identifies the type of PUDO: SHOP = shop, LOCKER = post office, LOCKER = locker, SHOPINSHOP = shop within another shop (used by GLS)
telephone(string)	Telephone number
street(string)	PUDO address
postCode(string)	PUDO postal code
city(string)	City/town of PUDO
province(string)	PUDO Province
country(string)	PUDO country code (2 characters)
coordinates(oggetto)	It contains two attributes, 'latitude' and 'longitude', of float type, which respectively contain the latitude and longitude of the geographical point where the PUDO is located
distance(float)	The distance in km from the address/location being researched
notes(string)	Any notes/indications
businessDays(array)	Indicates the days and hours when the PUDO is open, see dedicated section
availableServices(array)	Array of objects consisting of two attributes 'serviceCode' and 'serviceDescription', both of type string; they represent the services available from the PUDO; the 'serviceCode' field may be absent if not provided by the courier
courierSpecific(array)	Array of objects consisting of two attributes 'name' and 'value', both of type string; they represent specific fields for a given courier (e.g. harmonisedId for DHLPARCEL-ES)
holidays(array di oggetti)	Array of objects consisting of two attributes 'startDate' and 'endDate', both of type string and representing respectively start and end dates of scheduled closing periods. The dates are in the format "yyyy-mm-dd"
pushOrderPUDO(oggetto)	JSON object that can be passed to the 'pushOrder' API and can have different fields depending on the courier. For more information see pushOrder

Business Days

An object of the array businessDays represents a weekly opening day and has several attributes:

Parameter	Description
day(int)	Indicates the number of the day of the week according to ISO 8601 coding ( 1 = Monday...7 = Sunday)
dayName(string)	The name of the day of the week in English
dayNameIT(string)	The name of the day of the week in Italian
businessHours(array)	Array of objects consisting of two attributes, 'open' and 'close', both of type string, representing a time in the format 'hh: mm'

getQuotes

getQuotes allows you to request shipping quotes from multiple carriers for multiple services simultaneously.

Attention

Request activation from Customer Care.

POSThttps://api.qapla.it/1.3/getQuotes/

REQUEST
RESPONSE

Request

Header

^*Required parameter

Parameter	Description
x-api-key^*(string)	The channel API Key.
x-sandbox(string)	Requests execution in sandbox for testing, the values returned in this mode may not be realistic. Allowed values are "true" or "false". GLS-ITA does not provide a sandbox environment, so requests are sent to production servers.

Body

^*Required parameter

Parameter

Description

reference^*(string)

Unique reference code, sent back in the response, accepts only uppercase letters, lowercase letters, numbers, and the symbols "-", "_" and "."

senderCode(string)

Qapla' sender code to use for the quote. If valued, the procedure will use the sender data of the Channel with this code; if the inserted value does not exist, it will return an error; if not valued, the procedure will use the default sender or the Company's address.
NOTE: for GLS-ITA it is not possible to specify a senderCode.

recipient^*(object)

Recipient

street^*(string)	Recipient's address, possibly including the street number
zipCode(string)	Recipient's postal code (mandatory in Europe)
city^*(string)	Recipient's city, for international shipments enter the international (English) name of the city
province(string)	Province (mandatory in Italy) or state (where applicable) of the recipient
country^*(string)	Recipient's country, as a 2-character ISO code

(the fields required to obtain a quote vary depending on the carrier, generally at least the country and the zipcode or address and city are required)

currency(string)

Currency used to value monetary fields and in which the quote is requested expressed in a three-character string. If not specified, the value "EUR" is considered.
No conversion is performed.
The following carriers do not support currency choice and return an error if any currency other than EUR is requested: GLS-ITA, LICCARDI.
Additionally, carriers may return quotes in a currency different from the one indicated here. The quote currency is reported in the response.

amountShipment^*(float)

Shipment value, in the currency specified by the currency field. Float format with 2 decimals without currency symbols (#.##).

amountInsurance(float)

Insured value of the shipment, in the currency specified by the currency field or in Euro for carriers that do not support it. Float format with 2 decimals without currency symbols (#.##).
Do not value (or value with 0) if the merchandise insurance service is not wanted.

amountCash(float)

Cash on delivery value of the shipment, in the currency specified by the currency field or in Euro for carriers that do not support it. Float format with 2 decimals without currency symbols (#.##).
Do not value (or value with 0) if the cash on delivery service is not wanted.

parcels^*(array)

List of packages in the shipment

weight^*(float)	Package weight in kg NOTE: These carriers only accept integer values, so the provided value will be rounded up: TNT-ITA
width^*(float)	Package width in cm NOTE: These carriers only accept integer values, so the provided value will be rounded up: GLS-ITA, FEDEX, LICCARDI, TNT-ITA
height^*(float)	Package height in cm NOTE: These carriers only accept integer values, so the provided value will be rounded up: GLS-ITA, FEDEX, LICCARDI, TNT-ITA
length^*(float)	Package length in cm NOTE: These carriers only accept integer values, so the provided value will be rounded up: GLS-ITA, FEDEX, LICCARDI, TNT-ITA

couriers(array)

List of Qapla' "Carrier Codes" for which you want to get the quote. Valid carrier codes are DHL, FEDEX, GLS-ITA, LICCARDI, TNT-ITA, UPS and AMAZON-SHIPPING. If this parameter is not specified or left empty, quotes will be requested from all valid and configured carriers on Qapla'.

Response Body`200`

{
    "getQuotes": {
      "result": "OK",
      "version": "1.3.0",
      "reference": "abc123",
      "quotationId": "566ef67f-ec5f-4517-ac32-543c69032f5d",
      "startTimestamp": "2024-06-20T13:15:02.408+00:00",
      "finishTimestamp": "2024-06-20T13:15:06.208+00:00",
      "couriers": [
        {
          "code": "UPS",
          "quotes": [
            {
              "service": {
                "courierCode": "07",
                "qaplaCode": 1,
                "description": "Express"
              },
              "messages": [
                {
                  "type": "message",
                  "code": 110971,
                  "content": "Your invoice may vary from the displayed reference rates"
                },
                {
                  "type": "message",
                  "code": 110920,
                  "content": "Ship To Address Classification is changed from Commercial to Residential"
                }
              ],
              "deliveryOptions": null,
              "currency": "EUR",
              "amount": 79.55,
              "expectedPickupDate": null,
              "expectedDeliveryDate": null
            },
            {
              "service": {
                "courierCode": "11",
                "qaplaCode": 3,
                "description": "Standard"
              },
              "messages": [
                {
                  "type": "message",
                  "code": 110971,
                  "content": "Your invoice may vary from the displayed reference rates"
                },
                {
                  "type": "message",
                  "code": 110920,
                  "content": "Ship To Address Classification is changed from Commercial to Residential"
                }
              ],
              "deliveryOptions": null,
              "currency": "EUR",
              "amount": 55.25,
              "expectedPickupDate": null,
              "expectedDeliveryDate": null
            }
          ],
          "messages": [
            {
              "type": "message",
              "code": 110971,
              "content": "Your invoice may vary from the displayed reference rates"
            },
            {
              "type": "message",
              "code": 110920,
              "content": "Ship To Address Classification is changed from Commercial to Residential"
            }
          ]
        },
        {
          "code": "DHL",
          "quotes": [
            {
              "service": {
                "courierCode": "I",
                "qaplaCode": 4,
                "description": "Domestic Express H 9"
              },
              "messages": [],
              "deliveryOptions": null,
              "currency": "EUR",
              "amount": 57.68,
              "expectedPickupDate": null,
              "expectedDeliveryDate": "2024-06-24T09:00:00"
            }
          ],
          "messages": []
        }
      ]
    }
  }

Parameter

Description

result(string)

Indicates if the operation was successful, possible values are "OK" and "KO".

version(string)

Version of the API that generated the response.

reference(string)

Repeats the reference field from the request.

quotationId(string)

Unique identifier of the request assigned by our system (UUIDv4 format).

startTimestamp(string)

Date and time when the request was received (RFC3339 format).

finishTimestamp(string)

Date and time when the request was completed (RFC3339 format).

couriers(array)

Array of objects representing the responses from each queried courier

code(string)

"Carrier code" of Qapla' to which the quotes refer.

quotes(array)

The list of quotes returned by this courier

service(object)

The courier service quoted in this element

courierCode(string)	"Service code" of the courier.
qaplaCode(int)	"Service code" of Qapla'.
description(string)	Descriptive name of the service.

messages(array)

List of objects representing notices regarding the quotes for a specific service

type(string)	The type of message (message\|error).
code(string\|int)	Numeric error code if reported.
content(string)	Textual description of the message.

deliveryOptions(array)

List of any delivery options associated with the service (content depends on the courier)

type(string)	The type of option (0 = Other option; 1 = Delivery option).
code(string\|int)	Option code.
content(string)	Textual description of the option.

currency(string)

Currency code in which the estimated cost is reported.

amount(float)

The estimated value

expectedPickupDate(string)

Estimated pickup date of the parcels for shipment in yyyy-MM-dd format.

expectedDeliveryDate(string)

Estimated delivery date of the shipment in yyyy-MM-dd format.

messages(array)

Array of objects representing notices regarding the quotes reported by this courier

type(string)	The type of message (message\|error)
code(string\|int)	Numeric error code if reported
content(string)	Textual description of the message

apiVirtual

apiVirtual allows you to update the status of a virtual courier shipment.

POSThttps://api.qapla.it/virtual/

REQUEST
RESPONSE

Parameters

^*Mandatory parameter

apiKey^*(string)

The API Key assigned to the channel we want to query

apiVirtual(array)

It is an array that can hold maximum 100 updates.

trackingNumber^*(string)	The tracking number of the shipment to be updated
statusID / statusDetailID^*(float)	The ID of the status of the shipment and any statusDetailID
status(string)	The textual description of the shipment status
place(string)	The location where the shipment is located
date(YYYY-MM-DD HH:MM:S)	The date in ISO 8601 format "yyyy-mm-dd hh: mm: ss"
note(string)	Any shipping notes

Response Body`200`

Errors

In case of error the "result" field will contain "KO" and the "error" field the description of the error.

Channels

getChannel

getChannel allows you to obtain information on the channel connected to the API Key and the company who created it.

GEThttps://api.qapla.it/1.2/getChannel/?apiKey=[API_KEY]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	The API Key assigned to the channel we want to query
Optional Parameters
data	It obtains information on the configuration of the channel with respect to the platform and/or marketplaces. Possible values (all, platform, marketplaces)

Response Body`200`

checkChannel

It allows you to verify the connections with the marketplace platform configured on the channel.

GEThttps://api.qapla.it/1.2/checkChannel/?apiKey=[API_KEY]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	The API Key assigned to the channel we want to query

Response Body`200`

Errors

In the event of an error, the "result" field will contain "KO" and the "error" field will contain the description of the error.

getChannelMonitor

getChannelMonitor allows to obtain information on the channel connected to the API Key in a specific period.

GEThttps://api.qapla.it/1.2/getChannelMonitor/?apiKey=[API_KEY]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	The API Key assigned to the channel we want to query
Optional Parameters
range	It obtains information on the channel in a specific period. Possible values (today, yesterday, week, last-week, month, last-month, 30gg, 60gg)

Response Body`200`

{
                  "getChannelMonitor": {
                    "result":"OK",
                    "error":false,
                    "version": "1.2",
                    "range": "week",
                    "shipments": {
                      "delivered": 112,
                      "shipped": 250,
                      "imported": 0,
                      "errors": 0
                    },
                    "orders": {
                      "imported": 122,
                      "errors": 2
                    },
                    "email": {
                      "sent": 123,
                      "queue": 25,
                      "errors": 21
                    },
                    "sms": {
                      "sent": 123,
                      "queue": 25,
                      "errors": 21
                    },
                    "webhook": {
                      "updated": 123,
                      "queue": 25,
                      "errors": 21
                    }
                  }
                }

createChannel

It allows to create a new channel.

POSThttps://api.qapla.it/1.2/createChannel/

REQUEST
RESPONSE

Request

{
                  "apiKey": "[API_KEY]",
                  "createChannel": {
                    "code": "MYC1",
                    "name": "My channel name",
                    "url": "https://www.example.it",
                    "orderSettings": {
                      "import": "auto"
                    },
                    "platform": {
                      "shopify": {
                        "shopName": "qapla",
                        "apiKey": "3d445tg6yhujuuj8",
                        "password": "eedr5rg6yhu7uj",
                        "updateSettings": {
                          "updateWhenShipped": true,
                          "updateWhenShippedLocationID":1234567,
                          "updateWithShipmentStatus": true
                        }
                      }
                    },
                    "marketplaces": {
                      "amazon":{
                        "active": true,
                        "update": true,
                        "amazonSellerID": "13456787",
                        "amazonMWSAuthorisationToken": "fe3rtgh55y",
                        "amazonMarketplacesID":[
                          {
                            "country":"IT",
                            "marketplaceID":"123456"
                          },
                          {
                            "country":"ES",
                            "marketplaceID":"123456"
                          },
                          {
                            "country":"FR",
                            "marketplaceID":"123456"
                          },
                          {
                            "country":"DE",
                            "marketplaceID":"123456"
                          },
                          {
                            "country":"GB",
                            "marketplaceID":"123456"
                          }
                        ]
                      },
                      "carrefour":{
                        "active": true,
                        "update": true,
                        "settings":[
                          {
                            "country":"ES",
                            "apiKey":"123456"
                          }
                        ]
                      },
                      "cdiscount": {
                        "active": true,
                        "username": "myusername",
                        "password": "mypassword"
                      },
                      "eprice":{
                        "active": true,
                        "update": true,
                        "apiKey": "1234567"
                      },
                      "ibs": {
                        "active": true,
                        "update": true,
                        "apiKey": "fj94fr3fj034jf034fj"
                       },
                       "manomano":{
                          "apiKey":"12345678",
                          "settings":[
                            {
                              "active": true,
                              "country": "IT",
                              "login": "1234567",
                              "password": "123456"
                            },
                            {
                              "active": true,
                              "country": "ES",
                              "login": "1234567",
                              "password": "123456"
                            },
                            {
                              "active": true,
                              "country": "FR",
                              "login": "1234567",
                              "password": "123456"
                            },
                            {
                              "active": true,
                              "country": "DE",
                              "login": "1234567",
                              "password": "123456"
                            },
                            {
                              "active": true,
                              "country": "GB",
                              "login": "1234567",
                              "password": "123456"
                            }
                          ]
                       },
                       "privalia":{
                          "active": true,
                          "update": true,
                          "settings":[
                            {
                              "country": "IT",
                              "apiKey": "1234567"
                            },
                            {
                              "country": "ES",
                              "apiKey": "1234567"
                            }
                          ]
                       },
                       "spartoo":{
                          "active": true,
                          "update": true,
                          "apiKey": "1wdefrgtr3",
                          "domainsCountry":["it","es","fr","de","gb","pt","nl","gr","be","pl","cn"]
                       },
                       "worten":{
                          "active": true,
                          "update": true,
                          "settings":[
                            {
                              "country": "PT",
                              "apiKey": "1234567"
                            }
                          ]
                       }
                    }
                  }
                }

Parameters

^*Mandatory parameter

Parameter

Description

apiKey^*(string)

The API Key assigned to the channel we want to query

createChannel^*(object)

code^*(string)

The channel code (Ex. "MOC", "MYCH" )

name^*(string)

The channel name (Ex. "This is my channel name")

url^*(string)

Absolute url of your website/ecommerce (Ex. https://www.example.org)

orderSettings(object)

import(string)

Import type definition

Code	Import type
none	No import
auto	Auto import
manual	Manual import

platform(object)

ecwid(object)

storeID^*(string)
accessToken^*(string)

magento(object)

username^*(string)
storeID^*(string)

magento2(object)

username^*(string)
password^*(string)
storeID^*(string)

prestashop(object)

accessToken^*(string)

shopify(object)

shopName^*(string)

apiKey^*(string)

password^*(string)

updateSettings^*(object)

updateWhenShipped(bool)	Update the order to "shipped" when the shipment is created
updateWhenShippedLocationID(string)	Location ID retrieved from your Shopify account
updateWithShipmentStatus(bool)	Update with shipping statuses

storeden(object)

accessKey^*(string)
accessToken^*(string)

vtex(object)

domain^*(string)
appToken^*(string)
appKey^*(string)

woocommerce(object)

consumerKey^*(string)
secretKey^*(string)

marketplaces(object)

amazon(object)

active^*(bool)

Enable/disable marketplace

update^*(bool)

Order update

amazonSellerID^*(string)

amazonMWSAuthorisationToken^*(string)

amazonMarketplacesID(array object)

country^*(string)

Admitted values:

Code	Country
IT	Italy
GB	Great Britain
ES	Spain
FR	French
DE	Germany

marketplaceID^*(string)

carrefour(object)

active^*(bool)

Enable/disable marketplace

update^*(bool)

Order update

settings(array object)

country^*(string)	Admitted value: ES
apiKey^*(string)

cdiscount(object)

active^*(bool)	Enable/disable marketplace
username^*(string)
password^*(string)

ebay(object)

eprice(object)

active^*(bool)	Enable/disable marketplace
update^*(bool)	Order update
apiKey^*(string)

ibs(object)

active^*(bool)	Enable/disable marketplace
update^*(bool)	Order update
apiKey^*(string)

manomano(object)

apiKey^*(string)

settings^*(array object)

active^*(bool)

Enable/disable marketplace

country^*(string)

Admitted values:

Code	Country
IT	Italy
GB	Great Britain
ES	Spain
FR	French
DE	Germany

password^*(string)

apiKey(string)

Mandatory for REST API

sellerContractId(string)

Mandatory for REST API

privalia(object)

active^*(bool)

Enable/disable marketplace

update^*(bool)

Order Update

settings(array object)

apiKey^*(bool)
country^*(string)	Admitted values: IT, ES

spartoo(object)

active^*(bool)	Enable/disable marketplace
update^*(bool)	Order update.
apiKey^*(string)
domainsCountry^*(array)	Admitted values: "it","es","fr","de","gb","pt","nl","gr","be","pl","cn"

worten(object)

active^*(bool)

Enable/disable marketplace

update^*(bool)

Order update.

settings(array object)

apiKey^*(bool)
country^*(string)	Admitted value: PT

Response Body`200`

Errors

In the event of an error, the "result" field will contain "KO" and the "error" field will contain the description of the error.

updateChannel

It allows to change some channel settings.

PATCHhttps://api.qapla.it/1.2/updateChannel/

REQUEST
RESPONSE

Request

Parameters

^*Mandatory parameter

Parameter	Description
apiKey^*(string)	The API Key assigned to the channel we want to query
updateChannel^*(object)	Like create object

Response Body`200`

Errors

In the event of an error, the "result" field will contain "KO" and the "error" field will contain the description of the error.

deleteChannel

It allows to delete a specific channel.

DELETEhttps://api.qapla.it/1.2/deleteChannel/

REQUEST
RESPONSE

Request

Parameters

^*Mandatory parameter

Parameter

Description

deleteChannel^*(object)

apiKey^*(string)	The API Key assigned to the channel we want to query

Response Body`200`

Errors

In the event of an error, the "result" field will contain "KO" and the "error" field will contain the description of the error.

Misc

getCredits

getCredits allows you to get the remaining credits on your premium account.

GEThttps://api.qapla.it/1.2/getCredits/?apiKey=[API_KEY]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey	The API Key assigned to the channel we want to query

Response Body`200`

Description

result(string)	The result of the operation: OK or KO in case of error
error(string)	The error in case of result: KO
credits(int)	Remaining credits
date(string)	Count update date

getQaplaStatus

getQaplaStatus allows you to get the detailed list of Qapla' shipping status

GEThttps://api.qapla.it/1.2/getQaplaStatus/?apiKey=[API_KEY]&lang=[LANG]&id=[ID]

REQUEST
RESPONSE

Parameters

Parameter	Description
apiKey(string)	The API Key assigned to the channel we want to query
Optional parameters
lang(string)	The language of the names of the Qapla' status (it, en, es), default: it. Example: &lang=en
id(int)	Possible id of which you want to get informations Example: &id=3

Response Body`200`

{"getQaplaStatus":{"result":"OK","error":null,"qaplaStatus":[{"statusID":0,"status":"ATTESA ELABORAZIONE","statusDescription":"La gestione automatica di interrogazione del corriere non è ancora stata eseguita.","color":"#ecf0f1","icon":"https://cdn.qapla.it/status/0.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":1,"status":"IN SOSPESO","statusDescription":"La spedizione è stata trovata ma non ci sono ancora notizie da parte del corriere.","color":"#abbad4","icon":"https://cdn.qapla.it/status/1.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":2,"status":"ATTESA RITIRO","statusDescription":"Il corriere non ha ancora ritirato la spedizione.","color":"#35495e","icon":"https://cdn.qapla.it/status/2.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":20,"status":"PARTITO","statusDescription":"La spedizione è partita.","color":"#8A2BE2","icon":"https://cdn.qapla.it/status/20.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":3,"status":"IN TRANSITO","statusDescription":"La merce è in transito.","color":"#1D76D8","icon":"https://cdn.qapla.it/status/3.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":50,"status":"IN LAVORAZIONE","statusDescription":"Spedizione in lavorazione","color":"#BDB76B","icon":"https://cdn.qapla.it/status/50.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":4,"status":"IN CONSEGNA","statusDescription":"Spedizione in consegna.","color":"#376600","icon":"https://cdn.qapla.it/status/4.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":5,"status":"TENTATIVO DI CONSEGNA FALLITO","statusDescription":"La consegna è fallita. Pre-allarme per possibili problemi.","color":"#FF6E00","icon":"https://cdn.qapla.it/status/5.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":8,"status":"RITARDO","statusDescription":"La spedizione sta subendo dei ritardi.","color":"#e9be57","icon":"https://cdn.qapla.it/status/8.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":6,"status":"ECCEZIONE","statusDescription":"Viene segnalato un qualche problema che può essere generico o spiegato da ulteriori icone.","color":"#970D00","icon":"https://cdn.qapla.it/status/6.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":6,"status":"ECCEZIONE","statusDescription":null,"color":"#970D00","icon":"https://cdn.qapla.it/status/6-1.svg","statusDetailID":1,"statusDetail":"GIACENZA","statusDetailDescription":"La spedizione è in giacenza"},{"statusID":6,"status":"ECCEZIONE","statusDescription":null,"color":"#970D00","icon":"https://cdn.qapla.it/status/6-2.svg","statusDetailID":2,"statusDetail":"SPEDIZIONE IN RIENTRO / RIFIUTATA","statusDetailDescription":"La spedizione è stata rifiutata e la merce è in rientro."},{"statusID":6,"status":"ECCEZIONE","statusDescription":null,"color":"#970D00","icon":"https://cdn.qapla.it/status/6-3.svg","statusDetailID":3,"statusDetail":"DANNEGGIAMENTO","statusDetailDescription":"Il corriere segnala che la merce risulta danneggiata."},{"statusID":6,"status":"ECCEZIONE","statusDescription":null,"color":"#970D00","icon":"https://cdn.qapla.it/status/6-4.svg","statusDetailID":4,"statusDetail":"SMARRIMENTO","statusDetailDescription":"Il corriere segnala che la merce risulta smarrita."},{"statusID":10,"status":"PUNTO DI RITIRO","statusDescription":"La spedizione è stata consegnata in un Punto di Ritiro.","color":"#FFDE00","icon":"https://cdn.qapla.it/status/10.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":95,"status":"RIENTRATO","statusDescription":"La spedizione è rientrata al mittente.","color":"#620000","icon":"https://cdn.qapla.it/status/95.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null},{"statusID":99,"status":"CONSEGNATO","statusDescription":"La spedizione è stata consegnata al destinatario.","color":"#66cc00","icon":"https://cdn.qapla.it/status/99.svg","statusDetailID":0,"statusDetail":null,"statusDetailDescription":null}]}}

result(string)

The result of the operation: OK or KO in case of error

error(string)

The error in case of result: KO

version(string)

The version of API

qaplaStatus(array)

It is an array of status

statusID(int)	The Qapla' status
status(string)	Name of the status
statusDescription(string)	Description of the status
color(string)	The color assigned to the status
icon(string)	The icon assigned to the status
statusDetailID(int)	Possible status detail
statusDetail(string)	Name of the detail
statusDetailDescription(string)	Description of the detail

Script

Qapla's APIs can be efficiently queried using JavaScript scripts.

Tracking Script

By entering and configuring our Tracking Script, you can get tracking anywhere on the site.

<!-- Place this code after <body> tag -->
<script type="text/javascript">
    let apiKey = "7b1b7235"; // your channel's public API Key
    let reference = "104"; // your order's reference
    // let noCSS = true;
    // let compact = true;
    // let lang = "en";
</script>

<script type="text/javascript" src="https://api.qapla.it/js/1.2/qapla-tracking.min.js"></script>

<!-- Place this element where you want to display the Qapla' Tracking -->
<div id="qapla-tracking"></div>

Parameters

Parameter

Description

apiKey^*(string)

The "public" API KEY present in the configuration of the sales channel on the Qapla' Control Panel (CP).

reference^*/ trackingNumber^*(string)

Track by order reference or by tracking number.

noCSS(bool)

If true not include the standard css, allowing an override.

compact(bool)

If true a compact version is displayed.

lang(string)

if set it shows the courier statuses in the selected language. If not set, the default ('it') is used

lang(string)

Languages in which courier statuses can be displayed

it(string)	Italian
en(string)	English
de(string)	German
fr(string)	French
es(string)	Spanish
pt(string)	Portuguese
zh(string)	Chinese
ru(string)	Russian
jp(string)	Japanese
cs(string)	Czech
rn(string)	Romanian
hu(string)	Hungarian
ar(string)	Arabic
sk(string)	Slovak
pl(string)	Polish
kr(string)	Korean

Result

The result is an HTML that will be inserted into the element with id qapla-tracking having the following content.

Help

Qapla' Status

It's the interpretation of the status of the shipment with values that Qapla' assigns to each possible state of the courier.

id	name	Description
0	PROCESSING WAIT
1	PENDING	Shipment found but any news yet from courier.
2	WAITING FOR PICK-UP	The courier didn’t pick up the shipment yet.
20	DEPARTED	Shipment departed.
3	IN TRANSIT	The goods are in transit.
50	PROCESSING	Processing
50	PROCESSING • CUSTOMS
4	OUT FOR DELIVERY	Shipment in delivery.
5	FAILED DELIVERY ATTEMPT	Delivery failed. Early warning for potential problems.
8	DELAY	Shipment is suffering delay.
6	EXCEPTION	There is a problem; generic or explained by additional icons.
6	EXCEPTION • STOCK
6	EXCEPTION • RETURN
6	EXCEPTION • DAMAGED
6	EXCEPTION • LOST
6	EXCEPTION • PARTIAL DELIVERY
10	PICKUP POINT	Delivered to a PickUp Point.
95	RETURNED	Shipment returned to sender.
99	DELIVERED	The shipment has been delivered to the recipient.

Couriers

List of Qapla's couriers' codes, in alphabetical order.

Code	Name	URL
TWOGO	2GO	https://www.parcel2go.com/tracking/
THREE-JMS-LOGISTICS	3JMS Logistics	https://www.aftership.com/carriers/3jmslogistics
FOURPX	4PX	http://express.4px.com/
NINENINE-MINUTOS	99minutos	https://tracking.99minutos.com/
A1-POST	A1 Post	https://a1post.bg/en/track/
ABF-FREIGHT	ABF Freight	https://arcb.com/tools/tracking.html#/
ACS-COURIER	ACS Courier	https://www.acscourier.net/en/
AG-LOGISTICA	AG Logistica	http://www.aglogisticasrl.it/
AIR-EXPRESS-IT	Air Express	https://airexpress.it/
AIRPAK-EXPRESS	Airpak Express	https://tracking.airpak-express.com/tracking.aspx?stid=airpak&cn=
AIRTRANS	AirTrans	https://track.wqxs.com/93/
ALBANIA-POST	Albania Post	https://www.postashqiptare.al/
ALI-BUSINESS-LOGISTICS	Ali Business Logistics	http://120.24.176.176:8082/trackIndex.htm
ALIEXPRESS	Aliexpress	https://www.aliexpress.com/‎
ALPI	Alpi World	https://www.alpiworld.com/
AMATI-JR	Amati JR	http://www.amatijrtrasporti.it/
AMAZON-SHIPPING	Amazon Shipping	https://shipping.amazon.co.uk/
AN-POST	An Post	https://www.anpost.com/
ANJUN-LOGISTICS	Anjun Logistics	http://www.szanjuntrack.com/Szanjuntrack.asp
APP2DELIVERY	App2delivery
ARAMEX	Aramex	http://www.aramex.com
ARAMEX-AT	Aramex AT	https://www.aramex.com.au/tools/track?l=
ARAMEX-AU	Aramex AU	https://www.aramex.com.au/
ARAMEX-NZ	Aramex NZ	https://www.aramex.co.nz/tools/track?l=
ARAS-KARGO	Aras Kargo	https://kargotakip.araskargo.com.tr/mainpage.aspx?code=
ARCO	Arco Spedizioni	http://www.arco.it/
ARMENIA-POST	Armenia Post	https://www.haypost.am/hy/track-and-trace
ASENDIA	Asendia Europe	https://www.asendia.com
ASENDIA-DE	ASENDIA Germany	http://www.asendia.de/
ASENDIA-HK	Asendia HK	https://www.asendia.hk/cn/tracking/
ASENDIA-UK	Asendia UK	https://www.asendia.co.uk/tracking/
ASENDIA-UK-PREMIUM	Asendia UK Premium	https://watchmyparcel.com/asendia
ASENDIA-USA	ASENDIA USA	http://www.asendiausa.com/
ASM	ASM	http://www.asmred.com
ATLANTIC	Atlantic International Express	https://atlanticcourier.net/
AUEXPRESS	Auexpress	https://www.auexpress.com/order_track.php
AUSTRALIA-POST	Australia Post	https://auspost.com.au/
AUSTRIAN-POST	Austrian Post	https://www.post.at
AXLEHIRE	AxleHire	https://tracking.axlehire.com/
BETSERVICE	B&T Service	http://www.betservice.net/
BAHRAIN-POST	Bahrain Post	http://www.bahrain.bh/
BEJOT-LOGISTICS	Bejot Logistics	https://bejotlogistics.com/order/tracking/
BELPOCHTA	Belpochta	https://belpost.by/
BENIN-POST	Benin Post	http://courrier.laposte.bj/IPSWebTracking/
BH-POSTA	BH Posta	https://www.posta.ba/
BIZ-COURIER	Biz Courier	https://www.bizcourier.eu/
BLUECARE-EXPRESS	Bluecare Express	https://www.bluecare.express/Home/About
BORDER-EXPRESS	Border Express	https://www.borderexpress.com.au/tracking/?cn=
BA-POST	Bosnia And Herzegovina Post	http://www.posta.ba//en/track-trace-2/
BPOST	BPost	https://track.bpost.be
BRACCHI	Bracchi	https://www.bracchi.it/
BRAZIL-CORREIOS	Brazil Correios	http://correios.com.br/
BRT	BRT	http://www.brt.it
BUFFALO-SOUTH-AFRICA	Buffalo South Africa	https://www.buffaloex.co.za/track.html?number=
BULGARIAN-POSTS	Bulgarian Posts	https://www.bgpost.bg/en
CACESA-POSTAL	Cacesa Postal	https://www.cacesapostal.com/Tracking?q=
CAINIAO	Cainiao	https://global.cainiao.com/detail.htm?mailNoList=&spm=a3708.7860688.0.d01
CARGO-INTERNATIONAL	Cargo International	https://www.cargointernational.de/sendungsverfolgung/tracking/
CARGUS	Cargus	https://app.urgentcargus.ro/Private/Tracking.aspx
CBL-LOGISTICA	CBL Logistica	http://www.cbl-logistica.com
CDEK-EXPRESS	CDEK Express	https://www.cdek.ru/ru/tracking?order_id=
CDEK-TURKEY	CDEK Turkey	https://www.cdek.com.tr/en
CELERITAS	Celeritas	https://celeritastransporte.com/
CZECH-POST	Česká pošta	https://www.ceskaposta.cz
CEVA-LOGISTICS	Ceva Logistics	https://www.cevalogistics.com/
CHINA-EMS	China EMS	http://www.11183.com.cn/english.html
CHINA-POST	China Post	http://www.chinapost.com.cn/
CHIT-CHATS	Chit Chats	https://chitchats.com/tracking/
CHOICE-LOGISTICS	CHOICE Logistics	https://track.choicelogistics.com/elekta
CHRONOPOST-FR	Chronopost France	http://www.chronopost.fr/
CHRONOPOST-PORTUGAL	Chronopost Portugal(DPD)	https://chronopost.pt/en/node/167
CHUKOU1-LOGISTICS	Chukou1 Logistics	http://www.chukou1.com/LogistictsTrack.aspx?trackNo=
CHUNGHWA-POST	Chunghwa POST	http://postserv.post.gov.tw/pstmail/main_mail.html
CIRRO	CIRRO	https://www.cirroparcel.com/en/tracking-results/?id=&year=2023
CJ-LOGISTICS	CJ Logistics	https://www.cjlogistics.com/cn/tool/international/tracking
CNE-EXPRESS	CNE Express	http://www.cnexps.com/
COLDLINE	Coldline	https://www.coldlinegroup.com/
COLIS-PRIVE	Colis Privé	https://www.colisprive.com
COLISSIMO	Colissimo	http://www.colissimo.fr
COLLIVERY	Collivery	https://collivery.net/tracking
COMONE-EXPRESS	ComOne Express	http://www.com1logistics.com/tracking.html?trackNo=
CON-WAY-FREIGHT	Con-way Freight	https://app.ltl.xpo.com/appjs/tracking/#/tracking
COORDINADORA	Coordinadora	https://www.coordinadora.com/
CORREO-URUGUAYO	Correo Uruguayo	https://ahiva.correo.com.uy/servicioConsultaTntIps-wsWeb/seguimientoEnvios/eventosweb?codigoPieza=&retry=433
CORREOS	Correos	http://www.correos.es
CORREOS-EXPRESS	Correos Express	https://www.correosexpress.com
COSCO-EGLOBAL	COSCO eGlobal	https://elines.coscoshipping.com/ebusiness/
COURANT	Courant	https://track.aftership.com/trackings?courier=courant-plus&language=fr&tracking-numbers=
COURIER-EXPRESS-IT	Courier expres	http://www.spacecomputer-web.it/web/courier
CRONO-PTI	Crono Poste	http://www.poste-impresa.it/online/pmi/postali/italia/crono-gamma.shtml
CRONO-REVERSE	Crono Reverse	https://business.poste.it/professionisti-imprese/prodotti/crono-reverse-gestione-resi-ecommerce.html
CTC-EXPRESS	CTC Express	http://www.ctc-express.com.tw/
CTS_GROUP	CTS GROUP	https://www.ctsgroup.nl/en/
CTT	CTT	https://www.ctt.pt
CTT-EXPRESS	CTT Express	https://www.cttexpress.com/
CUBYN	Cubyn	https://www.cubyn.com/
CYPRUS-POST	Cyprus Post	https://www.cypruspost.post/
DAC-IT	D.A.C	https://dac-it.com/
DACHSER	Dachser	https://www.dachser.com/
DAI-POST	DAI Post	https://www.daipost.com/
DAO365	DAO365	https://www.dao.as/en/private/track-your-parcel?stregkode=
DAY-AND-ROSS	Day & Ross	https://dayross.com/view-shipment-tracking?division=Freight
DAYLIGHT-TRANSPORT	Daylight Transport	https://mydaylight.dylt.com/external/shipment?probill=
DBSCHENKER	DB Schenker	https://www.dbschenker.com/
DELCART	Delcart	http://www.delcart.in/tracking_details_3.php
DELNEXT	Delnext	https://www.delnext.com/IT/track_your_parcel
DEUTSCHE-POST	Deutsche Post	https://www.deutschepost.de/
DHL-DE	Deutsche Post DHL	http://www.dpdhl.com/
DEX-I	DEX-I	https://www.dexi.com.my/
DHL-ECOMMERCE	DHL eCommerce	http://webtrack.dhlglobalmail.com/
DHL	DHL Express	http://www.dhl.com/
DHL-FREIGHT	DHL Freight	https://www.logistics.dhl
DHL-GLOBAL-MAIL-ASIA	DHL Global Mail Asia	https://ecommerceportal.dhl.com/track/?ref=
DHL-HONG-KONG	DHL Hong Kong	https://www.logistics.dhl/hk-zh/home/tracking.html
DHL-PAKET	DHL Paket	https://www.dhl.de/
DHLPARCEL-CONNECT	DHL Parcel Connect	http://www.dhl.com/
DHLPARCEL-NL	DHL Parcel NL	https://www.dhlparcel.nl/
DHLPARCEL-ES	DHL Parcel Spain	https://www.dhlparcel.es
DIDADI-LOGISTICS-TECH	DIDADI LOGISTICS TECH	http://120.79.38.89/default/index/get-track-detail
DMM	DMM Network	http://www.dmmnetwork.it/
DOTZOT	Dotzot	http://dotzot.in/index-web.html
DPD	DPD	http://www.dpd.com/
DPD-HR	DPD Croatia	https://www.dpd.com/hr/en/receiving-parcels/parcel-tracking/
DPD-CZ	DPD CZ	https://www.dpdgroup.com/cz/mydpd/my-parcels/incoming?parcelNumber=
DPD-FR	DPD France	http://www.dpd.fr
DPD-IE	DPD Ireland	https://dpd.ie/tracking?deviceType=5&consignmentNumber=
DPD-NL	DPD Netherlands	https://www.dpd.com/nl/en/receiving/track/
DPD-PL	DPD Poland	https://www.dpd.com.pl/
DPD-PT	DPD Portugal	https://tracking.dpd.pt/track-and-trace?reference=
DPD-RO	DPD Romania	https://tracking.dpd.ro/
DPD-RU	DPD Russia	https://www.dpd.ru/dpd/search/search.do2
DPD-CH	DPD Switzerland	https://www.dpd.com/ch/en/mydpd/
DPD-UK	DPD UK	http://www.dpd.co.uk/
DPE-EXPRESS	DPE Express	http://www.dpe.net.cn/Tracking.php
DPEX	DPEX	https://dpex.com/track-and-trace/
DSV	DSV	http://www.dsv.com/
DX-DELIVERY	DX Delivery	https://www.dxdelivery.com/consumer/my-tracking/
EARLY-BIRD	Early Bird	https://earlybird.se/tracking/
EASY-SHIP	Easy Ship	https://www.trackmyshipment.co/shipment-tracking/
ECMS-EXPRESS	ECMS Express	https://ese.ecmsglobal.com/#/ecms/tracking?order_number=
ECOM-EXPRESS	Ecom Express	https://ecomexpress.in/tracking/?awb_field=
ECOSCOOTING	ECOSCOOTING	https://play.ecoscooting.com/tracking
ECUADOR-POST	Ecuador Post	https://www.correosdelecuador.gob.ec/rastreo-de-envios/
EFMX	eFMX	https://www.fmx.asia/cn/result_detail.php?p=1&conno=
EFS-ASIA	EFS Asia	http://web.efs.asia/script/users/tracking.php
ELOG-LUXEMBOURG	Elog Luxembourg	https://www.elog-luxembourg.com/
ELTA-HELLENIC-POST	ELTA Hellenic Post	https://www.elta.gr
EMIRATES-POST	Emirates Post	https://www.epg.gov.ae/
ENERGO-LOGISTIC	Energo Logistic	https://www.energologistic.it/
ENVIALIA	Envialia	http://www.envialia.com/
EQUICK	Equick	http://www.equick.cn/F10003.aspx
ESTAFETA-USA	Estafeta USA	https://rastreositecorecms.azurewebsites.net/Rastreo/Resultados/
ESTES	Estes	http://www.estes-express.com/WebApp/ShipmentTracking/MainServlet
EWE-GLOBAL-EXPRESS	EWE Global Express	https://www.ewe.com.au/html/track.html?cno=#track-results
EXELOT	Exelot	https://my.exelot.com/public/track/
EXPRESS-COURIER	Express Courier	https://expresscourierintl.com/tracking-results/?tracking_id=
FAR-INTERNATIONAL-LOGISTICS	Far International Logistics	https://www.far800.com/
FAROE-ISLANDS-POST	Faroe Islands Post	https://www.posta.fo/search?cc=
FAST-WL	FAST WORLD LOGISTIC	http://www.fastwl.com/
FASTWAY-NZ	Fastway New Zealand	https://www.fastway.co.nz/tools/track/
FBA-AU-SWISHIP	FBA AU Swiship	https://www.swiship.com.au/track/?id=
FBA-CA-SWISHIP	FBA CA Swiship	https://www.swiship.ca/track/?loc=zh-CN&id=*****
FBA-DE-SWISHIP	FBA DE Swiship	https://www.swiship.de/track/?id=
FBA-FR-SWISHIP	FBA FR Swiship	https://www.swiship.fr/track?id=
FBA-IT-SWISHIP	FBA IT Swiship	https://www.swiship.it/track?loc=it-IT&id=
FBA-JP-SWISHIP	FBA JP Swiship	https://www.swiship.jp/track/?loc=ja-JP&id=
FBA-UK-SWISHIP	FBA UK Swiship	https://www.swiship.co.uk/track/?id=
FBA-USA-SWISHIP	FBA USA Swiship	https://www.swiship.com/track/?id=
FEDEX	FedEx	http://www.fedex.com/
FEDEX-FIMS	Fedex FIMS	http://mailviewrecipient.fedex.com/recip_package_summary.aspx?PostalID=
FEDEX-POLAND-DOMESTIC	FedEx Poland Domestic	https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=&cntry_code=pl&locale=pl_PL
FERCAM	FERCAM Logistics	http://www.fercam.com/
FERMOPOINT	Fermopoint	https://www.fermopoint.it
FIJI-POST	Fiji Post	http://www.postfiji.com.fj/pages.cfm/services/track-trace/
FINESSO	Finesso	https://www.finesso.it/
FINLAND-POST-POSTI	Finland Post - Posti	https://www.posti.fi/private/tracking/#/?lang=en
FIRSTMILE	FirstMile	https://track.firstmile.com/detail.php?n=
FLASHEXPRESS-PH	FlashExpress PH	https://flashexpress.com/fle/tracking
FLYT-EXPRESS	Flyt Express	http://www.flytexpress.com/Home/LogisticsTracking#orderIds=
FREIGHTQUOTE	Freightquote	https://www.freightquote.com/track-shipment/?bol=
GDEX	GDEX	https://web3.gdexpress.com/official/iframe/etracking_v4.php?input=&choice=cnGdex
GEBRUDER-WEISS-GERMANY	Gebrüder Weiss Germany	https://www.gw-world.com/#/
GEIS-CZ	Geis CZ	https://www.geis-group.cz/en/tracking-tracing?p=
GEL-EXPRESS	GEL Express	https://srv4.thalmaier.de/gel/send/EN-en/TrackingAndTracing.aspx?sp=1&snr=&submit.x=13&submit.y=7
GENIKI-TAXYDROMIKI	Geniki Taxydromiki	https://www.taxydromiki.com/track/
GEODIS	Geodis	https://geodis.com/
GLOBALTR	Global Trasporti	http://www.globaltrasporti.com/
GLOBEGISTICS-INC	Globegistics Inc.	https://us.mytracking.net/globegistics/portal/ExternalTracking.aspx?track=
GLS-ITA	GLS	http://www.gls-italy.com
GLS-AT	GLS Austria	https://gls-group.com/AT/en/home
GLS-CA	GLS Canada	https://gls-canada.com/en/express/tracking/result
GLS	GLS Europe	https://gls-group.eu/
GLS-EUROPE-WW	GLS Europe WW	https://gls-group.eu/GROUP/en/home
GLS-FR	GLS France	https://gls-group.eu/FR/fr/home
GLS-DE	GLS Germany	https://www.gls-pakete.de/en/parcel-tracking?match=
GLS-PL	GLS Poland	https://gls-group.com/PL/en/parcel-tracking
GLS-SK	GLS Slovakia	https://gls-group.eu/SK/en/parcel-tracking.html?match=
GLS-SPAIN	GLS Spain	https://m.gls-spain.es/
GLS-US	GLS US	https://www.gls-us.com/Tracking/PackageDetail
GO-EXPRESS	GO! Express & Logistics	https://www.general-overnight.com
GOGLOBAL-POST	Goglobal Post	https://www.goglobalpost.com/track-detail/?t=
GRAND-SLAM-EXPRESS	Grand Slam Express	http://icms.grandslamexpress.in/webtracking/WebTracking.aspx
GUERNSEY-POST	Guernsey Post	https://www.guernseypost.com/track-trace
HAPPY-POST	Happy Post	https://happy-post.com/en/track/
HEPSIJET	HepsiJET	https://www.hepsijet.com/gonderi-takibi/
HERMES-DE	Hermes Germany	https://www.myhermes.de
HERMES-IT	Hermes Italy	http://www.hermes-italy.it/
HERMES	Hermes UK	https://www.myhermes.co.uk
HKD	HKD	http://www.hkdexpress.net/index.php?m=track&a=index
HONG-KONG-POST	Hong Kong Post	https://www.hongkongpost.hk/en/home/index.html
HOTWMS	HOTWMS	http://www.hotwms.com/trace.html
HRP	HR Parcel	https://www.hrparcel.com/
HRVATSKA-POSTA	Hrvatska pošta	https://www.posta.hr
HUA-HAN-LOGISTICS	Hua Han Logistics	http://www.hhddb.com/default/index/get-track-detail
HUNTER-EXPRESS	Hunter Express	https://www.hunterexpress.com.au/tracking/
ICS-COURIER	ICS courier	https://www.icscourier.ca/online-services/parcel-tracking.aspx
IDS-GERMANY	IDS Germany	https://www.ids-logistik.de/de/sendungsverfolgung?trackingNumber=
IMILE	iMile	https://www.imile.com/track/
INPOST	InPost	https://inpost.it/
INSTALLO	Installo	https://www.installo.it/
INTEGRA2	Integra2	https://www.integra2.es/
INTELCOM	Intelcom	https://intelcomexpress.com/en/tracking/
INTEXPRESS	Intexpress	http://www.internetexpress.co.za/Home/TrackWBOnline
JT-BRAZIL	J&T Brazil	https://www.jtexpress.com.br/trajectoryQuery?waybillNo=
JT-EXPRESS	J&T Express	https://www.jet.co.id/track
JT-EXPRESS-PHILIPPINES	J&T Express Philippines	https://www.jtexpress.ph/index/query/gzquery.html
JT-EXPRESS-THAILAND	J&T Express Thailand	https://www.jtexpress.co.th/service/estimated-price
JT-EXPRESS-UAE	J&T Express UAE	https://www.jtexpress.ae/trajectoryQuery?waybillNo=&type=0
JANCO-ECOMMERCE	Janco Ecommerce	https://track.jancoecommerce.com/cargotracking_ecom/itxp/xpop/xpordertrack?as_order_no=
JCEX	JCEX	https://www.jcex.com/html/web/guijichaxun/index.html?nums=
JD-EXPRESS	JD Express	http://www.jdwl.com/order/search?waybillCodes=
JERSEY-POST	Jersey Post	https://www.jerseypost.com/
JNE	jne	https://cekresi.jne.co.id/
JTEXPRESS-VN	jtexpress-vn	https://jtexpress.vn/track?billcodes=&btn_track=
JUSDASR	JusdaSR	https://jusdaeurope.com/en/package-tracking/
KANGAROO-WORLDWIDE-EXPRESS	Kangaroo Worldwide Express	http://www.kangaroo.com.my/
KERRY-ECOMMERCE	Kerry eCommerce	https://kerry-ecommerce.com/en/track-trace/
KERRY-EXPRESS-TH	Kerry Express TH	https://th.kerryexpress.com/en/track/?track=
KERRY-EXPRESS-VN	Kerry Express VN	https://kerryexpress.com.vn/tracking.aspx?tc=
KERRY-LOGISTICS	Kerry Logistics	http://www.expba.com/emmis/www.kerryeas.com.html
KERRY-TJ-LOGISTICS	Kerry TJ Logistics	https://www.kerrytj.com/en/
KINTETSU-WORLD-EXPRESS	Kintetsu World Express	https://www.kwe.com
KOMON-EXPRESS	KOMON EXPRESS	http://www.komonexpress.com/
KOREA-POST	Korea Post	https://www.epost.go.kr
KYOUNGDONG	KYOUNGDONG
LA-POSTE	La Poste	https://www.laposte.fr/
LATAM-YOU	LATAM YOU	https://latamyou.com/#/newTrack?no=
LATVIJAS-PASTS	Latvijas Pasts	https://pasts.lv/
LBC-EXPRESS	LBC Express	https://www.lbcexpress.com/us/track/?tracking_no=
LD-LOGISTICS	LD Logistics	http://www.ldlog.com.cn/cxwl.asp
LEBANON-POST	Lebanon Post	https://www.libanpost.com/arabic/individuals/mailing
LEXSHIP	Lexship	https://track.lexship.com/
LICCARDI	Liccardi Trasporti	https://www.liccarditrasporti.com/
LIECHTENSTEIN-POST	Liechtenstein Post	https://www.tnt.com/express/de_ch/site/home/applications/tracking.html?searchType=CON&cons=
LIEFERGRUN	Liefergrün	https://en.liefergruen.de/sendungsverfolgung
LIETUVOS-PASTAS	Lietuvos PaÅ¡tas	https://www.post.lt/
LM-PARCEL	LM Parcel	https://www.lmparcel.com/search?nums=
LOGISTERS	Logisters	http://193.112.169.101:8082/en/trackIndex.htm
LONE-STAR-OVERNIGHT	Lone Star Overnight	https://www2.lso.com/access/package-tracking?seo_redirect=1
LP-EXPRESS	LP Express
LUXEMBOURG-POST	Luxembourg Post	https://www.post.lu
LWE	LWE	http://www.lwe.com.hk/tracking
MACEDONIA-POST	Macedonia Post	https://www.posta.com.mk/
MAGYAR-POSTA	Magyar Posta	https://www.posta.hu/
MBE-ES	Mail Boxed Etc	https://www.mbe.es/es/tracking?c=
MBE-IT	Mail Boxes Etc. Italia	https://www.mbe.it/
MAILAMERICAS	MailAmericas	http://tracking.mailamericas.com/search
MALTA-POST	Malta Post	https://www.maltapost.com/
MEEST-EXPRESS	Meest Express	https://t.meest-group.com/en
MOLDOVA-POST	Moldova Post	http://www.posta.md/en/tracking?id=
MONDIALRELAY	Mondial Relay	https://www.mondialrelay.fr
MONTENEGRO-POST	Montenegro Post	https://e-racuni.postacg.me/PracenjePosiljaka/
MRW-ES	MRW	http://www.mrw.es/
NACEX-ES	Nacex	https://www.nacex.es/
NANJING-WOYUAN	Nanjing Woyuan	http://www.nanjingwoyuan.com/
NEWAY	Neway	https://esmart.newaytransport.com/v6/tracking/Track.external?refno=
NEXIVE	Nexive	http://www.nexive.it/
NINJA-VAN-MALAYSIA	Ninja Van Malaysia	https://www.ninjavan.co/en-my
NINJA-VAN-SINGAPORE	Ninja Van Singapore	https://www.ninjavan.co/en-sg/tracking?id=
NINJA-VAN-VIETNAM	Ninja Van Vietnam	https://www.ninjavan.co/en-vn/tracking?id=
NIPPON-EXPRESS	Nippon Express
NOPAR	Nopar Solutions	http://noparsolutions.com/
NOVA-POSHTA	Nova Poshta	https://novaposhta.ua/tracking/index/cargo_number//no_redirect/1
NT-LOGISTICS-VN	NT Logistics VN	https://www.ntlogistics.vn/chi-tiet-van-don.html?bill=
NZCOURIERS	NZCouriers	https://www.nzcouriers.co.nz/nzc/servlet/ITNG_TAndTServlet?barcode_data=&page=1&VCCA=Enabled&Key_Type=BarCode#Detail_0
OMAN-POST	Oman Post	https://www.omanpost.om/track-trace
OMNI-PARCEL	Omni Parcel	http://track.omniparcel.com/?id=
OMNIVA	Omniva	https://www.omniva.ee
ONEXP	One Express	http://www.oneexpress.it
ONTRAC	OnTrac	http://www.ontrac.com
ORANGE-CONNEX	Orange Connex	http://www.orangeconnex.com.cn/tracking
ORANGEDS	OrangeDS	https://tracking.orangeds.com/
OVERSEAS-TERRITORY-US-POST	Overseas Territory US Post	https://tools.usps.com/go/TrackConfirmAction_input
PAACK	Paack
PACKETA	Packeta	https://tracking.packeta.com/
PALLETW	Palletways	http://www.palletways.com
PALLEX	Pallex	https://www.pallex.it/
PANDU-LOGISTICS	Pandu Logistics	https://pandulogistics.com/track
PARCEL-FORCE	Parcel Force	http://www.parcelforce.com
PARGO	Pargo	https://pargo.co.za/track-trace/
PCA	PCA	https://www.pcaexpress.com.au/tracking/?c=
PFC-EXPRESS	PFC Express	http://www.pfcexpress.com/Manage/WebManage/Inquire.aspx?txtID=No
PICKRR	Pickrr	https://pickrr.com/tracking/#/?tracking_id=
PICKUPP	Pickupp	https://hk.pickupp.io/en/tracking
PIDGE	Pidge	https://tracking.pidge.in/login
PITNEY-BOWES	Pitney Bowes	https://trackpb.shipment.co/track
PITT-OHIO	Pitt Ohio	https://pittohio.com/myPittOhio/Shipping/LTL/TraceRequest
POCZTA-POLSKA	Poczta Polska	http://www.poczta-polska.pl
PONYU	PonyU
POS-MALAYSIA	Pos Malaysia	https://www.pos.com.my/
POST-HASTE	Post Haste	https://www.posthaste.co.nz/phl/servlet/ITNG_TAndTServlet?page=1&VCCA=Enabled&Key_Type=BarCode&barcode_data=
POST-ONE	Post One	https://postone.eu/en/track?code=
POSTA-ROMANA	Poșta Română	https://www.posta-romana.ro/
SLOVENIA-POST	Pošta Slovenije	https://www.posta.si
POSTAPLUS	PostaPlus	https://www.postaplus.com/?trackid=
PTI	Poste Italiane	http://www.poste.it
MILKMAN	PosteGoFresh	https://www.milkman.it/
POSTEN-NORGE	Posten Norge	https://www.posten.no/
POSTI	Posti	https://www.posti.fi/
POSTNL-INT	PostNL International	http://www.postnl.post/
POSTNL-3S	PostNL International 3S	https://www.internationalparceltracking.com
POSTNORD-DENMARK	PostNord Denmark	https://www.postnord.dk
POSTNORD-SWEDEN	PostNord Sweden	https://www.postnord.se/
PRESSIODE	Pressiode	http://pressiode.de/sendungsverfolgung
PRO-CARRIER	Pro Carrier	https://tracking.weareprocarrier.com/?tn=
PUROLATOR	Purolator	https://www.purolator.com/purolator/ship-track/tracking-summary.page
QHD	QHD	https://www.qhditalia.it/
QUIKENMX	QuikenMx	https://api.quiken.mx/track
RAIDEREX	RaidereX	https://app.detrack.com/w/#/tracking/s/c2ed7ab0c381d61e1959731ff286cbb0ba590cb4
RDA	Ramoneda	http://www.ramoneda.com/
REDUR	Redur
RHENUS	Rhenus Italia	https://www.rhenus.group/it/it/
RL-CARRIERS	RL Carriers	https://www.rlcarriers.com/shiptrace.asp
ROADRUNNER-FREIGHT	Roadrunner Freight	http://tools.rrts.com/LTLTrack/?searchValues=
ROYAL-MAIL	Royal Mail	http://www.royalmail.com
RPOST	RPost	https://www.errepost.it/
RUSSIAN-POST	Russian Post	https://www.pochta.ru
RUSTON	Ruston	http://www.ruston.cc/customer/xiaojianchaxun.html
RZY-EXPRESS	RZY Express	http://rzyexpress.com.sg/track.php
SF-EXPRESS	S.F. Express	http://www.sf-express.com
SAGAWA-GLOBAL	Sagawa Global	https://tracking.sagawa-sgx.com/sgx/trackeng.asp?enc=ENG&cat=AWB&awb=
SAIA-LTL-FREIGHT	Saia LTL Freight	https://www.saia.com/track
SAILPOST	Sailpost	http://www.sailpost.it
SMM-IT	San Marino Mail	http://www.sanmarinomail.sm
SAN-MARINO-POST	San Marino Post	https://www.poste.sm/on-line/home/servizi/servizi-on-line/tracciatura-oggetti-a-firma.html#service
SAP-EXPRESS	SAP Express	https://www.sap-express.id/en/track-awb
SAUDI-POST	Saudi Post	https://splonline.com.sa/en/shipmentdetailsstatic/?tid=
SDA	SDA	http://wwww.sda.it
SDA-RACCOMANDATA	SDA Raccomandata	http://wwww.sda.it
SDK-EXPRESS	SDK Express	http://www.sdk-express.cn/track.aspx
SENDABOX	Sendabox	http://www.sendabox.it
SENDING	Sending Transporte Urgente	https://www.sending.es
SETEL-EXPRESS	Setel Express	https://track.setel.com/t/
SEUR	Seur	http://www.seur.com
SF-INTERNATIONAL	SF International	http://www.sf-express.com/us/en/dynamic_function/waybill/#search/bill-number/
SGT	SGT Corriere Espresso	http://www.sgt.it/
SHIP-IT-ASIA	Ship It Asia	https://viewider.com/labs/shipment/track
SHIPA	Shipa	https://tracking.shipadelivery.com/?bc=
SHIPENTEGRA	ShipEntegra	https://track.shipentegra.com/result
SHIPROCKET	Shiprocket	https://www.shiprocket.in/shipment-tracking/
SHOPEE-EXPRESS-PHILIPINES	Shopee Express Philipines	https://spx.ph/#/detail/
SHOPEE-EXPRESS-VIETNAM	Shopee Express Vietnam	https://spx.vn
SHREE-ANJANI-COURIER	Shree Anjani Courier	http://anjanicourier.in/Doc_Track.aspx?No=
SINGAPORE-POST	Singapore Post	https://www.singpost.com/
SINOTRANS	Sinotrans	http://www.sinotrans-csc.com/
SKY-POSTAL	SKY Postal	https://tracking.skypostal.com/single-tracking.aspx?trck_number=
SKYNET-ITA	SkyNet Italy	http://www.skynetitaly.it
SKYNET-SOUTH-AFRICA	Skynet South Africa	https://api.skynet.co.za:3227/api/waybill/getWaybillTracking/?waybillReference=
SKYNET	SkyNet Worldwide Express	http://www.skynetwwe.com/
SLOVAK-PARCEL-SERVICE	Slovak Parcel Service	https://www.sps-sro.sk/en/track-trace/
SLOVAKIA-POST	Slovakia Post	https://tandt.posta.sk/en
SMSA-EXPRESS	SMSA Express	http://www.smsaexpress.com/Track.aspx?tracknumbers=
SOUTH-AFRICAN-POST	South African Post	https://www.postoffice.co.za
SPEDIAMO	Spediamo.it	http://www.spediamo.it/
SPEE-DEE-DELIVERY	Spee-Dee Delivery	https://speedeedelivery.com/track-a-shipment/
SPEED-POST	Speed Post
SPEEDAF-EXPRESS	Speedaf Express	https://speedaf.com/cn-cn
SPRING-GDS	Spring GDS	https://www.spring-gds.com/
STALLION-EXPRESS	Stallion Express	https://stallionexpress.ca/tracking/
STARKEN	Starken	https://www.starken.cl/
STEF-IT	STEF	https://www.stef.it/
STO-EXPRESS	STO Express	http://www.sto.cn
SUSA	Susa	https://flex.susa.it/Home
SWISS-POST	Swiss Post	https://www.post.ch/
SZENDEX	Szendex	https://erp.szendex.com/DlWebTrackingVWE/?seg=
T-CAT	T Cat	https://www.t-cat.com.tw/inquire/explain.aspx
TWS	T.W.S. Express Courier	http://www.twsexpresscourier.it
TEAM-GLOBAL-EXPRESS	Team Global Express	https://teamglobalexp.com/
TECNO-TRANS	Tecnotrans	http://www.tecnotrans.eu
TEMPO-ONE	Tempo One	https://www.tempo-one.com/
TFORCE-FREIGHT	TForce Freight (UPS Freight)	https://www.tforcefreight.com/ltl/apps/Tracking?proNumbers=
THABIT-LOGISTICS	Thabit Logistics	https://thabit-logistics.com/track-shipment
TPC	The Professional Couriers (TPC)	https://www.tpcindia.com/Default.aspx
TIPSA	TIPSA	http://www.tip-sa.com/
TNT	TNT	http://www.tnt.com
TNT-AUSTRALIA	TNT Australia	https://www.tntexpress.com.au/interaction/trackntrace.aspx
TNT-CLICK	TNT Click	http://www.tnt-click.it
TNT-ES	TNT España	http://www.tnt.es
TNT-FRANCE	TNT France	http://www.tnt.fr/
TNT-ITA	TNT Italia	https://www.tnt.it/
TNT-UK	TNT UK	http://www.tnt.com/express/en_gb/site/home.html
TOLL	Toll Group	https://www.tollgroup.com/
TOURLINE-EXPRESS	Tourline Express	http://www.tourlineexpress.com
TRACKNATOR	Tracknator	https://www.tracknator.com/#/track/
TRACKON-COURIER	Trackon Courier	http://trackoncourier.com/default.aspx
TRAKPAK	Trakpak	http://www.trackmytrakpak.com
TRANSAHER	Transaher	https://transaher.es/
TRUNKRS	Trunkrs	https://parcel.trunkrs.nl/
TTKD-EXPRESS	TTKD Express	http://www.ttkdex.com/staticFiles/pages/queryExpress.html
TYP	TYP	https://typ.delivery
UK-MAIL	UK Mail	https://www.dhl.com/gb-en/ecommerce/business-users/uk-mail.html
UNITED-DELIVERY-SERVICES	United Delivery Services	http://www.uniteddeliveryservice.com/packageTrack.php
UNIUNI	UniUni	https://uniexpress.ca/tracking?no=
UPS	UPS	http://www.ups.com/
UPS-GROUND	UPS Ground	https://www.ups.com/track?loc=en_US&tracknum=&requester=WT
UPS-MAIL-INNOVATIONS	UPS Mail Innovations	https://tracking.ups-mi.net/packageID/
USPS	USPS	https://www.usps.com/
V-XPRESS	V-Xpress	http://www.vxpress.in/track/
VENIPAK	Venipak	https://venipak.com/tracking/track/
VIETNAM-POST	Vietnam Post	http://www.vnpost.vn/en-us/dinh-vi/buu-pham?key=
VIETTEL-POST	Viettel Post	http://en.viettelpost.com.vn/
WE-WORLD-EXPRESS	We World Express	https://www.weworldexpress.com/wwe/track
WEDO-LOGISTICS	WeDo Logistics	https://www.wedo.cz/
WHISTL	Whistl	https://trackmyitem.whistl.co.uk/tracking/
WINIT	Winit	http://track.winit.com.cn/tracking/index.php?s=/Index/result
WISHPOST	WishPost	https://wishpost.wish.com/tracking
WIZMO	Wizmo	https://shipwizmo.com/tracking
WNDIRECT	wnDirect	https://wndirect.com/tracking.php?type=OR&ref=&submit=#
XDP-EXPRESS	XDP Express	https://www.xdp.co.uk/track.php?c=00000&code=000
XPO-LOGISTICS	XPO Logistics	https://track.xpoweb.com/ltl-shipment/
XPRESSPOST	xpresspost	https://www.canadapost.ca/trackweb/en#/search?searchFor=
XQ-EXPRESS	XQ Express	http://121.40.73.213:8082/trackIndex.htm
YAKIT	Yakit	https://shipping.yakit.com/tracking?yakitId=
YAMATO	Yamato Transport
YANWEN	Yanwen	http://www.yw56.com.cn/
YDH	Ydh	http://www.ydhex.com/
YODEL	Yodel Domestic	http://www.yodel.co.uk/
YTO-EXPRESS	YTO Express	http://www.yto.net.cn/gw/service/Shipmenttracking.html
YUNEXPRESS	Yun Express	http://www.yunexpress.com/
YUNDA-EXPRESS	Yunda Express	http://www.udalogistic.com/index
YURTICI-KARGO	Yurtici Kargo	https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code=
ZAJIL	Zajil	https://zajil-express.com/en/
ZELERIS-ES	Zeleris	https://www.zeleris.com/
ZIM-LOGISTICS	ZIM Logistics	https://www.zim-logistics.com.cn/
ZJS-INTERNATIONAL	ZJS International	http://www.zjs.com.cn/yscp/index.jhtml
ZTO-EXPRESS	ZTO Express	https://www.zto.com/express/expressCheck.html?txtBill=
ZTO-INTERNATIONAL	ZTO International	http://kh.zto.com/kh-en/
ZUFALL-GERMANY	Zufall Germany	https://tracking.myzufall.de/Track/
ZUST	Züst Ambrosetti	http://www.zust.it/

Default	G	Q
Default	0	0
ARCO	G	Q
Arco standard	0	0
Arco urgente	1	1
Arco espresso	2	2
ASENDIA	G	Q
e-PAQ Plus	31
e-PAQ Select	32
BRT	G	Q
Express	0	0
Priority	1	E
10:30	2	H
Circuito DPD	6	6
Circuito Euroexpress	7	7
Circuito Fedex	8	8
DPD Direct Infeed	9	9
CORREOS	G	Q
Domestic
PAQUETE POSTAL PRIORITARIO (I)	20
POSTAL EXPRéS (I)	21
PAQ Estándar DOMICILIO	22
PAQ Estándar OFICINA	23
PAQ RETORNO PREMIUM CON Envío ASOCIADO	25
S0148 PAQ RETORNO	26
PAQ PREMIUM DOMICILIO	27
PAQ PREMIUM EN OFICINA	28
PAQUETE POSTAL Económico (I)	30
PAQ PREMIUM ENTREGA EN HOMEPAQ	31
PAQ PREMIUM ENTREGA EN CITYPAQ	32
PAQ Estándar ENTREGA EN HOMEPAQ	33
PAQ Estándar ENTREGA EN CITYPAQ	34
International
PAQ STANDARD INTERNACIONAL (I)	24
PAQ PREMIUM INTERNACIONAL (I)	29
PAQ INTERNACIONAL LIGH	35
CORREOS-EXPRESS	G	Q
Domestic
Paq 10	20	20
Paq 14	21	21
Paq 24	22	22
Baleares Express	23	23
Canarias Express	24	24
Canarias Aéreo	25	25
Canarias Marítimo	26	26
Paq Empresa 14		29
ePaq 24		30
54 Entrega Plus	31	31
Express Islands		32
International
Paq 24		22
Internacional Estándar	27	27
Internacional Express	28	28
Paq Empresa 14	29	29
ePaq 24	30	30
54 Entrega Plus		31
CTT-EXPRESS	G	Q
Domestic
CTT 10		C10
CTT 14		C14
CTT 24		C24
CTT 48		C48
CTT BALEARES ECONOMY		CBA48
CTT BALEARES EXPRESS		CBA24
CTT CANARIAS AEREO		CCA24
CTT CANARIAS DOCUMENTACIÓN		CCAE
CTT CANARIAS MARÍTIMO		CCAM
International
CTT INTERNACIONAL ECONOMY		CIES
CTT INTERNACIONAL EXPRESS		CIEX
Crono	G	Q
Domestic
Express	2	P46
Economy	3	P49
Crono	1	P44
CRONOPLUS	5
ROAD EUROPE - EURODIS	6
Circuito Euroexpress	7
International
Internazionale	8	P48
DHL PARCEL CONNECT	G	Q
Domestic
DHL Parcel Connect		connect
DHL Parcel Connect PLUS		connectPlus
International
DHL Parcel International		international
DHL-PAKET	G	Q
Domestic
Paket	0	0
International
WeltPaket	6	6
Dhl	G	Q
Domestic
Domestic Express	0
Domestic Express 10:30	2
Domestic Express 12:00	1
Domestic Express 9:00	4
Express Easy	21
International
Economy Select	8
Medical Express	20
Parcel Product	22
Express Worldwide H12	7
International Express Worldwide	9
International Express 9:00	10
FERCAM	G	Q
BOOK	0
FLEX	2
FIX	1
SPEED	3
Private	5
HD (check "assemblyTypes")	20
FedEx	G	Q
Domestic
FedEx First		12
FedEx Priority Express		13
FedEx Priority		14
FedEx Economy		15
FedEx Priority Express Freight		16
FedEx Priority Freight		17
International
Priority	6
First	7
Economy	8
Connect plus	10
Regional Economy	11
GLS-AT	G	Q
PARCEL		PARCEL
EXPRESS		EXPRESS
FREIGHT		FREIGHT
GLS-ES	G	Q
CO1 - COURIER 14:00 Service	20
CO2 - COURIER BusinessParcel	21
CO3 - COURIER 10:00 Service	22
CO4 - COURIER SaturdayService	23
CO5 - COURIER MASIVO	24
CO6 - COURIER REC. EN NAVE	25
EC1 - EconomyParcel EconomyParcel	26
CA1 - CARGA MARITIMO	27
CO7 - COURIER ParcelShop	28
EC2 - EconomyParcel ParcelShop	29
EU1 - EUROBUSINESS PARCEL EBP	30
EU2 - EUROBUSINESS SMALL PARCEL EBP	31
AS1 - ASM TRAVELLERS ASM TRAVELLERS	32
Express 19:00	37
INPOST	G	Q
InPost Locker Standard		1
A2L - InPost Locker Standard		4
Liccardi	G	Q
Bancale		B
Dedicato		DE
Espresso		E
Reso		R
Store		ZS
MRW-ES	G	Q
Urgente 10		0000
Urgente Hoy - Frecuencia 1		0005_1
Urgente Hoy - Frecuencia 2		0005_2
Promociones		0010
Urgente 10 Expedición		0015
Urgente 12		0100
Urgente 12 Expedición		0105
Urgente 14		0110
Urgente 14 Expedición		0115
Urgente 19		0200
Urgente 19 Expedicion		0205
Urgente 19 Portugal		0220
Bag 19		0230
Bag 14		0235
Economico		0300
Economico Interinsular		0350
Marítimo Baleares		0370
Marítimo Canarias		0385
Marítimo Interinsular		0390
Express Documentos		0400
Express 2 Kilos		0450
Caja Express 3 Kilos		0480
Documentos 14		0490
Ecommerce		0800
Tramo Orario 08-14		0800_tramo_1
Tramo Orario 16-19		0800_tramo_2
Ecommerce Ultrarrápido - Frecuencia 1		0800_1
Ecommerce Ultrarrápido - Frecuencia 2		0800_2
Ecommerce Canje		810
Milkman	G	Q
Standard	0
Premium	1
NACEX ES	G	Q
NACEX 10:00H	20
NACEX 12:00H	21
INTERDIA mañana	22
INTERDIA tarde	23
INTERDIA aéreo	24
PLUS BAG 1	25
PLUS BAG 2	26
VALIJA	27
VALIJA IDA Y VUELTA	28
NACEX 19:00H	29
PUENTE URBANO mañana	30
PUENTE URBANO tarde	31
PUENTE URBANO nocturno.	32
DEVOLUCION ALBARAN CLIENTE	33
NACEX 08:30H	34
DEVOLUCION TALON	35
DEVOLUCION PLUS BAG 1	36
DEVOLUCION PLUS BAG 2	37
DEVOLUCION E-NACEX	38
NACEX SABADO	39
CANARIAS MARITIMO	40
CANARIAS 24H	41
PLUS PACK	42
E-NACEX	43
PREMIUM	44
NX-SHOP VERDE	45
NX-SHOP NARANJA	46
E-NACEX SHOP	47
C@MBIO	48
CANARIAS 48H	49
INMEDIATO	50
NACEX.SHOP	51
SWAP	52
RETORNO SWAP	53
DEV. ORIGEN	54
EURONACEX TERRESTRE	55
SERVICIO AEREO	56
EURONACEX ECONOMY	57
PLUSPACK EUROPA	58
BALEARES MARITIMO	59
NEXIVE	G	Q
Sistema Completo	0
Sistema Economy	2
Sistema Slim	1
Sistema Espresso	3
PAACK	G	Q
ST2 - Same day delivery - Timeslot available - 2 hours		ST2
PT2 - Precise day delivery - Timeslot available - 2 hours		PT2
CT2 - Two-day delivery - Timeslot available - 2 hours		CT2
WT2 - Any day delivery - Timeslot available - 2 hours		WT2
ST3 - Same day delivery - Timeslot available - 3 hours		ST3
ST4 - Same day delivery - Timeslot available - 4 hours		ST4
NT4 - Next day delivery - Timeslot available - 4 hours		NT4
PT4 - Precise day delivery - Timeslot available - 4 hours		PT4
CT4 - Two-day delivery - Timeslot available - 4 hours		CT4
WT4 - Any day delivery - Timeslot available - 4 hours		WT4
STH - Same day delivery - Timeslot available - morning or evening slots		STH
NTH - Next day delivery - Timeslot available - morning or evening slots		NTH
PTH - Precise day delivery - Timeslot available - morning or evening slots		PTH
CTH - Two-day delivery - Timeslot available - morning or evening slots		CTH
WTH - Any day delivery - Timeslot available - morning or evening slots		WTH
PTA - Precise day delivery - Timeslot available - All day		PTA
STZ - Same day delivery - Timeslot available - Other		STZ
NTZ - Next day delivery - Timeslot available - Other		NTZ
PTZ - Precise day delivery - Timeslot available - Other		PTZ
CTZ - Two-day delivery - Timeslot available - Other		CTZ
WTZ - Any day delivery - Timeslot available - Other		WTZ
XTZ - Same day / express delivery - Timeslot available - Other		XTZ
SF2 - Same day delivery - Fixed timeslot - 2 hours		SF2
NF2 - Next day delivery - Fixed timeslot - 2 hours		NF2
PF2 - Precise day delivery - Fixed timeslot - 2 hours		PF2
CF2 - Two-day delivery - Fixed timeslot - 2 hours		CF2
WF2 - Any day delivery - Fixed timeslot - 2 hours		WF2
XF2 - Same day / express delivery - Fixed timeslot - 2 hours		XF2
SF4 - Same day delivery - Fixed timeslot - 4 hours		SF4
NF4 - Next day delivery - Fixed timeslot - 4 hours		NF4
PF4 - Precise day delivery - Fixed timeslot - 4 hours		PF4
CF4 - Two-day delivery - Fixed timeslot - 4 hours		CF4
WF4 - Any day delivery - Fixed timeslot - 4 hours		WF4
XF4 - Same day / express delivery - Fixed timeslot - 4 hours		XF4
NFA - Next day delivery - Fixed timeslot - All day		NFA
PFA - Precise day delivery - Fixed timeslot - All day		PFA
CFA - Two-day delivery - Fixed timeslot - All day		CFA
WFA - Any day delivery - Fixed timeslot - All day		WFA
NFZ - Next day delivery - Fixed timeslot - Other		NFZ
PFZ - Precise day delivery - Fixed timeslot - Other		PFZ
CFZ - Two-day delivery - Fixed timeslot - Other		CFZ
WFZ - Any day delivery - Fixed timeslot - Other		WFZ
XFZ - Same day / express delivery - Fixed timeslot - Other		XFZ
PS2 - Precise day delivery - Fixed timeslot - 2 hours (custom)		PS2
Poste Delivery Business	G	Q
Domestic
Standard nazionale	0	APT000902
Espresso nazionale	1	APT000901
International
Standard internazionale		APT000904
Espresso internazionale		APT000903
SDA	G	Q
Extralarge	0	S09
Internazionale	8	S08
Economy	3	S24
Road Europe	7	S34
Export Box	6	S36
Crono Internazionale		P48
SEUR	G	Q
Domestic
SEUR 24	20
SEUR 10	21
SEUR 13:30	22
SEUR FRIO 10	27
SEUR FRIO 13:30	28
Seur FRIO 48 (Baleares)	29
Seur 13 Saturday	30
Seur 24 PICKUP	31
International
Seur Internacional NON EU	23
Seur Classic (DPD) Internacional Terrestre	24
Seur Classic (DPD) Predict Crossborder	25
Seur NetExpress (SEUR) Internacional Terrestre	26
Seur Classic 2SHOP	32
SMM-IT	G	Q
AT_DPD_PRIME_GEN	20
AT_POST_0584	21
AT_POST_B2C	46
BE_G3_STA	22
BE_TOO_BP	47
CH_SWP_PPECO	23
DE_490_WINE	24
DE_DHL_STA_POST	25
DE_DPD_B2C	26
DE_HERM_DROPOFF	27
DE_HERM_STA	28
DE_HERM_WINE	29
DE_DHL_PAKET_WEBSERVICE	43
ES_CORR_DROPOFF	30
ES_CORR_STA	31
FR_COL_SFS	44
FR_GLS_ADO	32
FR_GLS_STA	33
FR_GLS_WINE	34
FR_LPF_OTH	35
FR_MONDIAL_DROPOFF	36
INT_DHL_ECO	37
INT_DHL_EXPMB	38
IT_GLS_LIGHT	39
IT_SDA_MULTI	40
NL_G3_STA	41
PT_CORR_RAN	42
ES_PAA_STA	45
SkyNet Worldwide Express	G	Q
Domestic
Domestic Express	0
Domestic Express 1/5000	1
Express Documents	6
Express Non Documents	7
SKYSAVER	8
International
USA Deferred	9
USA Economy Service	10
Spring GDS	G	Q
TRCK - TRACKED	20	20
SIGN - SIGNATURED	21	21
PPTT - PostNL Packet Tracked	30	30
PPTR - PostNL Packet Registered	31	31
PPNT - PostNL Packet Non Tracked	32	32
CLLCT - Spring Collect Service		33
TRPL - Tracked Plus		34
SIPL - SIGNATURED		35
TIPSA	G	Q
20 - DELEGATION	20
48 - ECONOMY	21
25 - FARMA	22
96 - MARITIMA	23
24 - PREMIUM	24
06 - TIPSA 06	25
10 - TIPSA 10	26
14 - TIPSA 14	27
MV - TIPSA,	28
50 - YUPICK	29
TNT ES	G	Q
Domestic
Express	40
10:00 Express	42
12:00 Express	44
Express Plus	46
International
Economy Express	20
12:00 Economy Express	21
Express	22
9:00 Express	24
10:00 Express	26
12:00 Express	28
TNT IT	G	Q
Domestic
Nazionale Express	0	0
Nazionale 12:00 Express	1	1
Nazionale 10:00 Express	2	2
Nazionale Economy Express	3	3
International
Internazionale Express	6	6
Internazionale 12:00 Express	7	7
Internazionale Economy Express	8	8
Internazionale 12:00 Economy Express	9	9
TWS	G	Q
ESPRESSO		ESPRESSO
CAMIONISTICO		CAMIONISTICO
TWSPACKETEXP		TWSPACKETEXP
TWSPACKETCAM		TWSPACKETCAM
TWSPACKETDOC		TWSPACKETDOC
ESPRESSOGLS		ESPRESSOGLS
UPS	G	Q
Domestic
Nazionale Express Saver	0	0
Nazionale Express	1	1
Nazionale Express Plus	2	2
Nazionale Standard	3	3
International
Internazionale Express	6	6
Internazionale Express Plus	7	7
Internazionale Standard	8	8
Internazionale Saver	9	9
Expedited	10	10
USA Next day air	21	21
USA 2nd day air	22	22
USA Ground	23	23

ARCO
Preavviso telefonico	S
Sponda idraulica	X
ASENDIA
Economy	ECO
Signature	SIG
PUDO	PUDO
Mailbox	MBX
Predict next day	PND
Predict two days	P2D
Saturday	SAT
Evening delivery	ED
Timed delivery by 10.00	1000
Timed delivery by 12.00	1200
Dangerous Goods	DG
Address correction	AC
POD	POD
Flex	FLX
Enhanced liability 500 €	EL500
Enhanced liability 45 €	EL45
Enhanced liability 150 €	EL150
Sea	SEA
Personal Delivery	PD
BRT
su appuntamento	A
consegna al piano	P
servizio fresh	FRESH_YYYY-MM-DD
CORREOS
Código Oficina (máximo 7 caracteres)
CORREOS EXPRESS
Entrega el sábado	sabato
FERCAM
Al piano	alPiano
Sponda	sponda
Prenotazione telefonica	appuntamento
GLS AT
08:00 Service	0800Service
09:00 Service	0900Service
10:00 Service	1000Service
12:00 Service	1200Service
Saturday 10:00 Service	Saturday1000Service
Saturday 12:00 Service	Saturday1200Service
Saturday Service	SaturdayService
GLS-ITA
EXPRESS 12	22
FLEX DELIVERY PARCEL	31
SMART DELIVERY SERVICE	39
EXCHANGE	24
CONSEGNA AL PIANO	05
PREAVVISO TELEFONICO	25
SERVIZIO AL SABATO	07
SERVIZIO AL SABATO AFTERNOON	29
ENTRO ORE 12	01
ORA FISSA	02
SATURDAY EXPRESS	36
MEZZO IDONEO	06
LICCARDI
Preavviso telefonico	preavvisoTelefonico
MRW_ES
Entrega el sábado	sabato
Entrega urgente 8:30	entrega830
Entrega Partir De (de 00:00 a 23:00)	ejemplo 10:00
Sin gestión	N_gestion
Gestión en origen	O_gestion
Gestión en destino	D_gestion
Sin retorno	N_retorno
Retorno de albarán cobro en destino	D_retorno
Retorno de mercancia	S_retorno
Sin confirmación inmediata de entrega/recogida	N_confirm
Confirmación inmediata de recogida	R_confirm
Confirmación inmediata de entrega	E_confirm
PTI
Al piano	alPiano
Sabato	sabato
Su appuntamento	appuntamento
Poste Delivery Now	PDBnow
SDA / CRONO-PTI
consegna al piano	alPiano
consegna al sabato	sabato
consegna alla sera	sera
su appuntamento	appuntamento
Ore 09:00	T09
Ore 10:00	T10
Ore 12:00	T12
SEUR
Entrega el sábado	sabato
TWS
Consegna entro le 09:00 AM - spedizione monocollo	T09
Consegna entro le 10:00 AM	T10
Consegna entro le 12:00 AM	T12
Consegna Al Piano	PIA
Consegna Di Sabato	SAB
Consegna Su Appuntamento	APP
Consegna Di Sera	SER
Combinazione Consegna Al Piano/Di Sabato	PSA
Combinazione Consegna Al Piano/Su Appuntamento	PAP
Combinazione Consegna Al Piano/Di Sera	PSE
Combinazione Consegna Al Piano/Ore 9	PI0
Combinazione Consegna Al Piano/Ore 10	PI1
Combinazione Consegna Al Piano/Ore 12	PI2
Combinazione Consegna Di Sabato/Su Appuntamento	SAP
Combinazione Consegna Su Appuntamento/Di Sera	ASE
Combinazione Consegna Al Piano/Su Appuntamento/Di Sera	APS
Combinazione Al Piano/Di Sabato/Su Appuntamento	ASP

ARCO	G	Q
CONTANTE	A	A
ASSEGNO BANCARIO INTESTATO AL MITTENTE	1	1
ASSEGNO CIRCOLARE INTESTATO AL MITTENTE	2	2
ACCETTARE EFFETTO COME EMESSO DA DESTINATARIO		9
BRT - DISK B – WS REST	G	Q
CONTANTE	12	12
ASSEGNO INTESTATO AL MITTENTE [BP]	17	17
ASSEGNO CIRCOLARE INTESTATO ALLA MITTENTE [CM]	18	18
ASSEGNO BANCARIO INTESTATO ALLA MITTENTE [BM]	15	15
ASSEGNO CIRCOLARE INTESTATO AL CORRIERE	6
ASSEGNO CIRCOLARE INTESTATO AL MITTENTE ORIGINALE [OC]	10	10
ASSEGNO INTESTATO AL MITTENTE ORIGINALE [OM]	11	11
ASSEGNO BANCARIO INTESTATO CORRIERE CON MANLEVA [BB]	3	3
ACCETTARE ASSEGNO BANCARIO INTESTATO ALLA MITTENTE COSI COME RILASCIATO [TM]	19	19
DHL	G	Q
CASH, POS		YYY
CONTANTE	12
ASSEGNO CIRCOLARE INTESTATO AL MITTENTE ORIGINALE	10	GGG
ASSEGNO BANCARIO INTESTATO AL MITTENTE ORIGINALE	15	QQQ
CONTANTI, POS, ASSEGNO O ASSEGNO POSTALE O ASSEGNO CIRCOLARE PAGABILE AL MITTENTE	0	KKK
ASSEGNO BANCARIO O ASSEGNO POSTALE INTESTATO CASA MANDANTE		RRR
ASS. CIRC. INT CASA MANDANTE		LLL
CASH, POS O ASSEGNO (BANC./POST./CIRCOLARE) INTESTATO CASA MANDANTE		JJJ
FERCAM	G	Q
CONTANTE	12
ASSEGNO INTESTATO AL MITTENTE ORIGINALE	15
GLS-ITA	G	Q
CONTANTE		CONT
ASSEGNO BANCARIO		AB
ASSEGNO CIRCOLARE/BANCARIO (NO POSTALE)		ABC
ASSEGNO BANCARIO/POSTALE (NO CIRCOLARE)		ABP
ASSEGNO CIRCOLARE		AC
ASSEGNO POSTALE		AP
ASSEGNO CIRCOLARE/BANCARIO/POSTALE		ASS
Ass. come rilasciato		ASR
Ass. come rilasciato int. Mittente		ARM
Ass. come rilasciato - no postale		ASRP
Ass. come rilasciato int. Mittente – no postale		ARMP
LICCARDI	G	Q
SOLO CONTANTI	CNT	3
ASSEGNO CIRCOLARE INTESTATO AL MITTENTE	ACM	5
ASSEGNO BANCARIO INTESTATO AL MITTENTE	ABM	4
ASSEGNO A MITTENTE COME RILASCIATO		6
CONTANTI O ASSEGNO A MITTENTE COME RILASCIATO	T	8
POSTE DELIVERY BUSINESS	G	Q
CONTANTE	12	12
ASSEGNO CIRCOLARE INTESTATO AL MITTENTE		10
ASSEGNO BANCARIO INTESTATO AL MITTENTE		11
ASSEGNO INTESTATO AL MITTENTE ORIGINALE	15
SDA	G	Q
Tutti	VAR	VAR
Contanti	CON	CON
Ass.Banc.Mittente	ABM	ABM
Ass.Banc.SDA	ABS	ABS
Ass.Circ.Mittente	ACM	ACM
Ass.Circ.SDA	ACS	ACS
TNT IT	G	Q
CONTANTE	12	12
ASSEGNO INTESTATO AL MITTENTE ORIGINALE	15	15

New API v2

Introduction

Latest version available

Previous versions

Webhook

API Key

Endpoint

Response

Rate limiting

HTTP Response Status Codes

Abuse

Sandbox

Test

Postman Collection

Shipments

pushShipment

Request

Parameters

Response Body200

Errors

getShipment

Parameters

Response Body200

Description

Errors

getShipments

Parameters

Response Body200

Description

Errors

updateShipment

Parameters

Response Body200

deleteShipment

Parameters

Response Body200

undeleteShipment

Parameters

Response Body200

trackingByTimeFrame

Parameters

Response Body200

Description

Orders

pushOrder

Parameters

Response Body200

Description

Errors

getOrder

Parameters

Response Body200

getOrders

Parameters

Response Body200

deleteOrder

Parameters

Response Body200

updateOrder

undeleteOrder

Parameters

Response Body200

detectOrderCourier

Request

Parameters

Response Body200

Errors

Platforms

fetchPlatformOrders

Parameters

Response Body200

Errors

updatePlatformOrder

Authentication

Parameters

Peculiarities

Response Body200

Labels

createLabel

Test

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`

Response Body`200`