DeleteOrder. Deleting/Hiding an Invoice – InfluencerSoft

/API / DeleteOrder. Deleting/Hiding an Invoice

Content

To integrate with other services and applications, we recommend setting up integration via Zapier.
You will be able to transfer data between services without the help of programmers.
Learn more about Integration with Zapier.

You can delete the existing order by sending a query to the API service using API methods.

You can delete each order using the function.

The query is sent by the POST method in the URL encode format to the address: http://username.influencersoft.com/api/DeleteOrder where the username is the login of the user in the system, as well as their domain of the third level in the InfluencerSoft service.

Parameters Transferred in the Query

bill_id is the number of the order to be deleted (required)

How Does It Work?

You transfer the number of the order to be deleted using the DeleteOrder API function. If the order exists, it is deleted.

Your system will receive the result of the function performing.

The response is coded in JSON format. For more details, see the API Service Responses.

Example of Deleting the Order in PHP

In the example, we delete the order #1111. The login in the system is username.

GetHash Function forms the hash to the transferred data.

CheckHash Function checks the hash to the service response.

 // Login to the Influencersoft system. 
 $user_rs['user_id'] = 'username';
  // The key for forming a hash. See API section (the link in the bottom right corner of the personal account).
 $user_rs['user_rps_key'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
 
// Forming the array of bought goods for transferring to the API.
$send_data['bill_id'] = 1111; 

//Forming the hash to the transmitted data. 
$send_data['hash'] = GetHash($send_data, $user_rs);

// Calling the DeleteOrder function and decoding the received data.
$resp = json_decode(Send('http://username.influencersoft.com/api/DeleteOrder', $send_data));

//Checking the service response.
if(!CheckHash($resp, $user_rs)){
	echo "Error! The response hash is not true!"; print_r($resp);
	exit;
}

if($resp->;error_code == 0)
	echo "The order is deleted.</span> Service response: {$resp->;error_text}";
else
	echo "Error code:{$resp->;error_code} - description: {$resp->;error_text}";

// =========== Functions of sending, receiving and processing a response. ============

// Sending the query to the API service 
function Send($url, $data)
{
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // outputting the response to the variable.

	$res = curl_exec($ch);

	curl_close($ch);
	return $res;
}

// Forming the transferred to the API data hash.
function GetHash($params, $user_rs) {
	$params = http_build_query($params);
	$user_id = $user_rs['user_id'];
	$secret = $user_rs['user_rps_key'];
	$params = "$params::$user_id::$secret";
	return md5($params);
}

//Checking the received response hash.
function CheckHash($resp, $user_rs) {
	$secret = $user_rs['user_rps_key'];
	$code = $resp->;error_code;
	$text = $resp->;error_text;
	$hash = md5("$code::$text::$secret");
	if($hash == $resp->;hash)
		return true; // the hash is correct
	else
		return false; //  the hash is not correct
}