Tuhund - Register Person API

API List

• API Introduction
• Authentication Key API
• Server Date and Time
• Embed Image API
• Attachment Download API
• Common lookups API

CRM Integration API

• List of companies with basic details
• Complete details of a company
• List of customers of a branch with basic details
• Register Person
• Register company
• Register address
• Register contact query
• Login ID availability check
• Customer Login API

Delivery / Shipment Order API

• Register Delivery Order
• Delivery Order Tracking API

Expense Claims Integration API

• Register Expense Claim
• Add expense item to claim
• Save and present claim for approval
• Get list of claims with basic details
• Get claim with all details

Inventory Module Integration API

• Register Delivery Note
• Consumer side Stock Utilization Status Update

Sales Module Integration API

• Register Quotation API
• List of Commercial Invoices
• Number of Commercial Invoices
• Register Invoice API

Shopping Cart Integration API

• Price List API
• Create Shopping Cart Order
• Add product to shopping cart
• Update payment details
• Get order in shopping cart
• List of orders in shopping cart

Procurement Module API

• Purchase Order List
• Purchase Order Details

Manufacturing Module API

• Get job order list
• Get job order details
• Bills of material of a Product
• Bill of material

API # : 8029 | API Name : registerperson

This API is used to register a person in Tuhund along with multiple addresses.

URL : <domain>/apic/registerperson
Methods Allowed : POST

Payload Schema :

{ "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "firstname": { "type": "string" }, "dlvalidity": { "type": "string" }, "addresses": { "type": "array", "items": [ { "type": "object", "properties": { "address": { "type": "string" }, "city": { "type": "string" }, "stateid": { "type": "string" }, "countrycode": { "type": "string" }, "postcode": { "type": "string" }, "phone2": { "type": "string" }, "mobile": { "type": "string" }, "state": { "type": "string" }, "title": { "type": "string" }, "fax": { "type": "string" }, "email": { "type": "string" }, "phone1": { "type": "string" } }, "required": [ "address", "city", "stateid", "countrycode", "postcode", "phone2", "mobile", "state", "title", "fax", "email", "phone1" ] }, { "type": "object", "properties": { "address": { "type": "string" }, "city": { "type": "string" }, "stateid": { "type": "string" }, "countrycode": { "type": "string" }, "postcode": { "type": "string" }, "phone2": { "type": "string" }, "mobile": { "type": "string" }, "state": { "type": "string" }, "title": { "type": "string" }, "fax": { "type": "string" }, "email": { "type": "string" }, "phone1": { "type": "string" } }, "required": [ "address", "city", "stateid", "countrycode", "postcode", "phone2", "mobile", "state", "title", "fax", "email", "phone1" ] } ] }, "gender": { "type": "integer" }, "keywords": { "type": "string" }, "idnumber": { "type": "string" }, "middlename": { "type": "string" }, "title": { "type": "string" }, "lastname": { "type": "string" }, "religion": { "type": "string" }, "nationality": { "type": "string" }, "dob": { "type": "string" }, "nickname": { "type": "string" }, "personid": { "type": "string" }, "dlnumber": { "type": "string" }, "anniversary": { "type": "string" } }, "required": [ "firstname", "nationality" ] }

Request Headers :

Name	Description
device	A short name of your application. Device is mandatory but any value between 3 and 20 characters is accepted.
Authentication	Authentication code generated for API call.

Sample Payload :

{ "firstname": "Angela", "dlvalidity": "20/12/2038", "addresses": [ { "address": "#67, Church Street, Brigade Road", "city": "Bangalore", "stateid": "91012", "countrycode": "in", "postcode": "560001", "phone2": "+91800000000", "mobile": "+919800000000", "state": "Karnataka", "title": "Home Address", "fax": "+91800000000", "email": "sampleemail@domain.com", "phone1": "+91800000000" }, { "address": "No.44, Beside Innovative Multiplex Theater, Opp Bhagini Plaza, Munnekolal, Marathahalli", "city": "Bangalore", "stateid": "91012", "countrycode": "in", "postcode": "560037", "phone2": "+91800000000", "mobile": "+91800000000", "state": "Karnataka", "title": "Office Address", "fax": "+91800000000", "email": "sampleemail2@domain.com", "phone1": "+91800000000" } ], "gender": 1, "keywords": "sample 1,sample 2", "idnumber": "SGU678876786876", "middlename": "Tia", "title": "Ms.", "lastname": "Ong", "religion": "Christian", "nationality": "sg", "dob": "11/02/1990", "nickname": "Angela", "personid": "123545545", "dlnumber": "SA87667DS", "anniversary": "25/05/2020" }

Sample success response :

{ "result": 1, "message": "Person Registered.", "personid": "1622481914058" }

Sample failure response :

Case 1: First Name missing

{ "message":"Error while inserting records in database.", "response":-1, "errorcode":406, "errors":[ "firstname (First Name) is a mandatory field." ] }