1. Home
  2. Docs
  3. API Overview
  4. Documents – Client
  5. Edit Client

Edit Client

Edit the client in TASQ.

URL:

 https://jobapi.tasq.com.au/api/Job/EditClient

Supports:

POST.

Attribute Details:

Company Validate Info (object) must
Client (object)
ClientID (Guid) must
Client Name (string) (200) must
Job Contact Title (string) (50) optional
Mr./Ms./Mrs./Miss
Job Contact First Name (string) (200) optional
Job Contact Last Name (string) (200) optional
Job Contact Phone (string) (50) optional
Job Contact Mobile (string) (50) optional
Job Contact Fax (string) (50) optional
Job Contact Email (string) (100) optional
Is Same As Job Contact (bool)
Billing Contact Title (string) (50) optional
Mr./Ms./Mrs./Miss
Billing Contact First Name (string) (200) optional
Billing Contact Last Name (string) (200) optional
Billing Contact Phone (string) (50) optional
Billing Contact Mobile (string) (50) optional
Billing Contact Fax (string) (50) optional
Billing Contact Email (string) (100) optional
Memos (string) optional
Job Address (string) (200) optional
Job Address Line2 (string) (200) optional
Job City (string) (100) optional
Job State (string) (50) optional
ACT/NSW/NT/TAS/QLD/SA/VIC/WA
Job Postal Code (string) (50) optional
Job Country (string) (50) must
Is Same As Job Address (bool) optional
Billing Address (string) (200) optional
Billing Address Line2 (string) (200) optional
Billing City (string) (100) optional
Billing State (string) (50) optional
ACT/NSW/NT/TAS/QLD/SA/VIC/WA
Billing Postal Code (string) (50) optional
Billing Country (string) (50) must
ABN (string) (20) optional
Default Sales Discount (decimal) (5,2) optional
BSB Number (string) (7) optional
Bank Account Number (string) (30) optional
Bank Account Name (string) (100) optional
Statement Text (string) (30) optional
Payment Memos (string) optional
Default Sales Tax Code ID (Guid) optional
Is Inactive (bool)
Create Date (date) optional
Has Exported To Q6 (bool)

Example JSON POST data:

{
"CompanyValidateInfo": {
"ClientIP": null,
"LoginName": "testapi@tasq.com.au",
"MobileDeviceToken": null,
"Password": "test123.",
"WebApiTOKEN": "b3b777b0-c7af-458d-be64-b3d6d760177f"
},
    "Client": {
        "ClientID": 					null,
        "ClientName": 				"ZiliangCai",
        "JobContactTitle": 			"Mr",
        "JobContactFirstName": 		"ziliang",
        "JobContactLastName": 		"cai",
        "JobContactPhone": 			"15689466954",
        "JobContactMobile": 		"0385943163",
        "JobContactFax": 			"0358161864",
        "JobContactEmail": 			"ziliangcai@uniware.com.au",
        "IsSameAsJobContact": 		false,
        "BillingContactTitle": 		"Mr",
        "BillingContactFirstName": "ziliang",
        "BillingContactLastName": 	"cai",
        "BillingContactPhone": 		"15846531506",
        "BillingContactMobile": 	"0369583214",
        "BillingContactFax": 		"0369846159",
        "BillingContactEmail": 		"ziliangcai@uniware.com.au",
        "Memos": 						"Memo Text",
        "JobAddress": 				"HuBei",
        "JobAddressLine2": 			"HePingDaDao",
        "JobCity": 					"WuHan",
        "JobState": 					"NT",
        "JobPostalCode": 			"4300000",
        "JobCountry": 				"Australia",
        "IsSameAsJobAddress": 		true,
        "BillingAddress": 			"HuBei",
        "BillingAddressLine2": 		"HePingDaDao",
        "BillingCity": 				"WuHan",
        "BillingState": 				"NT",
        "BillingPostalCode": 		"4300000",
        "BillingCountry": 			"Australia",
        "ABN": 						"53004085616",
        "DefaultSalesDiscount": 	20.0,
        "BSBNumber": 				"454211",
        "BankAccountNumber": 		"Bank156",
        "BankAccountName": 			"Ziliang",
        "StatementText": 			"Statement Text",
        "PaymentMemos": 				"Payment Memo Text",
        "DefaultSalesTaxCodeID": "143aa782-6c6b-44ee-8d26-fd2a70b7f51d",
        "IsInactive": 				false,
        "CreateDate": 				null,
        "HasExportedToQ6": 			null
    }
}
Return Value:
{
	ActionCode: 	(string)					"Create",
	ErrorMessage: (string),					"",
	IsSuccessed: 	(string)					"YES",
	RetrunData: 	(object)					"53c9da55-ab9b-4c61-bfc5-9ecc12190d44"
}

C# Sample Code:

public static string EditClient (string Url ,string content)
        {
            string result = "";
            HttpWebRequest req = (HttpWebRequest)WebRequest.Create(Url);
            req.Method = "POST";
            req.ContentType = "application/json";

            #region Add Post Param
            byte[] data = Encoding.UTF8.GetBytes(content);
            req.ContentLength = data.Length;
            using (Stream reqStream = req.GetRequestStream())
            {
                reqStream.Write(data, 0, data.Length);
                reqStream.Close();
            }
            #endregion

            HttpWebResponse resp = (HttpWebResponse)req.GetResponse();
            Stream stream = resp.GetResponseStream();
            using (StreamReader reader = new StreamReader(stream, Encoding.UTF8))
            {
                result = reader.ReadToEnd();
            }
            return result;
        }

Javascript:

 function EditClient () {
        $.ajax({
            type: "Post",
            url: "https://jobapi.tasq.com.au/api/Item/EditClient",
            data: {
               …
            },
            dataType: "json",
            success: function (data) {
                console.dir(data)
            },
            error: function (e) {
                console.dir(e)
            }
        });
    }

Java Sample Code:

private static void EditClient(String json){
    try {
        URL url = new URL("https://jobapi.tasq.com.au/api/Job/EditClient");
        HttpURLConnection con = (HttpURLConnection)url.openConnection();
        con.setRequestMethod("POST");
        con.setRequestProperty("Content-Type", "application/json; charset=utf-8");
        con.setRequestProperty("Accept", "application/json");
        con.setDoInput(true);
        con.setDoOutput(true);
        con.setUseCaches(false);
        con.setRequestProperty("Connection", "Keep-Alive");
        if (json != null){
            byte[] writeBytes = json.getBytes("utf-8");
            OutputStream outputStream = con.getOutputStream();
            outputStream.write(writeBytes,0, writeBytes.length);
            outputStream.flush();
            outputStream.close();
        }
        if (con.getResponseCode() == HttpURLConnection.HTTP_OK){
            InputStreamReader in = new InputStreamReader(con.getInputStream());
            BufferedReader br = new BufferedReader(in);
            StringBuilder response = new StringBuilder();
            String responseLine = null;
            while ((responseLine = br.readLine()) != null){
                response.append(responseLine.trim());
            }
            System.out.println(response.toString());
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

Swift Sample Code:

func EditClient()
{
    let client: Client = Client()
    let UrlString = TASQSampleCommonLibrary.TASQApiUrl + "Job/EditClient"
    let loginDetail: LoginDetail = LoginDetail()
    var parameters = [String:AnyObject]()
    var arrayData = [String:AnyObject]()

    arrayData ["WebApiTOKEN"] = TASQSampleCommonLibrary.TASQApiTOKEN as AnyObject?
    arrayData ["LoginName"] = loginDetail.LoginEmail! as AnyObject?
    arrayData ["Password"] = loginDetail.LoginPassword! as AnyObject?
    arrayData ["ClientIP"] = TASQSampleCommonLibrary.getIPAddresses() as AnyObject?
    arrayData ["MobileDeviceToken"] = TASQSampleCommonLibrary.getMobileDeviceToken() as AnyObject?
    
    parameters["CompanyValidateInfo"] = arrayData as AnyObject?

    var clientArrayData = [String:String]()
    clientArrayData["ClientID"] = (client.ClientID != nil) ? client.ClientID : ""
    clientArrayData["ClientName"] =  (client.ClientName != nil) ? client.ClientName : ""
    clientArrayData["JobContactTitle"] =   (client.JobContactTitle != nil) ? client.JobContactTitle : ""
    clientArrayData["JobContactFirstName"] =   (client.JobContactFirstName != nil) ? client.JobContactFirstName : ""
    clientArrayData["JobContactLastName"] =  (client.JobContactLastName != nil) ? client.JobContactLastName : ""
    clientArrayData["JobContactPhone"] =   (client.JobContactPhone != nil) ? client.JobContactPhone : ""
    clientArrayData["JobContactMobile"] =  (client.JobContactMobile != nil) ? client.JobContactMobile : ""
    clientArrayData["JobContactFax"] =  (client.JobContactFax != nil) ? client.JobContactFax : ""
    clientArrayData["JobContactEmail"] =  (client.JobContactEmail != nil) ? client.JobContactEmail : ""
    clientArrayData["IsSameAsJobContact"] =  "\(String(describing: client.IsSameAsJobContact))"
    clientArrayData["BillingContactTitle"] =  (client.BillingContactTitle != nil) ? client.BillingContactTitle : ""
    clientArrayData["BillingContactFirstName"] =  (client.BillingContactFirstName != nil) ? client.BillingContactFirstName : ""
    clientArrayData["BillingContactLastName"] =  (client.BillingContactLastName != nil) ? client.BillingContactLastName : ""
    clientArrayData["BillingContactMobile"] =  (client.BillingContactMobile != nil) ? client.BillingContactMobile : ""
    clientArrayData["BillingContactPhone"] =  (client.BillingContactMobile != nil) ? client.BillingContactPhone : ""
    clientArrayData["BillingContactFax"] =  (client.BillingContactFax != nil) ? client.BillingContactFax : ""
    clientArrayData["BillingContactEmail"] =  (client.BillingContactEmail != nil) ? client.BillingContactEmail : ""
    clientArrayData["Memos"] =  (client.Memos != nil) ? client.Memos : ""
    clientArrayData["JobAddress"] =  (client.JobAddress != nil) ? client.JobAddress : ""
    clientArrayData["JobAddressLine2"] =  (client.JobAddressLine2 != nil) ? client.JobAddressLine2 : ""
    clientArrayData["JobCity"] =  (client.JobCity != nil) ? client.JobCity : ""
    clientArrayData["JobState"] =  (client.JobState != nil) ? client.JobState : ""
    clientArrayData["JobPostalCode"] =  (client.JobPostalCode != nil) ? client.JobPostalCode : ""
    clientArrayData["JobCountry"] =  (client.JobCountry != nil) ? client.JobCountry : ""
    clientArrayData["IsSameAsJobAddress"] = "\(String(describing: client.IsSameAsJobAddress))"
    clientArrayData["BillingAddress"] =  (client.BillingAddress != nil) ? client.BillingAddress : ""
    clientArrayData["BillingAddressLine2"] =  (client.BillingAddressLine2 != nil) ? client.BillingAddressLine2 : ""
    clientArrayData["BillingCity"] =  (client.BillingCity != nil) ? client.BillingCity : ""
    clientArrayData["BillingState"] =  (client.BillingState != nil) ? client.BillingState : ""
    clientArrayData["BillingPostalCode"] =  (client.BillingPostalCode != nil) ? client.BillingPostalCode : ""
    clientArrayData["BillingCountry"] =  (client.BillingCountry != nil) ? client.BillingCountry: ""
    clientArrayData["ABN"] =  (client.ABN != nil) ? client.ABN : ""
    clientArrayData["DefaultSalesDiscount"] =  (client.DefaultSalesDiscount != nil) ? client.DefaultSalesDiscount : ""
    clientArrayData["BSBNumber"] =  (client.BSBNumber != nil) ? client.BSBNumber : ""
    clientArrayData["BankAccountNumber"] =  (client.BankAccountNumber != nil) ? client.BankAccountNumber : ""
    clientArrayData["BankAccountName"] =  (client.BankAccountName != nil) ? client.BankAccountName : ""
    clientArrayData["StatementText"] =  (client.StatementText != nil) ? client.StatementText : ""
    clientArrayData["PaymentMemos"] =  (client.PaymentMemos != nil) ? client.PaymentMemos : ""
    clientArrayData["DefaultSalesTaxCodeID"] =  (client.DefaultSalesTaxCodeID != nil) ? client.DefaultSalesTaxCodeID : ""
    clientArrayData["IsInactive"] = "false"
    clientArrayData["CreateDate"] =  (client.CreateDate != nil) ? client.CreateDate : ""
    clientArrayData["HasExportedToQ6"] = "false"
    // clientArrayData["NeedValidate"] = "false"
    parameters["Client"]  = clientArrayData as AnyObject

    let request = NSMutableURLRequest(url: NSURL(string: UrlString)! as URL, cachePolicy: NSURLRequest.CachePolicy.reloadIgnoringLocalCacheData, timeoutInterval: 300)
    let jsonString = TASQSampleCommonLibrary.convertDictionaryToJSONData(dicData: parameters)
    print(jsonString)
    request.httpBody = jsonString.data(using: String.Encoding.utf8, allowLossyConversion: true)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    do {
        let config = URLSessionConfiguration.default
        let session = URLSession(configuration: config)
        let task = session.dataTask(with: request as URLRequest, completionHandler: {
            (data, response, error)  in
        })
        task.resume()
    }
}


How can we help?