Description

Used for multiple stock operations with one call

Request Parameters

#	Name	Type	Required	Example	Description
1	XML	string	0	Sample text	The same as ParameterXML
2	ParameterXML	string	0	Check Additional information	XML with stock operation values
3	Username	string	0	API user	User that executed the stock operation

Request body

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dem="https://api.pixi.eu/soap/demosandbox/">
   <soapenv:Header/>
   <soapenv:Body>
      <dem:pixiSetStockMultiple>
         <dem:XML>Sample text</dem:XML>
         <dem:ParameterXML>Check Additional information</dem:ParameterXML>
         <dem:Username>API user</dem:Username>
      </dem:pixiSetStockMultiple>
   </soapenv:Body>
</soapenv:Envelope>

Response

Body 1: Result set with row specific errors.

#	Name	Type	Description
1	ITEMNRINT	string	Shop item number.
2	ITEMKEY	integer	pixi* item ID
3	EAN	string	Item barcode.
4	BINNAME	string	Bin name.
5	STOCK	integer	XML input value for this item/bin
6	STOCKADD	integer	XML input value for this item/bin
7	STOCKREMOVE	integer	XML input value for this item/bin
8	Error	string	Description of the error status.
9	Reason	string	Always empty string
10	SMOREF	integer	Stock movement operation ID
11	SMTREF	integer	Stock movement type ID
12	status	integer	Execution status (1-OK/0-ERROR), on error (0) read message in Error field, on success (1) read message in SuccessMessage field
13	BATCHNUMBER	string	Item batch number
14	BESTBEFOREDATE	datetime	Item best before date
14	SuccessMessage	string	Description of the success status

Body 2: Status output

#	Name	Type	Description
1	Status	string	Execution status (OK/ERROR)
2	StatusMessage	string	Description of the status

Additional Notes

Complete **XML structure** with default values

    <ITEMSTOCK>
    	<ITEM>
    		<EANUPC></EANUPC>
    		<ITEMNRINT></ITEMNRINT>
    		<ITEMKEY></ITEMKEY>
    		<OVERWRITESTOCK></OVERWRITESTOCK>
    		<INVBINS>
    			<INVBIN>
    				<BINNAME></BINNAME>
    				<STOCK></STOCK> <!-- This tag should not be used! -->
    				<STOCKADD></STOCKADD>
    				<STOCKREMOVE></STOCKREMOVE>
    				<NEUTRALINVENTORY></NEUTRALINVENTORY>
    				<SMTREF>4/2</SMTREF> 
    				<SMOREF>2/1 (TakeOut/PutToStock)</SMOREF>
    				<BATCHNUMBER></BATCHNUMBER>
    				<BESTBEFOREDATE></BESTBEFOREDATE>
    			</INVBIN>
    		</INVBINS>
    	</ITEM>
    </ITEMSTOCK>


----------

XML tags used for **identifying the item**:

 - **EANUPC** -- Item barcode (Only EANUPC from ITEMS (current supplier) can be used. The recommendation is to use some other item code/itemkey that is unique for the item.)
 - **ITEMNRINT** -- Shop item number 
 - **ITEMKEY** -- pixi* item ID
 - **BATCHNUMBER** -- Item batch number (mandatory when the item has tag "BN")
 - **BESTBEFOREDATE** -- Item best before date (mandatory when the item has tag "BBD")

XML tags for performing the **stock operations**:

 - **BINNAME** - Bin name
 - **STOCKADD** - Add the stock for selected item on selected bin
 - **STOCKREMOVE** - Remove the stock for selected item on selected bin
 - **SMTREF** - Stock movement type ID
 - **SMOREF** - Stock movement operation ID

XML tags to be used with **extreme caution**:

 - **OVERWRITESTOCK** - Stock for selected item will be removed from all bins (0/1)
 - **NEUTRALINVENTORY** - deprecated from pixi* ELI on
 - ! **STOCK** ! - Set stock for selected item on selected bin to this exact number
	 - *Important*: As this tag might cause issues, we do not recommend using it at all! Instead, use STOCKADD or STOCKREMOVE.


*Important*: If same Bin name exists on two or more locations, do not use this API, since it will produce strange results with such Bins.


----------
**Samples**

**Put to stock:** quantity 5 for item (EAN:3184340092516) to bin "300"

    <ITEMSTOCK>
    	<ITEM>
    		<EANUPC>3184340092516</EANUPC>		
    		<INVBINS>
    			<INVBIN>				
    				<BINNAME>300</BINNAME>				
    				<STOCKADD>5</STOCKADD>				
    			</INVBIN>
    		</INVBINS>
    	</ITEM>
    </ITEMSTOCK>

**Take from stock:** quantity 2 for item (ITEMNRINT:2000040700005) from bin:"E-2-3" and quantity 3 from bin: "C-2-5"

        <ITEMSTOCK>
    	<ITEM>
    		<ITEMNRINT>2000040700005</ITEMNRINT>		
    		<INVBINS>
    			<INVBIN>				
    				<BINNAME>E-2-3</BINNAME>				
    				<STOCKREMOVE>2</STOCKREMOVE>				
    			</INVBIN>
    			<INVBIN>				
    				<BINNAME>C-2-5</BINNAME>				
    				<STOCKREMOVE>3</STOCKREMOVE>				
    			</INVBIN>
    		</INVBINS>
    	</ITEM>
    </ITEMSTOCK>
**Relocate:** quantity 2 for item (ITEMKEY:364) with batch number:"BATCH 001" from bin: "E-1-2" to bin:"C-2-5"

    <ITEMSTOCK>
    	<ITEM>
    		<ITEMKEY>364</ITEMKEY>		
    		<INVBINS>
    			<INVBIN>				
    				<BINNAME>E-1-2</BINNAME>				
    				<STOCKREMOVE>2</STOCKREMOVE>
    				<BATCHNUMBER>BATCH 001</BATCHNUMBER>				
    			</INVBIN>
    			<INVBIN>				
    				<BINNAME>C-2-5</BINNAME>				
    				<STOCKADD>2</STOCKADD>
    				<BATCHNUMBER>BATCH 001</BATCHNUMBER>				
    			</INVBIN>
    		</INVBINS>
    	</ITEM>
    </ITEMSTOCK>