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:

  • 0
  • 1
  • 2
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:

  • 0
  • 1
options.errorHandling Integer No

0 = DoNotConsolidateOnAnyError, 1 = ConsolidateValidConsignments

Possible values:

  • 0
  • 1
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:

  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 10
  • 54
  • 11
  • 55
  • 12
  • 56
  • 13
  • 57
  • 14
  • 58
  • 15
  • 59
  • 16
  • 17
  • 18
  • 19
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 60
  • 61
  • 20
  • 21
  • 22
  • 23
  • 24
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
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:

  • 1
  • 2
  • 3
  • 4
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:

  • 22
  • 44
  • 23
  • 45
  • 24
  • 46
  • 25
  • 47
  • 26
  • 48
  • 27
  • 49
  • 28
  • 29
  • 30
  • 31
  • 10
  • 32
  • 11
  • 33
  • 12
  • 34
  • 13
  • 35
  • 14
  • 36
  • 15
  • 37
  • 16
  • 38
  • 17
  • 39
  • 18
  • 19
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 40
  • 41
  • 20
  • 42
  • 21
  • 43
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:

  • 1
  • 2
  • 3
  • 4
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:

  • 22
  • 44
  • 23
  • 45
  • 24
  • 46
  • 25
  • 47
  • 26
  • 48
  • 27
  • 49
  • 28
  • 29
  • 30
  • 31
  • 10
  • 32
  • 11
  • 33
  • 12
  • 34
  • 13
  • 35
  • 14
  • 36
  • 15
  • 37
  • 16
  • 38
  • 17
  • 39
  • 18
  • 19
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 40
  • 41
  • 20
  • 42
  • 21
  • 43
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:

  • 22
  • 44
  • 23
  • 45
  • 24
  • 46
  • 25
  • 47
  • 26
  • 48
  • 27
  • 49
  • 28
  • 29
  • 30
  • 31
  • 10
  • 32
  • 11
  • 33
  • 12
  • 34
  • 13
  • 35
  • 14
  • 36
  • 15
  • 37
  • 16
  • 38
  • 17
  • 39
  • 18
  • 19
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 40
  • 41
  • 20
  • 42
  • 21
  • 43
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:

  • 22
  • 44
  • 23
  • 45
  • 24
  • 46
  • 25
  • 47
  • 26
  • 48
  • 27
  • 49
  • 28
  • 29
  • 30
  • 31
  • 10
  • 32
  • 11
  • 33
  • 12
  • 34
  • 13
  • 35
  • 14
  • 36
  • 15
  • 37
  • 16
  • 38
  • 17
  • 39
  • 18
  • 19
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 40
  • 41
  • 20
  • 42
  • 21
  • 43
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:

  • 11
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
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:

  • 0
  • 1
  • 2
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:

  • 0
  • 1
  • 2
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

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.