View UPS Services

UPS Guaranteed Quote Virtual Sandbox

Get Global Landed Cost duty and tax rate quotes for international shipments.

The UPS Guaranteed Quote API provides a Global Landed Cost (GLC) service, allowing shippers to calculate accurate duty and tax rates for international cross-border shipments. This tool simplifies the international shipping process by providing transparent cost estimates before the point of sale.

Use this hosted sandbox to simulate UPS Guaranteed Quote APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate landed cost calculation requests, verify duty and tax rate response schemas, test error handling for invalid commodity codes or destination countries, and simulate international shipping cost scenarios before integrating with UPS production systems.

UPS Guaranteed Quote virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS Guaranteed Quote responses instantly.

https://ups-guaranteed-quote.mock.beeceptor.com



Global Checkout

Header NameExample
transId*"0a1b9c2d8e3f7g4h6i5"
transactionSrc*"EWS"
Accept*"application/json"
Content-Type*"application/json"
registration-id"643F7EAC-DC06-19E3-84C9-0274164A04E9"
Request Payload
{
  "buyerCurrencyCode": "USD",
  "shipperCurrencyCode": "CAD",
  "serviceLevelCode": "01",
  "referenceNumber": "mar20240502",
  "shipperAccountNumber": " ",
  "shipment": {
    "importCountryCode": "US",
    "importProvince": "AB",
    "shipDate": "2024-04-01T00:00:00.000Z",
    "exportCountryCode": "CA",
    "transModes": "INT_AIR",
    "transportCost": {
      "value": 999,
      "currencyCode": "USD"
    },
    "insuranceCost": {
      "value": 3000,
      "currencyCode": "USD"
    },
    "shipmentType": "Sale",
    "shipperAddress": {
      "name": "IKEA Edmonton",
      "addressLine1": "311 102 St",
      "addressLine2": "NW",
      "postalCode": "AB T6N 1M",
      "city": "Edmonton",
      "countryCode": "AB",
      "stateProvinceCode": "ON"
    },
    "shipToAddress": {
      "name": "UPS",
      "addressLine1": "55 Glenlake Pkwy",
      "addressLine2": "NE",
      "postalCode": "30328",
      "city": "Sandy Springs",
      "countryCode": "US",
      "stateProvinceCode": "GA",
      "residentialAddressIndicator": false
    },
    "shipmentItems": [
      {
        "partNumber": "40093ADA2",
        "quantity": {
          "value": 12,
          "unitOfMeasure": "pallets"
        },
        "grossWeight": {
          "value": 1250,
          "unitOfMeasure": "kg"
        },
        "unitPrice": {
          "value": 1999,
          "currencyCode": "USD"
        },
        "originCountryCode": "GB",
        "description": "Surcoil Hose - Flush End - Long",
        "dimension": {
          "length": 48,
          "width": 48,
          "height": 60,
          "unitOfMeasure": "IN"
        }
      },
      {
        "partNumber": "AF4535635",
        "originCountryCode": "GB",
        "quantity": {
          "value": 10,
          "unitOfMeasure": "barrels"
        },
        "grossWeight": {
          "value": 1500,
          "unitOfMeasure": "lb"
        },
        "unitPrice": {
          "value": 1000,
          "currencyCode": "USD"
        },
        "description": "Cord 5mm PK50 Yellow/Red",
        "dimension": {
          "length": 24,
          "width": 24,
          "height": 36,
          "unitOfMeasure": "IN"
        }
      }
    ]
  }
}
Response Payload
{
  "quoteId": "QUOTE1233445",
  "quoteCreationTimestamp": "2024-05-08T17:02:43+0000",
  "referenceNumber": "aaaaaaaaaaaaaaa33",
  "quoteExpirationDate": "2024-05-08T00:00:00.000Z",
  "gcTotal": [
    {
      "type": "Shipper",
      "value": 89.2,
      "currencyCode": "USD"
    },
    {
      "type": "Buyer",
      "value": 100.2,
      "currencyCode": "CAD"
    }
  ]
}
{
  "response": {
    "errors": [
      {
        "code": "0061",
        "message": "Required parameter registration-id is invalid."
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "UJ0001",
        "message": "The token was invalid/expired or could not be verified"
      }
    ]
  }
}
{
  "response": {
    "errors": [
      {
        "code": "105.350",
        "description": "INVALID_PART_NUMBER",
        "field": "partNumber",
        "message": "PART_NUMBER is not valid",
        "value": ""
      }
    ]
  }
}
Service Homepage: github.com/UPS-API/api-documentation/blob/main/GlobalCheckout.yaml
upsshippinglogisticsecommercetaxduty