PUT api/deal/{id}/cost/{guid}

Add or update a deal cost for a deal cost header

Request Information

URI Parameters

Name	Description	Type	Additional information
id	Deal cost header identifier	globally unique identifier	Required
guid	Product identifier	globally unique identifier	Required

Body Parameters

Deal cost to save

DealCost

Name	Description	Type	Additional information
HeaderIdentifier		Collection of byte	None.
HeaderIdentifierGuid		globally unique identifier	None.
Identifier		Collection of byte	None.
IdentifierGuid		globally unique identifier	None.
SupplierIdentifier		Collection of byte	None.
SupplierGuid		globally unique identifier	None.
PLUG_UID		Collection of byte	None.
PluGuid	A Store Product GUID	globally unique identifier	None.
CampaignName		string	Deprecated. Please use CampaignPLU.DealCostIdentifier instead. String length: inclusive between 0 and 64
Description		string	None.
Cost		integer	None.
CostDecimals		integer	None.
Start		date	Data type: Date
End		date	Data type: Date
Type		DealCostType	None.
PromoType		PromoType	None.
BonusItemPLUG_UID		Collection of byte	None.
BonusItemPluGuid	A Store Product GUID	globally unique identifier	None.
BonusPurchaseUnits		integer	None.
BonusReceiveUnits		integer	None.
Updated		date	None.
MetcashPromotionID		string	None.
FromHost	FromHost identifying the source, see	integer	None.
StoreNames	Concatenated list of the stores that the deal cost header is in	string	Relation. This field may not always be loaded or used for updates.
StoreIDs	List of store ids of the stores that the deal cost header belongs to	Collection of integer	Relation. This field may not always be loaded or used for updates.
SupplierName	Supplier name	string	Relation. This field may not always be loaded or used for updates.
CampaignDescription	Campaign description of campaign using this deal cost	string	Relation. This field may not always be loaded or used for updates.
NewPrice	New sell price of campaign using this deal cost	integer	Relation. This field may not always be loaded or used for updates.
CampaignMetcashPromotionID	Metcash promotion id of campaign using this deal cost	string	Relation. This field may not always be loaded or used for updates.
CampaignActive	Active status of campaign using this deal cost	boolean	Relation. This field may not always be loaded or used for updates.
CampaignStartDate	Start date of campaign using this deal cost	date	Relation. This field may not always be loaded or used for updates.
CampaignEndDate	End date of campaign using this deal cost	date	Relation. This field may not always be loaded or used for updates.
MasterPLUG_UID	Master plu guid for the deal cost store product	Collection of byte	Relation. This field may not always be loaded or used for updates.
MasterID	Master guid for the deal cost store product	globally unique identifier	Relation. This field may not always be loaded or used for updates.
ProductName	Product description	string	Relation. This field may not always be loaded or used for updates.
ProductAPN	Product barcode	string	Relation. This field may not always be loaded or used for updates.
OrderCode	Order code of product for this supplier deal cost	string	Relation. This field may not always be loaded or used for updates.
NormalSell	Normal product sell	integer	Relation. This field may not always be loaded or used for updates.
NormalCost	Normal product cost	integer	Relation. This field may not always be loaded or used for updates.
NormalCostDecimals	Normal product cost decimals	integer	Relation. This field may not always be loaded or used for updates.
CartonQuantity		integer	Relation. This field may not always be loaded or used for updates.
SalesMode		integer	Relation. This field may not always be loaded or used for updates.
OrderPacked		integer	Relation. This field may not always be loaded or used for updates.
FuelItem		boolean	Relation. This field may not always be loaded or used for updates.
Active		boolean	Relation. This field may not always be loaded or used for updates.
BonusMasterPLUG_UID	Master plu guid for the deal cost store bonus product	Collection of byte	Relation. This field may not always be loaded or used for updates.
BonusMasterID	Master guid for the deal cost store bonus product	globally unique identifier	Relation. This field may not always be loaded or used for updates.
BonusProductName	Bonus product description	string	Relation. This field may not always be loaded or used for updates.
BonusProductAPN	Bonus product barcode	string	Relation. This field may not always be loaded or used for updates.
BonusOrderCode	Order code of bonus product for this supplier deal cost	string	Relation. This field may not always be loaded or used for updates.
BonusNormalSell	Normal bonus product sell	integer	Relation. This field may not always be loaded or used for updates.
BonusNormalCost	Normal bonus product cost	integer	Relation. This field may not always be loaded or used for updates.
BonusNormalCostDecimals	Normal bonus product cost decimals	integer	Relation. This field may not always be loaded or used for updates.
BonusCartonQuantity		integer	Relation. This field may not always be loaded or used for updates.
BonusSalesMode		integer	Relation. This field may not always be loaded or used for updates.
BonusOrderPacked		integer	Relation. This field may not always be loaded or used for updates.
BonusFuelItem		boolean	Relation. This field may not always be loaded or used for updates.
BonusActive		boolean	Relation. This field may not always be loaded or used for updates.

Request Formats

application/json, text/json

Sample:

{
  "headerIdentifier": "xIBJRjd5EkyUSfYwTqPsYg==",
  "headerIdentifierGuid": "464980c4-7937-4c12-9449-f6304ea3ec62",
  "identifier": "E547ariiYEWWL/QeleXW+g==",
  "identifierGuid": "6a3b9e13-a2b8-4560-962f-f41e95e5d6fa",
  "supplierIdentifier": "/R5QO96qWEmkppvcEZF2Mw==",
  "supplierGuid": "3b501efd-aade-4958-a4a6-9bdc11917633",
  "pluG_UID": "kVYZdGJ0X0iNhPqh15ORfA==",
  "pluGuid": "74195691-7462-485f-8d84-faa1d793917c",
  "campaignName": "91ad692c-bf2a-46fd-b074-814c42f501ba",
  "description": "sample string 4",
  "cost": 5,
  "costDecimals": 6,
  "start": "2026-06-03T18:34:58.4923091",
  "end": "2026-06-03T18:34:58.4923091",
  "type": 9,
  "promoType": 10,
  "bonusItemPLUG_UID": "2OvfQ8P8jEG2XfAkpZGolQ==",
  "bonusItemPluGuid": "43dfebd8-fcc3-418c-b65d-f024a591a895",
  "bonusPurchaseUnits": 11,
  "bonusReceiveUnits": 12,
  "updated": "2026-06-03T18:34:58.4923091",
  "metcashPromotionID": "sample string 14",
  "fromHost": 15,
  "storeNames": "sample string 16",
  "storeIDs": [
    1,
    2
  ],
  "supplierName": "sample string 17",
  "campaignDescription": "sample string 18",
  "newPrice": 1,
  "campaignMetcashPromotionID": "sample string 19",
  "campaignActive": true,
  "campaignStartDate": "2026-06-03T18:34:58.4923091",
  "campaignEndDate": "2026-06-03T18:34:58.4923091",
  "masterPLUG_UID": "adXniEfhzECBkw142z3W3g==",
  "masterID": "88e7d569-e147-40cc-8193-0d78db3dd6de",
  "productName": "sample string 22",
  "productAPN": "sample string 23",
  "orderCode": "sample string 24",
  "normalSell": 25,
  "normalCost": 26,
  "normalCostDecimals": 27,
  "cartonQuantity": 28,
  "salesMode": 29,
  "orderPacked": 30,
  "fuelItem": true,
  "active": true,
  "bonusMasterPLUG_UID": "gLU1hAjNfE2UC9k5Lz+hyA==",
  "bonusMasterID": "8435b580-cd08-4d7c-940b-d9392f3fa1c8",
  "bonusProductName": "sample string 34",
  "bonusProductAPN": "sample string 35",
  "bonusOrderCode": "sample string 36",
  "bonusNormalSell": 37,
  "bonusNormalCost": 38,
  "bonusNormalCostDecimals": 39,
  "bonusCartonQuantity": 40,
  "bonusSalesMode": 41,
  "bonusOrderPacked": 42,
  "bonusFuelItem": true,
  "bonusActive": true
}

application/xml, text/xml

Sample:

<DealCost xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://gapsolutions.com.au/schema/ezimanager">
  <Active>true</Active>
  <BonusActive>true</BonusActive>
  <BonusCartonQuantity>40</BonusCartonQuantity>
  <BonusFuelItem>true</BonusFuelItem>
  <BonusItemPLUG_UID>2OvfQ8P8jEG2XfAkpZGolQ==</BonusItemPLUG_UID>
  <BonusItemPluGuid>43dfebd8-fcc3-418c-b65d-f024a591a895</BonusItemPluGuid>
  <BonusMasterID>8435b580-cd08-4d7c-940b-d9392f3fa1c8</BonusMasterID>
  <BonusMasterPLUG_UID>gLU1hAjNfE2UC9k5Lz+hyA==</BonusMasterPLUG_UID>
  <BonusNormalCost>38</BonusNormalCost>
  <BonusNormalCostDecimals>39</BonusNormalCostDecimals>
  <BonusNormalSell>37</BonusNormalSell>
  <BonusOrderCode>sample string 36</BonusOrderCode>
  <BonusOrderPacked>42</BonusOrderPacked>
  <BonusProductAPN>sample string 35</BonusProductAPN>
  <BonusProductName>sample string 34</BonusProductName>
  <BonusPurchaseUnits>11</BonusPurchaseUnits>
  <BonusReceiveUnits>12</BonusReceiveUnits>
  <BonusSalesMode>41</BonusSalesMode>
  <CampaignActive>true</CampaignActive>
  <CampaignDescription>sample string 18</CampaignDescription>
  <CampaignEndDate>2026-06-03T18:34:58.4923091+00:00</CampaignEndDate>
  <CampaignMetcashPromotionID>sample string 19</CampaignMetcashPromotionID>
  <CampaignName>91ad692c-bf2a-46fd-b074-814c42f501ba</CampaignName>
  <CampaignStartDate>2026-06-03T18:34:58.4923091+00:00</CampaignStartDate>
  <CartonQuantity>28</CartonQuantity>
  <Cost>5</Cost>
  <CostDecimals>6</CostDecimals>
  <Description>sample string 4</Description>
  <End>2026-06-03T18:34:58.4923091+00:00</End>
  <FromHost>15</FromHost>
  <FuelItem>true</FuelItem>
  <HeaderIdentifier>xIBJRjd5EkyUSfYwTqPsYg==</HeaderIdentifier>
  <HeaderIdentifierGuid>464980c4-7937-4c12-9449-f6304ea3ec62</HeaderIdentifierGuid>
  <Identifier>E547ariiYEWWL/QeleXW+g==</Identifier>
  <IdentifierGuid>6a3b9e13-a2b8-4560-962f-f41e95e5d6fa</IdentifierGuid>
  <MasterID>88e7d569-e147-40cc-8193-0d78db3dd6de</MasterID>
  <MasterPLUG_UID>adXniEfhzECBkw142z3W3g==</MasterPLUG_UID>
  <MetcashPromotionID>sample string 14</MetcashPromotionID>
  <NewPrice>1</NewPrice>
  <NormalCost>26</NormalCost>
  <NormalCostDecimals>27</NormalCostDecimals>
  <NormalSell>25</NormalSell>
  <OrderCode>sample string 24</OrderCode>
  <OrderPacked>30</OrderPacked>
  <PLUG_UID>kVYZdGJ0X0iNhPqh15ORfA==</PLUG_UID>
  <PluGuid>74195691-7462-485f-8d84-faa1d793917c</PluGuid>
  <ProductAPN>sample string 23</ProductAPN>
  <ProductName>sample string 22</ProductName>
  <PromoType>10</PromoType>
  <SalesMode>29</SalesMode>
  <Start>2026-06-03T18:34:58.4923091+00:00</Start>
  <StoreIDs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:int>1</d2p1:int>
    <d2p1:int>2</d2p1:int>
  </StoreIDs>
  <StoreNames>sample string 16</StoreNames>
  <SupplierGuid>3b501efd-aade-4958-a4a6-9bdc11917633</SupplierGuid>
  <SupplierIdentifier>/R5QO96qWEmkppvcEZF2Mw==</SupplierIdentifier>
  <SupplierName>sample string 17</SupplierName>
  <Type>9</Type>
  <Updated>2026-06-03T18:34:58.4923091+00:00</Updated>
</DealCost>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.