{"_id":"5632a5e749e16d0d0012245b","version":{"_id":"5632a5e549e16d0d00122443","__v":6,"project":"55b933b3146ef121002158d3","createdAt":"2015-10-29T23:04:05.701Z","releaseDate":"2015-10-29T23:04:05.701Z","categories":["5632a5e749e16d0d00122444","5632a5e749e16d0d00122445","5632a5e749e16d0d00122446","5632a5e749e16d0d00122447","5632a5e749e16d0d00122448","5632a5e749e16d0d00122449","5632a5e749e16d0d0012244a","5632a5e749e16d0d0012244b","5632a5e749e16d0d0012244c","5632a5e749e16d0d0012244d","5632a5e749e16d0d0012244e","5632a5e749e16d0d0012244f","5632a5e749e16d0d00122450","5632b179df556c0d00cd095b","564e13053b2b4a19000cd69b","59caa9df65accc001a489c95","59cab50965accc001a489d28","59cadd464ab7b70024378e74"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"__v":0,"githubsync":"","project":"55b933b3146ef121002158d3","category":{"_id":"5632a5e749e16d0d0012244a","version":"5632a5e549e16d0d00122443","__v":1,"pages":["5632a5e749e16d0d00122451","5632a5e749e16d0d00122452","5632a5e749e16d0d00122453","5632a5e749e16d0d00122454","5632a5e749e16d0d00122455","5632a5e749e16d0d00122456","5632a5e749e16d0d00122457","5632a5e749e16d0d00122458","5632a5e749e16d0d00122459","5632a5e749e16d0d0012245a","5632a5e749e16d0d0012245b","5632a5e749e16d0d0012245c","5632a5e749e16d0d0012245d","5632a5e749e16d0d0012245e","5632a5e749e16d0d0012245f"],"project":"55b933b3146ef121002158d3","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-04T17:33:11.503Z","from_sync":false,"order":9,"slug":"products","title":"Products"},"user":"55b932ba8fd1a02b00f496c8","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-04T17:41:38.899Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":10,"body":"Retrieve all current inventory for a single product\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Description\"\n}\n[/block]\nThis method retrieves an array of [ProductInventory](/docs/productinventory) objects for the product specified by ProductRefNum. The ProductRefNum is the gateway assigned unique product identifier that was returned by addProduct. searchProducts can be used to find the ProductRefNum for a product if it is not known.\nEach element in the returned array represents the QtyOnHand and QtyOnOrder for each inventory location. For example, if you have inventory in three warehouses, an array with three elements will be returned.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Syntax\"\n}\n[/block]\n[ProductInventory](ProductInventory **getProductInvetory** ( [ueSecurityToken](/docs/uesecuritytoken) Token,string ProductRefNum)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Arguments\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"[ueSecurityToken](/docs/uesecuritytoken)\",\n    \"0-1\": \"Token\",\n    \"0-2\": \"Merchant security token: used to identify merchant and retrieve the custom fields.\",\n    \"1-0\": \"string\",\n    \"1-1\": \"ProductRefNum\",\n    \"1-2\": \"Gateway assigned product ID used to pull product details\"\n  },\n  \"cols\": 3,\n  \"rows\": 2\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Return Value\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"[ProductInventory](/docs/productinventory)\",\n    \"0-1\": \"Returns an array of ProductInventory objects.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Exceptions\"\n}\n[/block]\nThe following exceptions (errors) are applicable to this method.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Message\",\n    \"h-2\": \"Advice\",\n    \"0-0\": \"41002\",\n    \"0-1\": \"Product Not Found\",\n    \"0-2\": \"Product specified by ProductRefNum was not found. Make sure the number stored is not truncated or rounded.\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Examples\"\n}\n[/block]\n## PHP \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?php\\ntry {\\n $ProductRefNum = '912093987473';        \\n $inventory = $client->getProductInventory($token, $ProductRefNum);\\n print_r($inventory);\\n}\\ncatch(SoapFault $e) {\\n echo $e->getMessage();\\n}\\n?>\",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]\n## XML \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Request:\\n<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<SOAP-ENV:Envelope\\n xmlns:SOAP-ENV=\\\"http://schemas.xmlsoap.org/soap/envelope/\\\"\\n xmlns:ns1=\\\"urn:eBizCharge\\\"\\n xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\"\\n xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\"\\n xmlns:SOAP-ENC=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\"\\n SOAP-ENV:encodingStyle=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\">\\n<SOAP-ENV:Body>\\n<ns1:getProductInventory>\\n <Token xsi:type=\\\"ns1:ueSecurityToken\\\">\\n   <ClientIP xsi:type=\\\"xsd:string\\\">192.168.0.1</ClientIP>\\n   <PinHash xsi:type=\\\"ns1:ueHash\\\">\\n     <HashValue xsi:type=\\\"xsd:string\\\">fa10e601d0c6be6c79fce2fdb89f51c65148f8bf</HashValue>\\n     <Seed xsi:type=\\\"xsd:string\\\">12693612492090882854</Seed>\\n     <Type xsi:type=\\\"xsd:string\\\">sha1</Type>\\n   </PinHash>\\n   <SourceKey xsi:type=\\\"xsd:string\\\">1B93L5cpXV5hbx557d183q96EZ2jpqEf</SourceKey>\\n </Token>\\n <ProductRefNum xsi:type=\\\"xsd:string\\\">9011780645</ProductRefNum>\\n</ns1:getProductInventory>\\n</SOAP-ENV:Body>\\n</SOAP-ENV:Envelope>\\nResponse:\\n<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<SOAP-ENV:Envelope\\n xmlns:SOAP-ENV=\\\"http://schemas.xmlsoap.org/soap/envelope/\\\"\\n xmlns:ns1=\\\"urn:eBizCharge\\\"\\n xmlns:SOAP-ENC=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\"\\n xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\"\\n xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\"\\n SOAP-ENV:encodingStyle=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\">\\n<SOAP-ENV:Body>\\n<ns1:getProductInventoryResponse>\\n <getProductInventoryReturn SOAP-ENC:arrayType=\\\"ns1:ProductInventory[1]\\\" xsi:type=\\\"ns1:ProductInventoryArray\\\">\\n <item xsi:type=\\\"ns1:ProductInventory\\\">\\n   <InventoryLocation xsi:type=\\\"xsd:string\\\">Los Angeles</InventoryLocation>\\n   <QtyOnHand xsi:type=\\\"xsd:string\\\">5</QtyOnHand>\\n   <QtyOnOrder xsi:type=\\\"xsd:string\\\">25</QtyOnOrder>\\n   <DateAvailable xsi:type=\\\"xsd:string\\\">2009-10-10</DateAvailable>\\n </item>\\n </getProductInventoryReturn>\\n</ns1:getProductInventoryResponse>\\n</SOAP-ENV:Body>\\n</SOAP-ENV:Envelope>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"getproductinventory","type":"basic","title":"getProductInventory"}

getProductInventory


Retrieve all current inventory for a single product [block:api-header] { "type": "basic", "title": "Description" } [/block] This method retrieves an array of [ProductInventory](/docs/productinventory) objects for the product specified by ProductRefNum. The ProductRefNum is the gateway assigned unique product identifier that was returned by addProduct. searchProducts can be used to find the ProductRefNum for a product if it is not known. Each element in the returned array represents the QtyOnHand and QtyOnOrder for each inventory location. For example, if you have inventory in three warehouses, an array with three elements will be returned. [block:api-header] { "type": "basic", "title": "Syntax" } [/block] [ProductInventory](ProductInventory **getProductInvetory** ( [ueSecurityToken](/docs/uesecuritytoken) Token,string ProductRefNum) [block:api-header] { "type": "basic", "title": "Arguments" } [/block] [block:parameters] { "data": { "h-0": "Type", "h-1": "Name", "h-2": "Description", "0-0": "[ueSecurityToken](/docs/uesecuritytoken)", "0-1": "Token", "0-2": "Merchant security token: used to identify merchant and retrieve the custom fields.", "1-0": "string", "1-1": "ProductRefNum", "1-2": "Gateway assigned product ID used to pull product details" }, "cols": 3, "rows": 2 } [/block] [block:api-header] { "type": "basic", "title": "Return Value" } [/block] [block:parameters] { "data": { "0-0": "[ProductInventory](/docs/productinventory)", "0-1": "Returns an array of ProductInventory objects." }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Exceptions" } [/block] The following exceptions (errors) are applicable to this method. [block:parameters] { "data": { "h-0": "Code", "h-1": "Message", "h-2": "Advice", "0-0": "41002", "0-1": "Product Not Found", "0-2": "Product specified by ProductRefNum was not found. Make sure the number stored is not truncated or rounded." }, "cols": 3, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] ## PHP [block:code] { "codes": [ { "code": "<?php\ntry {\n $ProductRefNum = '912093987473'; \n $inventory = $client->getProductInventory($token, $ProductRefNum);\n print_r($inventory);\n}\ncatch(SoapFault $e) {\n echo $e->getMessage();\n}\n?>", "language": "php" } ] } [/block] ## XML [block:code] { "codes": [ { "code": "Request:\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<SOAP-ENV:Envelope\n xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\"\n xmlns:ns1=\"urn:eBizCharge\"\n xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\"\n xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n xmlns:SOAP-ENC=\"http://schemas.xmlsoap.org/soap/encoding/\"\n SOAP-ENV:encodingStyle=\"http://schemas.xmlsoap.org/soap/encoding/\">\n<SOAP-ENV:Body>\n<ns1:getProductInventory>\n <Token xsi:type=\"ns1:ueSecurityToken\">\n <ClientIP xsi:type=\"xsd:string\">192.168.0.1</ClientIP>\n <PinHash xsi:type=\"ns1:ueHash\">\n <HashValue xsi:type=\"xsd:string\">fa10e601d0c6be6c79fce2fdb89f51c65148f8bf</HashValue>\n <Seed xsi:type=\"xsd:string\">12693612492090882854</Seed>\n <Type xsi:type=\"xsd:string\">sha1</Type>\n </PinHash>\n <SourceKey xsi:type=\"xsd:string\">1B93L5cpXV5hbx557d183q96EZ2jpqEf</SourceKey>\n </Token>\n <ProductRefNum xsi:type=\"xsd:string\">9011780645</ProductRefNum>\n</ns1:getProductInventory>\n</SOAP-ENV:Body>\n</SOAP-ENV:Envelope>\nResponse:\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<SOAP-ENV:Envelope\n xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\"\n xmlns:ns1=\"urn:eBizCharge\"\n xmlns:SOAP-ENC=\"http://schemas.xmlsoap.org/soap/encoding/\"\n xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\"\n xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n SOAP-ENV:encodingStyle=\"http://schemas.xmlsoap.org/soap/encoding/\">\n<SOAP-ENV:Body>\n<ns1:getProductInventoryResponse>\n <getProductInventoryReturn SOAP-ENC:arrayType=\"ns1:ProductInventory[1]\" xsi:type=\"ns1:ProductInventoryArray\">\n <item xsi:type=\"ns1:ProductInventory\">\n <InventoryLocation xsi:type=\"xsd:string\">Los Angeles</InventoryLocation>\n <QtyOnHand xsi:type=\"xsd:string\">5</QtyOnHand>\n <QtyOnOrder xsi:type=\"xsd:string\">25</QtyOnOrder>\n <DateAvailable xsi:type=\"xsd:string\">2009-10-10</DateAvailable>\n </item>\n </getProductInventoryReturn>\n</ns1:getProductInventoryResponse>\n</SOAP-ENV:Body>\n</SOAP-ENV:Envelope>", "language": "xml" } ] } [/block]