ShipmentExtra.md

ShipmentExtra

An object holding optional extra services to be requested.

Fields

Field	Type	Required	Description
AccountsReceivableCustomerAccount	UPSReferenceFields	➖	N/A
Alcohol	Alcohol	➖	Indicates that a shipment contains Alcohol (Fedex and UPS only).
AncillaryEndorsement	AncillaryEndorsement	➖	Specify an ancillary service endorsement to provide the USPS with instructions on how to handle undeliverable-as-addressed pieces (DHL eCommerce only).
AppropriationNumber	UPSReferenceFields	➖	N/A
AuthorityToLeave	bool	➖	Request true to give carrier permission to leave the parcel in a safe place if no one answers the door (where supported). When set to false, if no one is available to receive the item, the parcel will not be left (*surcharges may be applicable).
BillOfLadingNumber	UPSReferenceFields	➖	N/A
Billing	Billing	➖	Specify billing details (UPS, FedEx, and DHL Germany only).
BypassAddressValidation	bool	➖	Bypasses address validation (USPS, UPS, & LaserShip only).
CarbonNeutral	bool	➖	Request carbon offsets by passing true (UPS only).
CarrierHubId	string	➖	Identifies the carrier injection site.
CarrierHubTravelTime	long	➖	Travel time in hours from fulfillment center to carrier injection site.
Cod	Cod	➖	Specify collection on delivery details (UPS only).
CodNumber	UPSReferenceFields	➖	N/A
ContainerType	string	➖	Specify container type.
CriticalPullTime	string	➖	Carrier arrival time to pickup packages from the fulfillment center. UTC format: %Y-%m-%dT%H:%M:%SZ
CustomerBranch	string	➖	Specify customer branch (Lasership only).
CustomerReference	CustomerReference	➖	Specify the reference field on the label (FedEx and UPS only).
DangerousGoods	DangerousGoodsObject	➖	Container for specifying the presence of dangerous materials. This is specific to USPS, and if any contents are provided, only certain USPS service levels will be eligible. For more information, see our guide on hazardous or dangerous materials shipping.
DangerousGoodsCode	DangerousGoodsCode	➖	Dangerous Goods Code (DHL eCommerce only). See Category Codes
DealerOrderNumber	UPSReferenceFields	➖	N/A
DeliveryInstructions	string	➖	Specify delivery instructions. Up to 500 characters. (FedEx and OnTrac only).
DeptNumber	DepartmentNumber	➖	Specify the department number field on the label (FedEx and UPS only).
DryIce	DryIce	➖	Specify that the package contains Dry Ice (FedEx, Veho, and UPS only).
FdaProductCode	UPSReferenceFields	➖	N/A
FulfillmentCenter	string	➖	The fulfilment center where the package originates from.
Insurance	Insurance	➖	To add 3rd party insurance powered by XCover, specify amount, content, and currency. Alternatively, you can choose carrier provided insurance by additionally specifying provider (UPS, FedEx and OnTrac only). If you do not want to add insurance to your shipment, do not set these parameters.
InvoiceNumber	InvoiceNumber	➖	Specify the invoice number field on the label (FedEx and UPS only).
IsReturn	bool	➖	This field specifies if it is a scan-based return shipment. See the Create a return shipment section for more details.
LasershipAttrs	List<ShipmentExtraLasershipAttributesEnum>	➖	Specify Lasership Attributes (Lasership only). Multiple options accepted.
LasershipDeclaredValue	string	➖	Declared value (Lasership only). Defaults to 50.00.
ManifestNumber	UPSReferenceFields	➖	N/A
ModelNumber	UPSReferenceFields	➖	N/A
PartNumber	UPSReferenceFields	➖	N/A
PoNumber	PoNumber	➖	Specify the PO number field on the label (FedEx and UPS only).
PreferredDeliveryTimeframe	PreferredDeliveryTimeframe	➖	Required for DHL Germany Paket Sameday. Designates a desired timeframe for delivery. Format is HHMMHHMM
Premium	bool	➖	Add premium service to a shipment (DHL Germany international shipments only).
ProductionCode	UPSReferenceFields	➖	N/A
PurchaseRequestNumber	UPSReferenceFields	➖	N/A
QrCodeRequested	bool	➖	Request a QR code for a given transaction when creating a shipping label (USPS domestic and Evri UK only).
Reference1	string	➖	Optional text to be printed on the shipping label if supported by carrier. Up to 50 characters.
Reference2	string	➖	Optional text to be printed on the shipping label if supported by carrier. Up to 50 characters. For DHL eCommerce, this field can be used for billing reference.
RequestRetailRates	bool	➖	Returns retail rates instead of account-based rates (UPS and FedEx only).
ReturnServiceType	ReturnServiceType	➖	Request additional return option for return shipments (UPS and Lasership only).
RmaNumber	RmaNumber	➖	Specify the RMA number field on the label (FedEx and UPS only).
SaturdayDelivery	bool	➖	Marks shipment as to be delivered on a Saturday.
SalespersonNumber	UPSReferenceFields	➖	N/A
SerialNumber	UPSReferenceFields	➖	N/A
SignatureConfirmation	SignatureConfirmation	➖	Request standard or adult signature confirmation. You can alternatively request Certified Mail (USPS only) or Indirect signature (FedEx only) or Carrier Confirmation (Deutsche Post only).
StoreNumber	UPSReferenceFields	➖	N/A
TransactionReferenceNumber	UPSReferenceFields	➖	N/A