DHL

DHL ICS2 (CIN)

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

• RICHIESTO: ddt_alpha Riferimento alfanumerico

• dettagli_ordine

• Opzionale: invoice_date

• Opzionale: invoice_number

• Opzionale: additional_charges

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": "[e-mail]",
      "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)

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!