Get Specific Purchase Bill

Get Specific Purchase Bill

Purpose

To get the specific purchasebill of your organization.

Request URL

https://live.membroz.com/api/purchasebills/[purchasebillid]

Request Method

GET
Note
  • Send authkey in https header
  • Enterprise customer can replace domain name with their hosting Url. for example https://app.xyz.com/api/purchasebills
  • API return matching purchasebill data or return error message.

Request JSON

Attribute Data Type Mandatory Description
PURCHASEID String Yes The record ID of the purchase you want to update. it is pass in request
/api/purchasebills/[purchasebillid]

Sample Request

curl --location --request GET 'https://live.membroz.com/api/purchasebills/[purchasebillid]'\
--header 'authkey: XXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{ 
    "search": [
        { "searchfield": "status", "searchvalue": "Paid", "criteria": "eq", "datatype": "text" }
    ]
}
'
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://live.membroz.com/api/purchasebills/[purchasebillid]")
  .method("GET", null)
  .addHeader("authkey", "XXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();
 "https://live.membroz.com/api/purchasebills/[purchasebillid]",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS =>"{ \r\n    \"search\": [\r\n        { \"searchfield\": \"status\", \"searchvalue\": \"Paid\", \"criteria\": \"eq\", \"datatype\": \"text\" }\r\n    ]\r\n}\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/purchasebills/[purchasebillid]"

payload = "{ \r\n    \"search\": [\r\n        { \"searchfield\": \"status\", \"searchvalue\": \"Paid\", \"criteria\": \"eq\", \"datatype\": \"text\" }\r\n    ]\r\n}\r\n"
headers = {
  'authkey': 'XXXXXXXXXX',
  'Content-Type': 'application/json'
}

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

print(response.text.encode('utf8'))

require "uri"
require "net/http"

url = URI("https://live.membroz.com/api/purchasebills/[purchasebillid]")

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

request = Net::HTTP::Get.new(url)
request["authkey"] = "XXXXXXXXXX"
request["Content-Type"] = "application/json"
request.body = "{ \r\n    \"search\": [\r\n        { \"searchfield\": \"status\", \"searchvalue\": \"Paid\", \"criteria\": \"eq\", \"datatype\": \"text\" }\r\n    ]\r\n}\r\n"

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

curl --location --request GET 'https://live.membroz.com/api/purchasebills/[purchasebillid]'\
--header 'authkey: XXXXXXXXXX'\
--header 'Content-Type: application/json' \
--data-raw '{ 
    "search": [
        { "searchfield": "status", "searchvalue": "Paid", "criteria": "eq", "datatype": "text" }
    ]
}
'

Possible Errors

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

Sample Response

{
    "paidamount": 1750,
    "creditamount": 0,
    "status": "Paid",
    "_id": "5f717013d0835e0aac69e178",
    "billnumber": 6,
    "ordernumber": 6,
    "vendorid": {
        "status": "active",
        "_id": "5f0305674ba62e380e5b26bd",
        "vendorname": "Protein Plus Nutrition",
        "branchid": "5ee9db1683e5d3898bd66133",
        "property": {
            "address": "Surat",
            "contact_number": "9861734520",
            "email": null,
            "vendorname": "Protein Plus Nutrition"
        },
        "createdAt": "2020-07-06T11:05:11.251Z",
        "updatedAt": "2020-08-15T16:10:47.803Z"
    },
    "totalamount": 1750,
    "balance": 0,
    "billdate": "2020-07-13T09:41:51.369Z",
    "items": [
        {
            "tax": [],
            "_id": "5f0c2c8254c1125e83500b29",
            "item": "5f0301dc4ba62e380e5b26a8",
            "quantity": 5,
            "cost": 350,
            "discount": 0,
            "totalcost": 1750
        }
    ],
    "branchid": "5e954c7b9df11624f81e7859",
    "draccount": "5d5d4fdb93b7a12dfcfea7ee",
    "craccount": "5d5d4cfe93b7a12dfcfea7b1",
    "createdAt": "2020-07-13T09:42:26.527Z",
    "updatedAt": "2020-08-15T16:30:40.781Z",
    "wfroleid": [],
    "wfuserid": []
}