DutiesPayorType Property

Method of payment for shipment, or duties and taxes.

Syntax

 upsshipintl.getDutiesPayorType([callback])
 upsshipintl.setDutiesPayorType( dutiesPayorType, [callback])

Possible Values

  0 (ptSender), 
  1 (ptRecipient), 
  2 (ptThirdParty), 
  3 (ptCollect), 
  4 (ptConsignee)

Default Value

0

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getDutiesPayorType([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setDutiesPayorType([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

Method of payment for shipment, or duties and taxes. This is required to be provided in a ship request. Valid payment types are:

The COLLECT payment type is only supported in FedEx Ground services. The CONSIGNEE type is only supported in UPS service.

For FedEx, when this property is set to a value other than 0 (ptSender), the DutiesPayorAccountNumber and DutiesPayorCountryCode are required to be provided in the request as well. Otherwise, those will default to FedExAccountNumber and SenderCountryCode.

For UPS, when set to ptSender, the DutiesPayorAccountNumber is automatically set to UPSAccountNumber. When ptRecipient is specified, DutiesPayorAccountNumber and DutiesPayorZipCode are required to be provided in the request. For return international shipments, this option is invalid for transportation charges. And, when ptThirdParty has been specified, the DutiesPayorAccountNumber, DutiesPayorZipCode and DutiesPayorCountryCode are required to be provided in the request. When ptConsignee is specified, it indicates that UPS Consignee Billing option is selected, no other properties need to be set. ptConsignee only applies to US/PR and PR/US shipment origins and destination.

Data Type

Integer