For the complete documentation index, see llms.txt. This page is also available as Markdown.

UPS

Gsped code list

Service
Courier code
Service code
Notes

Domestic Express Saver

103
0

Domestic

Domestic Express

103
1

Domestic

Domestic Express Plus

103
2

Domestic

Domestic Standard

103
3

Domestic

International Express

103
6

International

International Express Plus

103
7

International

International Standard

103
8

International

International Saver

103
9

International

Expedited

103
10

International

Trade documents

Available in POST and PATCH calls

"trade_documents":[
    {
        "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf",
        "contenuto":""
    }
]

Specific documentation for trade documents: https://apidocs.gsped.com/gsped-api-english-version/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents

Customs duties and shipping costs

With UPS you can give a third party's client codes to charge them the shipping costs and/or the customs duties.

Below are some example payloads to use in the various cases:

Shipping costs and customs duties to a third party:

Shipping costs to a third party and customs duties to the sender:

Shipping costs to the sender and customs duties to a third party:

Direct Delivery

To use UPS direct delivery, add the following field to the shipment creation call:

Delivery to an address in a residential area

To tell the courier that the delivery location is in a residential area, add the following field to the shipment creation call:

Shipment containing restricted articles

To tell the courier that the shipment consists of restricted articles, add the following field to the shipment creation call:

Where RESTRICTED_ARTICLE can take one of the following values:

  • alcoholic

  • diagnosticSpeciments

  • perishables

  • plants

  • seeds

  • specialExceptions

  • tobacco

Return shipments

There are several ways to create a return shipment. The modes we currently handle are the following:

Return type
Code to use
Description

Standard return

1

Return with 1 pickup attempt

2

Return with 3 pickup attempts

3

Return with electronic label (Electronic Return Label)

4

In this case the courier does NOT return the label in the response when creating the shipment. The label is sent directly to the shipment's sender.

These return codes can be used through the flag_reso field when creating the shipment