UpdateGood. Cambio de la configuración del producto existente

Puede cambiar la configuración del producto existente en su tienda SoloClic solicitando una consulta al servicio API utilizando métodos de software. Puede cambiar cada producto solo una vez usando 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/UpdateGood.

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

• good_name es el identificador del nuevo producto; debe ser único dentro de la cuenta (obligatorio),
• good_title es el nombre del producto (obligatorio),
• parent_id es el ID de categoría en el que se agrega el producto; la categoría ya debería existir,
• good_sum es el precio del producto (obligatorio),
• good_api_url_notif es la URL de las notificaciones de la API cuando se paga la factura (ver más en el artículo),
• good_api_url_new_order es la URL de las notificaciones de la API cuando se crea la factura (ver más en este artículo),
• good_success_link es la URL después del pago exitoso; es la página a la que se redirigirá al cliente después del pago exitoso,
• good_client_rassilki son identificadores de grupo separados por comas; los clientes entrarán en estos grupos después del pedido; si no existen tales grupos, se crearán,
• good_nalozh_only (solo para bienes físicos) determina si enviar el producto contra reembolso inmediatamente después de la formación del pedido: 0 – no, 1 – sí,
• good_only_countries son identificadores de países, donde la entrega del producto está disponible (¡usando comas, sin espacios!), si se omite, para entregar sin restricciones, las identificaciones se pueden ver aquí,
• good_download es el enlace para descargar el producto; si el producto es físico, entonces podría ser para su copia digital,
• good_mail_subject el asunto de la carta que el cliente recibirá después del pago,
• good_mail_format es el formato html o texto de la carta,
• good_mail_body es el código html de la carta, si se selecciona el formato html arriba,
• good_mail_text la versión de texto de la carta después del pago, si se selecciona el formato de texto arriba,
• good_partner_fee is the amount of the first-level partner commission in €,
• good_partner_fee_perc es la comisión de socio de primer nivel en% (porcentaje),
• good_partner_pfee es el monto de la comisión del socio de segundo nivel en €,
• good_partner_pfee_perc es la comisión del socio de segundo nivel en% (porcentaje),
• good_partner_show determina si desea mostrar este producto en los materiales publicitarios de su socio; valores posibles: 0 – no, 1 – sí,
• good_partner_SL_link es la URL de la página de descripción del producto (carta de ventas, carta de ventas),
• good_partner_addition_link es la URL de la página con materiales promocionales adicionales,
• good_partner_text es información para socios; aparece una breve nota sobre el producto en los materiales publicitarios del socio,
• good_pay_text es el código html para la página de pago del pedido, aquí puede usar las etiquetas: # IMAGE #, # PRODUCT #, # PRICE #, # USD #,
• good_timer es el límite de tiempo para el pago del pedido: 0 – no, 1 – sí,
• good_timer_unit es el valor límite, los valores posibles son: min – en minutos, hora – en horas, día – en días,
• good_timer_duration – el valor de duración de la restricción, el número que determina cuántos minutos, días u horas hay que pagar por el pedido,
• good_use_short determina si se debe utilizar un enlace corto para la página del pedido, 0 – no, 1 – sí,
• good_rashod es el costo de fabricación y envío del producto en $, para obtener estadísticas financieras más precisas,
• good_rashod_perc son los costos como un porcentaje del precio del producto (por ejemplo, impuestos, etc.),
• good_publish determina si mostrar el producto en el catálogo: 0 – no, 1 – sí.

good_name campos es el único campo obligatorio. Los demás parámetros de consulta dependen de usted.

El ID de categoría se puede tomar de la tienda en la sección «Categoría» de la sección de edición del producto.

¿Como funciona?

Envía la ID del producto y su configuración para reemplazar las existentes a la función UpdateGood 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 en PHP

En el ejemplo, cambiamos la configuración de un producto con el ID de «super_product». El inicio de sesión en el sistema es «nombre de usuario».

Los datos para cambiar se transmiten al máximo, pero puede enviar solo la configuración que necesita cambiar.

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. Ver la sección de API (el enlace en la esquina inferior derecha de la cuenta personal)
 $user_rs['user_rps_key'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
 
 // Formando el conjunto de productos comprados para transferirlos a la API
 
$send_data = array(
	'good_name' => 'super_product',
	'good_title'=> 'Super Product 3000', // nombre del producto
	'parent_id' => 111, // categoria ID
	'good_sum' => 999887, // precio del producto en €
	'good_api_url_notif' => 'https://my_site.es/my_script.php', // URL para notificaciones de API sobre facturas pagadas
	'good_api_url_new_order' => 'https://my_site.es/my_script2.php', // URL para notificaciones de API sobre facturas creadas
	'good_success_link' => 'https://my_site.es/my_script3.php', // URL después del pago exitoso
	'good_client_rassilki' => 'second, clients_super_product', // ID de grupo separados por comas, donde los clientes obtendrán después del pedido
	'good_nalozh_only' => 0, // solo para bienes físicos, ya sea para enviar el producto contra reembolso inmediatamente después de la formación del pedido: 0 - no, 1 - sí
	'good_only_countries' => 'USA,GB', // identificadores de países donde es posible la entrega del producto (separados por comas, sin espacios), si se omite: entrega sin restricciones, los identificadores se pueden ver aquí.
	'good_download'	=> 'https://my_site.es/downloads/product_10dvd.zip', // enlace de descarga
	'good_mail_subject'=> 'Gracias por su compra ', // el tema de la carta después del pago
	'good_mail_format'=> 'text', // el formato de la letra 'html' o 'text'
	'good_mail_body' => '', // código html del mensaje
	'good_mail_text' => 'Gracias por su compra! Enlace de descarga: {$download} ', // la versión de texto de la carta después del pago
	'good_partner_fee' => 90, // comisión de socio de primer nivel en €
	'good_partner_fee_perc'	=> '5', // Comisión de socio de primer nivel en %
	'good_partner_pfee'=> 10, // comisiones de socios de segundo nivel en €
	'good_partner_pfee_perc' => '5', // comisiones de socios de segundo nivel en %
	'good_partner_show' => 1, // mostrar si hay un socio en los materiales publicitarios: 0 - no, 1 - sí
	'good_partner_SL_link' => 'https://my_site.es/the_best_product.html', // URL de la página de descripción del producto (carta de ventas, carta de ventas)
	'good_partner_addition_link'=> 'https://my_site.es/banners.html', // URL de la página con materiales promocionales adicionales
	'good_partner_text'=> 'Es genial ', // Información para socios
	'good_pay_text' => '<h1>Ordering</h1><div>#IMAGE#</div><h2>#PRODUCT#</h2><h3>#PRICE#</h3>', // código html para la página de pago	 	 
        'good_timer' => 1, // límite de tiempo para el pago del pedido: 0 - no, 1 - sí	 	 
        'good_timer_unit' => 'day', // Valor límite: 'min' - en minutos, 'hour' - en horas, 'day' - en días 	 
        'good_timer_duration' => 2, // el valor de duración de la restricción (2 días)
        'good_use_short' => 0, // utilizar un enlace corto para la página de pedidos? 0 - no, 1 - sí
        'good_rashod' => 10, // gastos de fabricación y envío del producto en €
        'good_rashod_perc' => 6, // gastos en porcentaje del precio del producto (impuestos, etc.)
        'good_publish' => 1, // mostrar el producto en el catálogo: 0 - no, 1 - sí
 );	 	 
// Formando el hash a los datos transmitidos
$send_data['hash'] = GetHash($send_data, $user_rs);	 	 
// Llamar a la función UpdateGood y decodificar los datos recibidos
$resp = json_decode(Send('https://username.soloclic.com/api/UpdateGood', $send_data));	 	 
// Verificando 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 "El producto está actualizado. Respuesta del 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);	 	 
}	 	 
// Comprobación del 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 
}