Qapla' :: RESTful JSON API 1.3

Nuove API v2

Sono in corso di rilascio le nuove API v2, con nuove funzionalità e una nuova e più sicura modalità di autenticazione.

Introduzione

Le API forniscono la possibilità di integrare Qapla' sia in lettura che in scrittura con il tuo sistema di ecommerce proprietario o per il quale non è stato ancora implementato un plugin o un connector.

L'API di Qapla è basata su REST.
Accetta richieste GET, POST, PUT, DELETE e PATCH codificate JSON.
Restituisce i valori codificati JSON.
Il fuso orario di riferimento è il CEST, che corrisponde all'orario UTC+2 quando è in vigore l'ora legale, o UTC+1 quando è in vigore l'ora solare.

Ultima versione disponibile

Questa è la versione più recente delle API. Non tutte le API sono state migrate alla versione 1.3, mano a mano che saranno aggiunte nuove funzionalità, verranno aggiornate.

Le API non ancora aggiornate fanno ancora riferimento alla versione 1.2

Versioni precedenti

Le precedenti versioni di questa API sono mantenute ancora attive, ma considerate deprecate.

Webhook

Qapla' ha anche un servizio Webhook che è parte integrante delle API.

API Key

Per poter utilizzare le API è necessario essere a conoscenza delle API Key private assegnate al/ai tuo/i canale/i, che si trovano sul Control Panel nella sezione:

Impostazioni \ [NOME_CANALE]

Questa chiave API deve essere protetta e mantenuta segreta.

Endpoint

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

[API_VERSION]	È il valore di versione dell'API.
[ENDPOINT]	È l'endpoint che devi chiamare.

Response

La risposta JSON ad una Request utilizza questo formato standard

[API_NAME]	Il nome dell'API consumata
[OK/KO]	OK in caso di risposta positiva, KO In caso di errore
[ERROR_MESSAGE]	È null in caso di OK e conterrà l'errore in caso di KO

Limiti di utilizzo

Il sistema utilizza l'algoritmo TokenBucket con i seguenti parametri:

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

Attenzione
Una request multipla (es: pushShipment o pushOrder con 100 spedizioni od ordini) viene valutata come 100 token.

HTTP Response Status Codes

Un superamento del limite porterà al seguente response HTTP

429 Too Many Requests

e al seguente errore di risposta da parte di qualunque API coinvolta

"error": "Too Many Requests"

Abuse

L'abuso dell'utilizzo porterà ad un BAN dell'API Key.

Sandbox

Non esiste un ambiente di Sandbox vero e proprio. È sufficiente utilizzare il campo sandbox direttamente nelle chiamate API che lo supportano per utilizzare l'infrastrutture di test senza avere effetti operativi (come costi, richieste di presa al corriere, ecc..)

Test

Una volta ottenuta l'API Key è possibile effettuare immediatamente un test di connessione utilizzado l'API getChannel.

Postman Collection

Una Postman Collection è disponibile.

pushShipment

pushShipment permette di caricare una o più spedizioni tramite una POST dei dati in formato JSON.

In combinazione con il Webhook crea un sistema integrato di gestione delle spedizioni.

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

REQUEST
RESPONSE

Request

In questo esempio vengono caricate due spedizioni, una in formato "minimo" e una "completo".

{
  "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
        }
      ]
    }
  ]
}

Parametri

Esistono 3 tipi di modalità di caricamento delle spedizioni.

"minimo" contenente 3 campi obbligatori^*
"necessario" per attivare i servizi aggiuntivi di comunicazione al cliente come Email transazionali, ecc.^•
"completo" con sempre i primi 3 campi obbligatori, ma che contiene tutte le informazioni

^*Parametro obbligatorio

^•Parametro necessario per attivare email transazionali e/o SMS

⚠
Il numero massimo di spedizioni inviabili per ogni singola request è 100.

apiKey(string)

La API Key assegnata al canale nel quale si desidera importare le spedizioni

pushShipment(array)

È un array di massimo 100 spedizioni da caricare.

trackingNumber^*(string)

Il tracking number / numero di spedizione / lettera di vettura del corriere

courier^*(string)

Il codice corriere di Qapla'

shipDate^*(string)

Data spedizione

reference^•(string)

Riferimento ordine

platformOrderID(string)

Eventuale ID numerico o alfanumerico, utilizzato come riferimento aggiuntivo per l'ordine

orderDate(string)

Data dell'ordine

parcels(array)

Eventuali colli della spedizione. Ogni collo può essere definito tramite un oggetto così composto:

weight(float)	Eventuale peso dell'ordine. Obbligatorio se non viene inviato il "boxCode"
length(float)	Eventuali misure: lunghezza. Obbligatorio se non viene inviato il "boxCode"
width(float)	Eventuali misure: profondità. Obbligatorio se non viene inviato il "boxCode"
height(float)	Eventuali misure: altezza. Obbligatorio se non viene inviato il "boxCode"
boxCode(string)	Eventuale codice scatola (se utilizzato le misure verranno prese dalla scatola con codice corrispondente)
originCountry(string)	Nazione di origine del collo in formato ISO 3166-1 alpha-2 (Esempio: IT)
content(string)	Eventuale descrizione del contenuto

name^•(string)

Nome del destinatario

street(string)

Indirizzo del destinatario

city(string)

Città del destinatario

ZIP(string)

CAP del destinatario

state(string)

Provincia del destinatario

country(string)

La nazione del destinatario in formato ISO 3166-1 alpha-2 (Esempio: IT)

email^•(string)

Email del destinatario

telephone^•(string)

Telefono del destinatario

agent(string)

Indirizzo email di un contatto commerciale del cliente

amount(float)

Eventuale importo della spedizione (da comunicare al cliente. Es: contrassegno)

pod(boolean)

È true se la spedizione è in contrassegno

shipping(float)

Eventuale costo della spedizione

custom1(string)

Valore custom 1

custom2(string)

Valore custom 2

custom3(string)

Valore custom 3

note(string)

Una nota relativa alla spedizione (max 255 char)

language(string)

Lingua della spedizione (ISO 639-1, es: 'fr').
Un valore nullo o non riconosciuto indicherà la spedizione come 'it'.

origin(string)

Origine della spedizione, valori ammessi:

    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 e teamsystemcommerce possono essere usati come sinonimi

isReturnable(bool)

Se è true indica la possibilità di reso dell'intera spedizione.

deliveryDate(string)

Eventuale data richiesta consegna

latestShipDate(string)

Spedizione entro questa data in formato YYYY-MM-DD

latestDeliveryDate(string)

Consegna entro questa data in formato YYYY-MM-DD

tag(string)

Una "tag" per identificare spedizioni appartenenti ad un gruppo.

isTrackingNumber(bool)

È true quando posto nel campo trackingNumber è il tracking number reale della spedizione.

rows

È un array di "righe ordine".

Non è obbligatorio, ma se popolato ha alcuni dati che lo sono.

sku^*(string)

Codice articolo

name^*(string)

Descrizione articolo

qty^*(int)

Quantità

price^*(float)

Prezzo

total(float)

Prezzo totale

weight(float)

Eventuale peso dell'articolo

url(string)

La url specifica del prodotto

imageUrl(string)

La url dell'immagine del prodotto

notes(string)

Eventuale note prodotto

customsCode(string)

Eventuale Codice Doganale (HSCode, Taric, ecc.)

originCountry(string)

Nazione di origine del prodotto in formato ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Eventuale peso netto del prodotto

unitOfMeasurement(string)

Generale
DHL

Eventuale unità di misura

Codice	Descrizione
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)

Eventuale numero progressivo, identificativo del numero collo in cui viene spedito il prodotto

transparencyCodes(string[])

Array di Transparency Code

Response Body`200`

Errori

In caso di errore invece ogni riga di spedizione verrà segnalata:

getShipment

getShipment permette di leggere lo stato di una spedizione tramite il tracking number, il riferimento ordine o l'ID.

Per una gestione totale ed integrata del ciclo di aggiornamento delle spedizioni valuta anche il Webhook.

🛈
Ricorda i limiti di utilizzo e di valutare anche il 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

Parametri

Parametro

Descrizione

apiKey^*(string)

la API Key assegnata al canale che vogliamo interrogare

Parametri esclusivi

trackingNumber(string)

il tracking number interessato

reference(string)

il riferimento ordine

id(int)

ID della spedizione

custom1, custom2, custom3(string)

i campi custom1, custom2, custom3

Parametri opzionali

lang

La lingua dei nomi degli stati Qapla' (it, en, es), default: it.

Esempio:

&lang=en

data

Il flag data specifica quali e quanti dati vogliamo ricevere, di default torna dei dati minimi sullo stato di avanzamento della spedizione.
Può avere i seguenti valori:

Parametro	Descrizione
	se non viene specificato nessun parametro verranno ritornati i dati minimi
all	dati minimi + tutti i dati a seguire
consignee	dati minimi + i dati del destinatario
children	dati minimi + i dati delle spedizioni figlio, se esistenti
parent	dati minimi + i dati della spedizione padre, se esistente
flag	dati minimi + i dati relativi alla segnalazione della spedizione, se esistenti
notifications	dati minimi + i dati delle notifiche (email sms, webhook, qaplAPP)
history	dati minimi + la tracking history della spedizione
rows	dati minimi + gli eventuali prodotti
parcels	dati minimi + informazioni sui colli
deliveryInfo	dati minimi + informazioni sulle modalità di spedizione (spedizione entro, consegna entro)

Il parametro può essere combinato separato da virgole, ad esempio

&data=consignee,history

per ottenere solo questi dati.

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"
            }
          }
        ]
      }
    ]
  }
}

Descrizione

È un array che può contenere più di una spedizione

shipments
result	Il risultato dell'operazione: OK o KO in caso di errore
error	L'errore in caso di result: KO
version	La versione dell'API
lang	La lingua richiesta / passata come parametro (default: it)
count	Quante spedizioni sono presenti

id

ID della spedizione

hash

L'hash della spedizione, utilizzato per esempio dalla pagina di tracking

url

Indirizzo della pagina di tracking di questa spedizione

reference

Il riferimento ordine

trackingNumber

Il tracking number

isDeleted

è true (valore boolean) se la spedizione è cancellata

isArchived

è true (valore boolean) se la spedizione è archiviata

origin

L'origine della spedizione se caricata (es: magento, prestashop, amazon, ecc)

courier

code	Codice del corriere
name	Nome del corriere
icon	URL dell'icona del corriere
note	Eventuali note del corriere sulla spedizione
estimatedDeliveryDate	Eventuale data stimata di prevista consegna
url	L'indirizzo url del corriere
trackingURL	L'indirizzo url del tracking del corriere per questa spedizione

status

Lo stato attuale della spedizione

date

La data dello stato, come riportata dal corriere

dateISO

La versione ISO YYYY-MM-DD HH:MM:SS della data comunicata dal corriere

status

Lo stato comunicato dal corriere

place

Il luogo comunicato dal corriere

qaplaStatus

La "traduzione" dello stato del corriere negli stati di Qapla'

id	L'ID dello stato
status	La decrizione
detailID	L'ID dell'eventuale dettaglio
detail	La descrizione dell'eventuale dettaglio
color	Il colore assegnato da Qapla' allo stato
icon	L'icona dello stato

dateUpd

La data in cui lo stato della spedizione è stata aggiornata su Qapla'

lastCheck

La data dell'ultimo controllo dello stato della spedizione

shipDate

La data di spedizione comunicataci al caricamento della spedizione

orderDate

La data dell'ordine comunicataci al caricamento della spedizione

dateIns

La data di caricamento della spedizione

consignee

I dati del destinatario

name	Nome del destinatario
address	L'indirizzo del destinatario
city	La città del destinatario
state	La provincia del destinatario
country	La nazione del destinatario
email	L'email del destinatario
isAmazon	È true (valore boolean) se la email del destinatario è di Amazon
phone	Il telefono del destinatario

language

La lingua in cui "parlerà" la spedizione quando verranno inviate notifiche come email o SMS

newTrackingNumber

L'eventuale nuovo tracking number assegnato alla spedizione

oldTrackingNumber

L'eventuale vecchio tracking number in caso venga popolato il campo newTrackingNumber

hasNewTrackingNumber

È true (valore boolean) se la spedizione ha ottenuto un nuovo tracking number

isTrackingNumber

È true (valore boolean) se il valore trackingNumber contiene il vero tracking number

trueTrackingNumber

Contiene l'eventuale "vero" tracking number

altTrackingNumber

Contiene un eventuale tracking number alternativo nel caso la spedizione lo abbia cambiato a parità di corriere in corso di viaggio

returnTrackingNumber

Indica l'eventuale tracking number di ritorno se diverso da quello di andata

isReturnShipment

È true (valore boolean) se la spedizione è una spedizione di reso / ritorno

isCOD

È true (valore boolean) se la spedizione è in constrassegno

amountText

L'importo testuale della spedizione

amount

L'importo come numero float

isDelivered

È true (valore boolean) se la spedizione è consegnata

isChild

È true (valore boolean) se la spedizione è "figlia" di un'altra spedizione, in questo caso verrà popolato il campo "parent"

parent

La spedizione "padre"

id	Id della spedizione
reference	Il riferimento ordine della spedizione
trackingNumber	Il tracking number ordine della spedizione
courier	Il codice corriere della spedizione
url	La URL a questa stessa API per richiamare la spedizione padre

hasChildren

È true (valore boolean) se la spedizione ha dei "figli", in questo caso verrà popolato il campo "children"

children

È un array di spedizioni "child"

id	Id della spedizione
reference	Il riferimento ordine della spedizione
trackingNumber	Il tracking number ordine della spedizione
courier	Il codice corriere della spedizione
url	La URL a questa stessa API per richiamare la spedizione

custom1

Il valore custom1 come importato

custom2

Il valore custom2 come importato

custom3

Il valore custom3 come importato

deliveryMode

Può assumere i valori "home" per una consegna direttamente al destinatario o "pickup" per una consegna diretta ad un punto di ritiro (Pickup point)

hasFlag

È true (valore boolean) se la spedizione è stata "segnalata", in questo caso viene popolato il campo "flag"

flag

Description	La descrizione del flag
Note	L'eventuale nota

notifications

Tutte le notifiche inviate per stato per questa spedizione. Ottenibile utilizzando il parametro data=notifications ed incluso se data=all

email

È un array di email inviate

result	È OK se la email è andata a buon fine e KO in caso contrario
statusID	Lo stato Qapla' per il quale è stata inviata la email
status	La descrizione dello stato inviato
date	La data di invio
error	L'eventuale errore
isOpened	È true (valore boolean) se la email è stata aperta / letta

sms

È un array di SMS inviati

result	È OK se l'SMS è anadato a buon fine e KO in caso contrario
statusID	Lo stato Qapla' per il quale è stato inviato l'SMS
status	La descrizione dello stato inviato
date	La data di invio

webhook

È un array di webhook inviate.

result	È OK se la email è andata a buon fine e KO in caso contrario
statusID	Lo stato Qapla' per il quale è stato inviato il webhook
status	La descrizione dello stato inviato
date	La data di invio

qaplAPP

È un array di notifiche inviate a qaplAPP

result	È OK se la email è andata a buon fine e KO in caso contrario
statusID	Lo stato Qapla' per il quale è stato inviato la notifica a qaplAPP
status	La descrizione dello stato inviato
date	La data di notifica

trackingHistory

È un array dei seguenti elementi

date

La data dello stato come comunicata dal corriere

dateISO

La versione ISO YYYY-MM-DD HH:MM:SS della data comunicata dal corriere

status

Lo stato comunicato dal corriere

place

Il luogo

qaplaStatus

La "traduzione" dello stato del corriere negli stati di Qapla'

id	L'ID dello stato
status	La decrizione
detailID	L'ID dell'eventuale dettaglio
detail	La descrizione dell'eventuale dettaglio
color	Il colore assegnato da Qapla' allo stato
icon	L'icona dello stato

parcels

I colli presenti nella spedizione. Ottenibile utilizzando il parametro data=parcels ed incluso se data=all

weight(float)	Eventuale peso dell'ordine. Obbligatorio se non viene inviato il "boxCode"
length(float)	Eventuali misure: lunghezza. Obbligatorio se non viene inviato il "boxCode"
width(float)	Eventuali misure: profondità. Obbligatorio se non viene inviato il "boxCode"
height(float)	Eventuali misure: altezza. Obbligatorio se non viene inviato il "boxCode"
boxCode(string)	Eventuale codice scatola (se utilizzato le misure verranno prese dalla scatola con codice corrispondente)
originCountry(string)	Nazione di origine del collo in formato ISO 3166-1 alpha-2 (Esempio: IT)
content(string)	Eventuale descrizione del contenuto

rows

Le righe dei prodotti presenti nella spedizione. Ottenibile utlizzando il parametro data=rows ed incluso se data=all

sku^*(string)

Codice articolo

name^*(string)

Descrizione articolo

qty^*(int)

Quantità

price^*(float)

Prezzo

total(float)

Prezzo totale

weight(float)

Eventuale peso dell'articolo

url(string)

La url specifica del prodotto

imageUrl(string)

La url dell'immagine del prodotto

notes(string)

Eventuale note prodotto

customsCode(string)

Eventuale Codice Doganale (HSCode, Taric, ecc.)

originCountry(string)

Nazione di origine del prodotto in formato ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Eventuale peso netto del prodotto

unitOfMeasurement(string)

Generale
DHL

Eventuale unità di misura

Codice	Descrizione
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)

Eventuale numero progressivo, identificativo del numero collo in cui viene spedito il prodotto

Errori

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

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

getShipments

getShipments permette di ricevere la lista delle spedizioni importate da Qapla' per data di inserimento, data di spedizione, data ordine.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare
[DATE]^*
shipDate	data spedizione in formato ISO 8601 "YYYY-MM-DD"
orderDate	data ordine in formato ISO 8601 "YYYY-MM-DD"
dateIns	data di caricamento in formato ISO 8601 "YYYY-MM-DD"

^*Se nessun parametro viene valorizzato di default verrà utilizzato dateIns e la data corrente.

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"}]}}

Descrizione

result(string)

Il risultato dell'operazione: OK o KO in caso di errore

error(string)

L'errore in caso di result: KO

version(string)

La versione dell'API

search(string)

Il parametro imputato come ricerca

count(int)

Quante spedizioni sono presenti

shipments(array)

È un array che può contenere più di una spedizione

id(int)	ID numerico della spedizione
getShipment(string)	La url alla API getShipment per questa spedizione
reference(string)	Il riferimento ordine
trackingNumber(string)	Il tracking number
isDeleted(bool)	È true (valore boolean) se la spedizione è cancellata
isArchived(bool)	È true (valore boolean) se la spedizione è archiviata
origin(string)	Piattaforma di origine della spedizione
courier(string)	Il codice corriere della spedizione
statusID(int)	Lo stato Qapla' della spedizione
statusDetailID(int)	Eventuale stato Qapla' di dettaglio
shipDate(string)	Data di spedizione
orderDate(string)	Data ordine
dateIns(string)	Data di caricmaneto su Qapla'
language(string)	Linguaggio della spedizione
custom1(string)	Valore custom1
custom2(string)	Valore custom2
custom3(string)	Valore custom3
isCOD(boolean)	È true se il pagamento è in contrassegno
deliveredDate(string)	Data di consegna

Errori

updateShipment

updateShipment permette di aggiornare una spedizione.

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

REQUEST
RESPONSE

Parametri

Si inviano gli stessi parametri della pushShipment tenendo conto che la chiave primaria è composta da

trackingNumber
courier

Response Body`200`

deleteShipment

deleteShipment permette di eliminare una spedizione.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
courier^*(string)	il codice corriere della spedizione
trackingNumber^*(string)	il tracking number della spedizione

Response Body`200`

undeleteShipment

undeleteShipment permette di ripristinare una spedizione.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
courier^*(string)	il codice corriere della spedizione
trackingNumber^*(string)	il tracking number della spedizione

Response Body`200`

trackingByTimeFrame

trackingByTimeFrame permette di ottenere l'elenco delle spedizioni che hanno subito un aggiornamento dello stato del tracking compreso nel timeframe dateFrom / dateTo.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
Parametri opzionali
dateFrom(timestamp)	default: un'ora fa. In formato ISO 8601 "yyyy-mm-dd hh:mm:ss"
dateTo(timestamp)	in formato ISO 8601 "yyyy-mm-dd hh:mm:ss"
lang	La lingua dei nomi degli stati Qapla' (it, en, es), default: it. Esempio: &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
		}]
	}
}

Descrizione

result	Il risultato dell'operazione: OK o KO in caso di errore
error	L'errore in caso di result: KO
version	La versione dell'API
lang	La lingua richiesta / passata come parametro (default: it)
count	Quante spedizioni sono presenti
shipments	La descrizione della spedizione

pushOrder

pushOrder permette di caricare uno o più ordini tramite una POST dei dati in formato JSON.

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"
    }
  ]
}

Parametri

^*Parametro obbligatorio

⚠
Il numero massimo di ordini inviabile per ogni singola request è 100.

apiKey^*(string) La API Key assegnata al canale che vogliamo interrogare

origin(string)

Origine dell'ordine, valori ammessi:

    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 e teamsystemcommerce possono essere usati come sinonimi

pushOrder(array)

È un array di massimo 100 ordini da caricare.

reference^*(string) Il riferimento alfanumerico dell'ordine

orderID(int) Eventuale riferimento numerico dell'ordine

courier(string) Il codice corriere di Qapla'

courierService^*(string) Eventuale tipo del servizio del corriere; per esempio può essere il codice contratto di GLS Italy. Se il campo è vuoto o non viene inviato il default è '0'.

status(string) Lo stato dell'ordine (processing, complete, ecc)

createdAt^*(YYYY-MM-DD HH:MM:S) Data di creazione ordine

updatedAt^*(YYYY-MM-DD HH:MM:SS) Data di aggiornamento ordine.
Attenzione
Questa data viene usata per stabilire se aggiornare l'ordine su Qapla', ovvero se l'ordine è stato già importato da Qapla'. Un valore più recente di questo campo farà sì che Qapla' lo consideri come "ordine aggiornato" e quindi aggiorni tutti i dati precedentemente importati.

name^*(string) Nome del destinatario

street^*(string) Indirizzo del destinatario

city^*(string) Città del destinatario

state^*(string) Provincia del destinatario

postCode^*(string) CAP del destinatario

country^*(string) La nazione del destinatario in formato ISO 3166-1 alpha-2 (Esempio: IT)

email(string) Email del destinatario

telephone(string) Telefono del destinatario

amount(float) Importo della spedizione.
Specificare solo un separatore (il punto) per indicare i decimali, e non utilizzare separatori per indicare le migliaia. Indicare al massimo due cifre decimali. Esempio: 2340.23

shippingCost(float) Costo della spedizione.
Specificare solo un separatore (il punto) per indicare i decimali, e non utilizzare separatori per indicare le migliaia. Indicare al massimo due cifre decimali. Esempio: 9.35

currencyCode(string) Codice valuta ISO 4217 (default: EUR)

payment Tipo di pagamento

isCOD(boolean) È true se il pagamento è in contrassegno

notes(string) Eventuali note dell'ordine

parcels(array)

Eventuali colli della spedizione. Ogni collo può essere definito tramite un oggetto così composto:

weight(float)	Eventuale peso dell'ordine. Obbligatorio se non viene inviato il "boxCode"
length(float)	Eventuali misure: lunghezza. Obbligatorio se non viene inviato il "boxCode"
width(float)	Eventuali misure: profondità. Obbligatorio se non viene inviato il "boxCode"
height(float)	Eventuali misure: altezza. Obbligatorio se non viene inviato il "boxCode"
boxCode(string)	Eventuale codice scatola (se utilizzato le misure verranno prese dalla scatola con codice corrispondente)
originCountry(string)	Nazione di origine del collo in formato ISO 3166-1 alpha-2 (Esempio: IT)
content(string)	Eventuale descrizione del contenuto

isReturnable(bool) Se è true indica la possibilità di reso dell'intero ordine.

shippingCODPaymentOption(string) La modalità di pagamento dell'eventuale contrassegno se diversa dalle impostazioni di default (da concordarsi)

shippingInsurance(float | string)

Generale
GLS-ITA
SDA
CRONO PTI

Eventuale importo assicurato

ALL-IN: valorizzare il campo "shippingDeliveryOptions" inserendo la stringa: ALLIN

Per la generazione diretta con SDA, il valore va passato sotto forma di stringa, specificando uno dei seguenti codici:

Codice	Tipo di assicurazione
	Se non viene specificato nessun parametro, non verrà indicato alcun tipo di assicurazione
AS01	FINO A EURO 258,23
AS02	FINO A EURO 516,46
AS03	FINO A EURO 1.549,37
AS04	FINO A EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE FINO A EURO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX

Per la generazione diretta con CRONO PTI, il valore va passato sotto forma di stringa, specificando uno dei seguenti codici:

Codice	Tipo di assicurazione
	Se non viene specificato nessun parametro, non verrà indicato alcun tipo di assicurazione
AS01	FINO A EURO 258,23
AS02	FINO A EURO 516,46
AS03	FINO A EURO 1.549,37
AS04	FINO A EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE FINO A EURO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX
AS14	ASSICURATA CRONO INTERNAZIONALE

shippingDeliveryOptions(string | JSON)

Generale
PTI
BRT

In caso si vogliano utilizzare due valori, questi devono essere separati da virgola
Esempio: A,P oppure 22,07

Per il corriere PTI bisogna usare un JSON strutturato come i seguenti esempi

In caso si vogliano utilizzare due valori, questi devono essere separati da virgola
Esempio: A,P oppure A,FRESH_YYYY-MM-DD

Nel caso di servizio fresh la data è opzionale:
Esempio: FRESH_YYYY-MM-DD, FRESH
Fresh con data: La data di scadenza sarà pari a quella passata
Fresh senza data: La data di scadenza sarà pari alla data della creazione etichetta più gli eventuali giorni inseriti nella configurazione canale oppure, nel caso non siano stati inseriti, 5 giorni.

Nota: Il corriere non accetta date inferiori alla data di creazione etichetta più 5 giorni.

shippingRequiredDeliveryDate(YYYY-MM-DD) La data in formato YYYY-MM-DD di richiesta consegna

latestShipDate(string) Spedizione entro questa data in formato YYYY-MM-DD

latestDeliveryDate(string) Consegna entro questa data in formato YYYY-MM-DD

pickUpDate(YYYY-MM-DD) La data in formato YYYY-MM-DD di ritiro richiesta al corriere

custom1,2,3(string) Eventuali campi custom

pickupPoint(string) Eventuale codice di un pickup point

content(string) Il contenuto della merce che potrà essere presente sull'etichetta(dipende dal corriere)

rows(array)

È un array di "righe ordine".

Non è obbligatorio, ma se popolato ha alcuni dati che lo sono.

sku^*(string)

Codice articolo

name^*(string)

Descrizione articolo

qty^*(int)

Quantità

price^*(float)

Prezzo

total(float)

Prezzo totale

weight(float)

Eventuale peso dell'articolo

url(string)

La url specifica del prodotto

imageUrl(string)

La url dell'immagine del prodotto

notes(string)

Eventuale note prodotto

customsCode(string)

Eventuale Codice Doganale (HSCode, Taric, ecc.)

originCountry(string)

Nazione di origine del prodotto in formato ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Eventuale peso netto del prodotto

unitOfMeasurement(string)

Generale
DHL

Eventuale unità di misura

Codice	Descrizione
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)

Eventuale numero progressivo, identificativo del numero collo in cui viene spedito il prodotto

transparencyCodes(string[])

Array di Transparency Code

assemblyTypes(array)

Eventuale elenco di tipologie di montaggio, una per prodotto, per i corrieri che supportano questa informazioni

Generale
FERCAM

code^*(string)	Il codice della tipologia di montaggio scelta

Disponibile per il "courierService" 20 (HD). Deve essere specificato un elemento per ogni elemento di rows.

I valori disponibili per "code":

Code	Descrizione
5	Attivazione Elettrodomestici
09	Incasso forni/piano cottura con dichiaraz. Conf.
08	Incasso frigoriferi
07	Incasso lavastoviglie e lavatrici
11	Install. Clima DUAL con tubazione da predisporre
14	Install. Clima DUAL con tubazione già predisposta
10	Install. Clima MONO con tubazione da predisporre
13	Install. Clima MONO con tubazione già predisposta
12	Install. Clima TRIAL con tubazione da predisporre
15	Install. Clima TRIAL con tubazione già predisposta
K	Installazione base HD
Z	Installazione complessa HD
Y	Installazione media HD
W	Installazione semplice HD
06	Installazione TV a muro
20	Montaggio 30
17	Montaggio Cyclette
18	Montaggio Ellittica
4	Montaggio Strutture Multifunzione
16	Montaggio Tapis Roulant
1	Montaggio Tapis-Cyclette-Ellittica
2	Montaggio Tavoli Ping-Pong
3	Montaggio Vogatori

sender

È il mittente della spedizione se diverso dall'intestatario del contratto.

code^*(string)	Il codice da assegnare al mittente per una migliore identificazione
businessName(string)	Ragione sociale
street(string)	Indirizzo
city(string)	Città
state(string)	Provincia
postCode(string)	CAP
country(string)	Nazione in formato ISO 3166-1 alpha-2 (Esempio: IT)
email(string)	Email del mittente
telephone(string)	Telefono del mittente
referent(string)	Referente del mittente
isDefault(bool)	È true se il mittente verrà salvato come default per tutte le altre spedizioni

PUDO(object)

Permette di impostare un punto di Pick-up o Drop-off del ritiro della merce. Ogni campo va compilato in base alla necessità del corriere. Far riferimento alle tabelle poco sotto

id^*(string)	Identificativo del PUDO
type(string)	Tipologia Servizio
name(string)	Nome del servizio
address(string)	Indirizzo del punto di Pick-up o Drop-off
city(string)	Città del punto Pick-up o Drop-off
state(string)	Provincia del punto di Pick-up o Drop-off
country(string)	Nazione del punto di Pick-up o Drop-off
postalCode(string)	CAP del punto di Pick-up o Drop-off
description(string)	Descrizione
harmonisedId(string)	Id numerico aggiuntivo del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es. 104
keyword(string)	Keyword del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es 'DHL Servicepoint'
psfKey(string)	PsfKey del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es 'ES-0004240'
postnumber(string)	Postnumber del punto di Pick-up o Drop-off, se di tipo 'packstation'. E' un codice che il cliente finale possiede personalmente

**DHL / BRT / INPOST / FEDEX / MRW / SENDING**
Attributo	Valore
id^*(string)	Codice o identificativo del PUDO

**TNT ITA / GLS-ITA**
Attributo	Valore
id^*(string)	Valori possibili: TNT: Codice identificativo del TNT point/Locker; GLS-IT: Codice identificativo chiamato SHOP_ID;
type^*(string)	Valori possibili: TNT: 3 (TNT point) o 5 (TNT Locker); GLS-IT: Codice identificativo chiamato PARTNER_SHOP_ID;

**PTI(Poste Italiane)**
Attributo	Valore
id^*(string)	Codice o identificativo del PUDO
type^*(string)	Valori possibili: `ConsegnaPuntoPoste` `ConsegnaUfficioPostale` `ConsegnaLocker` `ConsegnaPUDOUPS`
name^*(string)	Nome del Punto di Ritiro
address^*(string)	Indirizzo del Punto di Ritiro
postalCode^*(string)	CAP del Punto di Ritiro
city^*(string)	Città/Località del Punto di Ritiro
province^*(string)	Provincia del Punto di Ritiro
country^*(string)	Nazione del Punto di Ritiro

**UPS**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
name^*(string)	Name
postalCode^*(string)	CAP
state^*(string)	Provincia

**SDA**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
name^*(string)	Nome
postalCode^*(string)	CAP
state^*(string)	Provincia

**DHL-PAKET**
Attributo	Valore
id^*(string)	Codice o identificativo
type^*(string)	Tipo di PUDO ("locker" o "postoffice")
city^*(string)	Città
name^*(string)	Nome del PUDO
country^*(string)	Nazione
postalCode^*(string)	CAP
postnumber(string)	PostNumber. Obbligatorio per il type "postoffice"

**DHLPARCEL-ES**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP
harmonisedId^*(string)	Harmonized Id
keyword^*(string)	Keyword
psfKey^*(string)	PsfKey
postnumber(string)	PostNumber

**GLS-SPAIN**
Attributo	Valore
id^*(string)	Codice o identificativo
name^*(string)	Nome del PUDO
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP

**CORREOS-EXPRESS**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP

**SEUR**
Attributo	Valore
id^*(string)	Codice o identificativo

**TIPSA**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
name^*(string)	Nome del PUDO
postalCode^*(string)	CAP

invoice(object)

Permette di impostare le informazioni relative alla fattura associata alla spedizione, utile per le spedizioni che devono passare la dogana.
Obbligatorio per DHL

number^*(string)	Numero della fattura
date(string)	Data della fattura (formato YYYY-MM-DD)

goodsCode(string)

Generale
FERCAM

Eventuale codice merce

Codici specifici per legare tariffazioni diverse legate alla tipologia di merce (da concordare con FERCAM).

Codice	Valore
	Se non viene specificato nessun parametro, non verrà impostato alcun codice merce.
BANC	Utilizzo del listino a bancale.

Response Body`200`

Descrizione

version(string)

Il numero di versione di questa API

result(string)

È "OK" se la trasmissione è andata a buon fine, "KO" in caso di errore

error(string)

L'eventuale messaggio di errore in caso di result "KO"

count(int)

Quanti ordini inviati nella richiesta

orders(array)

È un array che corrisponde al numero di ordini inviati nella richiesta.

row(int)	Numero di riga
reference(string)	Il riferimento dell'ordine inviato nella richiesta
orderID(int)	L'eventuale id numerico dell'ordine inviato nella richiesta
action(string)	Prevede i seguenti valori: imp: ordine importato upd: ordine aggiornato del: ordine cancellato skp: nessuna azione intrapresa ext: ordine già esistente err: segnala un errore
error(string)	L'eventuale errore nel caricamento di questo ordine

imported(int)

Contatore degli ordini importati

updated(int)

Contatore degli ordini aggiornati

deleted(int)

Contatore degli ordini cancellati

skipped(int)

Contatore degli ordini saltati

existing(int)

Contatore degli ordini già esistenti

Errori

Il messaggio di errore viene riportato nel campo "error".

getOrder

getOrder permette di recuperare un ordine.

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

REQUEST
RESPONSE

Parametri

Parametro

Descrizione

apiKey^*(string)

la API Key assegnata al canale che vogliamo interrogare

reference^*(string)

il riferimento ordine

data

Il flag data specifica quali e quanti dati vogliamo ricevere, di default torna dei dati minimi sullo stato di avanzamento della spedizione.
Può avere i seguenti valori:

Parametro	Descrizione
	se non viene specificato nessun parametro verranno ritornati i dati minimi
all	dati minimi + tutti i dati a seguire
deliveryInfo	dati minimi + informazioni sulle modalità di spedizione (spedizione entro, consegna entro)

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 permette di ricevere la lista degli ordini importati da Qapla'.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
[DATE]
updatedAt	data aggiornamento ordine in formato ISO 8601 "YYYY-MM-DD"
createdAt	data ordine in formato ISO 8601 "YYYY-MM-DD"
dateIns	data di caricamento in formato ISO 8601 "YYYY-MM-DD"
dateFrom / dateTo	forbice di date per il valore "updatedAt" in formato ISO 8601 "yyyy-mm-dd hh:mm:ss"

Se non viene passato nessun parametro [DATE] il default è dateFrom = 1 ora fa alle 00.

Response Body`200`

deleteOrder

deleteOrder permette di eliminare un ordine.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
reference^*(string)	il riferimento ordine

Response Body`200`

updateOrder

updateOrder è sopperita dall' impostazione pushOrder e si utilizza il parametro updatedAt per stabilire se l'ordine debba essere aggiornato.

updatedAt^*(YYYY-MM-DD HH:MM:SS)	Data di aggiornamento ordine. Attenzione Questa data viene usata per stabilire se aggiornare l'ordine su Qapla', ovvero se l'ordine è stato già importato da Qapla'. Un valore più recente di questo campo farà sì che Qapla' lo consideri come "ordine aggiornato" e quindi aggiorni tutti i dati precedentemente importati.

undeleteOrder

undeleteOrder permette di ripristinare un ordine eliminato.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
reference^*(string)	il riferimento ordine

Response Body`200`

detectOrderCourier

Attenzione

Questa API è attualmente in test. Richiedere l'attivazione al Customer Care.

detectOrderCourier permette di ottenere il corriere da assegnare all'ordine, seguendo regole preimpostate (impostazioni da configurare sul Control Panel).

Utile prima di una createLabel per identificare preventivamente il corriere da utilizzare.

È basata su 3 regole per identificare il corriere in base a peso, eventuale importo in contrassegno ed il CAP di destinazione.

Se si è in possesso di chiare regole come ad esempio le seguenti:

Peso	COD	CAP
minore o uguale a 3Kg			GLS
maggiore di 3Kg	minore di 100€		BRT
maggiore di 3Kg	maggiore di 100€	minore di 70000 (nord)	GLS
maggiore di 3Kg	maggiore di 100€	maggiore di 70000 (sud)	BRT

è possibile predeterminare e preassegnare il corriere all'ordine prima che l'etichetta venga creata, ad esempio con la createLabel.

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

REQUEST
RESPONSE

Request

Parametri

^*Parametro obbligatorio

Parametro	Descrizione
apiKey^*(string)	La API Key del canale
country^*(string)	La nazione del destinatario in formato ISO 3166-1 alpha-2 (Esempio: IT)
weight^*(float)	Eventuale peso dell'ordine
cod(float)	Importo della spedizione, se la spedizione è in contrassegno
postCode(string)	CAP del destinatario

Response Body`200`

Parametro	Descrizione
courier(json)	Contiene id, codice e nome del corriere identificato
rule(json)	Contiene id, e nome della regola identificata
request(json)	I parametri della request

Errori

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

fetchPlatformOrders

fetchPlatformOrders permette di ricevere la lista degli ordini presenti su una platform.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	La API Key assegnata al canale che vogliamo interrogare
platform(string)	La platform associata, per esempio un marketplace. Se non viene indicata, viene considerata la platform (CMS) associata al canale. Se nessuna platform è associata al canale, il parametro diventa obbligatorio per indicare un marketplace. Valori ammessi: 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 e teamsystemcommerce possono essere usati come sinonimi
dateFrom / dateTo(timestamp)	Forbice di date per il valore "updatedAt" in formato ISO 8601 "yyyy-mm-dd hh:mm:ss"
orderFormat(string)	Se viene passato il valore (platform) verranno restituiti gli ordini in formato originale. Nel caso in cui non venga passato alcun valore i risultati verranno restituiti in formato standard (qapla).
skip(string)	Se viene passato il parametro &skip (senza un valore) gli ordini verranno analizzati e saltati in caso lo stato ordine sia indicato come tra quelli da non considerare.

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
                }
                ]
                }
                ]
                }
                }

Errori

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

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

updatePlatformOrder

updatePlatformOrder permette di aggiornare gli ordini presenti su una platform.

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

REQUEST
RESPONSE

Autenticazione

L'autenticazione avviene tramite l'apiKey del canale, passando Q-API-Key nell'header della request

Parametro	Descrizione
Q-API-Key^*(string)	L' API Key del canale.

Parametri

Parametro	Descrizione
platform^*(string)	La platform associata, per esempio un marketplace. Valori ammessi: 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 e teamsystemcommerce possono essere usati come sinonimi
reference(string)	Il riferimento alfanumerico dell'ordine. Da inserire, se richiesto, in base alla platform specifica utilizzata.
orderID(int)	Riferimento numerico dell'ordine. Da inserire, se richiesto, in base alla platform specifica utilizzata.
courier^*(string)	Il codice corriere di Qapla'
trackingNumber^*(string)	Il tracking number dell'ordine da aggiornare
setShipped(bool)	E' true se è impostata la spedizione. Da utilizzare a seconda delle peculiarità della platform utilizzata.
setDelivered(bool)	E' true se è impostata la consegna. Da utilizzare a seconda delle peculiarità della platform utilizzata.
storeCountry(string)	Il codice nazione in formato iso 2 del marketplace. (se richiesto)
trackingUrl(string)	Eventuale URL per visualizzare informazioni sul tracking

Peculiarità

Miravia

setShipped o setDelivered sono obbligatori.

La request di aggiornamento con setShipped e trackingNumber deve essere ripetuta due volte a distanza di almeno 1 per policy del marketplace che richiede un intervallo di un'ora tra gli stati Ready To Ship e Shipped.

La request di aggiornamento con setDelivered va effettuata una sola volta a distanza di almeno 12 ore dalla seconda request con setShipped per policy del marketplace che richiede un intervallo di 12 ore tra gli stati Shipped e Delivered.

Response Body`200`

createLabel

createLabel permette di creare una etichetta in formato PDF o ZPL (impostazioni da configurare sul Control Panel).

Attenzione

Richiedere l'attivazione al Customer Care.

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

REQUEST
RESPONSE

Test

È possibile ottenere una "dummy label" di test utilizzando il corriere avente codice GENERIC.

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"
  }
}

Parametri

^*Parametro obbligatorio

Parametro Descrizione

apiKey^*(string) La API Key del canale

sandbox(boolean) È true se si vuole utilizzare la sandbox (modalità test)
Attenzione: questo parametro funziona se il corriere è già stato correttamente impostato sul canale.
Rivolgersi al Customer Care di Qapla'.

origin(string)

Origine della spedizione, valori ammessi:

    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 e teamsystemcommerce possono essere usati come sinonimi

reference^*(string) Il riferimento alfanumerico dell'ordine

orderID(string) Eventuale riferimento numerico dell'ordine

courier^*(string) Il codice corriere di Qapla'

courierService^*(string) Eventuale tipo del servizio del corriere; per esempio può essere il codice contratto di GLS Italy. Se il campo è vuoto o non viene inviato il default è '0'.

name^*(string) Nome del destinatario

address^*(string) Indirizzo del destinatario

city^*(string) Città del destinatario

state^*(string) Provincia del destinatario

postCode^*(string) CAP del destinatario

country^*(string) La nazione del destinatario in formato ISO 3166-1 alpha-2 (Esempio: IT)

email(string) Email del destinatario

telephone(string) Telefono del destinatario

amount(float) Importo della spedizione.
Specificare solo un separatore (il punto) per indicare i decimali, e non utilizzare separatori per indicare le migliaia. Indicare al massimo due cifre decimali. Esempio: 2340.23

shippingCost(float) Costo della spedizione.
Specificare solo un separatore (il punto) per indicare i decimali, e non utilizzare separatori per indicare le migliaia. Indicare al massimo due cifre decimali. Esempio: 9.35

currencyCode(string) Codice valuta ISO 4217 (default: EUR)

isCOD(boolean) È true se il pagamento è in contrassegno

payment(string) Eventuale metodo di pagamento dell'ordine. Può essere impostato su CONTRASSEGNO solo se anche isCOD è impostato a true

notes(string) Eventuali note dell'ordine

parcels(int|array)

Eventuali colli dell'ordine. Può anche essere definito come array indicando le informazioni di ogni singolo collo:

weight(float)	Eventuale peso dell'ordine. Obbligatorio se non viene inviato il "boxCode"
length(float)	Eventuali misure: lunghezza. Obbligatorio se non viene inviato il "boxCode"
width(float)	Eventuali misure: profondità. Obbligatorio se non viene inviato il "boxCode"
height(float)	Eventuali misure: altezza. Obbligatorio se non viene inviato il "boxCode"
boxCode(string)	Eventuale codice scatola (se utilizzato le misure verranno prese dalla scatola con codice corrispondente)
originCountry(string)	Nazione di origine del collo in formato ISO 3166-1 alpha-2 (Esempio: IT)
content(string)	Eventuale descrizione del contenuto

weight(float) Eventuale peso dell'ordine (non valido se "parcels" è un array)

length(float) Eventuali misure: lunghezza (non valido se "parcels" è un array)

width(float) Eventuali misure: profondità (non valido se "parcels" è un array)

height(float) Eventuali misure: altezza (non valido se "parcels" è un array)

shippingCODPaymentOption(string) La modalità di pagamento dell'eventuale contrassegno se diversa dalle impostazioni di default (da concordarsi)

shippingInsurance(float | string)

Generale
GLS-ITA
SDA
CRONO-PTI

Eventuale importo assicurato

ALL-IN: valorizzare il campo "shippingDeliveryOptions" inserendo la stringa: ALLIN

Per la generazione diretta con SDA, il valore va passato sotto forma di stringa, specificando uno dei seguenti codici:

Codice	Tipo di assicurazione
	Se non viene specificato nessun parametro, non verrà indicato alcun tipo di assicurazione
AS01	FINO A EURO 258,23
AS02	FINO A EURO 516,46
AS03	FINO A EURO 1.549,37
AS04	FINO A EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE FINO A EURO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX

Per la generazione diretta con CRONO PTI, il valore va passato sotto forma di stringa, specificando uno dei seguenti codici:

Codice	Tipo di assicurazione
	Se non viene specificato nessun parametro, non verrà indicato alcun tipo di assicurazione
AS01	FINO A EURO 258,23
AS02	FINO A EURO 516,46
AS03	FINO A EURO 1.549,37
AS04	FINO A EURO 2.582,28
AS05	ASSICURATA INTERNAZIONALE FINO A EURO 1.500,00
AS12	ASSICURATA ROAD EUROPE
AS13	ASSICURATA EXPORT BOX
AS14	ASSICURATA CRONO INTERNAZIONALE

shippingDeliveryOptions(string | JSON)

Generale
PTI
BRT

In caso si vogliano utilizzare due valori, questi devono essere separati da virgola
Esempio: A,P oppure 22,07

Per il corriere PTI bisogna usare un JSON strutturato come i seguenti esempi

In caso si vogliano utilizzare due valori, questi devono essere separati da virgola
Esempio: A,P oppure A,FRESH_YYYY-MM-DD

Nel caso di servizio fresh la data è opzionale:
Esempio: FRESH_YYYY-MM-DD, FRESH
Fresh con data: La data di scadenza sarà pari a quella passata
Fresh senza data: La data di scadenza sarà pari alla data della creazione etichetta più gli eventuali giorni inseriti nella configurazione canale.

Nota: Il corriere non accetta date inferiori alla data di creazione etichetta più 5 giorni, quindi nel caso dai calcoli precedenti risulti una data precedente, la data di scadenza sarà uguale al quinto giorno successivo alla data di creazione.

shippingRequiredDeliveryDate(YYYY-MM-DD) La data in formato YYYY-MM-DD di richiesta consegna

latestShipDate(string) Spedizione entro questa data in formato YYYY-MM-DD

latestDeliveryDate(string) Consegna entro questa data in formato YYYY-MM-DD

pickupDate(YYYY-MM-DD) La data in formato YYYY-MM-DD di ritiro richiesta al corriere

Per il corriere SDA, se questo campo non viene specificato in fase di creazione dell'etichetta, in fase di trasmissione verrà automaticamente assegnato il giorno lavorativo successivo a quello della trasmissione

gSpedPrinterID(int) Eventuale id stampante (user_id) per la Labeling Machine di Gsped (da concordarsi)

printNodePrinterID(int | string) Eventuale id o nome della stampante da utilizzare con PrintNode (da concordarsi)

forceReprint(int) Se impostato a 1 forza nuovamente la stampa dell'etichetta tramite PrintNode; valido se utilizzato con "printNodePrinterID"

content(string) Il contenuto della merce che potrà essere presente sull'etichetta(dipende dal corriere)

custom1(string) Campo personalizzato

custom2(string) Campo personalizzato

custom3(string) Campo personalizzato

sender

È il mittente della spedizione se diverso dall'intestatario del contratto.

Attenzione
Se il mittente è gia stato creato sul Control Panel o già inviato precedentemente questo viene codificato e sarà sufficiente inviare il solo codice.

"sender": "codicedelsender"

code^*(string)	Il codice da assegnare al mittente per una migliore identificazione
businessName(string)	Ragione sociale
street(string)	Indirizzo
city(string)	Città
state(string)	Provincia
postCode(string)	CAP
country(string)	Nazione in formato ISO 3166-1 alpha-2 (Esempio: IT)
email(string)	Email del mittente
telephone(string)	Telefono del mittente
referent(string)	Referente del mittente
isDefault(bool)	È true se il mittente verrà salvato come default per tutte le altre spedizioni

tradeDocuments(array)

Documenti elettronici da trasmettere al corriere. È possibile caricare più di un file per spedizione. Il peso massimo di ogni file è 5 MB.

Per il momento disponibile solo per i corrieri DHL, FedEx e UPS.

Trasmesso come un array di oggetti, con tre elementi obbligatori ciascuno:

type(string)	Il tipo del file, che varia a seconda del corriere (vedi tabella)
name(string)	Il nome del file
content(string)	Contenuto del file in codifica base64

	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)

È un array di "righe ordine".

Non è obbligatorio, ma se popolato ha alcuni dati che lo sono.

sku^*(string)

Codice articolo

name^*(string)

Descrizione articolo

qty^*(int)

Quantità

price^*(float)

Prezzo

total(float)

Prezzo totale

weight(float)

Eventuale peso dell'articolo

url(string)

La url specifica del prodotto

imageUrl(string)

La url dell'immagine del prodotto

notes(string)

Eventuale note prodotto

isReturnable(bool)

Prodotto abilitato per il reso. Se non impostato è true

customsCode(string)

Eventuale Codice Doganale (HSCode, Taric, ecc.)

originCountry(string)

Nazione di origine del prodotto in formato ISO 3166-1 alpha-2 (Esempio: IT)

netWeight(float)

Eventuale peso netto del prodotto

unitOfMeasurement(string)

Generale
DHL

Eventuale unità di misura

Codice	Descrizione
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)

Eventuale numero progressivo, identificativo del numero collo in cui viene spedito il prodotto

transparencyCodes(string[])

Array di Transparency Code

assemblyTypes(array)

Eventuale elenco di tipologie di montaggio, una per prodotto, per i corrieri che supportano questa informazioni

Generale
FERCAM

code^*(string)	Il codice della tipologia di montaggio scelta

Disponibile per il "courierService" 20 (HD). Deve essere specificato un elemento per ogni elemento di rows.

I valori disponibili per "code":

Code	Descrizione
5	Attivazione Elettrodomestici
09	Incasso forni/piano cottura con dichiaraz. Conf.
08	Incasso frigoriferi
07	Incasso lavastoviglie e lavatrici
11	Install. Clima DUAL con tubazione da predisporre
14	Install. Clima DUAL con tubazione già predisposta
10	Install. Clima MONO con tubazione da predisporre
13	Install. Clima MONO con tubazione già predisposta
12	Install. Clima TRIAL con tubazione da predisporre
15	Install. Clima TRIAL con tubazione già predisposta
K	Installazione base HD
Z	Installazione complessa HD
Y	Installazione media HD
W	Installazione semplice HD
06	Installazione TV a muro
20	Montaggio 30
17	Montaggio Cyclette
18	Montaggio Ellittica
4	Montaggio Strutture Multifunzione
16	Montaggio Tapis Roulant
1	Montaggio Tapis-Cyclette-Ellittica
2	Montaggio Tavoli Ping-Pong
3	Montaggio Vogatori

PUDO(object)

Permette di impostare un punto di Pick-up o Drop-off del ritiro della merce. Ogni campo va compilato in base alla necessità del corriere. Far riferimento alle tabelle poco sotto

id^*(string)	Identificativo del PUDO
type(string)	Tipologia Servizio
name(string)	Nome del servizio
address(string)	Indirizzo del punto di Pick-up o Drop-off
city(string)	Città del punto Pick-up o Drop-off
state(string)	Provincia del punto di Pick-up o Drop-off
country(string)	Nazione del punto di Pick-up o Drop-off
postalCode(string)	CAP del punto di Pick-up o Drop-off
description(string)	Descrizione
harmonisedId(string)	Id numerico aggiuntivo del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es. 104
keyword(string)	Keyword del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es 'DHL Servicepoint'
psfKey(string)	PsfKey del punto di Pick-up o Drop-off, ricavabile dalla getPudos. Es 'ES-0004240'
postnumber(string)	Postnumber del punto di Pick-up o Drop-off, se di tipo 'packstation'. E' un codice che il cliente finale possiede personalmente

**DHL / BRT / INPOST / FEDEX / MRW / SENDING**
Attributo	Valore
id^*(string)	Codice o identificativo del PUDO

**TNT ITA / GLS-ITA**
Attributo	Valore
id^*(string)	Valori possibili: TNT: Codice identificativo del TNT point/Locker; GLS-IT: Codice identificativo chiamato SHOP_ID;
type^*(string)	Valori possibili: TNT: 3 (TNT point) o 5 (TNT Locker); GLS-IT: Codice identificativo chiamato PARTNER_SHOP_ID;

**PTI(Poste Italiane)**
Attributo	Valore
id^*(string)	Codice o identificativo del PUDO
type^*(string)	Valori possibili: `ConsegnaPuntoPoste` `ConsegnaUfficioPostale` `ConsegnaLocker` `ConsegnaPUDOUPS`
name^*(string)	Nome del Punto di Ritiro
address^*(string)	Indirizzo del Punto di Ritiro
postalCode^*(string)	CAP del Punto di Ritiro
city^*(string)	Città/Località del Punto di Ritiro
province^*(string)	Provincia del Punto di Ritiro
country^*(string)	Nazione del Punto di Ritiro

**UPS**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
name^*(string)	Name
postalCode^*(string)	CAP
state^*(string)	Provincia

**SDA**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
name^*(string)	Nome
postalCode^*(string)	CAP
state^*(string)	Provincia

**DHL-PAKET**
Attributo	Valore
id^*(string)	Codice o identificativo
type^*(string)	Tipo di PUDO ("locker" o "postoffice")
city^*(string)	Città
name^*(string)	Nome del PUDO
country^*(string)	Nazione
postalCode^*(string)	CAP
postnumber(string)	PostNumber. Obbligatorio per il type "postoffice"

**DHLPARCEL-ES**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP
harmonisedId^*(string)	Harmonized Id
keyword^*(string)	Keyword
psfKey^*(string)	PsfKey
postnumber(string)	PostNumber

**GLS-SPAIN**
Attributo	Valore
id^*(string)	Codice o identificativo
name^*(string)	Nome del PUDO
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP

**CORREOS-EXPRESS**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
country^*(string)	Nazione
postalCode^*(string)	CAP

**SEUR**
Attributo	Valore
id^*(string)	Codice o identificativo

**TIPSA**
Attributo	Valore
id^*(string)	Codice o identificativo
address^*(string)	Indirizzo
city^*(string)	Città
name^*(string)	Nome del PUDO
postalCode^*(string)	CAP

invoice(object)

Permette di impostare le informazioni relative alla fattura associata alla spedizione, utile per le spedizioni che devono passare la dogana.
Obbligatorio per DHL

number^*(string)	Numero della fattura
date(string)	Data della fattura (formato YYYY-MM-DD)

dangerousGoods(JSON)

FEDEX

Per il corriere FEDEX bisogna usare un JSON strutturato come segue

parcel: rappresenta il numero del parcel che contiene i dangerous good (nell'esempio una spedizione con 3 parcels di cui solo il primo e il terzo contengono dangerous goods)

type: battery

batteryPackingType: può assumere 2 valori

CONTAINED_IN_EQUIPMENT
PACKED_WITH_EQUIPMENT

batteryMaterialType: può assumere 2 valori

LITHIUM_METAL
LITHIUM_ION

forceLabelsOutput(int)

Se impostato a 1, la api "createLabel" restituirà le etichette generate anche quando viene stampata con PrintNode o GLM. Utilizzabile solo se "printNodePrinterID" o "gSpedPrinterID" sono a loro volta impostati. Valore di default: 0

goodsCode(string)

Generale
FERCAM

Eventuale codice merce

Codici specifici per legare tariffazioni diverse legate alla tipologia di merce (da concordare con FERCAM).

Codice	Valore
	Se non viene specificato nessun parametro, non verrà impostato alcun codice merce.
BANC	Utilizzo del listino a bancale.

Response Body`200`

Parametro	Descrizione
isShipped(boolean)	È true se l'ordine è già stato etichettato e restituisce l'etichetta già creata.
id(int)	L'id della spedizione. Importante per invocare altre API.
trackingNumber(string)	Il tracking number della spedizione.
returnTrackingNumber(string)	Se richiesta etichetta di reso contestuale
format(string)	Il formato dell'etichetta PDF (base64) JPG (base64) ZPL
labels(array)	Un array con il base64 delle etichette ottenute (potrebbero esserci più etichette per più colli o resi, ecc.). Oppure Lo ZPL per la stampa su Zebra, come configurato sul Control Panel.

Errori

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

deleteLabel

deleteLabel permette di eliminare un'etichetta creata con createLabel.

Attenzione

Questa API è attualmente in test. Richiedere l'attivazione al Customer Care.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
id^*(int)	L'id dell'etichetta tornato da createLabel

Response Body`200`

getLabel

getLabel permette scaricare un'etichettta precedentemente creata su Qapla' nel formato originale del corriere (PDF, JPG o ZPL).

Attenzione: la getLabel NON funziona con le dummy label create con il corriere GENERIC (anche con la createLabel).

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

Parametri

Parametro	Descrizione
apiKey^*(string)	la API Key assegnata al canale che vogliamo interrogare
Parametri esclusivi
trackingNumber(string)	il tracking number interessato
reference(string)	il riferimento ordine
parcel(int)	Il numero del collo (default = 1) - Disponibile solo per le etichette in formato PDF
id(int)	l'id della spedizione
json(string)	se passato (es: &json) forza la response come JSON
getReturnLabel(string)	se passato (es: &getReturnLabel) restituisce l'etichetta di reso contestuale

Response Body`200`

L'etichetta con il corretto content type (JPG, PDF o testo per la ZPL)

Oppure, se usato il parametro &json

Errori

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

checkLabel

checkLabel permette di verificare lo stato di una etichetta precedentemente creata.

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

Parametri

Parametro	Descrizione
apiKey^*(string)	La API Key assegnata al canale che vogliamo interrogare
Parametri esclusivi
trackingNumber(string)	Il tracking number interessato
reference(string)	Il riferimento ordine
id(int)	L'id dell'etichetta

Response Body`200`

Errori

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

confirmLabel

confirmLabel permette di confermare e trasmettere al corriere le etichette create con createLabel e di ottenere la Distinta di carico (borderò/manifest) in formato PDF .

Attenzione

Richiedere l'attivazione al Customer Care.

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

REQUEST
RESPONSE

Request

Parametri

Attenzione Utilizzare "labelCreationDate" oppure "labelID".

^*Parametro obbligatorio

Parametro	Descrizione
apiKey^*(string)	La API Key del canale
courier^*(string)	Il codice corriere di Qapla'
labelCreationDate^*(date)	La data della creazione etichette in formato ISO 8601 "YYYY-MM-DD"
labelID^*(array)	Generale GLS-AT Un array degli ID delle spedizioni ottenuto con createLabel Parametro non supportato per questo corriere, utilizzare solo il parametro labelCreationDate

Response Body`200`

Parametro	Descrizione
courier(string)	Il codice del corriere
number(string)	Il numero della conferma
date(string)	La data di conferma
shipments(int)	Il numero di spedizioni confermate
error(array\|string)	Errori riscontrati in fase di conferma
manifest(string)	Il manifest in PDF codificato Base64

Errori

In caso tutte le spedizioni siano andate in errore, il campo "result" conterrà "KO" ed il campo "error" sarà una stringa contenente la descrizione dell'errore.
In caso contrario il campo "error" sarà un array contenente i dettagli dei singoli errori.

getCouriers

getCouriers permette di richiedere l'elenco dei corrieri sia totale, sia per singola nazione /ragione.

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

REQUEST
RESPONSE

Parametri

Parametro

Descrizione

apiKey

la API Key assegnata al canale che vogliamo interrogare

Parametri opzionali

country

vuoto per tutti i corrieri, o un elenco di valori nazione separati da virgola

country=it,fr,global

I valori disponibili sono:

	at	Austria
	be	Belgio
	ch	Svizzera
	cn	Cina
	cy	Cipro
	cz	Repubblica Ceca
	de	Germania
	dk	Danimarca
	ee	Estonia
	es	Spagna
	eu
	fi	Finlandia
	fr	Francia
	gb	Regno Unito
	global
	gr	Grecia
	hk	Hong Kong
	hr	Croazia
	hu	Ungheria
	ie	Irlanda
	it	Italia
	kr	Corea del Sud
	lt	Lituania
	lv	Lettonia
	mt	Malta
	my	Malaysia
	nl	Paesi Bassi
	pl	Polonia
	pt	Portogallo
	ru	Russia
	se	Svezia
	si	Slovenia
	us	USA
	za	Sud Africa

code

Il codice Qapla' del corriere

code=BRT

hasLabels

Seleziona i corrieri che hanno la generazione etichette su Qapla'

Response Body`200`

Il seguente URL

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

darà come risultato:

{"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 cerca di determinare il corriere dal tracking number fornito, rispondendo con un elenco di corrieri.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare
trackingNumber	Il tracking number da identificare

Response Body`200`

getPudos

getPudos permette di richiedere l'elenco dei PUDO (Pick Up Drop Off points) di più corrieri contemporaneamente.

Attenzione

Richiedere l'attivazione al Customer Care.

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

REQUEST
RESPONSE

Request

Parametri

^*Parametro obbligatorio

Parametro	Descrizione
apiKey^*(string)	La API Key del canale. Può essere, in alternativa, fornita come parametro di query nell'URL della richiesta, sempre utilizzando il metodo http POST. Esempio: POSThttps://api.qapla.it/1.2/getPudos/?apiKey=[API_KEY]
postCode^*(string)	CAP della località di cui si intende cercare i PUDO
country^*(string)	Codice ISO 3166-2 della nazione in cui è localizzato il postCode. Non viene effettuato un controllo sulla qualità del codice
couriers(array)	Elenco dei “Codici corriere” di Qapla' di cui si vuole conoscere i PUDO. I codici corriere validi sono BRT, DHL, DHL-PAKET, DHLPARCEL-ES, FEDEX, FERMOPOINT, GLS, INPOST, PTI, UPS, CORREOS, TIPSA, CORREOS-EXPRESS, MRW-ES, SEUR, NACEX-ES e SENDING. Se questo parametro non viene specificato o viene lasciato vuoto, verranno recuperati i PUDO di tutti i corrieri validi e configurati su Qapla'.
province(string)	Provincia della località oggetto di ricerca
city(string)	Città/comune della località oggetto di ricerca (obbligatorio per TIPSA)
street(string)	Indirizzo, completo di eventuale numero civico
radius(number)	Raggio, espresso in KM, entro il quale limitare la ricerca dei PUDO. Specificare un valore ≤ 0 equivale a non specificare nessun raggio
limit(number)	Numero di PUDO restituiti per ogni corriere. Specificare un valore ≤ 0 equivale a non specificare nessun limite, in questo caso il corriere restituirà il suo 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"
  }
}

Parametro

Descrizione

result(string)

Indica se l'operazione è andata a buon fine, i valori possibili sono “OK” e “KO”

error(string)

Contiene la descrizione dell'eventuale errore che è stato sollevato, vuoto se result = “OK”

data(array)

Array di oggetti contenenti l'elenco dei PUDO. Ogni elemento dell'array corrisponde alla risposta ottenuta da un corriere

statusCode(int)

Codice di Errore, esito dell'interrogazione effettuata nei confronti del corriere

200(int)	OK/No error
404(int)	NOT FOUND; il webservice del corriere ha restituito un elenco vuoto di PUDO
408(int)	TIMEOUT; il webservice del corriere ha impiegato troppo tempo a rispondere
500(int)	GENERIC ERROR;
501(int)	EMPTY RESPONSE; il webservice del corriere non ha restituito una risposta
522(int)	UNPROCESSABLE RESPONSE; il webservice del corriere ha restituito un output che non è stato possibile interpretare (es. JSON o XML non valido)
599(int)	CUSTOM ERROR; il webservice ha risposto con un errore specifico per il corriere interrogato, maggiori informazioni sull'errore si possono trovare nel campo "error"

courier(string)

Codice del corriere interrogato (es. GLS, DHL, PTI, ecc.)

error(string)

Eventuale descrizione dell'errore se ne è stato sollevato uno durante l'interrogazione del singolo corriere

servicePointList(array)

Array di oggetti contenenti l'elenco dei PUDO. Ogni elemento dell'array corrisponde alla risposta ottenuta da un corriere

ID(string)	Identificativo interno utilizzato dal corriere
name(string)	Nome dell'esercizio/negozio/locker
type(string)	Identifica la tipologia del PUDO: SHOP = negozio, POSTOFFICE = ufficio postale, LOCKER = locker, SHOPINSHOP = negozio all'interno di un altro negozio (usato da GLS)
telephone(string)	Numero di telefono
street(string)	Indirizzo del PUDO
postCode(string)	CAP del PUDO
city(string)	Città/comune del PUDO
province(string)	Provincia del PUDO
country(string)	Codice nazione del PUDO (2 caratteri)
coordinates(oggetto)	Contiene due attributi, “latitude” e “longitude”, di tipo float, che contengono rispettivamente latitudine e longitudine del punto geografico in cui si trova il PUDO
distance(float)	La distanza in Km dall'indirizzo/località che è stato oggetto di ricerca
notes(string)	Eventuali note/indicazioni
businessDays(array)	Indica i giorni e gli orari di apertura del PUDO, si veda il paragrafo dedicato
availableServices(array)	Array di oggetti formati da due attributi “serviceCode” e “serviceDescription”, entrambi di tipo string; rappresentano i servizi disponibili presso il PUDO; il campo “serviceCode” potrebbe essere assente se non previsto dal corriere
courierSpecific(array)	Array di oggetti formati da due attributi “name” e “value”, entrambi di tipo string; rappresentano campi specifici per un determinato corriere (es. harmonizedId per DHLPARCEL-ES)
holidays(array di oggetti)	Array di oggetti formati da due attributi “startDate” e “endDate”, entrambi di tipo string e rappresentati rispettivamente data di inizio e data di fine di periodi di chiusura previsti. Le date sono nel formato “yyyy-mm-dd”
pushOrderPUDO(oggetto)	Oggetto JSON che può essere passato alla API "pushOrder" e può prevedere campi diversi a seconda del corriere. Per maggiori informazioni vedere pushOrder

Business Days

Un oggetto dell'array businessDays rappresenta un giorno di apertura settimanale e presenta diversi attributi:

Parametro	Descrizione
day(int)	Indica il numero del giorno della settimana secondo la codifica ISO 8601 ( 1 = Lunedì…7 = Domenica)
dayName(string)	Il nome del giorno della settimana in inglese
dayNameIT(string)	Il nome del giorno della settimana in italiano
businessHours(array)	Array di oggetti formati da due attributi, “open” e “close”, entrambi di tipo string, rappresentanti un orario nel formato “hh:mm”

getQuotes

getQuotes permette di richiedere preventivi di spedizione a più corrieri per più servizi contemporaneamente.

Attenzione

Richiedere l'attivazione al Customer Care.

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

REQUEST
RESPONSE

Request

Header

^*Parametro obbligatorio

Parametro	Descrizione
x-api-key^*(string)	L' API Key del canale.
x-sandbox(string)	Richiede l'esecuzione in sandbox per test, i valori restituiti in questa modalità potrebbero non essere realistci. Valori ammessi "true" o "false". GLS-ITA Non fornisce un ambiente sandbox, quindi le richieste vengono inviate ai server di produzione.

Body

^*Parametro obbligatorio

Parametro

Descrizione

reference^*(string)

Codice di riferimento univoco, viene reinviato nella risposta, accetta solo lettere maiuscole, lettere minuscole, numeri e i simboli "-", "_" e "."

senderCode(string)

Codice mittente Qapla' da usare per il preventivo. Se valorizzato la procedura utilizzerà i dati del mittente del Canale con tale codice; se il valore inserito è inesistente ritornerà un errore; in caso non venga valorizzato la procedura utilizzerà il mittente di default o l'indirizzo dell'Azienda.
NOTA: per GLS-ITA non è possibile specificare un senderCode.

recipient^*(object)

Destinatario

street^*(string)	Indirizzo del destinatario, eventualmente inclusivo del numero civico
zipCode(string)	CAP del destinatario (obbligatorio in Europa)
city^*(string)	Città del destinatario, per spedizioni internazionali inserire il nome internazionale (inglese)della città
province(string)	Provincia (obbligatorio in Italia) o stato (dove applicabile) del destinatario
country^*(string)	Nazione del destinatario, come codice ISO a 2 caratteri

(i campi richiesti per ottenere un preventivo variano a seconda del corriere, in generale sono richiesti almeno la nazione e lo zipcode o l'indirizzo e la città)

currency(string)

Valuta usata per valorizzare i campi monetari e in cui si richiede il preventivo espressa in stringa di tre caratteri. Se non specificata viene considerato il valore "EUR"
Nessuna conversione viene effettuata
I seguenti corrieri non supportano la scelta della valuta e riportano errore se viene richiesta qualsiasi valuta diversa da EUR: GLS-ITA, LICCARDI
Inoltre i corrieri possono restituire preventivi in valuta diversa da quella qui indicata. La valuta del preventivo viene riportata nella risposta.

amountShipment^*(float)

Valore della spedizione, nella valuta specificata dal campo currency. Formato float con 2 decimali senza simboli per la valuta (#.##).

amountInsurance(float)

Valore assicurato della spedizione, nella valuta specificata dal campo currency o in Euro per i corrieri che non lo supportano. Formato float con 2 decimali senza simboli per la valuta (#.##)
Non valorizzare (o valorizzare con 0) se non si vuole il servizio di assicurazione della merce.

amountCash(float)

Valore del contrassegno della spedizione, nella valuta specificata dal campo currency o in Euro per i corrieri che non lo supportano. Formato float con 2 decimali senza simboli per la valuta (#.##).
Non valorizzare (o valorizzare con 0) se non si vuole il servizio di contrassegno.

parcels^*(array)

Lista dei colli nella spedizione

weight^*(float)	Peso del collo in kg NOTA: Questi corrieri accettano solo valori interi, quindi il valore fornito verrà arrotondato per eccesso: TNT-ITA
width^*(float)	Larghezza del collo in cm NOTA: Questi corrieri accettano solo valori interi, quindi il valore fornito verrà arrotondato per eccesso: GLS-ITA, FEDEX, LICCARDI, TNT-ITA
height^*(float)	Altezza del collo in cm NOTA: Questi corrieri accettano solo valori interi, quindi il valore fornito verrà arrotondato per eccesso: GLS-ITA, FEDEX, LICCARDI, TNT-ITA
length^*(float)	Lunghezza del collo in cm NOTA: Questi corrieri accettano solo valori interi, quindi il valore fornito verrà arrotondato per eccesso: GLS-ITA, FEDEX, LICCARDI, TNT-ITA

couriers(array)

Elenco dei "Codici corriere" di Qapla' di cui si vuole ottenere il preventivo. I codici corriere validi sono DHL, FEDEX, GLS-ITA, LICCARDI, TNT-ITA, UPS e AMAZON-SHIPPING. Se questo parametro non viene specificato o viene lasciato vuoto, verranno richiesti i preventivi di tutti i corrieri validi e configurati su 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": []
        }
      ]
    }
  }

Parametro

Descrizione

result(string)

Indica se l'operazione è andata a buon fine, i valori possibili sono “OK” e “KO”.

version(string)

Versione della API che ha generato la risposta.

reference(string)

Ripete il campo reference della richiesta.

quotationId(string)

Identificatore univoco della richiesta assegnato dal nostro sistema (formato UUIDv4).

startTimestamp(string)

Data e ora in cui la richiesta è stata ricevuta (formato RFC3339).

finishTimestamp(string)

Data e ora in cui la richiesta è stata evasa (formato RFC3339).

couriers(array)

Array di oggetti rappresentanti le risposte per ogni corriere interrogato

code(string)

“Codice corriere” di Qapla' a cui fanno riferimento i preventivi contenuti.

quotes(array)

La lista di quotazioni ritornate da questo corriere

service(object)

Il servizio del corriere preventivato in questo elemento

courierCode(string)	“Codice servizio” del corriere.
qaplaCode(int)	“Codice servizio” di Qapla'.
description(string)	Nome descrittivo del servizio.

messages(array)

Lista di oggetti rappresentanti avvisi riguardanti le quotazioni per uno specifico servizio

type(string)	Il tipo di messaggio (message\|error).
code(string\|int)	Codice di errore numerico se riportato.
content(string)	Descrizione testuale del messaggio.

deliveryOptions(array)

Lista con le eventuali opzioni di consegna abbinate al servizio (il contenuto dipende dal corriere)

type(string)	Il tipo di opzione (0 = Altra opzione; 1 = Opzione di consegna).
code(string\|int)	Codice dell'opzione.
content(string)	Descrizione testuale dell'opzione.

currency(string)

Codice valuta in cui è riportato il costo preventivato.

amount(float)

Il valore del preventivo

expectedPickupDate(string)

Data di ritiro presunta dei colli per la spedizione nel formato yyyy-MM-dd.

expectedDeliveryDate(string)

Data di consegna presunta della spedizione nel formato yyyy-MM-dd.

messages(array)

Array di oggetti rappresentanti avvisi riguardanti le quotazioni riportate da questo corriere

type(string)	Il tipo di messaggio (message\|error)
code(string\|int)	Codice di errore numerico se riportato
content(string)	Descrizione testuale del messaggio

apiVirtual

apiVirtual permette di aggiornare lo stato di una spedizione del corriere virtuale.

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

REQUEST
RESPONSE

Parametri

^*Parametro obbligatorio

apiKey^*(string)

La API Key assegnata al canale che vogliamo interrogare

apiVirtual(array)

È un array che può contenere massimo 100 aggiornamenti.

trackingNumber^*(string)	Il tracking number della spedizione da aggiornare
statusID / statusDetailID^*(float)	L'ID dello stato della spedizione e l'eventuale statusDetailID
status(string)	La descrizione testuale dello stato della spedizione
place(string)	La località dove si trova la spedizione
date(YYYY-MM-DD HH:MM:S)	La data in formato ISO 8601 "yyyy-mm-dd hh:mm:ss"
note(string)	Eventuali note della spedizione

Response Body`200`

Errori

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

getChannel

getChannel permette di ottenere informazioni sul canale collegato all'API Key e alla azienda che lo ha creato.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare
Parametri opzionali
data	Ottiene informazioni sulla configurazione del canale rispetto alla piattaforma e/o ai marketplace. Valori possibili (all, platform, marketplaces)

Response Body`200`

checkChannel

Permette di verificare le connessioni con la piattaforma e i marketplace configurati sul canale.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare

Response Body`200`

Errori

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

getChannelMonitor

getChannelMonitor permette di ottenere informazioni sull'utilizzo del canale collegato all'API Key in un certo periodo.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare
Parametri opzionali
range	Ottiene informazioni sul canale per uno specifico periodo. Valori possibili (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

Permette di creare un nuovo canale.

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"
                            }
                          ]
                       }
                    }
                  }
                }

Parametri

^*Parametro obbligatorio

Parametro

Descrizione

apiKey^*(string)

La API Key del canale

createChannel^*(object)

code^*(string)

Il codice del canale (Es. "MOC", "MYCH" )

name^*(string)

Il nome del canale (Es. "Questo è il mio canale")

url^*(string)

Url assoluto del tuo sito/ecommerce (Es. https://www.example.org)

orderSettings(object)

import(string)

Definisce il tipo di importazione

Codice	Tipo di importazione
none	Nessuna importazione
auto	Importazione automatica
manual	Importazione manuale

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)	Aggiorna l'ordine in "spedito" quando viene creata la spedizione
updateWhenShippedLocationID(string)	ID posizione recuperato dal tuo account Shopify
updateWithShipmentStatus(bool)	Aggiorna con gli stati di spedizione

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)

Abilita/disabilita marketplace

update^*(bool)

Aggiorna ordine

amazonSellerID^*(string)

amazonMWSAuthorisationToken^*(string)

amazonMarketplacesID(array object)

country^*(string)

Valori ammessi:

Codice	Paese
IT	Italia
GB	Gran Bretagna
ES	Spagna
FR	Francia
DE	Germania

marketplaceID^*(string)

carrefour(object)

active^*(bool)

Abilita/disabilita marketplace

update^*(bool)

Aggiorna ordine

settings(array object)

country^*(string)	Valore ammissibile: ES
apiKey^*(string)

cdiscount(object)

active^*(bool)	Abilita/disabilita marketplace
username^*(string)
password^*(string)

ebay(object)

eprice(object)

active^*(bool)	Abilita/disabilita marketplace
update^*(bool)	Aggiorna ordine
apiKey^*(string)

ibs(object)

active^*(bool)	Abilita/disabilita marketplace
update^*(bool)	Aggiorna ordine
apiKey^*(string)

manomano(object)

apiKey^*(string)

settings^*(array object)

active^*(bool)

Abilita/disabilita marketplace

country^*(string)

Valori ammessi:

Codice	Paese
IT	Italia
GB	Gran Bretagna
ES	Spagna
FR	Francia
DE	Germania

login^*(string)

password^*(string)

apiKey(string)

Necessario per API REST

sellerContractId(string)

Necessario per API REST

privalia(object)

active^*(bool)

Abilita/disabilita marketplace

update^*(bool)

Aggiorna ordine

settings(array object)

apiKey^*(bool)
country^*(string)	Valori ammissibili: IT, ES

spartoo(object)

active^*(bool)	Abilita/disabilita marketplace
update^*(bool)	Aggiorna ordine.
apiKey^*(string)
domainsCountry^*(array)	Valori ammissibili: "it","es","fr","de","gb","pt","nl","gr","be","pl","cn"

worten(object)

active^*(bool)

Abilita/disabilita marketplace

update^*(bool)

Aggiorna ordine.

settings(array object)

apiKey^*(bool)
country^*(string)	Valore ammissibile: PT

Response Body`200`

Errori

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

updateChannel

Permette di modificare alcune impostazioni del canale.

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

REQUEST
RESPONSE

Request

Parametri

^*Parametro obbligatorio

Parametro	Descrizione
apiKey^*(string)	La API Key del canale
updateChannel^*(object)	Come da oggetto in creazione

Response Body`200`

Errori

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

deleteChannel

Permette di eliminare uno specifico canale.

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

REQUEST
RESPONSE

Request

Parametri

^*Parametro obbligatorio

Parametro

Descrizione

deleteChannel^*(object)

apiKey^*(string)	La API Key del canale

Response Body`200`

Errori

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

getCredits

getCredits permette di ottenere i crediti rimanenti sul proprio account premium.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey	la API Key assegnata al canale che vogliamo interrogare

Response Body`200`

Descrizione

result(string)	Il risultato dell'operazione: OK o KO in caso di errore
error(string)	L'errore in caso di result: KO
credits(int)	I crediti rimanenti
date(string)	La data di aggiornamento del conteggio

getQaplaStatus

getQaplaStatus permette di ottenere l'elenco dettagliato degli stati spedizione Qapla'.

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

REQUEST
RESPONSE

Parametri

Parametro	Descrizione
apiKey(string)	la API Key assegnata al canale che vogliamo interrogare
Parametri opzionali
lang(string)	La lingua dei nomi degli stati Qapla' (it, en, es), default: it. Esempio: &lang=en
id(int)	Eventuale id del quale si vuole ottenere informazioni Esempio: &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)

Il risultato dell'operazione: OK o KO in caso di errore

error(string)

L'errore in caso di result: KO

version(string)

La versione dell'API

qaplaStatus(array)

È un array di stati

statusID(int)	Lo stato Qapla'
status(string)	Il nome dello stato
statusDescription(string)	La descrizione dello stato
color(string)	Il colore assegnato allo stato
icon(string)	L'icona assegnata allo stato
statusDetailID(int)	L'eventuale dettaglio dello stato
statusDetail(string)	Il nome del dettaglio
statusDetailDescription(string)	La descrizione del dettaglio

Tracking Script

Inserendo e configurando il nostro Tracking Script, è possibile ottenere il tracking in qualunque parte del sito.

<!-- 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>

Parametri

Parametro

Descrizione

apiKey^*(string)

La API KEY “pubblica” presente nella configurazione del canale di vendita sul Control Panel (CP) di Qapla’.

reference^*/ trackingNumber^*(string)

Tracciare per riferimento ordine o per tracking number.

noCSS(bool)

se true non include il css standard, permettendo un override.

compact(bool)

se true visualizza una versione compatta, senza gli stati propri del corriere.

lang(string)

se impostato mostra gli stati del corriere nella lingua selezionata. Se non impostato viene utilizzato il default ('it')

lang(string)

Lingue in cui è possibile visualizzare gli stati corriere

it(string)	Italiano
en(string)	Inglese
de(string)	Tedesco
fr(string)	Francese
es(string)	Spagnolo
pt(string)	Portoghese
zh(string)	Cinese
ru(string)	Russo
jp(string)	Giapponese
cs(string)	Ceco
rn(string)	Romeno
hu(string)	Ungherese
ar(string)	Arabo
sk(string)	Slovacco
pl(string)	Polacco
kr(string)	Coreano

Risultato

Il risultato è un HTML che verrà inserito dentro l'elemento con id qapla-tracking avente il seguente contenuto.

Qapla' Status

È l'interpretazione dello stato della spedizione con dei valori che Qapla' assegna a ciascun possibile stato del corriere.

id	detailID	Nome	Descrizione
0		ATTESA ELABORAZIONE	La gestione automatica di interrogazione del corriere non è ancora stata eseguita.
1		IN SOSPESO	La spedizione è stata trovata ma non ci sono ancora notizie da parte del corriere.
2		ATTESA RITIRO	Il corriere non ha ancora ritirato la spedizione.
20		PARTITO	La spedizione è partita.
3		IN TRANSITO	La merce è in transito.
50		IN LAVORAZIONE	Spedizione in lavorazione
50	1	IN LAVORAZIONE • DOGANA
4		IN CONSEGNA	Spedizione in consegna.
5		TENTATIVO DI CONSEGNA FALLITO	La consegna è fallita. Pre-allarme per possibili problemi.
8		RITARDO	La spedizione sta subendo dei ritardi.
6		ECCEZIONE	Viene segnalato un qualche problema che può essere generico o spiegato da ulteriori icone.
6	1	ECCEZIONE • GIACENZA	La spedizione è in giacenza
6	2	ECCEZIONE • SPEDIZIONE IN RIENTRO / RIFIUTATA	La spedizione è stata rifiutata e la merce è in rientro.
6	3	ECCEZIONE • DANNEGGIAMENTO	Il corriere segnala che la merce risulta danneggiata.
6	4	ECCEZIONE • SMARRIMENTO	Il corriere segnala che la merce risulta smarrita.
6	5	ECCEZIONE • CONSEGNA PARZIALE
10		PUNTO DI RITIRO	La spedizione è stata consegnata in un Punto di Ritiro.
95		RIENTRATO	La spedizione è rientrata al mittente.
99		CONSEGNATO	La spedizione è stata consegnata al destinatario.

Corrieri

Elenco dei codici Qapla' per corriere, in ordine alfabetico.

Codice	Nome	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/

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

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

Nuove API v2

Introduzione

Ultima versione disponibile

Versioni precedenti

Webhook

API Key

Endpoint

Response

Limiti di utilizzo

HTTP Response Status Codes

Abuse

Sandbox

Test

Postman Collection

Spedizioni

pushShipment

Request

Parametri

Response Body200

Errori

getShipment

Parametri

Response Body200

Descrizione

Errori

getShipments

Parametri

Response Body200

Descrizione

Errori

updateShipment

Parametri

Response Body200

deleteShipment

Parametri

Response Body200

undeleteShipment

Parametri

Response Body200

trackingByTimeFrame

Parametri

Response Body200

Descrizione

Ordini

pushOrder

Parametri

Response Body200

Descrizione

Errori

getOrder

Parametri

Response Body200

getOrders

Parametri

Response Body200

deleteOrder

Parametri

Response Body200

updateOrder

undeleteOrder

Parametri

Response Body200

detectOrderCourier

Request

Parametri

Response Body200

Errori

Platforms

fetchPlatformOrders

Parametri

Response Body200

Errori

updatePlatformOrder

Autenticazione

Parametri

Peculiarità

Response Body200

Etichette

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`