DHL

Lista codici Gsped

Servizio
Codice corriere
Codice servizio
Note

Domestic Express

104
0

Domestico

Domestic Express H12

104
1

Domestico

Domestic Express H10:30

104
2

Domestico

Domestic Express H9

104
4

Domestico

Express Worldwide H12

104
7

Internazionale

Economy Select

104
8

Internazionale

Express Worldwide

104
9

Internazionale

Express Worldwide H9

104
10

Internazionale

DHL ICS2 (CIN)

Per le spedizioni extraUe il corriere richiede obbligatoriamente che nella chiamata Shipment vengano valorizzati:

Fatture attive

C'è la possibilità di inviare dati della fattura (per ora solamente la p.iva / codice fiscale) dello Shipper al corriere valorizzando il campo fattura_dhl in questo modo

"fattura_dhl": [
    {
      "codice_fiscale": "02554360061", // codice fiscale o partita iva
      "pec": null,
      "sdi": "0000000",
      "nome": "Nome intestatario",
      "indirizzo": "Indirizzo completo",
      "cap": "20148",
      "citta": "Milano",
      "provincia": "MI",
      "nazione": "IT",
      "type": "privato",
      "email": "noreply@gsped.com",
      "nolo": 18.01,
      "totale_fattura": 18.01,
      "assicurazione": null,
      "valore": 0
    }

Addebito terzo

Per DHL è stato reso possibile indicare i codici clienti di un terzo per addebitargli i costi di spedizione e/o gli oneri doganali.

Di seguito alcuni esempi di payload da utilizzare nelle varie casistiche :

Costi spedizione e oneri doganali a terzo :

"parties": {
        "freightPayer": {
            "country": "IT",
            "clientCode": "abcdef"
        },
        "customsPayer": {
            "country": "IT",
            "clientCode": "ghjki"
        }
    }

ATTENZIONE:

In caso il codice terzo sia radicato nella stessa nazione in cui è destinata la spedizione, il codice cliente DEVE essere di tipo IMPORT

Costi spedizione a terzo e oneri doganali a mittente : 

"parties": {
        "freightPayer": {
            "country": "IT",
            "clientCode": "abcdef"
        }
    }

Costi spedizione a mittente e oneri doganali a terzo :

"parties": {
        "customsPayer": {
            "country": "IT",
            "clientCode": "ghjki"
        }
    }

Codici utili alla dogana in spedizioni internazionali

Per le spedizioni internazionali dove la merce è soggetta a controlli doganali, vi può essere la necessità di indicare dei codici specifici utili alla doaana, come può essere ad esempio il codice ITN per le spedizioni in export dagli Stati Uniti.

Ogni codice da indicare al corriere è composto da due informazioni : Il tipo di codice (a cosa corrisponde) ed il rispettivo valore.

Ecco un esempio del payload da utilizzare : 

"dhl": {
        "invoiceReferences": {
            "ITN": "codice_123",
            "FTR": "codice_456"
        }
    }

Di seguito l'elenco di codici ammessi dal corriere :

  • ACL -> Parent Shipment ID for BBX

  • CID -> Customer Identifier

  • CN -> Contract Number

  • CU -> Consignor reference number

  • ITN -> US Export declaration reference ID

  • MRN -> Movement Reference number

  • UCN -> Unique reference of a consignment (UCRN)

  • OID -> Order Number

  • PON -> Purchase Order Number

  • RMA -> RMA Number

  • AAM -> AWB Ref #

  • ABT -> Goods Declaration number

  • ADA -> Buyer Reference number

  • AES -> AES Post Clearance

  • AFD -> 1496 Item number

  • ANT -> Consignee Reference number

  • BKN -> Booking Number

  • BOL -> Bill of Lading Number

  • CDN -> Customs Declaration number

  • COD -> Cash On Delivery

  • DSC -> Weltpaket Reference

  • FF -> Freight forwarder's reference number

  • FN -> Freight bill number

  • FTR -> Post Clearance Exemption US

  • HWB -> Shipment Identifiers

  • IBC -> Inbound center reference number

  • IPP -> Insurance Policy Provider

  • LLR -> Load list reference

  • MAB -> Master Airwaybill Number

  • MWB -> MAWB Reference number

  • NLR -> ECCN - No License Required indicator (NLR)

  • OBC -> Outbound center reference number

  • PD -> Vendor Reference Number

  • PRN -> Pickup request number

  • RTL -> Return Leg waybill number

  • SID -> Shipment ID 15 Digit CODA

  • SS -> Seller Reference number

  • SWN -> Original Waybill number (Return)

Servizio Go Green Plus

Servizi di trasporto a basse emissioni, facilitati da carburante per l'aviazione sostenibile.

"dhl": {
        "goGreenPlus": true
    }

Servizio Firma Adulto

DHL richiederà la firma di consegna da parte di un adulto all'indirizzo di consegna concordato.

"dhl": {
        "adultSignature": true
    }

Servizio Firma Diretta

DHL otterrà la firma dal destinatario o da un rappresentante all'indirizzo di consegna. Nel caso in cui non ci sia nessuno all'indirizzo di consegna, DHL ritenterà la consegna. Il servizio Firma Diretta assicura che le tue spedizioni non possano essere reindirizzate, lasciate in una cassetta postale o lasciate al vicino.

"dhl": {
        "directSignature": true
    }

Proactive Tracking

Monitoraggio del transito della tua spedizione, con incidenti e notifiche di consegna in tempo reale.

"dhl": {
        "proactiveTracking": true
    }

Modifica di una spedizione (Shipment patch)

ATTENZIONE! nel caso in cui sia attivata la generazione della proforma automatica non è possibile eseguire la patch della spedizione

Di seguito un payload completo dei dati aggiornabili senza la necessità di ribollettazione delle spedizione:

{
    "currency": "EUR",
    "order_ref": "Rif. modificato 3",
    "invoice_date": "2024-09-20",
    "invoice_number": "123",
    "incoterm": {
        "incoterm_code": "FCA",
        "location": "C.So felice cavallotti 4 15121 Alessandria"
    },
    "dettagli_ordine": [
        {
            "sku": "PBK1_mod",
            "description": "Cosa verde",
            "qty": "2",
            "um": "KG",
            "barcode_riga": "11111111",
            "hs_code": "222222222",
            "prezzo_singolo": "20",
            "peso_riga": "3",
            "country_of_origin": "FR"
        },
        {
            "sku": "PBK12",
            "description": "Cosa nera",
            "qty": "1",
            "um": "BOX",
            "barcode_riga": "12345465",
            "hs_code": "123456454",
            "prezzo_singolo": "7",
            "peso_riga": "1",
            "country_of_origin": "FR"
        }
    ],
    "courierData": {
        "additional_charges": {
            "fuel": 1
        }
    },
    "dhl": {
        "invoiceReferences": {
            "ITN": "codice_123"
        }
    }
}

N.B. è possibile mandare solo alcuni dati ma gli oggetti della chiamata: dettagli_ordine, courierData, dhl se ci sono devono essere completi, i precedenti valori verranno sovrascritti!

PreviousDb SchenkerNextResi in franchigia - RGR

Last updated

Was this helpful?