Add product Inventory items

Add product Inventory items

Purpose

To add new Product inventory items/location to your organization.

Request URL

https://live.membroz.com/api/inventoryitems

Request Method

POST
Note
  • Send authkey in https header
  • You can add only one product inventory items per POST request.
  • You must use only Field API names in the input. You can obtain the field API names from Fields metadata API
  • Enterprise customer can replace domain name with their hosting Url. for example https://app.xyz.com/api/inventoryitems
  • API will return inserted product inventory items data in JSON format or error message.

Request JSON

Attribute Data Type Mandatory Description
inventoryitemsname text yes inventoryitems/location/company name
currency text
country text
timezone text
city text
companyphone text
contactperson text

Sample Request

curl --location --request POST 'https://live.membroz.com/api/inventoryitems' \
--header 'authkey: XXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '   {
       
        "purchase": {
            "taxes": []
        },
        "sale": {
            "taxes": [],
            "rate": 60
        },
        "type": "service",
        "status": "active",
        "itemname": "One on One Consulting on yoga",
        "offertype": "5f5b8aa0e1012425ecacbad6",
        "unit": "pcs",
        "branchid": "5e954c7b9df11624f81e7859",
        "enableinventory": false,
        "property": {
            "serviceid": "5f5b8aa0e1012425ecacbad4"
        },
        "createdAt": "2020-09-11T14:33:04.566Z",
        "updatedAt": "2020-09-11T14:33:04.566Z",
        "updatedby": "5e954c7b9df11624f81e785b",
        "addedby": "5e954c7b9df11624f81e785b"
    }'
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "   {\r\n       \r\n        \"purchase\": {\r\n            \"taxes\": []\r\n        },\r\n        \"sale\": {\r\n            \"taxes\": [],\r\n            \"rate\": 60\r\n        },\r\n        \"type\": \"service\",\r\n        \"status\": \"active\",\r\n        \"itemname\": \"One on One Consulting on yoga\",\r\n        \"offertype\": \"5f5b8aa0e1012425ecacbad6\",\r\n        \"unit\": \"pcs\",\r\n        \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n        \"enableinventory\": false,\r\n        \"property\": {\r\n            \"serviceid\": \"5f5b8aa0e1012425ecacbad4\"\r\n        },\r\n        \"createdAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedby\": \"5e954c7b9df11624f81e785b\",\r\n        \"addedby\": \"5e954c7b9df11624f81e785b\"\r\n    }");
Request request = new Request.Builder()
  .url("https://live.membroz.com/api/inventoryitems")
  .method("POST", body)
  .addHeader("authkey", "XXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();
 "https://live.membroz.com/api/inventoryitems",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"   {\r\n       \r\n        \"purchase\": {\r\n            \"taxes\": []\r\n        },\r\n        \"sale\": {\r\n            \"taxes\": [],\r\n            \"rate\": 60\r\n        },\r\n        \"type\": \"service\",\r\n        \"status\": \"active\",\r\n        \"itemname\": \"One on One Consulting on yoga\",\r\n        \"offertype\": \"5f5b8aa0e1012425ecacbad6\",\r\n        \"unit\": \"pcs\",\r\n        \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n        \"enableinventory\": false,\r\n        \"property\": {\r\n            \"serviceid\": \"5f5b8aa0e1012425ecacbad4\"\r\n        },\r\n        \"createdAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedby\": \"5e954c7b9df11624f81e785b\",\r\n        \"addedby\": \"5e954c7b9df11624f81e785b\"\r\n    }",
  CURLOPT_HTTPHEADER => array(
    "authkey: XXXXXXXXXX",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "https://live.membroz.com/api/inventoryitems"

payload = "   {\r\n       \r\n        \"purchase\": {\r\n            \"taxes\": []\r\n        },\r\n        \"sale\": {\r\n            \"taxes\": [],\r\n            \"rate\": 60\r\n        },\r\n        \"type\": \"service\",\r\n        \"status\": \"active\",\r\n        \"itemname\": \"One on One Consulting on yoga\",\r\n        \"offertype\": \"5f5b8aa0e1012425ecacbad6\",\r\n        \"unit\": \"pcs\",\r\n        \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n        \"enableinventory\": false,\r\n        \"property\": {\r\n            \"serviceid\": \"5f5b8aa0e1012425ecacbad4\"\r\n        },\r\n        \"createdAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedby\": \"5e954c7b9df11624f81e785b\",\r\n        \"addedby\": \"5e954c7b9df11624f81e785b\"\r\n    }"
headers = {
  'authkey': 'XXXXXXXXXX',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
require "uri"
require "net/http"

url = URI("https://live.membroz.com/api/inventoryitems")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authkey"] = "XXXXXXXXXX"
request["Content-Type"] = "application/json"
request.body = "   {\r\n       \r\n        \"purchase\": {\r\n            \"taxes\": []\r\n        },\r\n        \"sale\": {\r\n            \"taxes\": [],\r\n            \"rate\": 60\r\n        },\r\n        \"type\": \"service\",\r\n        \"status\": \"active\",\r\n        \"itemname\": \"One on One Consulting on yoga\",\r\n        \"offertype\": \"5f5b8aa0e1012425ecacbad6\",\r\n        \"unit\": \"pcs\",\r\n        \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n        \"enableinventory\": false,\r\n        \"property\": {\r\n            \"serviceid\": \"5f5b8aa0e1012425ecacbad4\"\r\n        },\r\n        \"createdAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedby\": \"5e954c7b9df11624f81e785b\",\r\n        \"addedby\": \"5e954c7b9df11624f81e785b\"\r\n    }"

response = https.request(request)
puts response.read_body
var client = new RestClient("https://live.membroz.com/api/inventoryitems");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("authkey", "XXXXXXXXXX");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "   {\r\n       \r\n        \"purchase\": {\r\n            \"taxes\": []\r\n        },\r\n        \"sale\": {\r\n            \"taxes\": [],\r\n            \"rate\": 60\r\n        },\r\n        \"type\": \"service\",\r\n        \"status\": \"active\",\r\n        \"itemname\": \"One on One Consulting on yoga\",\r\n        \"offertype\": \"5f5b8aa0e1012425ecacbad6\",\r\n        \"unit\": \"pcs\",\r\n        \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n        \"enableinventory\": false,\r\n        \"property\": {\r\n            \"serviceid\": \"5f5b8aa0e1012425ecacbad4\"\r\n        },\r\n        \"createdAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedAt\": \"2020-09-11T14:33:04.566Z\",\r\n        \"updatedby\": \"5e954c7b9df11624f81e785b\",\r\n        \"addedby\": \"5e954c7b9df11624f81e785b\"\r\n    }",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Possible Errors

HTTP Status Error Code Message Reason
permission denied 403 You do not have permission

Sample Response

{
    "purchase": {
        "taxes": []
    },
    "sale": {
        "taxes": [],
        "rate": 60
    },
    "type": "service",
    "status": "active",
    "_id": "5f6d88e4c97e67698f6687f6",
    "itemname": "One on One Consulting on yoga",
    "offertype": "5f5b8aa0e1012425ecacbad6",
    "unit": "pcs",
    "branchid": "5e954c7b9df11624f81e7859",
    "enableinventory": false,
    "property": {
        "serviceid": "5f5b8aa0e1012425ecacbad4"
    },
    "createdAt": "2020-09-25T06:06:28.706Z",
    "updatedAt": "2020-09-25T06:06:28.706Z",
    "updatedby": "5e954c7b9df11624f81e785b",
    "addedby": "5e954c7b9df11624f81e785b"
}