Banyan Technology LIVE Connect™
  1. Updating
Banyan Technology LIVE Connect™
  • Version 3
    • Authentication
      • Retrieve a token
    • Shipments
      • Creating
        • Create a Full Shipment
        • Create an EZ Rate Shipment
      • Updating
        • Add Document(s) to a Shipment
          POST
        • Update a Shipment
          PUT
        • Adds one or more Reference Numbers to a Shipment
          POST
        • Mark as Exported
          POST
      • Retrieving
        • Get a Shipment
        • Get multiple Shipments
        • Get Quotes
        • Get Reference Numbers for a Shipment
        • Get documents for the specified shipment.
      • Booking
        • Book a Shipment
        • Unbooks the awarded quote on the specified load.
      • Canceling
        • Cancels a shipment.
    • Invoice
      • Get multiple invoices
      • Mark as Exported
    • Tracking
      • Get tracking statuses
      • Mark as exported.
    • StaticData
      • Accessorials
      • Document Types
      • Equipment Types
      • Package Types
      • Limited Access Types
      • Size UOMs
      • Weight UOMs
      • Pay Types
      • Ship Types
      • Countries
      • Statuses
      • Service Modes
  • Version 2
    • Recommended Workflow
      • Rating
        • ImportForQuote
        • ImportForQuote_Sync
        • GetQuotes
      • Booking/Dispatching
        • BookLoad
      • Tracking
        • GetTrackingStatuses
      • Documents
        • GetDocuments
      • Invoices
        • GetInvoices
        • GetInvoicesWithLoadDetails
    • Additional Offerings
      • Cancelling
        • Cancel a Load
      • Updating
        • UpdateLoad
        • UpdateLoadStatus
        • UpdateShipmentsExport
      • Importing
        • PendingImport
        • ImportForBook
      • Manual Quotes
        • AddManualQuote
      • EZ Rates
        • EzRate
        • EzRate_Sync
      • Waterfall Tendering
        • StartWaterfallTendering
        • CancelWaterfallTendering
      • Unbooking
        • UnBookLoad
      • Additional Dispatching
        • DispatchLoad
      • Load Details
        • GetLoadDetails
        • GetNotes
      • Additional Tracking
        • GetTrackingByLoad
      • Other
        • Normalized Charge Codes
      • SOAP
    • Changelog
  • Exports and Webhooks
    • Standard Load Export - v1
    • Standard Load Export - v2
    • Standard Load Export - v3
    • Push Tracking
  1. Updating

Update a Shipment

PUT
/api/v3/shipments/{Id}
Shipments

Updates a shipment in Banyan.#

This method can be used to change the details on an existing shipment, or convert an EZ Rate shipment into a full shipment.#

Reference the table below, as well as the supplied examples to see the different ways to use this endpoint.#

AttributeType    Description
WaitForRatesboolDefaults to true. Returns when rating engine is complete.Set to false to return a response immediately.
IsEzRateboolDefaults to false. Create the shipment as an EZ Rate with minimal data.
loadAccessorialsarrayFor any accessorials only the description or the abbreviation is needed. See /StaticData/Accessorials endpoint for valid values.
pullMarketRatesboolDefaults to false. Pulls the market rates for this shipment.
HandlingUnitsarrayThe handling units containing the products. For shipments that cannot utilize handling units, supply a single handling unit with 0 for quantity, and None for package type, and the shipment will not create handling units.
VendorIdstringIf vendor id is supplied, the system will look up the vendor location and use that data instead of what is in the request. If DistributionCenterReferenceNumber is supplied this can further filter data for vendors with multiple locations.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
Id
integer 
required
The Id of the entity the request relates to.
Body Params application/json
The update shipment request.
forceReRating
boolean 
optional
Gets or sets a flag that controls forcefully re-rating a shipment. When true, rating will be done regardless of any other changes to the load.
When false, a re-rate MAY STILL OCCUR if vital information about the load and user permissions call for it.
waitForRates
boolean 
optional
Gets or sets a flag indicating whether a response should wait for rating to complete in cases where rating was triggered.
isEzRate
boolean 
optional
Gets or sets a flag indicating whether this load is an "EZ Rate".
requestCarbonService
boolean 
optional
If true, and the shipment undergoes re-rating, the system will request a carbon footprint calculation
and estimate for the cost of offset. If the shipment does not go through the rating process, the calculation
and estimate will not occur. Consider using the BanyanWebServices.Domain.Requests.Version3.UpdateShipmentRequest.ForceReRating flag if necessary.
If false, any existing carbon services will be removed from the shipment, and any relevant markups removed from quotes.
pullMarketRates
boolean 
optional
If true, market rates will be pulled for this shipment
shipmentData
object (BanyanWebServices.Domain.Dtos.CreateShipment.ShipmentDataDto) 
required
The ShipmentData data transfer object. This will contain all relevant information about a shipment.
manifestId
string  | null 
optional
The manifest id. May also be referred to as the PRO Number.
bolNumber
string  | null 
optional
The Bill of Lading number.
customerPo
string  | null 
optional
The customer PO number.
invoiceId
string  | null 
optional
The invoice id.
billingId
string  | null 
optional
The billing id.
shipperConfirmationNumber
string  | null 
optional
The shipper pickup number.
consigneeConfirmationNumber
string  | null 
optional
The consignee pickup number.
estimatedPickup
string <date-time>
optional
The estimated pickup date.
actualPickup
string <date-time>
optional
The actual pickup date.
estimatedDelivery
string <date-time>
optional
The estimated delivery date.
actualDelivery
string <date-time>
optional
The actual delivery date.
shipType
enum<string> 
required
The shipping type.
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
The pay type
Allowed values:
CollectPrepaid
exportReason
enum<string> 
optional
The International export reason.
Allowed values:
TemporaryRepair/ReturnPermanent
internationalTerm
enum<string> 
optional
The international terms.
Allowed values:
Cost and FreightCost Insurance and FreightCarriage and Insurance PaidCarriage Paid ToDelivered at FrontierDelivered Duty PaidDelivered Duty UnpaidDelivered Ex QuayDelivered Ex ShipEx WorksFree Alongside ShipFree CarrierFree On Board
usBrokerSameAsShipper
boolean 
optional
Flag to set us broker values to the same as the shipper.
Default:
false
usBrokerSameAsConsignee
boolean 
optional
Flag to set US broker values to the same as the consignee.
Default:
false
internationalBrokerSameAsShipper
boolean 
optional
Flag to set Int. broker values to the same as the shipper.
Default:
false
internationalBrokerSameAsConsignee
boolean 
optional
Flag to set Int. broker values to the same as the consignee.
Default:
false
useDefaultUSBroker
boolean 
optional
Flag to set US broker values to the clients default US broker
Default:
false
useDefaultInternationalBroker
boolean 
optional
Flag to set Int. broker values to the clients default Int. broker
Default:
false
usBroker
object (BrokerDto) 
optional
US broker details
internationalBroker
object (BrokerDto) 
optional
International broker details
shipperLocation
object (LocationDto) 
required
Shipper Information
consigneeLocation
object (LocationDto) 
required
Consignee Information
useDefaultBillTo
boolean 
optional
Gets or sets a flag indicating whether default bill to data should be used.
If set to true, the BillTo section of the request should be left null and the system will load defaults.
If set to false, the BillTo section of the request must be provided.
Default:
false
billTo
object (BillToDto) 
optional
BillTo information. Required if useDefaultBillTo is false.
shipmentServices
array[object (ShipmentServiceDto) {8}] 
required
The shipment services.
>= 1 items
packageInfo
object (PackageInfoDto) 
optional
Package Information
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance
handlingUnits
array[object (HandlingUnitDto) {9}] 
required
The handling units containing product information.
For shipments that cannot utilize handling units, supply a single handling unit with 0 for quantity, and None for package type, and the shipment will not create handling units.
>= 1 items
documents
array[object (DocumentPostDto) {4}] 
optional
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
shipperAccessorials
array[object (ShipperAccessorialDto) {3}]  | null 
optional
The shipper (origin) accessorials. Only one of abbreviation or description is required when supplying accessorials.
consigneeAccessorials
array[object (ConsigneeAccessorialDto) {3}]  | null 
optional
The consignee (destination) accessorials. Only one of abbreviation or description is required when supplying accessorials.
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials. Only one of abbreviation or description is required when supplying accessorials.
Example
{
    "isEzRate": true,
    "waitForRates": false,
    "shipmentData": {
        "shipType": "ThirdParty",
        "payType": "Prepaid",
        "shipperLocation": {
            "address": {
                "city": "ALBANY",
                "stateOrProvince": "NY",
                "zipCode": "12204",
                "country": "United States"
            }
        },
        "consigneeLocation": {
            "address": {
                "city": "MIAMI",
                "stateOrProvince": "FL",
                "zipCode": "33156",
                "country": "United States"
            }
        },
        "shipmentServices": [
            {
                "serviceMode": "LTL",
                "quantity": 2,
                "packageType": "Pallets",
                "equipmentType": "Van-Standard Trailer",
                "weightUnitOfMeasurement": "LBS"
            }
        ],
        "handlingUnits": [
            {
                "packageType": "Pallets",
                "quantity": 2,
                "products": [
                    {
                        "packageType": "Boxes",
                        "quantity": 20,
                        "class": 200,
                        "weight": 400,
                        "weightUnitOfMeasurement": "LBS",
                        "dimensions": {
                            "unitOfMeasurement": "IN",
                            "length": 42,
                            "width": 42,
                            "height": 56
                        },
                        "description": "TEST ONLY - PRODUCT 1 DESCRIPTION - TEST ONLY"
                    }
                ]
            }
        ]
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://ws.integration.banyantechnology.com/api/v3/shipments/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "isEzRate": true,
    "waitForRates": false,
    "shipmentData": {
        "shipType": "ThirdParty",
        "payType": "Prepaid",
        "shipperLocation": {
            "address": {
                "city": "ALBANY",
                "stateOrProvince": "NY",
                "zipCode": "12204",
                "country": "United States"
            }
        },
        "consigneeLocation": {
            "address": {
                "city": "MIAMI",
                "stateOrProvince": "FL",
                "zipCode": "33156",
                "country": "United States"
            }
        },
        "shipmentServices": [
            {
                "serviceMode": "LTL",
                "quantity": 2,
                "packageType": "Pallets",
                "equipmentType": "Van-Standard Trailer",
                "weightUnitOfMeasurement": "LBS"
            }
        ],
        "handlingUnits": [
            {
                "packageType": "Pallets",
                "quantity": 2,
                "products": [
                    {
                        "packageType": "Boxes",
                        "quantity": 20,
                        "class": 200,
                        "weight": 400,
                        "weightUnitOfMeasurement": "LBS",
                        "dimensions": {
                            "unitOfMeasurement": "IN",
                            "length": 42,
                            "width": 42,
                            "height": 56
                        },
                        "description": "TEST ONLY - PRODUCT 1 DESCRIPTION - TEST ONLY"
                    }
                ]
            }
        ]
    }
}'

Responses

🟢200Success
application/json
Body
The update shipment response dto.
loadId
integer <int32>
optional
Gets or sets the load identifier.
status
string  | null 
optional
Gets or sets the status.
client
object (ClientDto) 
optional
Class ClientDto.
clientId
integer <int32>
optional
The unique id of this client in the Banyan system.
clientName
string  | null 
optional
Name of client that the shipment is under.
clientRefNumber
string  | null 
optional
The client ref number associated to this client.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Class AwardedQuotePricingDto.
raw
number <double>
optional
Quote raw price (returned from the carrier)
carrier
number <double>
optional
Quote carrier price (carrier markups applied)
customer
number <double>
optional
Quote customer price (customer markups applied)
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
quoteId
integer <int32>
optional
Banyan's primary quote identifier
carrierName
string 
optional
Carrier name
carrierId
integer <int32>
optional
Banyan's primary carrier identifier
scac
string 
optional
Carrier standard carrier alpha code
thirdPartyName
string  | null 
optional
Typically set when the quote is from a 3PL. This will contain the 3pl carrier's name.
thirdPartyScac
string  | null 
optional
3PL standard carrier alpha code
serviceId
string  | null 
optional
Quote service identifier
rawPrice
object (QuotePriceDto) 
optional
Quote raw price (returned from the carrier)
carrierPrice
object (QuotePriceDto) 
optional
Quote carrier price (carrier markups applied)
customerPrice
object (QuotePriceDto) 
optional
Quote customer price (customer markups applied)
transitTime
integer <int32>
optional
Quote transit time
quoteNumber
string  | null 
optional
Carrier quote identifier
carrierPerson
string  | null 
optional
Carrier person
carrierNote
string  | null 
optional
Note returned by the carrier regarding the quote
dateStamp
string <date-time>
optional
Quote date
interline
boolean 
optional
Set to true only when confirmed to be interline
accepted
boolean 
optional
Quote has been accepted by client
currencyType
optional
Quote currency type
service
string  | null 
optional
Quote service
insuranceDetails
optional
Insurance Details related to the quote
accountNumber
string  | null 
optional
Account Number/ID used for Quote (if any)
notes
array[object (NoteDto) {4}]  | null 
optional
Gets or sets the notes.
description
string  | null 
optional
Note text
noteTypeId
integer <int32>
optional
Note Type Id
userName
string  | null 
optional
Note creator
dateStamp
string <date-time>
optional
Note date
manifestId
string  | null 
optional
Gets or sets the manifest identifier.
bolNumber
string  | null 
optional
Gets or sets the bol number.
customerPo
string  | null 
optional
Gets or sets the customer po.
invoiceId
string  | null 
optional
Gets or sets the invoice identifier.
billingId
string  | null 
optional
Gets or sets the billing identifier.
incoTermId
integer <int32>
optional
Gets or sets the inco term identifier.
pickupNumber
string  | null 
optional
Gets or sets the pickup number.
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Gets or sets the estimated pickup date.
actualPickup
string <date-time> | null 
optional
Gets or sets the pickup date.
estimatedDelivery
string <date-time> | null 
optional
Gets or sets the estimated delivery date.
actualDelivery
string <date-time> | null 
optional
Gets or sets the delivery date.
createdDate
string <date-time> | null 
optional
Gets or sets the created date.
shipType
string  | null 
optional
Gets or sets the type of the ship.
payType
string  | null 
optional
Gets or sets the type of the pay.
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
companyName
string  | null 
optional
Company name
locationName
string  | null 
optional
Location name
einNumber
string  | null 
optional
The EIN Number of the location (if applicable)
note
string  | null 
optional
A note for the location
contactMethods
object (ContactMethodsDto) 
optional
Contact methods for the location.
contactPerson
object (ContactPersonDto) 
optional
Contact Person for the location
address
object (AddressDto) 
optional
Address information for the location.
vendorId
string  | null 
optional
Vendor identifier - Used to map to an existing vendor in Banyan.
The system will look up the vendor location and use that data instead of what is in the request.
distributionCenterReferenceNumber
string  | null 
optional
Distribution center identifier - Used to map to an existing distribution center in Banyan. This can further filter data for vendors with multiple locations.
dock
object (DockDetailsDto)  | null 
optional
Dock Information for the location.
consigneeLocation
object (LocationDto) 
optional
billTo
object (BillToDto) 
optional
Class BillToDto.
name
string  | null 
optional
Name of Bill To
<= 50 characters
contactMethods
object (ContactMethodsDto) 
optional
Bill To contact methods
note
string  | null 
optional
Note for Bill To
address
object (AddressDto) 
optional
Bill To Address information
packageInfo
object (PackageInfoDto) 
optional
Class PackageInfoDto.
routeNumber
string  | null 
optional
Used to identify the route a driver will take when moving a package; used for Local Carrier
cod
number <double>
optional
Shipment collect on delivery amount
>= 0
declaredLiability
number <double>
optional
Shipment declared liability amount
>= 0
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Gets or sets the shipment services.
serviceMode
enum<string> 
required
The service mode of the shipment. Default: LTL
Allowed values:
Standard Parcel ServiceLTLVolumeAir CargoOcean FreightDrive AwayIntermodalOcean LCLAir InternationalInternational ExpeditedDomestic ExpeditedFull TruckloadBulkRailDrayageLocal CarrierExpeditedScheduledPartial TruckloadGFPSpot QuoteFinal Mile
quantity
integer <int32>
optional
Shipment shipping quantity
> 0
packageType
enum<string> 
required
The package type of the shipment. Default: Pallets
Allowed values:
ACCATTBAGSBALEBRRLBASKBINBOXSBUCKBHDSBNDLCARBCRTNCASECHSTCOILCTNCRTSCYLSDRUMEACHENVLPFEETFIRKGYLDKEGSLOOSOCTAPACKPAILPLTSPIECPCJCRACKREELROLLSKIDSLIPSPRSTOTETRLRTRYSTRCKTRNKTUBETUBSUNITSUNPKVHCL
equipmentType
enum<string> 
required
The equipment type of the shipment. Default: Van-standard trailer
Allowed values:
16ft Straight Truck18ft Straight Truck24ft Straight Truck24ft Straight Truck w/ lift gate26ft Straight Truck26ft Straight Truck w/ lift gate4x453ft - Van TrailerAir CargoALLBox truckBox truck w/ lift gateBulk TruckCarCar-CarrierCargo VanContainer - 20ftContainer - 40ftContainer - 40HQContainer - 45ftContainer - 53ftDouble DropDoublesDump TruckDumper - 20 yardDumper - 40 yardDumper - 60 yardDumper - 80 yardFlat BedFrozenFull Size VanGooseneckHopper BottomLow BoyMaxi TrailerMinivanOtherParcel TruckPickup TruckRail Car - 20ftRail Car - 40ftRail Car - 53ftRefrigeratedRemovable GooseneckRoll-off TruckSprinter VanStep DeckTankerTractorTractor TrailerTrailer – 24ftTrailer – 26ftTrailer – 28ftTrailer – 48ftTrailer – 53ftTri-Axle VanTruckTruck w/ lift gateVanVan w/ lift gateVan-standard trailerWalking FloorWinch Truck
additionalWeight
number <double>
optional
Shipment additional weight
>= 0
weightUnitOfMeasurement
optional
The weight unit of measurement for the shipment. Default: LBS
specialInstructions
string  | null 
optional
Shipment special instructions
dimensions
object (DimensionsDto) 
optional
Total shipment dimenstions
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
Gets or sets the handling units.
packageType
enum<string> 
required
The package type for the handling unit. Pallets is the default value.
Allowed values:
ACCATTBAGSBALEBRRLBASKBINBOXSBUCKBHDSBNDLCARBCRTNCASECHSTCOILCTNCRTSCYLSDRUMEACHENVLPFEETFIRKGYLDKEGSLOOSOCTAPACKPAILPLTSPIECPCJCRACKREELROLLSKIDSLIPSPRSTOTETRLRTRYSTRCKTRNKTUBETUBSUNITSUNPKVHCL
quantity
integer <int32>
optional
The quanity of this hanlding unit.
length
number <double>
optional
The Length of the handling unit.
width
number <double>
optional
The width of the handling unit.
height
number <double>
optional
The height of the handling unit.
additionalWeight
number <double>
optional
Any additional weight added to the handling unit.
unitOfMeasurement
enum<string> 
optional
The unit of measurement for the size dimensions of the handling unit. Required if dimensions are provided.
Allowed values:
CMFTIN
weightUnitOfMeasurement
enum<string> 
optional
The unit of measurement for the Additional Weight of the handling unit.
Allowed values:
LBSKG
products
array[object (ProductDto) {13}] 
required
The individual products on the handling unit.
>= 1 items
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
Gets or sets the load accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
Gets or sets the shipper accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
Gets or sets the consignee accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
Gets or sets the reference fields.
type
string 
required
The type of the Reference field
>= 1 characters<= 250 characters
value
string 
required
The actual value of the Reference field
>= 1 characters<= 250 characters
printOnBol
boolean 
optional
If true, this reference field will be printed on the shipments BOL
printOnShippingLabel
boolean 
optional
If true, this reference field will be printed on the shipments Shipping Label
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
The Insurance data transfer object.
vendor
string  | null 
optional
The vendor. This will match based on vendor name or code.
commodityType
string  | null 
optional
The commodity type. This will match based on name or code.
commodityCondition
string  | null 
optional
The commodity condition. This will match on name or code.
insuredValue
number <double> | null 
optional
The amount being insured.
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Gets or sets the stops.
loadId
integer <int32>
required
Banyan's primary shipment identifier
status
enum<string> 
required
Description of current status
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCancelledDispatch RequestedDispatch FailedQuote Approval PendingApproval Denied
client
object (ClientDto) 
required
Client information for this shipment.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Information about the awarded quote once a shipment has been booked.
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
notes
array[object (NoteDto) {4}]  | null 
optional
Shipment & carrier notes
manifestId
string  | null 
optional
Shipment PRO number
bolNumber
string  | null 
optional
Shipment BOL number
customerPo
string  | null 
optional
Shipment Customer PO
invoiceId
string  | null 
optional
Shipment Invoice identifier
billingId
string  | null 
optional
Shipment Billing identifier
incoTermId
integer <int32>
optional
Shipment IncoTerm identifier
pickupNumber
string  | null 
optional
Pickup number assigned to the load
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Estimated Pickup Date
actualPickup
string <date-time> | null 
optional
Actual Pickup Date
estimatedDelivery
string <date-time> | null 
optional
Estimated Delivery Date
actualDelivery
string <date-time> | null 
optional
Actual Delivery Date
createdDate
string <date-time> | null 
optional
Shipment created date
shipType
enum<string> 
required
Shipment Ship Type
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
Shipment Pay Type
Allowed values:
CollectPrepaid
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
Shipper Information
consigneeLocation
object (LocationDto) 
optional
Consignee Information
billTo
object (BillToDto) 
optional
Billing Information
packageInfo
object (PackageInfoDto) 
optional
Package Information
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Shipment Service(s)
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
The handling units containing product information.
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials.
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipper accessorials.
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The consignee accessorials.
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance Details
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Individual stops for a multi-stop shipment
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Individual legs for a multi-legshipment
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
trackingNumbers
array[string]
required
List of any Tracking Numbers attached to a shipment
ratingCompleted
boolean 
required
Gets or sets a value indicating whether rating completed
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Gets or sets the legs.
loadId
integer <int32>
required
Banyan's primary shipment identifier
status
enum<string> 
required
Description of current status
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCancelledDispatch RequestedDispatch FailedQuote Approval PendingApproval Denied
client
object (ClientDto) 
required
Client information for this shipment.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Information about the awarded quote once a shipment has been booked.
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
notes
array[object (NoteDto) {4}]  | null 
optional
Shipment & carrier notes
manifestId
string  | null 
optional
Shipment PRO number
bolNumber
string  | null 
optional
Shipment BOL number
customerPo
string  | null 
optional
Shipment Customer PO
invoiceId
string  | null 
optional
Shipment Invoice identifier
billingId
string  | null 
optional
Shipment Billing identifier
incoTermId
integer <int32>
optional
Shipment IncoTerm identifier
pickupNumber
string  | null 
optional
Pickup number assigned to the load
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Estimated Pickup Date
actualPickup
string <date-time> | null 
optional
Actual Pickup Date
estimatedDelivery
string <date-time> | null 
optional
Estimated Delivery Date
actualDelivery
string <date-time> | null 
optional
Actual Delivery Date
createdDate
string <date-time> | null 
optional
Shipment created date
shipType
enum<string> 
required
Shipment Ship Type
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
Shipment Pay Type
Allowed values:
CollectPrepaid
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
Shipper Information
consigneeLocation
object (LocationDto) 
optional
Consignee Information
billTo
object (BillToDto) 
optional
Billing Information
packageInfo
object (PackageInfoDto) 
optional
Package Information
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Shipment Service(s)
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
The handling units containing product information.
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials.
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipper accessorials.
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The consignee accessorials.
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance Details
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Individual stops for a multi-stop shipment
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {45}]  | null 
optional
Individual legs for a multi-legshipment
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
trackingNumbers
array[string]
required
List of any Tracking Numbers attached to a shipment
ratingCompleted
boolean 
required
Gets or sets a value indicating whether rating completed
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
vendorName
string  | null 
optional
Name of Vendor
highBuyRate
number <double> | null 
optional
High Buy Rate Recommendation of Vendor
lowBuyRate
number <double> | null 
optional
Low Buy Rate Recommendation of Vendor
buyRate
number <double> | null 
optional
Target Buy Rate Recommendation of Vendor
startRate
number <double> | null 
optional
Starting Bid Recommandation of Vendor
confidenceLevel
integer <int32> | null 
optional
Confidence of Vendor to hit target rate
currency
string  | null 
optional
The currency of the Market Rate.
date
string <date-time> | null 
optional
The date the Market Rate was generated.
reRateReasons
string  | null 
optional
If the shipment had changes that required re-rating, the reason(s) for doing so.
wasReRated
boolean 
optional
Flag indicating whether the changes required re-rating.
Example
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠422Client Error
🟠429Too Many Requests
Previous
Add Document(s) to a Shipment
Next
Adds one or more Reference Numbers to a Shipment
Built with