POST /apiv2/consignments/editUnmanifestedConsignment
Servers
- /
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
toCountryId |
Integer | No |
MachShip assigned ID of the destination country. |
despatchDateTimeLocal |
String | No |
Optional: The local despatch datetime that was provided in the route. This datetime must be local to the pickup location. If the DespatchDateTimeUtc is provided, this does not need to be set. If no time is set, this will default to NOW (pickup local time) |
internationalFromCity |
String | No |
International from city. |
carrierAccountId |
Integer | No | |
fromName |
String | No | |
carrierIds[] |
Array | No |
The (optional) listing of Machship Carrier IDs to restrict the returning routes for. When left blank all carriers you have available will be queried for routes. Only used if CarrierId is not specified |
subServiceId |
Integer | No |
The Machship ID of the sub-service under the carrier's service (if there are any). If there are sub-services and this field is left blank, the default will be selected |
internationalFromPostcode |
String | No |
International from postcode. |
fromCountryCode |
String | No |
Two or three letter ISO code of the country of origin. |
fromCompanyLocationId |
Integer | No |
The Machship Id of the saved company location that you want to use. If this is provided, Machship will link this consignment to your saved location and you do not have to provide the delivery details |
toContact |
String | No | |
id |
Integer | No | |
internationalToProvince |
String | No |
International to province. |
customerReference |
String | No | |
questionIds[] |
Array | No |
A collection of Machship IDs corresponding to questions who's result is true |
despatchDateTimeUtc |
String | No |
Optional: The UTC despatch datetime that was provided in the route. If the DespatchDateTimeLocal is provided, this does not need to be set. If no time is set, it will default to NOW (UTC) |
printerToken |
String | No | |
companyId |
Integer | No |
An (optional) Machship ID of a company. When supplied the routes will be those of the company specified, when left blank they will be routes for the company associated with the authorised user. |
toName |
String | No | |
isInternational |
Boolean | No |
Flag to indicate if this consignment is international. |
fromAddressLine2 |
String | No | |
fromAddressLine1 |
String | No | |
toCompanyLocationId |
Integer | No |
The Machship Id of the saved company location that you want to use. If this is provided, Machship will link this consignment to your saved location and you do not have to provide the delivery details |
fromCountry |
Object | No | |
fromCountry.id |
Integer | No | |
fromCountry.currencyCode |
String | No | |
fromCountry.name |
String | No | |
fromCountry.numeric |
String | No | |
fromCountry.taxPercentage |
Number | No | |
fromCountry.displayName |
String | No | |
fromCountry.code3 |
String | No | |
fromCountry.code2 |
String | No | |
fromPhone |
String | No | |
linkedPendingConsignmentIds[] |
Array | No |
Optional list of Machship Pending Consignment ID(s) to link to this consignment - these pending consignment(s) will be linked to this consignment and effectively be deleted from Machship |
fromLocation |
Object | No | |
fromLocation.suburb |
String | No | |
fromLocation.postcode |
String | No | |
fromLocationId |
Integer | No |
The machship ID of the from (pickup) location. Can be left blank if supplying the suburb / postcode instead |
parentConsignmentId |
Integer | No | |
fromAbbreviation |
String | No | |
staffMemberName |
String | No | |
fromContact |
String | No | |
customValues[] |
Array | No | |
customValues[].propertyName |
String | No | |
customValues[].value |
String | No | |
companyCarrierAccountId |
Integer | No | |
receiverAccountId |
Integer | No | |
items[] |
Array | Yes |
A collection of the items being sent |
items[].quantity |
Integer | No |
Number of items |
items[].standardItemId |
Integer | No | |
items[].itemType |
Integer | No |
1 = Carton, 2 = Skid, 3 = Pallet, 4 = Crate, 5 = Satchel, 6 = Roll, 7 = Panel, 8 = Bag, 9 = Tube, 10 = Stillage, 11 = Envelope, 12 = Pack, 13 = Rails, 14 = TimberLoose, 15 = Combined, 16 = TimberPack, 17 = Pipe, 18 = BDouble, 19 = Semi, 20 = TwentyFootContainer, 21 = FortyFootContainer, 22 = Bundle, 23 = Case, 24 = Volume, 26 = IBC, 27 = GLPallet, 28 = GLTrolley, 29 = GLCarton, 30 = Trolley, 31 = TotalVolume, 32 = Drum, 33 = Loscam, 34 = LoscamWood, 35 = LoscamPlastic, 36 = Chep, 37 = ChepWood, 38 = ChepPlastic, 39 = Tray, 40 = Pot, 41 = SeedlingRack, 42 = SilverTrolley, 43 = LightTruckTyre, 44 = PassengerTyre, 45 = AgriculturalTyre, 46 = MowerTyre, 47 = SolidTyre, 48 = TractorTyre, 49 = TrailerTyre, 50 = TruckTyre, 51 = Pallecon, 52 = Item, 53 = Machine, 54 = JiffyBag, 55 = Pot200mm, 56 = Pot250mm, 57 = Pot300mm, 58 = Flatpack, 59 = BrandedPallet, 60 = Disposable, 61 = Plastic Possible values:
|
items[].standardItem |
Object | No | |
items[].standardItem.height |
Number | No |
Height of the item in cm |
items[].standardItem.length |
Number | No |
Length of the item in cm |
items[].standardItem.width |
Number | No |
Width of the item in cm |
items[].standardItem.weight |
Number | No |
Weight of the item in kg |
items[].consignmentItemContents[] |
Array | No | |
items[].consignmentItemContents[].description |
String | Yes | |
items[].consignmentItemContents[].countryOfManufactureId |
Integer | No | |
items[].consignmentItemContents[].quantity |
Integer | No | |
items[].consignmentItemContents[].ciMarksAndNumbers |
String | No | |
items[].consignmentItemContents[].purpose |
String | No | |
items[].consignmentItemContents[].harmonizedCode |
String | No | |
items[].consignmentItemContents[].reference2 |
String | No | |
items[].consignmentItemContents[].dollarValue |
Number | No | |
items[].consignmentItemContents[].reference3 |
String | No | |
items[].consignmentItemContents[].reference1 |
String | No | |
items[].consignmentItemContents[].partNumber |
String | No | |
items[].consignmentItemContents[].countryOfManufactureCode |
String | No | |
items[].consignmentItemContents[].countryOfManufacture |
Object | No | |
items[].consignmentItemContents[].countryOfManufacture.id |
Integer | No | |
items[].consignmentItemContents[].countryOfManufacture.currencyCode |
String | No | |
items[].consignmentItemContents[].countryOfManufacture.name |
String | No | |
items[].consignmentItemContents[].countryOfManufacture.numeric |
String | No | |
items[].consignmentItemContents[].countryOfManufacture.taxPercentage |
Number | No | |
items[].consignmentItemContents[].countryOfManufacture.displayName |
String | No | |
items[].consignmentItemContents[].countryOfManufacture.code3 |
String | No | |
items[].consignmentItemContents[].countryOfManufacture.code2 |
String | No | |
items[].id |
Integer | No |
This is populated IF it is an existing unmanifested consignment's consignment item ID |
items[].name |
String | No |
Name or description of the goods you are sending |
items[].sku |
String | No |
Optional: the SKU or code of the item you are sending |
items[].combinedLoadSize |
Object | No | |
items[].combinedLoadSize.height |
Number | No | |
items[].combinedLoadSize.length |
Number | No | |
items[].combinedLoadSize.width |
Number | No | |
items[].combinedLoadSize.weight |
Number | No | |
items[].consignmentItemReferences[] |
Array | No | |
items[].consignmentItemReferences[].printedDateUtc |
String | No | |
items[].consignmentItemReferences[].printed |
Boolean | No | |
items[].combinedItem |
Object | No | |
items[].combinedItem.totalWeight |
Number | No |
Total weight in kg of the combined item |
items[].combinedItem.heaviestIndividualItem |
Number | No |
Weight in kg of the heaviest individual item that comprises the combined item |
items[].combinedItem.totalWidth |
Number | No |
Total width in cm of the combined item |
items[].combinedItem.totalHeight |
Number | No |
Total height in cm of the combined item |
items[].combinedItem.totalLength |
Number | No |
Total length in cm of the combined item |
items[].combinedItem.numberOfPieces |
Integer | No |
Number of individual pieces that comprise the combined item |
items[].consignmentItemDgItems[] |
Array | No | |
items[].consignmentItemDgItems[].packingGroup |
Integer | No |
1 = One, 2 = Two, 3 = Three, 4 = None Possible values:
|
items[].consignmentItemDgItems[].unNumber |
Integer | No | |
items[].consignmentItemDgItems[].dgClassType |
Integer | No |
2 = FlammableGas, 3 = OtherGas, 4 = ToxicGas, 5 = FlammableLiquid, 6 = FlammableSolid, 7 = SpontaneouslyCombustible, 8 = DangerousWhenWet, 9 = OxidizingAgent, 10 = OrganicPeroxide, 11 = ToxicSubstance, 12 = InfectiousSubstance, 13 = Radioactive, 14 = Corrosive, 15 = Miscellaneous, 16 = Explosive1A, 17 = Explosive1B, 18 = Explosive1C, 19 = Explosive1D, 20 = Explosive1E, 21 = Explosive1F, 22 = Explosive1G, 23 = Explosive1J, 24 = Explosive1L, 25 = Explosive2B, 26 = Explosive2C, 27 = Explosive2D, 28 = Explosive2E, 29 = Explosive2F, 30 = Explosive2G, 31 = Explosive2H, 32 = Explosive2J, 33 = Explosive2K, 34 = Explosive2L, 35 = Explosive3C, 36 = Explosive3G, 37 = Explosive3H, 38 = Explosive3J, 39 = Explosive3K, 40 = Explosive3L, 41 = Explosive4B, 42 = Explosive4C, 43 = Explosive4D, 44 = Explosive4E, 45 = Explosive4F, 46 = Explosive4G, 47 = Explosive4S, 48 = Explosive5D, 49 = Explosive6N Possible values:
|
items[].consignmentItemDgItems[].unNumberInfo |
Object | No | |
items[].consignmentItemDgItems[].unNumberInfo.packingGroup |
Integer | No |
1 = One, 2 = Two, 3 = Three, 4 = None Possible values:
|
items[].consignmentItemDgItems[].unNumberInfo.unNumber |
Integer | No | |
items[].consignmentItemDgItems[].unNumberInfo.name |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.packingGroupName |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClassesForDisplay |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.classesForDisplay |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.class |
Object | No | |
items[].consignmentItemDgItems[].unNumberInfo.class.label |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.class.class |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.class.classType |
Integer | No |
2 = FlammableGas, 3 = OtherGas, 4 = ToxicGas, 5 = FlammableLiquid, 6 = FlammableSolid, 7 = SpontaneouslyCombustible, 8 = DangerousWhenWet, 9 = OxidizingAgent, 10 = OrganicPeroxide, 11 = ToxicSubstance, 12 = InfectiousSubstance, 13 = Radioactive, 14 = Corrosive, 15 = Miscellaneous, 16 = Explosive1A, 17 = Explosive1B, 18 = Explosive1C, 19 = Explosive1D, 20 = Explosive1E, 21 = Explosive1F, 22 = Explosive1G, 23 = Explosive1J, 24 = Explosive1L, 25 = Explosive2B, 26 = Explosive2C, 27 = Explosive2D, 28 = Explosive2E, 29 = Explosive2F, 30 = Explosive2G, 31 = Explosive2H, 32 = Explosive2J, 33 = Explosive2K, 34 = Explosive2L, 35 = Explosive3C, 36 = Explosive3G, 37 = Explosive3H, 38 = Explosive3J, 39 = Explosive3K, 40 = Explosive3L, 41 = Explosive4B, 42 = Explosive4C, 43 = Explosive4D, 44 = Explosive4E, 45 = Explosive4F, 46 = Explosive4G, 47 = Explosive4S, 48 = Explosive5D, 49 = Explosive6N Possible values:
|
items[].consignmentItemDgItems[].unNumberInfo.class.subRisk |
Boolean | No | |
items[].consignmentItemDgItems[].unNumberInfo.class.division |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.classes[] |
Array | No | |
items[].consignmentItemDgItems[].unNumberInfo.classes[].label |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.classes[].class |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.classes[].classType |
Integer | No |
2 = FlammableGas, 3 = OtherGas, 4 = ToxicGas, 5 = FlammableLiquid, 6 = FlammableSolid, 7 = SpontaneouslyCombustible, 8 = DangerousWhenWet, 9 = OxidizingAgent, 10 = OrganicPeroxide, 11 = ToxicSubstance, 12 = InfectiousSubstance, 13 = Radioactive, 14 = Corrosive, 15 = Miscellaneous, 16 = Explosive1A, 17 = Explosive1B, 18 = Explosive1C, 19 = Explosive1D, 20 = Explosive1E, 21 = Explosive1F, 22 = Explosive1G, 23 = Explosive1J, 24 = Explosive1L, 25 = Explosive2B, 26 = Explosive2C, 27 = Explosive2D, 28 = Explosive2E, 29 = Explosive2F, 30 = Explosive2G, 31 = Explosive2H, 32 = Explosive2J, 33 = Explosive2K, 34 = Explosive2L, 35 = Explosive3C, 36 = Explosive3G, 37 = Explosive3H, 38 = Explosive3J, 39 = Explosive3K, 40 = Explosive3L, 41 = Explosive4B, 42 = Explosive4C, 43 = Explosive4D, 44 = Explosive4E, 45 = Explosive4F, 46 = Explosive4G, 47 = Explosive4S, 48 = Explosive5D, 49 = Explosive6N Possible values:
|
items[].consignmentItemDgItems[].unNumberInfo.classes[].subRisk |
Boolean | No | |
items[].consignmentItemDgItems[].unNumberInfo.classes[].division |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClasses[] |
Array | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClasses[].label |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClasses[].class |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClasses[].classType |
Integer | No |
2 = FlammableGas, 3 = OtherGas, 4 = ToxicGas, 5 = FlammableLiquid, 6 = FlammableSolid, 7 = SpontaneouslyCombustible, 8 = DangerousWhenWet, 9 = OxidizingAgent, 10 = OrganicPeroxide, 11 = ToxicSubstance, 12 = InfectiousSubstance, 13 = Radioactive, 14 = Corrosive, 15 = Miscellaneous, 16 = Explosive1A, 17 = Explosive1B, 18 = Explosive1C, 19 = Explosive1D, 20 = Explosive1E, 21 = Explosive1F, 22 = Explosive1G, 23 = Explosive1J, 24 = Explosive1L, 25 = Explosive2B, 26 = Explosive2C, 27 = Explosive2D, 28 = Explosive2E, 29 = Explosive2F, 30 = Explosive2G, 31 = Explosive2H, 32 = Explosive2J, 33 = Explosive2K, 34 = Explosive2L, 35 = Explosive3C, 36 = Explosive3G, 37 = Explosive3H, 38 = Explosive3J, 39 = Explosive3K, 40 = Explosive3L, 41 = Explosive4B, 42 = Explosive4C, 43 = Explosive4D, 44 = Explosive4E, 45 = Explosive4F, 46 = Explosive4G, 47 = Explosive4S, 48 = Explosive5D, 49 = Explosive6N Possible values:
|
items[].consignmentItemDgItems[].unNumberInfo.subClasses[].subRisk |
Boolean | No | |
items[].consignmentItemDgItems[].unNumberInfo.subClasses[].division |
String | No | |
items[].consignmentItemDgItems[].unNumberInfo.requiresTechnicalName |
Boolean | No | |
items[].consignmentItemDgItems[].companyDgItemId |
Integer | No | |
items[].consignmentItemDgItems[].properShippingName |
String | No | |
items[].consignmentItemDgItems[].aggregateQuantity |
Number | No | |
items[].consignmentItemDgItems[].subDgClassTypes[] |
Array | No | |
items[].consignmentItemDgItems[].containerType |
Integer | No |
1 = Drum, 2 = Carton, 3 = IBC, 4 = Pail, 5 = DemountableTank, 6 = Bottle, 7 = PressureDrums, 8 = Tubes, 9 = MEGCs, 10 = Aerosol, 11 = Bag Possible values:
|
items[].consignmentItemDgItems[].isAggregateQuantityWeight |
Boolean | No | |
items[].consignmentItemDgItems[].isEmptyDgContainer |
Boolean | No | |
items[].consignmentItemDgItems[].isMarinePollutant |
Boolean | No | |
items[].consignmentItemDgItems[].numberOfContainers |
Integer | No | |
items[].consignmentItemDgItems[].technicalOrChemicalGroupNames |
String | No | |
items[].consignmentItemDgItems[].isTemperatureControlled |
Boolean | No | |
items[].companyItemId |
Integer | No |
Optional: Links this item back up to a saved item in Machship |
items[].machshipItemType |
Object | No | |
items[].machshipItemType.id |
Integer | No | |
items[].machshipItemType.abbreviation |
String | No | |
items[].machshipItemType.isUniversal |
Boolean | No | |
items[].machshipItemType.name |
String | No | |
items[].machshipItemType.hexColor |
String | No | |
items[].machshipItemType.description |
String | No | |
items[].machshipItemType.value |
String | No | |
items[].machshipItemType.usePalletSpaces |
Boolean | No | |
items[].machshipItemType.exclude |
Boolean | No | |
items[].palletSpaces |
Number | No | |
items[].combinedItemId |
Integer | No | |
internationalToPostcode |
String | No |
International to postcode. |
setItemReferences |
Boolean | No |
When set to true the system will use the item references supplied, otherwise the item references will be automatically generated by MachShip |
dgsDeclaration |
Boolean | No |
This must be set to true if the consignment contains Dangerous Goods. If this consignment does not have Dangerous Goods, this must be set to false. Note this flag only needs to be set if you are setup to consign Dangerous Goods through Machship |
toLocation |
Object | No | |
toLocation.suburb |
String | No | |
toLocation.postcode |
String | No | |
toCountryCode |
String | No |
Two or three letter ISO code of the destination country. |
fromEmail |
String | No | |
carrierServiceId |
Integer | No | |
toLocationId |
Integer | No |
The machship ID of the to (receiver) location. Can be left blank if supplying the suburb / postcode instead |
previousConsignmentId |
Integer | No | |
toAbbreviation |
String | No | |
toCountry |
Object | No | |
toCountry.id |
Integer | No | |
toCountry.currencyCode |
String | No | |
toCountry.name |
String | No | |
toCountry.numeric |
String | No | |
toCountry.taxPercentage |
Number | No | |
toCountry.displayName |
String | No | |
toCountry.code3 |
String | No | |
toCountry.code2 |
String | No | |
carrierId |
Integer | No | |
toEmail |
String | No | |
consignmentOptions |
String | No | |
fromCountryId |
Integer | No |
MachShip assigned ID of the country of origin. |
toAddressLine2 |
String | No | |
defaultRouteSelection |
Integer | No |
0 = Cheapest, 1 = Fastest Possible values:
|
electiveSurchargeIds[] |
Array | No | |
internationalFromProvince |
String | No |
International from province. |
toAddressLine1 |
String | No | |
receiverAccountCode |
String | No | |
internationalToCity |
String | No |
International to city. |
customerReference2 |
String | No | |
specialInstructions |
String | No | |
sendingTrackingEmail |
Boolean | No |
Set this to true if you would like to send a tracking email to the receiver email address once this consignment is manifested |
toPhone |
String | No |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.