POST shipment/shipWithQuote

Action will make a shipment using provided details. Use this action when you already quoted rates. Pass the QuoteId and RateId with other shipment details.

Pass HTTP Authorization request header with value "Bearer {token}" to perform this action.

Request Information

URI Parameters

None.

Body Parameters

Shipment request object.

ShipmentRequest

Name	Description	Type	Additional information
QuoteId	Quote Id to be used for shipment. Id is provided in RateResponse	string	None.
RateId	Id of a rate to be used for shipment. Id provided in RateResponse.	string	None.
ShipDate	Ship date in UTC	date	None.
ShipperAddress	Shipper address	ShipmentAddress	None.
ReturnAddress	Return Address	Address	None.
IncludeReturnLabel	Include parcel return label	boolean	None.
ConsigneeAddress	Consignee address	ShipmentAddress	None.
Reference1	Reference 1	string	None.
Reference2	Referece 2	string	None.
Reference3	Referece 3	string	None.
Reference4	Referece 4	string	None.
Reference5	Referece 5	string	None.
Reference6	Referece 6	string	None.
ProductDetails	Product details	Collection of ProductDetail	None.
ITN	International transaction number	string	None.
PickupDetails	Pickup details	PickupDetails	None.
AdditionalDetails	Additional details	AdditionalDetails	None.
ZPLLabel	Options 4x6ForAllThatApply, FedEx4x4.675 or UPS4x8	ZPLLabel	Optional
ShippingNotificationEmail	Shipment confirmation email	string	Optional
UsePro	If populated, then this is going to be used as a PRO.	string	Optional

Request Formats

application/json, text/json

Sample:

{
  "QuoteId": "sample string 1",
  "RateId": "sample string 2",
  "ShipDate": "2025-04-02T12:50:23.8442896-07:00",
  "ShipperAddress": {
    "CompanyId": "sample string 1",
    "AttentionTo": "sample string 2",
    "Company": "sample string 3",
    "Email": "sample string 4",
    "Phone": "sample string 5",
    "Street1": "sample string 6",
    "Street2": "sample string 7",
    "City": "sample string 8",
    "Country": "sample string 9",
    "State": "sample string 10",
    "Zip": "sample string 11"
  },
  "ReturnAddress": {
    "AttentionTo": "sample string 1",
    "City": "sample string 2",
    "CompanyId": "sample string 3",
    "Company": "sample string 4",
    "Country": "sample string 5",
    "Email": "sample string 6",
    "State": "sample string 7",
    "Street1": "sample string 8",
    "Street2": "sample string 9",
    "Phone": "sample string 10",
    "Zip": "sample string 11",
    "OrderType": "sample string 12",
    "TaxIDNumber": "sample string 13"
  },
  "IncludeReturnLabel": true,
  "ConsigneeAddress": {
    "CompanyId": "sample string 1",
    "AttentionTo": "sample string 2",
    "Company": "sample string 3",
    "Email": "sample string 4",
    "Phone": "sample string 5",
    "Street1": "sample string 6",
    "Street2": "sample string 7",
    "City": "sample string 8",
    "Country": "sample string 9",
    "State": "sample string 10",
    "Zip": "sample string 11"
  },
  "Reference1": "sample string 4",
  "Reference2": "sample string 5",
  "Reference3": "sample string 6",
  "Reference4": "sample string 7",
  "Reference5": "sample string 8",
  "Reference6": "sample string 9",
  "ProductDetails": [
    {
      "Country": "sample string 1",
      "HTSCode": "sample string 2",
      "Description": "sample string 3",
      "Number": "sample string 4",
      "PackageId": "sample string 5",
      "PricePerPiece": 6.0,
      "PricePerPiece2": 7.0,
      "PricePerPiece3": 8.0,
      "PricePerPiece4": 9.0,
      "Quantity": 10,
      "Quantity2": 11,
      "Quantity3": 12,
      "Quantity4": 13,
      "Unit": "sample string 14",
      "OrderNumber": "sample string 15",
      "LineType": "sample string 16",
      "LineNumber": "sample string 17",
      "RequiredShipDate": "2025-04-02T12:50:23.845289-07:00",
      "RequiredArrivalDate": "2025-04-02T12:50:23.845289-07:00",
      "CanShipEarly": true,
      "CanArriveEarly": true,
      "ItemWeight": 20.0,
      "CustomerItem": "sample string 21",
      "LotNumber": "sample string 22",
      "Length": 23.0,
      "Width": 24.0,
      "Height": 25.0,
      "FreightClass": "sample string 26",
      "NMFC": "sample string 27",
      "UserDefined1": "sample string 28",
      "UserDefined2": "sample string 29",
      "UserDefined3": "sample string 30",
      "TechnicalName": "sample string 31",
      "FPHazmatId": 32,
      "UNID": "sample string 33",
      "SKU": "sample string 34",
      "UPC": "sample string 35",
      "Category": "sample string 36",
      "DDTCQuantityUOM": "sample string 37",
      "ECCN": "sample string 38",
      "License": "sample string 39",
      "ItemNotes": "sample string 40"
    },
    {
      "Country": "sample string 1",
      "HTSCode": "sample string 2",
      "Description": "sample string 3",
      "Number": "sample string 4",
      "PackageId": "sample string 5",
      "PricePerPiece": 6.0,
      "PricePerPiece2": 7.0,
      "PricePerPiece3": 8.0,
      "PricePerPiece4": 9.0,
      "Quantity": 10,
      "Quantity2": 11,
      "Quantity3": 12,
      "Quantity4": 13,
      "Unit": "sample string 14",
      "OrderNumber": "sample string 15",
      "LineType": "sample string 16",
      "LineNumber": "sample string 17",
      "RequiredShipDate": "2025-04-02T12:50:23.845289-07:00",
      "RequiredArrivalDate": "2025-04-02T12:50:23.845289-07:00",
      "CanShipEarly": true,
      "CanArriveEarly": true,
      "ItemWeight": 20.0,
      "CustomerItem": "sample string 21",
      "LotNumber": "sample string 22",
      "Length": 23.0,
      "Width": 24.0,
      "Height": 25.0,
      "FreightClass": "sample string 26",
      "NMFC": "sample string 27",
      "UserDefined1": "sample string 28",
      "UserDefined2": "sample string 29",
      "UserDefined3": "sample string 30",
      "TechnicalName": "sample string 31",
      "FPHazmatId": 32,
      "UNID": "sample string 33",
      "SKU": "sample string 34",
      "UPC": "sample string 35",
      "Category": "sample string 36",
      "DDTCQuantityUOM": "sample string 37",
      "ECCN": "sample string 38",
      "License": "sample string 39",
      "ItemNotes": "sample string 40"
    }
  ],
  "ITN": "sample string 10",
  "PickupDetails": {
    "ReadyDateTime": "2025-04-02T12:50:23.845289-07:00",
    "Emails": [
      "sample string 1",
      "sample string 2"
    ],
    "CutoffDateTime": "2025-04-02T12:50:23.845289-07:00"
  },
  "AdditionalDetails": {
    "CarrierInsuranceAmount": 1.0,
    "CODDetails": {
      "Amount": 1.0,
      "ChargeCode": "sample string 2",
      "PaymentType": 1,
      "RemitAddress": {
        "AttentionTo": "sample string 1",
        "City": "sample string 2",
        "CompanyId": "sample string 3",
        "Company": "sample string 4",
        "Country": "sample string 5",
        "Email": "sample string 6",
        "State": "sample string 7",
        "Street1": "sample string 8",
        "Street2": "sample string 9",
        "Phone": "sample string 10",
        "Zip": "sample string 11",
        "OrderType": "sample string 12",
        "TaxIDNumber": "sample string 13"
      }
    },
    "DeliveryConfirmation": 1,
    "HazmatEmergencyNo": "sample string 2",
    "HazmatContact": "sample string 3",
    "IsSaturdayDelivery": true,
    "IsDeliveryDutyPaid": true,
    "SpecialInstructions": "sample string 6",
    "PickupSpecialInstructions": "sample string 7",
    "Alcohol": true,
    "EIN": "sample string 9"
  },
  "ZPLLabel": 0,
  "ShippingNotificationEmail": "sample string 11",
  "UsePro": "sample string 12"
}

Response Information

Resource Description

ShipmentResponse

Name	Description	Type	Additional information
Data	Shipment response object info	ShipmentResponseObject	None.
Code	Response code returned by api	HttpStatusCode	None.
Message	Human readable message	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Data": {
    "RateId": "sample string 1",
    "ShipmentId": "sample string 2",
    "QuoteAmount": "sample string 3",
    "Documents": [
      {
        "Type": "sample string 1",
        "Format": "sample string 2",
        "Url": "sample string 3",
        "Number": "sample string 4"
      },
      {
        "Type": "sample string 1",
        "Format": "sample string 2",
        "Url": "sample string 3",
        "Number": "sample string 4"
      }
    ],
    "ZPLDocuments": [
      {
        "Type": "sample string 1",
        "Format": "sample string 2",
        "Url": "sample string 3",
        "Number": "sample string 4"
      },
      {
        "Type": "sample string 1",
        "Format": "sample string 2",
        "Url": "sample string 3",
        "Number": "sample string 4"
      }
    ],
    "TrackingNumbers": [
      "sample string 1",
      "sample string 2"
    ],
    "PickupNumber": "sample string 4",
    "Errors": [
      "sample string 1",
      "sample string 2"
    ]
  },
  "Code": 100,
  "Message": "sample string 1"
}