Add Purchase Order

Add Purchase Order

Purpose

To add new Purchase Order/location to your organization.

Request URL

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

Request Method

POST
Note
  • Send authkey in https header
  • You can add only one purchase order 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/purchaseorders
  • API will return inserted purchase order data in JSON format or error message.

Request JSON

Attribute Data Type Mandatory Description
purchaseordername text yes purchaseorder/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/purchaseorders' \
--header 'authkey: XXXXXXXXXX'\
--header 'Content-Type: application/json' \
--data-raw '  {
       
        "status": "active",
        "ponumber": 1,
        "prefix": "PO",
        "vendorid":  "5f648c0f48f800c5a50b28cd",
        "billingaddress": "Surat",
        "shippingaddress": "Surat",
        "orderdate": "2020-09-25T07:30:58.898Z",
        "shippingdate": "2020-09-25T18:30:00.000Z",
        "items": [
            {
                "_id": "5f6d9cc2e5e33a695b36e77b",
                "item": null,
                "quantity": 11,
                "cost": 70000,
                "totalcost": 700000,
                "tax": []
            }
        ],
        "branchid": "5f35059f248951a2181c3877",
        "createdAt": "2020-09-25T07:31:14.551Z",
        "updatedAt": "2020-09-25T07:31:14.551Z",
        "updatedby": "5f3a21d7f0dd1136c2ee7cad",
        "addedby": null
    }'
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "  {\r\n       \r\n        \"status\": \"active\",\r\n        \"ponumber\": 1,\r\n        \"prefix\": \"PO\",\r\n        \"vendorid\":  \"5f648c0f48f800c5a50b28cd\",\r\n        \"billingaddress\": \"Surat\",\r\n        \"shippingaddress\": \"Surat\",\r\n        \"orderdate\": \"2020-09-25T07:30:58.898Z\",\r\n        \"shippingdate\": \"2020-09-25T18:30:00.000Z\",\r\n        \"items\": [\r\n            {\r\n                \"_id\": \"5f6d9cc2e5e33a695b36e77b\",\r\n                \"item\": null,\r\n                \"quantity\": 11,\r\n                \"cost\": 70000,\r\n                \"totalcost\": 700000,\r\n                \"tax\": []\r\n            }\r\n        ],\r\n        \"branchid\": \"5f35059f248951a2181c3877\",\r\n        \"createdAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedby\": \"5f3a21d7f0dd1136c2ee7cad\",\r\n        \"addedby\": null\r\n    }");
Request request = new Request.Builder()
  .url("https://live.membroz.com/api/purchaseorders")
  .method("POST", body)
  .addHeader("authkey", "XXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();
 "https://live.membroz.com/api/purchaseorders",
  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        \"status\": \"active\",\r\n        \"ponumber\": 1,\r\n        \"prefix\": \"PO\",\r\n        \"vendorid\":  \"5f648c0f48f800c5a50b28cd\",\r\n        \"billingaddress\": \"Surat\",\r\n        \"shippingaddress\": \"Surat\",\r\n        \"orderdate\": \"2020-09-25T07:30:58.898Z\",\r\n        \"shippingdate\": \"2020-09-25T18:30:00.000Z\",\r\n        \"items\": [\r\n            {\r\n                \"_id\": \"5f6d9cc2e5e33a695b36e77b\",\r\n                \"item\": null,\r\n                \"quantity\": 11,\r\n                \"cost\": 70000,\r\n                \"totalcost\": 700000,\r\n                \"tax\": []\r\n            }\r\n        ],\r\n        \"branchid\": \"5f35059f248951a2181c3877\",\r\n        \"createdAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedby\": \"5f3a21d7f0dd1136c2ee7cad\",\r\n        \"addedby\": null\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/purchaseorders"

payload = "  {\r\n       \r\n        \"status\": \"active\",\r\n        \"ponumber\": 1,\r\n        \"prefix\": \"PO\",\r\n        \"vendorid\":  \"5f648c0f48f800c5a50b28cd\",\r\n        \"billingaddress\": \"Surat\",\r\n        \"shippingaddress\": \"Surat\",\r\n        \"orderdate\": \"2020-09-25T07:30:58.898Z\",\r\n        \"shippingdate\": \"2020-09-25T18:30:00.000Z\",\r\n        \"items\": [\r\n            {\r\n                \"_id\": \"5f6d9cc2e5e33a695b36e77b\",\r\n                \"item\": null,\r\n                \"quantity\": 11,\r\n                \"cost\": 70000,\r\n                \"totalcost\": 700000,\r\n                \"tax\": []\r\n            }\r\n        ],\r\n        \"branchid\": \"5f35059f248951a2181c3877\",\r\n        \"createdAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedby\": \"5f3a21d7f0dd1136c2ee7cad\",\r\n        \"addedby\": null\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/purchaseorders")

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        \"status\": \"active\",\r\n        \"ponumber\": 1,\r\n        \"prefix\": \"PO\",\r\n        \"vendorid\":  \"5f648c0f48f800c5a50b28cd\",\r\n        \"billingaddress\": \"Surat\",\r\n        \"shippingaddress\": \"Surat\",\r\n        \"orderdate\": \"2020-09-25T07:30:58.898Z\",\r\n        \"shippingdate\": \"2020-09-25T18:30:00.000Z\",\r\n        \"items\": [\r\n            {\r\n                \"_id\": \"5f6d9cc2e5e33a695b36e77b\",\r\n                \"item\": null,\r\n                \"quantity\": 11,\r\n                \"cost\": 70000,\r\n                \"totalcost\": 700000,\r\n                \"tax\": []\r\n            }\r\n        ],\r\n        \"branchid\": \"5f35059f248951a2181c3877\",\r\n        \"createdAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedby\": \"5f3a21d7f0dd1136c2ee7cad\",\r\n        \"addedby\": null\r\n    }"

response = https.request(request)
puts response.read_body

var client = new RestClient("https://live.membroz.com/api/purchaseorders");
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        \"status\": \"active\",\r\n        \"ponumber\": 1,\r\n        \"prefix\": \"PO\",\r\n        \"vendorid\":  \"5f648c0f48f800c5a50b28cd\",\r\n        \"billingaddress\": \"Surat\",\r\n        \"shippingaddress\": \"Surat\",\r\n        \"orderdate\": \"2020-09-25T07:30:58.898Z\",\r\n        \"shippingdate\": \"2020-09-25T18:30:00.000Z\",\r\n        \"items\": [\r\n            {\r\n                \"_id\": \"5f6d9cc2e5e33a695b36e77b\",\r\n                \"item\": null,\r\n                \"quantity\": 11,\r\n                \"cost\": 70000,\r\n                \"totalcost\": 700000,\r\n                \"tax\": []\r\n            }\r\n        ],\r\n        \"branchid\": \"5f35059f248951a2181c3877\",\r\n        \"createdAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedAt\": \"2020-09-25T07:31:14.551Z\",\r\n        \"updatedby\": \"5f3a21d7f0dd1136c2ee7cad\",\r\n        \"addedby\": null\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

{
    "status": "active",
    "_id": "5f7176e1377d85782f8b20ac",
    "ponumber": 1,
    "prefix": "gymme",
    "vendorid": "5f648c0f48f800c5a50b28cd",
    "billingaddress": "Surat",
    "shippingaddress": "Surat",
    "orderdate": "2020-09-25T07:30:58.898Z",
    "shippingdate": "2020-09-25T18:30:00.000Z",
    "items": [
        {
            "_id": "5f6d9cc2e5e33a695b36e77b",
            "item": null,
            "quantity": 11,
            "cost": 70000,
            "totalcost": 700000,
            "tax": []
        }
    ],
    "branchid": "5f35059f248951a2181c3877",
    "createdAt": "2020-09-28T05:38:41.691Z",
    "updatedAt": "2020-09-28T05:38:41.691Z",
    "updatedby": "5e954c7b9df11624f81e785b",
    "addedby": "5e954c7b9df11624f81e785b"
}