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}

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

Body Params application/json

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 Code 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

Example
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠422Client Error
🟠429Too Many Requests
Modified at 2024-09-16 11:42:17
Previous
Add Document(s) to a Shipment
Next
Adds one or more Reference Numbers to a Shipment
Built with