Add Expense Voucher

Add Expense Voucher

Purpose

To add new expense/location to your organization.

Request URL

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

Request Method

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

Request JSON

Attribute Data Type Mandatory Description
expensename text yes expense/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/expenses' \
--header 'authkey: XXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "active",
    "_id": "5f71709bd0835e0aac69e187",
    "expenseaccount": "5d5d4fda93b7a12dfcfea7d4",
    "paidthrough": {
        "secure": false,
        "status": "active",
        "_id": "5d5d4cfe93b7a12dfcfea7b1",
        "headname": "Accounts Payable",
        "accounttype": "Accounts Payable",
        "description": "This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.",
        "reporthead": "Liability&Equity",
        "reporttype": "balancesheet",
        "cashflowhead": "OperatingIncome"
    },
    "vendorid": "5eec4cafc535f1b870bb7cb7",
    "addedby": "5ee9db1683e5d3898bd66135",
    "branchid": "5e954c7b9df11624f81e7859",
    "amount": 25000,
    "date": "2020-07-06T18:30:00.000Z",
    "draccount": "5d5d4fda93b7a12dfcfea7d4",
    "craccount": "5d5d4cfe93b7a12dfcfea7b1",
    "createdAt": "2020-07-07T06:50:42.818Z",
    "updatedAt": "2020-07-07T06:50:42.818Z"
}'
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"status\": \"active\",\r\n    \"_id\": \"5f71709bd0835e0aac69e187\",\r\n    \"expenseaccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"paidthrough\": {\r\n        \"secure\": false,\r\n        \"status\": \"active\",\r\n        \"_id\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n        \"headname\": \"Accounts Payable\",\r\n        \"accounttype\": \"Accounts Payable\",\r\n        \"description\": \"This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.\",\r\n        \"reporthead\": \"Liability&Equity\",\r\n        \"reporttype\": \"balancesheet\",\r\n        \"cashflowhead\": \"OperatingIncome\"\r\n    },\r\n    \"vendorid\": {\r\n        \"status\": \"active\",\r\n        \"_id\": \"5eec4cafc535f1b870bb7cb7\",\r\n        \"vendorname\": \"Metro Fitness Equipment\",\r\n        \"branchid\": \"5ee9db1683e5d3898bd66133\",\r\n        \"property\": {\r\n            \"address\": \"Surat\",\r\n            \"contact_number\": \"9647830152\",\r\n            \"email\": null,\r\n            \"vendorname\": \"Metro Fitness Equipment\"\r\n        },\r\n        \"createdAt\": \"2020-06-19T05:27:11.679Z\",\r\n        \"updatedAt\": \"2020-06-19T05:27:11.679Z\"\r\n    },\r\n    \"addedby\": \"5ee9db1683e5d3898bd66135\",\r\n    \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n    \"amount\": 25000,\r\n    \"date\": \"2020-07-06T18:30:00.000Z\",\r\n    \"draccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"craccount\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n    \"createdAt\": \"2020-07-07T06:50:42.818Z\",\r\n    \"updatedAt\": \"2020-07-07T06:50:42.818Z\"\r\n}");
Request request = new Request.Builder()
  .url("https://live.membroz.com/api/expenses")
  .method("POST", body)
  .addHeader("authkey", "XXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();
 "https://live.membroz.com/api/expenses",
  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    \"status\": \"active\",\r\n    \"_id\": \"5f71709bd0835e0aac69e187\",\r\n    \"expenseaccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"paidthrough\": {\r\n        \"secure\": false,\r\n        \"status\": \"active\",\r\n        \"_id\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n        \"headname\": \"Accounts Payable\",\r\n        \"accounttype\": \"Accounts Payable\",\r\n        \"description\": \"This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.\",\r\n        \"reporthead\": \"Liability&Equity\",\r\n        \"reporttype\": \"balancesheet\",\r\n        \"cashflowhead\": \"OperatingIncome\"\r\n    },\r\n    \"vendorid\": {\r\n        \"status\": \"active\",\r\n        \"_id\": \"5eec4cafc535f1b870bb7cb7\",\r\n        \"vendorname\": \"Metro Fitness Equipment\",\r\n        \"branchid\": \"5ee9db1683e5d3898bd66133\",\r\n        \"property\": {\r\n            \"address\": \"Surat\",\r\n            \"contact_number\": \"9647830152\",\r\n            \"email\": null,\r\n            \"vendorname\": \"Metro Fitness Equipment\"\r\n        },\r\n        \"createdAt\": \"2020-06-19T05:27:11.679Z\",\r\n        \"updatedAt\": \"2020-06-19T05:27:11.679Z\"\r\n    },\r\n    \"addedby\": \"5ee9db1683e5d3898bd66135\",\r\n    \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n    \"amount\": 25000,\r\n    \"date\": \"2020-07-06T18:30:00.000Z\",\r\n    \"draccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"craccount\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n    \"createdAt\": \"2020-07-07T06:50:42.818Z\",\r\n    \"updatedAt\": \"2020-07-07T06:50:42.818Z\"\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/expenses"

payload = "{\r\n    \"status\": \"active\",\r\n    \"_id\": \"5f71709bd0835e0aac69e187\",\r\n    \"expenseaccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"paidthrough\": {\r\n        \"secure\": false,\r\n        \"status\": \"active\",\r\n        \"_id\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n        \"headname\": \"Accounts Payable\",\r\n        \"accounttype\": \"Accounts Payable\",\r\n        \"description\": \"This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.\",\r\n        \"reporthead\": \"Liability&Equity\",\r\n        \"reporttype\": \"balancesheet\",\r\n        \"cashflowhead\": \"OperatingIncome\"\r\n    },\r\n    \"vendorid\": {\r\n        \"status\": \"active\",\r\n        \"_id\": \"5eec4cafc535f1b870bb7cb7\",\r\n        \"vendorname\": \"Metro Fitness Equipment\",\r\n        \"branchid\": \"5ee9db1683e5d3898bd66133\",\r\n        \"property\": {\r\n            \"address\": \"Surat\",\r\n            \"contact_number\": \"9647830152\",\r\n            \"email\": null,\r\n            \"vendorname\": \"Metro Fitness Equipment\"\r\n        },\r\n        \"createdAt\": \"2020-06-19T05:27:11.679Z\",\r\n        \"updatedAt\": \"2020-06-19T05:27:11.679Z\"\r\n    },\r\n    \"addedby\": \"5ee9db1683e5d3898bd66135\",\r\n    \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n    \"amount\": 25000,\r\n    \"date\": \"2020-07-06T18:30:00.000Z\",\r\n    \"draccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"craccount\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n    \"createdAt\": \"2020-07-07T06:50:42.818Z\",\r\n    \"updatedAt\": \"2020-07-07T06:50:42.818Z\"\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/expenses")

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    \"status\": \"active\",\r\n    \"_id\": \"5f71709bd0835e0aac69e187\",\r\n    \"expenseaccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"paidthrough\": {\r\n        \"secure\": false,\r\n        \"status\": \"active\",\r\n        \"_id\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n        \"headname\": \"Accounts Payable\",\r\n        \"accounttype\": \"Accounts Payable\",\r\n        \"description\": \"This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.\",\r\n        \"reporthead\": \"Liability&Equity\",\r\n        \"reporttype\": \"balancesheet\",\r\n        \"cashflowhead\": \"OperatingIncome\"\r\n    },\r\n    \"vendorid\": {\r\n        \"status\": \"active\",\r\n        \"_id\": \"5eec4cafc535f1b870bb7cb7\",\r\n        \"vendorname\": \"Metro Fitness Equipment\",\r\n        \"branchid\": \"5ee9db1683e5d3898bd66133\",\r\n        \"property\": {\r\n            \"address\": \"Surat\",\r\n            \"contact_number\": \"9647830152\",\r\n            \"email\": null,\r\n            \"vendorname\": \"Metro Fitness Equipment\"\r\n        },\r\n        \"createdAt\": \"2020-06-19T05:27:11.679Z\",\r\n        \"updatedAt\": \"2020-06-19T05:27:11.679Z\"\r\n    },\r\n    \"addedby\": \"5ee9db1683e5d3898bd66135\",\r\n    \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n    \"amount\": 25000,\r\n    \"date\": \"2020-07-06T18:30:00.000Z\",\r\n    \"draccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"craccount\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n    \"createdAt\": \"2020-07-07T06:50:42.818Z\",\r\n    \"updatedAt\": \"2020-07-07T06:50:42.818Z\"\r\n}"

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

var client = new RestClient("https://live.membroz.com/api/expenses");
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    \"status\": \"active\",\r\n    \"_id\": \"5f71709bd0835e0aac69e187\",\r\n    \"expenseaccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"paidthrough\": {\r\n        \"secure\": false,\r\n        \"status\": \"active\",\r\n        \"_id\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n        \"headname\": \"Accounts Payable\",\r\n        \"accounttype\": \"Accounts Payable\",\r\n        \"description\": \"This is an account of all the money which you owe to others like a pending bill payment to a vendor,etc.\",\r\n        \"reporthead\": \"Liability&Equity\",\r\n        \"reporttype\": \"balancesheet\",\r\n        \"cashflowhead\": \"OperatingIncome\"\r\n    },\r\n    \"vendorid\": {\r\n        \"status\": \"active\",\r\n        \"_id\": \"5eec4cafc535f1b870bb7cb7\",\r\n        \"vendorname\": \"Metro Fitness Equipment\",\r\n        \"branchid\": \"5ee9db1683e5d3898bd66133\",\r\n        \"property\": {\r\n            \"address\": \"Surat\",\r\n            \"contact_number\": \"9647830152\",\r\n            \"email\": null,\r\n            \"vendorname\": \"Metro Fitness Equipment\"\r\n        },\r\n        \"createdAt\": \"2020-06-19T05:27:11.679Z\",\r\n        \"updatedAt\": \"2020-06-19T05:27:11.679Z\"\r\n    },\r\n    \"addedby\": \"5ee9db1683e5d3898bd66135\",\r\n    \"branchid\": \"5e954c7b9df11624f81e7859\",\r\n    \"amount\": 25000,\r\n    \"date\": \"2020-07-06T18:30:00.000Z\",\r\n    \"draccount\": \"5d5d4fda93b7a12dfcfea7d4\",\r\n    \"craccount\": \"5d5d4cfe93b7a12dfcfea7b1\",\r\n    \"createdAt\": \"2020-07-07T06:50:42.818Z\",\r\n    \"updatedAt\": \"2020-07-07T06:50:42.818Z\"\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": "5f72cab40bb03b46458a6ba6",
    "expenseaccount": "5d5d4fda93b7a12dfcfea7d4",
    "paidthrough": "5d5d4cfe93b7a12dfcfea7b1",
    "vendorid": "5eec4cafc535f1b870bb7cb7",
    "addedby": "5e954c7b9df11624f81e785b",
    "branchid": "5e954c7b9df11624f81e7859",
    "amount": 25000,
    "date": "2020-07-06T18:30:00.000Z",
    "draccount": "5d5d4fda93b7a12dfcfea7d4",
    "craccount": "5d5d4cfe93b7a12dfcfea7b1",
    "createdAt": "2020-09-29T05:48:36.301Z",
    "updatedAt": "2020-09-29T05:48:36.301Z",
    "updatedby": "5e954c7b9df11624f81e785b"
}