Resi in franchigia - RGR
Il reso in franchigia o Returned Goods Relief (RGR) è un servizio offerto da DHL per esonerare dei dazi doganali il proprietario del contratto per prodotti resi dall'estero (SOLO per flussi di andata e ritorno).
Gsped mette a disposizione l'endpoint RGR per la generazione del file SPED per la sola spedizione di andata oppure la generazione del file RGR per la spedizione di reso.
Endpoint RGR
POST
/https://api.gsped.it/{istanza}/dhl/rgr
Headers
Content-Type
application/json
x-api-key
YOUR API KEY
Body
flag_reso*
number
Indicazione se si tratta di una spedizione di reso o meno. Valori possibili : 0 -> Spedizione di andata 1 -> Spedizione di reso
client_id*
number
Valore comunicato da Gsped
num_spedizione*
string
Numero di spedizione (tracking number)
colli*
number
Numero di colli
addebito_dogana*
number
Valore numerico che indica a chi spettano gli oneri doganali. Valori possibili : 0 -> Destinatario 1 -> Mittente
valuta*
string
Codice a tre caratteri che indica la valuta di riferimento (Esempio EUR)
rcpt_email*
string
Indirizzo email del destinatario
rcpt_name*
string
Nome del destinatario
rcpt_addr*
string
Indirizzo del destinatario
rcpt_city*
string
Cità del destinatario
rcpt_country_code*
string
Nazione del destinatario in formato ISO code a 2 caratteri
sender_eori*
string
Codice eori del mittente
ordersData*
object
Contiene i dettagli detagli del ordine e/o merce spedita
ordersData.totale_lordo*
number
Valore complessivo della merce spedita
ordersData.invoice_number*
string
Numero fattura e/o riferimento ordine
ordersData.invoice_date*
string
Data della fattura in formato YYYY-MM-DD
ordersData.detailsData*
array
Array che contiene i dettagli dei prodotti spediti
ordersData.detailsData.*.sku*
string
SKU del prodotto
ordersData.detailsData.*.description*
string
Descrizione del prodotto
ordersData.detailsData.*.hs_code*
string
HS Code del prodotto
ordersData.detailsData.*.country_of_origin*
string
Nazione di provenienza del prodotto
ordersData.detailsData.*.prezzo_singolo*
number
Prezzo del singolo prodotto
ordersData.detailsData.*.qty*
number
Numero di pezzi spediti
ordersData.detailsData.*.peso_riga*
number
Peso del prodotto
originalAwbData
object
Contiene i dati relativi alla spedizione di andata. Nota bene : Solo in caso si tratti di un reso (flag_reso = 1)
originalAwbData.num_spedizione
string
Numero di tracking della spedizione di andata
originalAwbData.detailsData
array
Array che contiene i dettagli dei prodotto spediti nella spedizione di anadata
originalAwbData.detailsData.*.sku
string
SKU del prodotto
Legenda :
* -> Dato obbligatorio
* -> Dato obbligatorio SOLO in caso si tratti di una spedizione di andata
Response
{
"status": "ok"
}
Esempi
Payload generazione file SPED per le spedizioni di andata :
{
"flag_reso": "0",
"client_id": YOUR_CLIENT_ID,
"num_spedizione": "123456789",
"colli": "1",
"addebito_dogana": "1",
"valuta": "EUR",
"rcpt_email": "[email protected]",
"rcpt_name": "test destinatario",
"rcpt_addr": "via palma 12",
"rcpt_city": "Alessandria",
"rcpt_country_code": "IT",
"sender_eori": "codiceEori",
"ordersData": {
"totale_lordo": "55",
"invoice_number": "fatt123",
"invoice_date": "2024-07-08",
"detailsData": [
{
"sku": "sku123",
"description": "prodotto 123",
"hs_code": "hsc123",
"country_of_origin": "CO",
"prezzo_singolo": "20",
"qty": "1",
"peso_riga": "2"
},
{
"sku": "sku124",
"description": "prodotto 124",
"hs_code": "hsc124",
"country_of_origin": "IT",
"prezzo_singolo": "35",
"qty": "1",
"peso_riga": "1"
}
]
}
}
Payload generazione file RGR per le spedizioni di reso :
{
"flag_reso": "1",
"client_id": YOUR_CLIENT_ID,
"num_spedizione": "123456789",
"ordersData": {
"detailsData": [
{
"sku": "sku123"
},
{
"sku": "sku124"
}
]
},
"originalAwbData": {
"num_spedizione": "987654321"
}
}
Last updated
Was this helpful?