This endpoint is used to create new shipment by passing JSON request payload.

Resource URL

Cluster	URL

Cluster	URL
Australia	https://api.bbamastro.com/shipment
US	https://api-us.bbamastro.com/shipment

Header Request

Field	Data Type	Description

Field	Data Type	Description
Authorization	String	Bearer Access token

Request Payload

Field		Data Type	Required	Description

Field		Data Type	Required	Description
sourceAddress		Object	Yes	Source address
	name	String	No	Source address name
	firstName	String	Yes	Sender first name
	lastName	String	Yes	Sender last name
	addressLine1	String	Yes	Sender address line 1
	addressLine2	String	No	Sender address line 2
	phone	String	Yes	Sender phone number
	email	String	Yes	Sender email address
	company	String	No	Sender company name
	location.code	String	Yes	Sender postal code
	location.country.code	String	Yes	Sender country code
	location.id	Long	Yes	Sender address location id
	location.name	String	Yes	Source address location name
	location.state.code	String	Yes	Source postal code
destinationAddress		Object	Yes	Destination address
	firstName	String	Yes	Destination first name
	lastName	String	Yes	Destination last name
	addressLine1	String	Yes	Destination address line 1
	addressLine2	String	No	Destination address line 2
	phone	String	Yes	Destination phone number
	email	String	Yes	Destination email address
	company	String	No	Destination company name
	location.code	String	Yes	Destination postal code
	location.country.code	String	Yes	Destination country code
	location.name	String	Yes	Destination location name
	location.state.code	String	Yes	Destination state code
reasonForShipping		String	Yes	Reason for shipping. Available values are `purchase`, `gift`, `sale`, `sample`, `return`,`repair`, `personal_Effects`
taxStatus		String	Yes	Tax status. Available values are `private`, `company`.
pickupDetails		Object	Yes	Quote pickup details
	asap	Boolean	Yes	Pickup ASAP
	pickupDate	Date	Yes if asap is true	Pickup date. The format is “yyyy-MM-dd“. ex: “2022-09-27“
	pickupTimezone	String	Yes if asap is true	Pickup timezone. ex: “+10:00“
	pickupEarliestTime	String	yes if asap is true	Pickup earliest time. The format is “hh:mm“. ex: “10:00“
notifyReceiver		Boolean	No	Notify receiver for any update of this shipment
packages		Object[]	yes	Packages
	length	Decimal	Yes	Package length
	width	Decimal	Yes	Package width
	height	Decimal	Yes	Package height
	weight	Decimal	Yes	Package weight
	contentWeight	Decimal	Yes	Package content weight
	measureUnit	String	No	Item measure unit. Available values are CM, IN, M, FT, MM. Default value will be used if the value is null.
	weightUnit	String	No	Item weight unit. Available values are Grams, Kilograms, Ounces, Pounds. Default value will be used if the value is null.
	quantity	Integer	Yes	Package quantity
items		Object[]	yes	Items
	name	String	Yes	Item Name
	sku	String	No	Item SKU
	length	Decimal	Yes	Item length
	width	Decimal	Yes	Package width
	height	Decimal	Yes	Package height
	weight	Decimal	Yes	Package weight
	measureUnit	String	Yes	Item measure unit. Available values are CM, IN, M, FT, MM. Default value will be used if the value is null.
	weightUnit	String	Yes	Item weight unit. Available values are Grams, Kilograms, Ounces, Pounds. Default value will be used if the value is null.
	quantity	Integer	Yes	Package quantity
	value	Decimal	Yes	Item Price
	currency	String	Yes	Item currency
	manufacturer	String	No	Origin of item
carrierId		String	Yes	Carrier id
serviceId		String	Yes	Service id
serviceProfileId		String	Yes	Service profile id
office		Long	No	Office id

Request Payload Sample

{
    "destinationAddress": {
        "firstName": "Greg",
        "lastName": "Sharp",
        "addressLine1": "11A Edinburgh Rd",
        "phone": "+61415149001",
        "email": "info@mailinator.com",
        "location": {
            "code": "2204",
            "country": {
                "code": "AU"
            },
            "name": "Marrickville",
            "state": {
                "code": "NSW"
            }
        }
    },
    "sourceAddress": {
        "firstName": "Ship2Anywhere",
        "lastName": "user",
        "addressLine1": "Highway Street",
        "phone": "+61423793039",
        "email": "ship2anywhere@mailinator.com",
        "company": "Ship2Anywhere",
        "location": {
            "code": "3205",
            "country": {
                "code": "AU"
            },
            "id": 18011,
            "name": "South Melbourne",
            "state": {
                "code": "VIC"
            }
        }
    },
    "reasonForShipping": "sale",
    "taxStatus": "private",
    "pickupDetails": {
        "asap": true
    },
    "packages": [
        {
            "measureUnit": "CM",
            "weightUnit": "Kilograms",
            "weight": "1",
            "contentWeight": "1",
            "quantity": "1",
            "length": "1",
            "width": "1",
            "height": "1"
        }
    ],
    "items": [
        {
            "quantity": 1,
            "value": "100",
            "manufacturer": "AU",
            "sku": null,            
            "weight": "1",
            "length": "11",
            "width": "11",
            "height": "11",
            "name": "Test item",
            "measureUnit": "CM",
            "weightUnit": "Kilograms",
            "currency": "AUD"
        }
    ],
    "carrierId": "couriers-please",
    "serviceId": "P2A",
    "serviceProfileId": "62ee60a110d1d100019b1e19"
}

Responses

HTTP Code	Description	Schema

HTTP Code	Description	Schema
201	Created	ShipmentPublicProjection
401	Unauthorized	No Content
403	Forbidden	No Content
404	Not Found	No Content

Shipment

Name	Description	Schema

Name	Description	Schema
accompanied Delivery optional	Indicate if the delivery will be accompanied by another person Example : false	boolean
active optional	Shipment activation status Example : false	boolean
amount optional	Shipment amount	number
appliedShippingRule optional	Shipping rules that are applied to shipment	ShippingRule
bbaReferenceNumber optional	Shipment BBA Reference number	string
billed optional		boolean
bookingDate optional	The date when shipment booked	string (date-time)
bookingStatus optional	Shipment booking status	enum (new, unprocessed, inprogress, pending, processed)
breakBulkDetails optional	${swagger.model.shipment.break_bulk_details}	BreakBulkDetails
carrierBookingOptions optional	${swagger.model.shipment.carrier_booking_options}	< string, string > map
carrierID optional	Shipment carrier identifier	string
carrierOderId optional	${swagger.model.shipment.carrierOrderId}	string
carrierProfileId optional	Shipment carrier profile identifier	string
carrierServiceRateId optional	${swagger.model.shipment.carrier_service_rate_id}	string
carrierShipmentId optional	Carrier’s shipment identifier	string
clientPresent optional	Indicate if client will be present to assist the receiving of shipment Example: false	boolean
company optional	Shipment company	string
consignmentId optional	Shipment consignment identifier	string
consolidation optional	Shipment consolidation	ShipmentConsolidation
containerId optional	Shipment crossdock container identifier	string
containerName optional	Shipment crossdock container name	string
containerType optional	Shipment crossdock container type	enum (bag, box, carton, case, crate, envelope, pallet, rack, sack, tray)
createdDate optional	The date when shipment created	string (date-time)
currency optional	Shipment currency	string
customerReferences optional	Shipment customer references	< string > array
dangerousGoods optional	Indicate if shipment contains dangerous goods Example : false	boolean
deliveredDate optional	The date when shipment delivered	string (date-time)
description optional	Shipment description	string
destinationAddress optional	Shipment destination address	Address
eta optional	Shipment ETA	string
fromFtp optional	Indicate if the shipment data from FTP file Example : false	boolean
history optional		< History > array
id optional	Shipment identifier	string

POST /shipment

Resource URL

Header Request

Request Payload

Request Payload Sample

Responses

Shipment