DeleteOrder. Eliminar / Ocultar una factura

Puede eliminar el pedido existente enviando una consulta al servicio API utilizando métodos de software.

Puede eliminar cada pedido una vez utilizando la función.

La consulta se envía mediante el método POST en formato URLencode a la dirección: https://username.soloclic.com/api/DeleteOrder.

Donde username es el inicio de sesión del usuario en el sistema, así como su dominio de tercer nivel en el servicio SoloClic.

Parámetros transferidos en la consulta

• bill_id es el número de la orden que se eliminará (obligatorio).

¿Como funciona?

Envía la ID del producto y su configuración para reemplazar las existentes a la función DeleteOrder API.

Su sistema recibirá el resultado de la función realizada.

Su sistema recibirá el resultado de la función en formato JSON como respuesta. Para obtener más detalles, consulte la Estados, Códigos y Descripciones de respuesta de API.

Ejemplo de eliminación de la orden en PHP

En el ejemplo, eliminamos la orden # 1111. El inicio de sesión en el sistema es «username».

La función GetHash forma el hash de los datos transferidos.

La función CheckHash comprueba el hash de la respuesta del servicio.

 // Inicie sesión en el sistema SoloClic.
 $user_rs['user_id'] = 'username';
  // La clave para formar un hash. Consulte la sección API (el enlace en la esquina inferior derecha de la cuenta personal).
 $user_rs['user_rps_key'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
 
// Formando el conjunto de bienes comprados para transferirlos a la API.
$send_data['bill_id'] = 1111; 

// Formamos una firma para los datos transmitidos
$send_data['hash'] = GetHash($send_data, $user_rs);

// Llamar a la función DeleteOrder y decodificar los datos recibidos.
$resp = json_decode(Send('https://username.soloclic.com/api/DeleteOrder', $send_data));

// Comprobando la respuesta del servicio.
if(!CheckHash($resp, $user_rs)){
	echo "¡Error! ¡El hash de respuesta no es cierto!"; print_r($resp);
	exit;
}

if($resp->;error_code == 0)
	echo "Se elimina el pedido. Respuesta de servicio: {$resp->;error_text}";
else
	echo "Código de error: {$resp->;error_code} - descripción: {$resp->;error_text}";

// =========== Funciones de enviar, recibir y procesar una respuesta. ============

// Envío de la consulta al servicio API
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); // dando salida a la respuesta a la variable.

	$res = curl_exec($ch);

	curl_close($ch);
	return $res;
}

// Formando el hash de datos transferidos a la API.
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);
}

// Comprobando el hash de respuesta recibido.
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; // el hash es correcto
	else
		return false; //  el hash no es correcto
}