POST /apiv2/consolidation/performConsolidation
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 |
---|---|---|---|
options |
Object | No | |
options.doNotConsolidate |
Boolean | No |
Set this flag to true when you do not want to consolidate, rather you just want the consignments to be returned to be abl to perform a bulk update |
options.consolidationTarget |
Integer | No |
Which type of consignments to target for consolidation0 = Unmanifested, 1 = Pending, 2 = Both Possible values:
|
options.groupByReferenceOne |
Boolean | No |
Whether the first customer reference be used when grouping consignments for consolidation |
options.groupByService |
Boolean | No |
Whether the service will be considered when consolidating consignments (only relevant when Machship.Common.Models.Consolidation.ConsolidationOptions.GroupByCarrier is also set to true) |
options.companyId |
Integer | No |
The Machship Company ID that consolidation should be performed for - if omitted it will be performed against the company of the user performing consolidation |
options.groupByReferenceTwo |
Boolean | No |
Whether the second customer reference be used when grouping consignments for consolidation |
options.groupByCarrier |
Boolean | No |
Whether the carrier will be considered when consolidating consignments |
options.defaultRouteSelection |
Integer | No |
0 = Cheapest, 1 = Fastest Possible values:
|
options.errorHandling |
Integer | No |
0 = DoNotConsolidateOnAnyError, 1 = ConsolidateValidConsignments Possible values:
|
options.pendingConsignmentIds[] |
Array | No |
Optional - list of pending consignment IDs to attempt to consolidate. Will not be considered if Machship.Common.Models.Consolidation.ConsolidationOptions.ConsolidationTarget is set to Machship.Common.Models.Consolidation.Enums.ConsolidationTarget.Unmanifested. If omitted all pending consignments will be used to attempt consolidation. |
options.preventFutureDateConsoldation |
Boolean | No | |
options.groupByDespatchDate |
Boolean | No |
Whether the despatch date be used when grouping consignments for consolidation |
options.unmanifestedConsignmentIds[] |
Array | No |
Optional - list of unmanifested consignment IDs to attempt to consolidate. Will not be considered if Machship.Common.Models.Consolidation.ConsolidationOptions.ConsolidationTarget is set to Machship.Common.Models.Consolidation.Enums.ConsolidationTarget.Pending. If omitted all unmanifested consignments will be used to attempt consolidation. |
grouping |
Object | No | |
grouping.consignments[] |
Array | No |
The consolidated consignments and their details |
grouping.consignments[].toCountryId |
Integer | No | |
grouping.consignments[].staffMemberName |
String | No | |
grouping.consignments[].customValues[] |
Array | No | |
grouping.consignments[].customValues[].propertyName |
String | No | |
grouping.consignments[].customValues[].value |
String | No | |
grouping.consignments[].internationalFromCity |
String | No | |
grouping.consignments[].despatchDateLocal |
String | No | |
grouping.consignments[].items[] |
Array | No | |
grouping.consignments[].items[].quantity |
Integer | No |
Number of items |
grouping.consignments[].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:
|
grouping.consignments[].items[].standardItem |
Object | No | |
grouping.consignments[].items[].standardItem.height |
Number | No |
Height of the item in cm |
grouping.consignments[].items[].standardItem.length |
Number | No |
Length of the item in cm |
grouping.consignments[].items[].standardItem.width |
Number | No |
Width of the item in cm |
grouping.consignments[].items[].standardItem.weight |
Number | No |
Weight of the item in kg |
grouping.consignments[].items[].consignmentItemContents[] |
Array | No | |
grouping.consignments[].items[].consignmentItemContents[].description |
String | Yes | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufactureId |
Integer | No | |
grouping.consignments[].items[].consignmentItemContents[].quantity |
Integer | No | |
grouping.consignments[].items[].consignmentItemContents[].ciMarksAndNumbers |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].purpose |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].harmonizedCode |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].reference2 |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].dollarValue |
Number | No | |
grouping.consignments[].items[].consignmentItemContents[].reference3 |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].reference1 |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].partNumber |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufactureCode |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture |
Object | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.id |
Integer | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.currencyCode |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.name |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.numeric |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.taxPercentage |
Number | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.displayName |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.code3 |
String | No | |
grouping.consignments[].items[].consignmentItemContents[].countryOfManufacture.code2 |
String | No | |
grouping.consignments[].items[].id |
Integer | No |
This is populated IF it is an existing unmanifested consignment's consignment item ID |
grouping.consignments[].items[].name |
String | No |
Name or description of the goods you are sending |
grouping.consignments[].items[].sku |
String | No |
Optional: the SKU or code of the item you are sending |
grouping.consignments[].items[].combinedLoadSize |
Object | No | |
grouping.consignments[].items[].combinedLoadSize.height |
Number | No | |
grouping.consignments[].items[].combinedLoadSize.length |
Number | No | |
grouping.consignments[].items[].combinedLoadSize.width |
Number | No | |
grouping.consignments[].items[].combinedLoadSize.weight |
Number | No | |
grouping.consignments[].items[].consignmentItemReferences[] |
Array | No | |
grouping.consignments[].items[].consignmentItemReferences[].printedDateUtc |
String | No | |
grouping.consignments[].items[].consignmentItemReferences[].printed |
Boolean | No | |
grouping.consignments[].items[].combinedItem |
Object | No | |
grouping.consignments[].items[].combinedItem.totalWeight |
Number | No |
Total weight in kg of the combined item |
grouping.consignments[].items[].combinedItem.heaviestIndividualItem |
Number | No |
Weight in kg of the heaviest individual item that comprises the combined item |
grouping.consignments[].items[].combinedItem.totalWidth |
Number | No |
Total width in cm of the combined item |
grouping.consignments[].items[].combinedItem.totalHeight |
Number | No |
Total height in cm of the combined item |
grouping.consignments[].items[].combinedItem.totalLength |
Number | No |
Total length in cm of the combined item |
grouping.consignments[].items[].combinedItem.numberOfPieces |
Integer | No |
Number of individual pieces that comprise the combined item |
grouping.consignments[].items[].consignmentItemDgItems[] |
Array | No | |
grouping.consignments[].items[].consignmentItemDgItems[].packingGroup |
Integer | No |
1 = One, 2 = Two, 3 = Three, 4 = None Possible values:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumber |
Integer | No | |
grouping.consignments[].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:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo |
Object | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.packingGroup |
Integer | No |
1 = One, 2 = Two, 3 = Three, 4 = None Possible values:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.unNumber |
Integer | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.name |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.packingGroupName |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClassesForDisplay |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classesForDisplay |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.class |
Object | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.class.label |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.class.class |
String | No | |
grouping.consignments[].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:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.class.subRisk |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.class.division |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classes[] |
Array | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classes[].label |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classes[].class |
String | No | |
grouping.consignments[].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:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classes[].subRisk |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.classes[].division |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClasses[] |
Array | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClasses[].label |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClasses[].class |
String | No | |
grouping.consignments[].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:
|
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClasses[].subRisk |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.subClasses[].division |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].unNumberInfo.requiresTechnicalName |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].companyDgItemId |
Integer | No | |
grouping.consignments[].items[].consignmentItemDgItems[].properShippingName |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].aggregateQuantity |
Number | No | |
grouping.consignments[].items[].consignmentItemDgItems[].subDgClassTypes[] |
Array | No | |
grouping.consignments[].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:
|
grouping.consignments[].items[].consignmentItemDgItems[].isAggregateQuantityWeight |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].isEmptyDgContainer |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].isMarinePollutant |
Boolean | No | |
grouping.consignments[].items[].consignmentItemDgItems[].numberOfContainers |
Integer | No | |
grouping.consignments[].items[].consignmentItemDgItems[].technicalOrChemicalGroupNames |
String | No | |
grouping.consignments[].items[].consignmentItemDgItems[].isTemperatureControlled |
Boolean | No | |
grouping.consignments[].items[].companyItemId |
Integer | No |
Optional: Links this item back up to a saved item in Machship |
grouping.consignments[].items[].palletSpaces |
Number | No | |
grouping.consignments[].receiverAccountId |
Integer | No | |
grouping.consignments[].uniqueIdentifier |
String | No |
This is used when new consignments are being created and run through the consolidation engine - having a globally unique ID means we can match the consolidation result back up with the request |
grouping.consignments[].dgsDeclared |
Boolean | No | |
grouping.consignments[].internationalToPostcode |
String | No | |
grouping.consignments[].internationalFromPostcode |
String | No | |
grouping.consignments[].fromCompanyLocationId |
Integer | No | |
grouping.consignments[].id |
Integer | No | |
grouping.consignments[].internationalToProvince |
String | No | |
grouping.consignments[].originalPendingConsignments[] |
Array | No | |
grouping.consignments[].originalPendingConsignments[].id |
Integer | No |
Machship's Consignment / Pending Consignment ID |
grouping.consignments[].originalPendingConsignments[].account |
Object | No | |
grouping.consignments[].originalPendingConsignments[].account.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].account.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].account.accountCode |
String | No | |
grouping.consignments[].originalPendingConsignments[].account.carrierId |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].account.carrier |
Object | No | |
grouping.consignments[].originalPendingConsignments[].account.carrier.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].account.carrier.abbreviation |
String | No | |
grouping.consignments[].originalPendingConsignments[].account.carrier.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].account.carrier.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].account.isInTestMode |
Boolean | No | |
grouping.consignments[].originalPendingConsignments[].account.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount |
Object | No |
Stripped back details of the Company Carrier Account |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.abbreviation |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount |
Object | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.accountCode |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrierId |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrier |
Object | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrier.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrier.abbreviation |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrier.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.carrier.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.isInTestMode |
Boolean | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccount.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.carrierAccountId |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.companyId |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].companyCarrierAccount.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].consignmentNumber |
String | No |
Machship's Consignment (MS) or Pending Consignment (PS) number |
grouping.consignments[].originalPendingConsignments[].carrier |
Object | No | |
grouping.consignments[].originalPendingConsignments[].carrier.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].carrier.abbreviation |
String | No | |
grouping.consignments[].originalPendingConsignments[].carrier.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].carrier.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].hasPrintedLabels |
Boolean | No | |
grouping.consignments[].originalPendingConsignments[].service |
Object | No | |
grouping.consignments[].originalPendingConsignments[].service.id |
Integer | No | |
grouping.consignments[].originalPendingConsignments[].service.abbreviation |
String | No | |
grouping.consignments[].originalPendingConsignments[].service.name |
String | No | |
grouping.consignments[].originalPendingConsignments[].service.displayName |
String | No | |
grouping.consignments[].originalPendingConsignments[].isPendingConsignment |
Boolean | No | |
grouping.consignments[].consignmentNumber |
String | No | |
grouping.consignments[].toAddress |
Object | No |
An address |
grouping.consignments[].toAddress.contact |
String | No |
The contact name for this address |
grouping.consignments[].toAddress.name |
String | No |
The name of the addresss |
grouping.consignments[].toAddress.email |
String | No |
The email address associated with this addresss |
grouping.consignments[].toAddress.location |
Object | No | |
grouping.consignments[].toAddress.location.locationType |
Integer | No |
0 = Suburb, 1 = PostOfficeBox, 2 = International Possible values:
|
grouping.consignments[].toAddress.location.searchStr |
String | No |
used if the user only passed in a string for the location. Location Service will then try to find location based on str |
grouping.consignments[].toAddress.location.description |
String | No | |
grouping.consignments[].toAddress.location.locationAliases[] |
Array | No | |
grouping.consignments[].toAddress.location.locationAliases[].id |
Integer | No | |
grouping.consignments[].toAddress.location.locationAliases[].locationId |
Integer | No | |
grouping.consignments[].toAddress.location.locationAliases[].name |
String | No | |
grouping.consignments[].toAddress.location.locationAliases[].location |
No | ||
grouping.consignments[].toAddress.location.suburb |
String | No | |
grouping.consignments[].toAddress.location.postcode |
String | No | |
grouping.consignments[].toAddress.location.stateId |
Integer | No | |
grouping.consignments[].toAddress.location.isFrom |
Boolean | No | |
grouping.consignments[].toAddress.location.state |
Object | No | |
grouping.consignments[].toAddress.location.state.id |
Integer | No | |
grouping.consignments[].toAddress.location.state.name |
String | No | |
grouping.consignments[].toAddress.location.state.code |
String | No | |
grouping.consignments[].toAddress.location.countryCode |
String | No |
The country code is used to determine the international location |
grouping.consignments[].toAddress.location.id |
Integer | No | |
grouping.consignments[].toAddress.location.descriptionShort |
String | No | |
grouping.consignments[].toAddress.location.countryId |
Integer | No | |
grouping.consignments[].toAddress.location.timeZoneId |
Integer | No | |
grouping.consignments[].toAddress.location.country |
Object | No | |
grouping.consignments[].toAddress.location.country.id |
Integer | No | |
grouping.consignments[].toAddress.location.country.currencyCode |
String | No | |
grouping.consignments[].toAddress.location.country.name |
String | No | |
grouping.consignments[].toAddress.location.country.numeric |
String | No | |
grouping.consignments[].toAddress.location.country.taxPercentage |
Number | No | |
grouping.consignments[].toAddress.location.country.displayName |
String | No | |
grouping.consignments[].toAddress.location.country.code3 |
String | No | |
grouping.consignments[].toAddress.location.country.code2 |
String | No | |
grouping.consignments[].toAddress.location.subLocality |
String | No | |
grouping.consignments[].toAddress.location.timeZone |
Object | No | |
grouping.consignments[].toAddress.location.timeZone.id |
Integer | No | |
grouping.consignments[].toAddress.location.timeZone.jsName |
String | No | |
grouping.consignments[].toAddress.location.timeZone.name |
String | No | |
grouping.consignments[].toAddress.phone |
String | No |
The phone number associated with this address |
grouping.consignments[].toAddress.addressLine1 |
String | No |
The first line of the address |
grouping.consignments[].toAddress.addressLine2 |
String | No |
The (optional) second line of the address |
grouping.consignments[].isPendingConsignment |
Boolean | No | |
grouping.consignments[].questionIds[] |
Array | No | |
grouping.consignments[].despatchDateUtc |
String | No | |
grouping.consignments[].customerReferenceOne |
String | No | |
grouping.consignments[].isReceiverAccount |
Boolean | No | |
grouping.consignments[].companyCarrierAccount |
Object | No |
Stripped back details of the Company Carrier Account |
grouping.consignments[].companyCarrierAccount.id |
Integer | No | |
grouping.consignments[].companyCarrierAccount.abbreviation |
String | No | |
grouping.consignments[].companyCarrierAccount.name |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount |
Object | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.id |
Integer | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.name |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.accountCode |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrierId |
Integer | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrier |
Object | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrier.id |
Integer | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrier.abbreviation |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrier.name |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.carrier.displayName |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.isInTestMode |
Boolean | No | |
grouping.consignments[].companyCarrierAccount.carrierAccount.displayName |
String | No | |
grouping.consignments[].companyCarrierAccount.carrierAccountId |
Integer | No | |
grouping.consignments[].companyCarrierAccount.companyId |
Integer | No | |
grouping.consignments[].companyCarrierAccount.displayName |
String | No | |
grouping.consignments[].toCountry |
Object | No | |
grouping.consignments[].toCountry.id |
Integer | No | |
grouping.consignments[].toCountry.currencyCode |
String | No | |
grouping.consignments[].toCountry.name |
String | No | |
grouping.consignments[].toCountry.numeric |
String | No | |
grouping.consignments[].toCountry.taxPercentage |
Number | No | |
grouping.consignments[].toCountry.displayName |
String | No | |
grouping.consignments[].toCountry.code3 |
String | No | |
grouping.consignments[].toCountry.code2 |
String | No | |
grouping.consignments[].customerReferenceTwo |
String | No | |
grouping.consignments[].printerToken |
String | No | |
grouping.consignments[].originalConsignments[] |
Array | No | |
grouping.consignments[].originalConsignments[].id |
Integer | No |
Machship's Consignment / Pending Consignment ID |
grouping.consignments[].originalConsignments[].account |
Object | No | |
grouping.consignments[].originalConsignments[].account.id |
Integer | No | |
grouping.consignments[].originalConsignments[].account.name |
String | No | |
grouping.consignments[].originalConsignments[].account.accountCode |
String | No | |
grouping.consignments[].originalConsignments[].account.carrierId |
Integer | No | |
grouping.consignments[].originalConsignments[].account.carrier |
Object | No | |
grouping.consignments[].originalConsignments[].account.carrier.id |
Integer | No | |
grouping.consignments[].originalConsignments[].account.carrier.abbreviation |
String | No | |
grouping.consignments[].originalConsignments[].account.carrier.name |
String | No | |
grouping.consignments[].originalConsignments[].account.carrier.displayName |
String | No | |
grouping.consignments[].originalConsignments[].account.isInTestMode |
Boolean | No | |
grouping.consignments[].originalConsignments[].account.displayName |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount |
Object | No |
Stripped back details of the Company Carrier Account |
grouping.consignments[].originalConsignments[].companyCarrierAccount.id |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.abbreviation |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.name |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount |
Object | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.id |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.name |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.accountCode |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrierId |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrier |
Object | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrier.id |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrier.abbreviation |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrier.name |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.carrier.displayName |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.isInTestMode |
Boolean | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccount.displayName |
String | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.carrierAccountId |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.companyId |
Integer | No | |
grouping.consignments[].originalConsignments[].companyCarrierAccount.displayName |
String | No | |
grouping.consignments[].originalConsignments[].consignmentNumber |
String | No |
Machship's Consignment (MS) or Pending Consignment (PS) number |
grouping.consignments[].originalConsignments[].carrier |
Object | No | |
grouping.consignments[].originalConsignments[].carrier.id |
Integer | No | |
grouping.consignments[].originalConsignments[].carrier.abbreviation |
String | No | |
grouping.consignments[].originalConsignments[].carrier.name |
String | No | |
grouping.consignments[].originalConsignments[].carrier.displayName |
String | No | |
grouping.consignments[].originalConsignments[].hasPrintedLabels |
Boolean | No | |
grouping.consignments[].originalConsignments[].service |
Object | No | |
grouping.consignments[].originalConsignments[].service.id |
Integer | No | |
grouping.consignments[].originalConsignments[].service.abbreviation |
String | No | |
grouping.consignments[].originalConsignments[].service.name |
String | No | |
grouping.consignments[].originalConsignments[].service.displayName |
String | No | |
grouping.consignments[].originalConsignments[].isPendingConsignment |
Boolean | No | |
grouping.consignments[].carrier |
Object | No | |
grouping.consignments[].carrier.id |
Integer | No | |
grouping.consignments[].carrier.abbreviation |
String | No | |
grouping.consignments[].carrier.name |
String | No | |
grouping.consignments[].carrier.displayName |
String | No | |
grouping.consignments[].companyId |
Integer | No | |
grouping.consignments[].isInternational |
Boolean | No | |
grouping.consignments[].service |
Object | No | |
grouping.consignments[].service.id |
Integer | No | |
grouping.consignments[].service.abbreviation |
String | No | |
grouping.consignments[].service.name |
String | No | |
grouping.consignments[].service.displayName |
String | No | |
grouping.consignments[].fromCountryId |
Integer | No | |
grouping.consignments[].toCompanyLocationId |
Integer | No | |
grouping.consignments[].fromCountry |
Object | No | |
grouping.consignments[].fromCountry.id |
Integer | No | |
grouping.consignments[].fromCountry.currencyCode |
String | No | |
grouping.consignments[].fromCountry.name |
String | No | |
grouping.consignments[].fromCountry.numeric |
String | No | |
grouping.consignments[].fromCountry.taxPercentage |
Number | No | |
grouping.consignments[].fromCountry.displayName |
String | No | |
grouping.consignments[].fromCountry.code3 |
String | No | |
grouping.consignments[].fromCountry.code2 |
String | No | |
grouping.consignments[].fromAddress |
Object | No |
An address |
grouping.consignments[].fromAddress.contact |
String | No |
The contact name for this address |
grouping.consignments[].fromAddress.name |
String | No |
The name of the addresss |
grouping.consignments[].fromAddress.email |
String | No |
The email address associated with this addresss |
grouping.consignments[].fromAddress.location |
Object | No | |
grouping.consignments[].fromAddress.location.locationType |
Integer | No |
0 = Suburb, 1 = PostOfficeBox, 2 = International Possible values:
|
grouping.consignments[].fromAddress.location.searchStr |
String | No |
used if the user only passed in a string for the location. Location Service will then try to find location based on str |
grouping.consignments[].fromAddress.location.description |
String | No | |
grouping.consignments[].fromAddress.location.locationAliases[] |
Array | No | |
grouping.consignments[].fromAddress.location.locationAliases[].id |
Integer | No | |
grouping.consignments[].fromAddress.location.locationAliases[].locationId |
Integer | No | |
grouping.consignments[].fromAddress.location.locationAliases[].name |
String | No | |
grouping.consignments[].fromAddress.location.locationAliases[].location |
No | ||
grouping.consignments[].fromAddress.location.suburb |
String | No | |
grouping.consignments[].fromAddress.location.postcode |
String | No | |
grouping.consignments[].fromAddress.location.stateId |
Integer | No | |
grouping.consignments[].fromAddress.location.isFrom |
Boolean | No | |
grouping.consignments[].fromAddress.location.state |
Object | No | |
grouping.consignments[].fromAddress.location.state.id |
Integer | No | |
grouping.consignments[].fromAddress.location.state.name |
String | No | |
grouping.consignments[].fromAddress.location.state.code |
String | No | |
grouping.consignments[].fromAddress.location.countryCode |
String | No |
The country code is used to determine the international location |
grouping.consignments[].fromAddress.location.id |
Integer | No | |
grouping.consignments[].fromAddress.location.descriptionShort |
String | No | |
grouping.consignments[].fromAddress.location.countryId |
Integer | No | |
grouping.consignments[].fromAddress.location.timeZoneId |
Integer | No | |
grouping.consignments[].fromAddress.location.country |
Object | No | |
grouping.consignments[].fromAddress.location.country.id |
Integer | No | |
grouping.consignments[].fromAddress.location.country.currencyCode |
String | No | |
grouping.consignments[].fromAddress.location.country.name |
String | No | |
grouping.consignments[].fromAddress.location.country.numeric |
String | No | |
grouping.consignments[].fromAddress.location.country.taxPercentage |
Number | No | |
grouping.consignments[].fromAddress.location.country.displayName |
String | No | |
grouping.consignments[].fromAddress.location.country.code3 |
String | No | |
grouping.consignments[].fromAddress.location.country.code2 |
String | No | |
grouping.consignments[].fromAddress.location.subLocality |
String | No | |
grouping.consignments[].fromAddress.location.timeZone |
Object | No | |
grouping.consignments[].fromAddress.location.timeZone.id |
Integer | No | |
grouping.consignments[].fromAddress.location.timeZone.jsName |
String | No | |
grouping.consignments[].fromAddress.location.timeZone.name |
String | No | |
grouping.consignments[].fromAddress.phone |
String | No |
The phone number associated with this address |
grouping.consignments[].fromAddress.addressLine1 |
String | No |
The first line of the address |
grouping.consignments[].fromAddress.addressLine2 |
String | No |
The (optional) second line of the address |
grouping.consignments[].account |
Object | No | |
grouping.consignments[].account.id |
Integer | No | |
grouping.consignments[].account.name |
String | No | |
grouping.consignments[].account.accountCode |
String | No | |
grouping.consignments[].account.carrierId |
Integer | No | |
grouping.consignments[].account.carrier |
Object | No | |
grouping.consignments[].account.carrier.id |
Integer | No | |
grouping.consignments[].account.carrier.abbreviation |
String | No | |
grouping.consignments[].account.carrier.name |
String | No | |
grouping.consignments[].account.carrier.displayName |
String | No | |
grouping.consignments[].account.isInTestMode |
Boolean | No | |
grouping.consignments[].account.displayName |
String | No | |
grouping.consignments[].internationalFromProvince |
String | No | |
grouping.consignments[].receiverAccountCode |
String | No | |
grouping.consignments[].isTest |
Boolean | No |
When true then the consignment is never going to be sent to the carrier and exists in MachShip purely to test |
grouping.consignments[].internationalToCity |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[] |
Array | No | |
grouping.consignments[].originalUnmanifestedConsignments[].id |
Integer | No |
Machship's Consignment / Pending Consignment ID |
grouping.consignments[].originalUnmanifestedConsignments[].account |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.accountCode |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrierId |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrier |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrier.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrier.abbreviation |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrier.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.carrier.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.isInTestMode |
Boolean | No | |
grouping.consignments[].originalUnmanifestedConsignments[].account.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount |
Object | No |
Stripped back details of the Company Carrier Account |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.abbreviation |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.accountCode |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrierId |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrier |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrier.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrier.abbreviation |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrier.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.carrier.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.isInTestMode |
Boolean | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccount.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.carrierAccountId |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.companyId |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].companyCarrierAccount.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].consignmentNumber |
String | No |
Machship's Consignment (MS) or Pending Consignment (PS) number |
grouping.consignments[].originalUnmanifestedConsignments[].carrier |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].carrier.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].carrier.abbreviation |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].carrier.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].carrier.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].hasPrintedLabels |
Boolean | No | |
grouping.consignments[].originalUnmanifestedConsignments[].service |
Object | No | |
grouping.consignments[].originalUnmanifestedConsignments[].service.id |
Integer | No | |
grouping.consignments[].originalUnmanifestedConsignments[].service.abbreviation |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].service.name |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].service.displayName |
String | No | |
grouping.consignments[].originalUnmanifestedConsignments[].isPendingConsignment |
Boolean | No | |
grouping.consignments[].specialInstructions |
String | No | |
grouping.consignments[].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 |
grouping.companyId |
Integer | No |
The Machship Company ID that consolidation should / has been performed against |
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.