PUT api/deal/{id}

Add or update a deal cost header

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

Deal cost header identifier

 globally unique identifier

Required

Body Parameters

Deal cost header to save

DealCostHeader
NameDescriptionTypeAdditional information
HeaderIdentifier

Collection of byte

None.
HeaderIdentifierGuid

globally unique identifier

None.
SupplierIdentifier

Collection of byte

None.
SupplierGuid

globally unique identifier

None.
Description

string

None.
Start

date

Data type: Date
End

date

Data type: Date
Type

DealCostType

None.
PromoType

PromoType

None.
FromHost

FromHost identifying the source, see

 integer

None.
Created

date

None.
CreatedByUser

string

None.
Updated

Local updated time

 date

None.
UpdatedByUser

string

None.
Deleted

boolean

None.
SupplierName

Supplier name

 string

Relation. This field may not always be loaded or used for updates.
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

StoreIDs for the deal cost to be updated to

 Collection of integer

Relation. This field may not always be loaded or used for updates.
MasterPLUG_UID

Collection of byte

Relation. This field may not always be loaded or used for updates.
MasterPluGuid

Product for the deal cost header

 globally unique identifier

Relation. This field may not always be loaded or used for updates.
DealCosts

Deal costs to update

 Collection of DealCost

Relation. This field may not always be loaded or used for updates.

Request Formats

application/json, text/json

Sample: 
{
  "headerIdentifier": "j5c5cb89hEu4IDeGOi3HfQ==",
  "headerIdentifierGuid": "7139978f-3dbf-4b84-b820-37863a2dc77d",
  "supplierIdentifier": "5gCi0BXFMU+6AbHZxxpC7A==",
  "supplierGuid": "d0a200e6-c515-4f31-ba01-b1d9c71a42ec",
  "description": "sample string 2",
  "start": "2026-04-03T06:17:24.5196231",
  "end": "2026-04-03T06:17:24.5196231",
  "type": 5,
  "promoType": 6,
  "fromHost": 7,
  "created": "2026-04-03T06:17:24.5196231",
  "createdByUser": "sample string 9",
  "updated": "2026-04-03T06:17:24.5196231",
  "updatedByUser": "sample string 11",
  "deleted": true,
  "supplierName": "sample string 13",
  "storeNames": "sample string 14",
  "storeIDs": [
    1,
    2
  ],
  "masterPLUG_UID": "Fu+h0Cf2a0CqohUl2h65cg==",
  "masterPluGuid": "d0a1ef16-f627-406b-aaa2-1525da1eb972",
  "dealCosts": [
    {
      "$id": "2",
      "headerIdentifier": "0oM5LSV3m0ihCLMEULZynA==",
      "headerIdentifierGuid": "2d3983d2-7725-489b-a108-b30450b6729c",
      "identifier": "mGoV8tFyB0WoqOMHJxPpdw==",
      "identifierGuid": "f2156a98-72d1-4507-a8a8-e3072713e977",
      "supplierIdentifier": "vQ6gj1VK7kSSypK89Efr6g==",
      "supplierGuid": "8fa00ebd-4a55-44ee-92ca-92bcf447ebea",
      "pluG_UID": "buxCFYhrxEKCc9t++ndRAA==",
      "pluGuid": "1542ec6e-6b88-42c4-8273-db7efa775100",
      "campaignName": "0dd8bdfc-35d4-4d63-9471-c2eee2e801be",
      "description": "sample string 4",
      "cost": 5,
      "costDecimals": 6,
      "start": "2026-04-03T06:17:24.5196231",
      "end": "2026-04-03T06:17:24.5196231",
      "type": 9,
      "promoType": 10,
      "bonusItemPLUG_UID": "z+NMJn9jM0Ojb32Ai7xOzg==",
      "bonusItemPluGuid": "264ce3cf-637f-4333-a36f-7d808bbc4ece",
      "bonusPurchaseUnits": 11,
      "bonusReceiveUnits": 12,
      "updated": "2026-04-03T06:17:24.5196231",
      "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-04-03T06:17:24.5196231",
      "campaignEndDate": "2026-04-03T06:17:24.5196231",
      "masterPLUG_UID": "b2Li0A9b70eIEu+DIXGl8w==",
      "masterID": "d0e2626f-5b0f-47ef-8812-ef832171a5f3",
      "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": "hyLcJ1OTHkyu+uz6Cy6IAQ==",
      "bonusMasterID": "27dc2287-9353-4c1e-aefa-ecfa0b2e8801",
      "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
    },
    {
      "$ref": "2"
    }
  ]
}

application/xml, text/xml

Sample: 
<DealCostHeader xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://gapsolutions.com.au/schema/ezimanager">
  <Created>2026-04-03T06:17:24.5196231+00:00</Created>
  <CreatedByUser>sample string 9</CreatedByUser>
  <DealCosts>
    <DealCost>
      <Active>true</Active>
      <BonusActive>true</BonusActive>
      <BonusCartonQuantity>40</BonusCartonQuantity>
      <BonusFuelItem>true</BonusFuelItem>
      <BonusItemPLUG_UID>z+NMJn9jM0Ojb32Ai7xOzg==</BonusItemPLUG_UID>
      <BonusItemPluGuid>264ce3cf-637f-4333-a36f-7d808bbc4ece</BonusItemPluGuid>
      <BonusMasterID>27dc2287-9353-4c1e-aefa-ecfa0b2e8801</BonusMasterID>
      <BonusMasterPLUG_UID>hyLcJ1OTHkyu+uz6Cy6IAQ==</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-04-03T06:17:24.5196231+00:00</CampaignEndDate>
      <CampaignMetcashPromotionID>sample string 19</CampaignMetcashPromotionID>
      <CampaignName>0dd8bdfc-35d4-4d63-9471-c2eee2e801be</CampaignName>
      <CampaignStartDate>2026-04-03T06:17:24.5196231+00:00</CampaignStartDate>
      <CartonQuantity>28</CartonQuantity>
      <Cost>5</Cost>
      <CostDecimals>6</CostDecimals>
      <Description>sample string 4</Description>
      <End>2026-04-03T06:17:24.5196231+00:00</End>
      <FromHost>15</FromHost>
      <FuelItem>true</FuelItem>
      <HeaderIdentifier>0oM5LSV3m0ihCLMEULZynA==</HeaderIdentifier>
      <HeaderIdentifierGuid>2d3983d2-7725-489b-a108-b30450b6729c</HeaderIdentifierGuid>
      <Identifier>mGoV8tFyB0WoqOMHJxPpdw==</Identifier>
      <IdentifierGuid>f2156a98-72d1-4507-a8a8-e3072713e977</IdentifierGuid>
      <MasterID>d0e2626f-5b0f-47ef-8812-ef832171a5f3</MasterID>
      <MasterPLUG_UID>b2Li0A9b70eIEu+DIXGl8w==</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>buxCFYhrxEKCc9t++ndRAA==</PLUG_UID>
      <PluGuid>1542ec6e-6b88-42c4-8273-db7efa775100</PluGuid>
      <ProductAPN>sample string 23</ProductAPN>
      <ProductName>sample string 22</ProductName>
      <PromoType>10</PromoType>
      <SalesMode>29</SalesMode>
      <Start>2026-04-03T06:17:24.5196231+00:00</Start>
      <StoreIDs xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>1</d4p1:int>
        <d4p1:int>2</d4p1:int>
      </StoreIDs>
      <StoreNames>sample string 16</StoreNames>
      <SupplierGuid>8fa00ebd-4a55-44ee-92ca-92bcf447ebea</SupplierGuid>
      <SupplierIdentifier>vQ6gj1VK7kSSypK89Efr6g==</SupplierIdentifier>
      <SupplierName>sample string 17</SupplierName>
      <Type>9</Type>
      <Updated>2026-04-03T06:17:24.5196231+00:00</Updated>
    </DealCost>
    <DealCost>
      <Active>true</Active>
      <BonusActive>true</BonusActive>
      <BonusCartonQuantity>40</BonusCartonQuantity>
      <BonusFuelItem>true</BonusFuelItem>
      <BonusItemPLUG_UID>z+NMJn9jM0Ojb32Ai7xOzg==</BonusItemPLUG_UID>
      <BonusItemPluGuid>264ce3cf-637f-4333-a36f-7d808bbc4ece</BonusItemPluGuid>
      <BonusMasterID>27dc2287-9353-4c1e-aefa-ecfa0b2e8801</BonusMasterID>
      <BonusMasterPLUG_UID>hyLcJ1OTHkyu+uz6Cy6IAQ==</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-04-03T06:17:24.5196231+00:00</CampaignEndDate>
      <CampaignMetcashPromotionID>sample string 19</CampaignMetcashPromotionID>
      <CampaignName>0dd8bdfc-35d4-4d63-9471-c2eee2e801be</CampaignName>
      <CampaignStartDate>2026-04-03T06:17:24.5196231+00:00</CampaignStartDate>
      <CartonQuantity>28</CartonQuantity>
      <Cost>5</Cost>
      <CostDecimals>6</CostDecimals>
      <Description>sample string 4</Description>
      <End>2026-04-03T06:17:24.5196231+00:00</End>
      <FromHost>15</FromHost>
      <FuelItem>true</FuelItem>
      <HeaderIdentifier>0oM5LSV3m0ihCLMEULZynA==</HeaderIdentifier>
      <HeaderIdentifierGuid>2d3983d2-7725-489b-a108-b30450b6729c</HeaderIdentifierGuid>
      <Identifier>mGoV8tFyB0WoqOMHJxPpdw==</Identifier>
      <IdentifierGuid>f2156a98-72d1-4507-a8a8-e3072713e977</IdentifierGuid>
      <MasterID>d0e2626f-5b0f-47ef-8812-ef832171a5f3</MasterID>
      <MasterPLUG_UID>b2Li0A9b70eIEu+DIXGl8w==</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>buxCFYhrxEKCc9t++ndRAA==</PLUG_UID>
      <PluGuid>1542ec6e-6b88-42c4-8273-db7efa775100</PluGuid>
      <ProductAPN>sample string 23</ProductAPN>
      <ProductName>sample string 22</ProductName>
      <PromoType>10</PromoType>
      <SalesMode>29</SalesMode>
      <Start>2026-04-03T06:17:24.5196231+00:00</Start>
      <StoreIDs xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:int>1</d4p1:int>
        <d4p1:int>2</d4p1:int>
      </StoreIDs>
      <StoreNames>sample string 16</StoreNames>
      <SupplierGuid>8fa00ebd-4a55-44ee-92ca-92bcf447ebea</SupplierGuid>
      <SupplierIdentifier>vQ6gj1VK7kSSypK89Efr6g==</SupplierIdentifier>
      <SupplierName>sample string 17</SupplierName>
      <Type>9</Type>
      <Updated>2026-04-03T06:17:24.5196231+00:00</Updated>
    </DealCost>
  </DealCosts>
  <Deleted>true</Deleted>
  <Description>sample string 2</Description>
  <End>2026-04-03T06:17:24.5196231+00:00</End>
  <FromHost>7</FromHost>
  <HeaderIdentifier>j5c5cb89hEu4IDeGOi3HfQ==</HeaderIdentifier>
  <HeaderIdentifierGuid>7139978f-3dbf-4b84-b820-37863a2dc77d</HeaderIdentifierGuid>
  <MasterPLUG_UID>Fu+h0Cf2a0CqohUl2h65cg==</MasterPLUG_UID>
  <MasterPluGuid>d0a1ef16-f627-406b-aaa2-1525da1eb972</MasterPluGuid>
  <PromoType>6</PromoType>
  <Start>2026-04-03T06:17:24.5196231+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 14</StoreNames>
  <SupplierGuid>d0a200e6-c515-4f31-ba01-b1d9c71a42ec</SupplierGuid>
  <SupplierIdentifier>5gCi0BXFMU+6AbHZxxpC7A==</SupplierIdentifier>
  <SupplierName>sample string 13</SupplierName>
  <Type>5</Type>
  <Updated>2026-04-03T06:17:24.5196231+00:00</Updated>
  <UpdatedByUser>sample string 11</UpdatedByUser>
</DealCostHeader>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Deal cost header identifier

globally unique identifier

Response Formats

application/json, text/json

Sample: 
"5640aae6-2c9d-47ac-b8ef-f17a3b866abc"

application/xml, text/xml

Sample: 
<guid xmlns="http://schemas.microsoft.com/2003/10/Serialization/">5640aae6-2c9d-47ac-b8ef-f17a3b866abc</guid>

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Sample: 
PK,2�\_#��5xl/workbook.xml �(�����0��&�C���%�p��Ճ�R�������Ƿ�@������C'���}�hB�k,ct!�K�,��v�z�b��E��Ck�[���|<^���EeM�����a��AD=.(͔��~���=L!�d�ug�%D~S4ö���ajܲ�0�ν��	#_�4<J �㗒��(oxco0J���PK,2�\����	�[Content_Types].xml �(����J�0�_��*M�D��V�*��d�
�d�k��<�H���V���=
��|�o��|����������+�����7l���e۶~=E�"�zlXO�@Ճ��C�3]HNR~���R��uU�<���������a��36��b7םQ
�1Z�$�8z�R��3
tP��-c�� g����_M��Of���~O�s�T���� ����P<�D��e=1Z��a2�b
��%#H'�2}���e�B)��~j/F�t��PK
,2�\��>�''_rels/.rels �(�<?xml version="1.0" encoding="utf-8"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml" Id="R33891d720ff1418b" /></Relationships>PK,2�\PU,%�xl/worksheets/sheet1.xml �(��Q�N�0���w�v�cLm'�i���кK�&����瓤!q�Ė��{v��MlF���MMK�2�&�����T٫����q[��~<p�Z�Z�
�hB�'����p�{���I��|�e;nq>H9�F+���hQtɂV*-����T`��ž��o��|W��_1�c|]c��Ր%,�>'�W�:��4�7Z�Q]�*SOK�K7�*�
���.���as_>�<ϊ2/w���y�kyu�W��y^4����T�1���4��0��d�co8���aKh�DmR����PK,2�\�@�Pxl/_rels/workbook.xml.rels �(���KN�0@�b͞8N�Ơ�ݰa[z��Q;�]�gc���V� �X��j4��'�|�lvo�H^0��;	�(��Ӿ\/�̝��v��Q�<�0G�W\�`S�(���b�gt�c|�T�i���Q�H��\Ӱd�5��3���4>z}�Х?��Շc��	�A����R����L��I��h�յІs��7S��<b���Η2+�Ž0m�o��Me�
�=��/�tZ�j�Ѽ^a�V
�d5z��/PK,2�\Ѓc'2E
xl/styles.xml �(��S�j�0��&0���0�^�]v��:��d;��H��Kj�vG�Mz�zOHr�iB8v�F��WEG�?s�Oh�lff�uZМ���ށh�R���6�'��2��������ɳ�UŦ`<Қo���x���8��K�6BC ^�کĖ��B���n��f8����9� ����CUk��#��U�ub��WUB;��k���&�
AR>��� ��im��ΑF���YO��%�}���LJ\in�,���9oy}��y.�$��6��ųNJ�c��T��rĘ)փBR淶�E3ʟ�\��q��PK,2�\�B�7��xl/sharedStrings.xml �(�5�An�0E�b��8Pjr��'h0q&�R<N3*��]�|���}w�K�z�*1s�]�8�!򽃟�/݂��<��:x���z'RT��t0��\��0QB�典&c^����Ȳ2�4�C�X�02��7.Uj������U�+��D��΃>�0辥Q��~���g�w�o�+�PK-,2�\_#��5xl/workbook.xmlPK-,2�\����	��[Content_Types].xmlPK-
,2�\��>�''U_rels/.relsPK-,2�\PU,%��xl/worksheets/sheet1.xmlPK-,2�\�@�P8xl/_rels/workbook.xml.relsPK-,2�\Ѓc'2E
}xl/styles.xmlPK-,2�\�B�7���xl/sharedStrings.xmlPK��

application/vnd.ms-excel

Sample: 
PK,2�\��&�5xl/workbook.xml �(�����0��J}�(�P�O����k��&�&�$(IE�R�n���󕳱Ck�@>jԮ��Oc�T�.fBv��
|���L�K���o�ڳ8�2fq/�vBN�n�Xn���^�J�Դ>�)�fO��[e0���I�b��r��"V���ν��[�0<�[��u��q�p�Ѓ}�J����PK,2�\����	�[Content_Types].xml �(����J�0�_��*M�D��V�*��d�
�d�k��<�H���V���=
��|�o��|����������+�����7l���e۶~=E�"�zlXO�@Ճ��C�3]HNR~���R��uU�<���������a��36��b7םQ
�1Z�$�8z�R��3
tP��-c�� g����_M��Of���~O�s�T���� ����P<�D��e=1Z��a2�b
��%#H'�2}���e�B)��~j/F�t��PK
,2�\ه�~''_rels/.rels �(�<?xml version="1.0" encoding="utf-8"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml" Id="Rfc4f595f8a1b473b" /></Relationships>PK,2�\PU,%�xl/worksheets/sheet1.xml �(��Q�N�0���w�v�cLm'�i���кK�&����瓤!q�Ė��{v��MlF���MMK�2�&�����T٫����q[��~<p�Z�Z�
�hB�'����p�{���I��|�e;nq>H9�F+���hQtɂV*-����T`��ž��o��|W��_1�c|]c��Ր%,�>'�W�:��4�7Z�Q]�*SOK�K7�*�
���.���as_>�<ϊ2/w���y�kyu�W��y^4����T�1���4��0��d�co8���aKh�DmR����PK,2�\�$�}�Pxl/_rels/workbook.xml.rels �(���Kn�0@�b;��8$A6ݰ�\�v&�ؖmJ9[=R�P�Jm����h~OO��|����扼���
�	�Z�v�}��=U��n8�'�0ZO��
!�5�^
8��:v:�fb�zj�:�i�؊�%��x����Q�Q�u�L/Ɲ�����14�S���$R���e%W�(���Jq �aj>\'�^��B&+�<g�qVf���2�pؾ/�tZ�jӢ���E^s������PK,2�\Ѓc'2E
xl/styles.xml �(��S�j�0��&0���0�^�]v��:��d;��H��Kj�vG�Mz�zOHr�iB8v�F��WEG�?s�Oh�lff�uZМ���ށh�R���6�'��2��������ɳ�UŦ`<Қo���x���8��K�6BC ^�کĖ��B���n��f8����9� ����CUk��#��U�ub��WUB;��k���&�
AR>��� ��im��ΑF���YO��%�}���LJ\in�,���9oy}��y.�$��6��ųNJ�c��T��rĘ)փBR淶�E3ʟ�\��q��PK,2�\�B�7��xl/sharedStrings.xml �(�5�An�0E�b��8Pjr��'h0q&�R<N3*��]�|���}w�K�z�*1s�]�8�!򽃟�/݂��<��:x���z'RT��t0��\��0QB�典&c^����Ȳ2�4�C�X�02��7.Uj������U�+��D��΃>�0辥Q��~���g�w�o�+�PK-,2�\��&�5xl/workbook.xmlPK-,2�\����	��[Content_Types].xmlPK-
,2�\ه�~''U_rels/.relsPK-,2�\PU,%��xl/worksheets/sheet1.xmlPK-,2�\�$�}�P8xl/_rels/workbook.xml.relsPK-,2�\Ѓc'2E
xl/styles.xmlPK-,2�\�B�7���xl/sharedStrings.xmlPK��