Operación actualizar_items_pricelist
- Victoria Amato (Unlicensed)
Comprobaciones
Para poder ejecutar la operación, se debe comprobar que:
La sesión sea válida. La sesión es válida si está activa, lo que implica que se inició sesión con un usuario existente en Colppy.
El usuario tenga permisos sobre la empresa.
Se deben completar los parámetros:
idEmpresa : número entero que corresponde al id de la empresa para la cual impactará la operación.
idPriceList : número entero que corresponde al id de la lista de precios que se va a listar.
idItems : recibe una colección o array de números enteros separados por comas que corresponden a los id de los ítems a actualizar [93420, 93421].
Los precios pueden ser actualizados por una de estas variantes:
porcentaje : parámetro para actualizar el precio de los ítems aumentando (10) o disminuyendo (-10) el precio actual por un determinado porcentaje.
fijo : parámetro para actualizar el precio de los ítems con un nuevo valor fijo.
importe : parámetro para actualizar el precio de los ítems variando el importe en + o en - valor.
is_disabled : parámetro para habilitar o deshabilitar ítems. Enviar 0 (cero) para habilitar o enviar 1 (uno) para deshabilitar.
Operación para actualizar los precios de los Ítems de una Lista de Precios - Por porcentaje
Solicitud actualizar_items_pricelist ("porcentaje": 10)
{
"auth": {
"usuario": "USUARIO_API", //Ingresar el usuario dado de alta en dev.colppy.com
"password": "USUARIO_API_PASSWORD" //Contraseña en MD5 de usuario de dev.colppy.com
},
"service": {
"provision": "PriceList",
"operacion": "operacion": "actualizar_items_pricelist"
},
"parameters": {
"sesion":{
"usuario": "USUARIO_EMPRESA", //Ingresar el usuario que tiene acceso a la empresa en Colppy
"claveSesion": "USUARIO_SESION_EMPRESA" //Ingresar la clave devuelta por la operación iniciar_sesion
},
"idEmpresa":131168995,
"idPriceList": 14614,
"idItems": [93420, 93421],
"porcentaje": 10
}
}Respuesta exitosa para actualizar los precios de los Ítems de una Lista de Precios - Por porcentaje
Respuesta actualizar_items_pricelist ("porcentaje": 10)
{
"service": {
"provision": "PriceList",
"operacion": "actualizar_items_pricelist",
"version": "1_0_0_0",
"response_date": "2020-11-17 21:53:31"
},
"result": {
"estado": 0,
"mensaje": "La operaci�n se realiz� correctamente"
},
"response": {
"success": true,
"message": "La operación se realizó con éxito.",
"data": {
"success": true
}
}
}Operación para actualizar los precios de los Ítems de una Lista de Precios - Por Valor Fijo
Solicitud actualizar_items_pricelist ("fijo": 300.25)
{
"auth": {
"usuario": "USUARIO_API", //Ingresar el usuario dado de alta en dev.colppy.com
"password": "USUARIO_API_PASSWORD" //Contraseña en MD5 de usuario de dev.colppy.com
},
"service": {
"provision": "PriceList",
"operacion": "operacion": "actualizar_items_pricelist"
},
"parameters": {
"sesion":{
"usuario": "USUARIO_EMPRESA", //Ingresar el usuario que tiene acceso a la empresa en Colppy
"claveSesion": "USUARIO_SESION_EMPRESA" //Ingresar la clave devuelta por la operación iniciar_sesion
},
"idEmpresa":131168995,
"idPriceList": 14614,
"idItems": [93420, 93421],
"fijo": 300.25
}
}Respuesta exitosa para actualizar los precios de los Ítems de una Lista de Precios - Por Valor Fijo
Respuesta actualizar_items_pricelist "fijo": 300.25)
Operación para actualizar los precios de los Ítems de una Lista de Precios - Variación por Importe
Solicitud actualizar_items_pricelist ("porcentaje": 10)
Respuesta exitosa para actualizar los precios de los Ítems de una Lista de Precios - Variación por Importe
Respuesta actualizar_items_pricelist ("importe": 20)
Operación para para habilitar o deshabilitar Ítems de una Lista de Precios
Enviar "is_disabled": 0 para habilitar ítems
Enviar "is_disabled": 1 para deshabilitar ítems
Solicitud actualizar_items_pricelist ("is_disabled": 1)
Respuesta exitosa para habilitar o deshabilitar Ítems de una Lista de Precios
Respuesta actualizar_items_pricelist ("is_disabled": 1)
Mensajes de Error
Si hay un problema con la solicitud orequest, la respuesta o result puede devolver los siguientes códigos de error:
"estado" : 501, "mensaje" :
"Los datos enviados no corresponden a un valor JSON válido"
Mensajes de Validación
Si se pudo ejecutar la petición, pero hay problemas con los datos, el response va a indicar "success" : false, y los siguientes mensajes:
"La empresa 13116899 no pertenece al usuario USUARIO_EMPRESA".
Este error indica que falta completar el idEmpresa o que la empresa no pertenece al usuario."La lista de precios no corresponde a la empresa seleccionada. <br /> El id seleccionado no existe en la lista de precios."
Este error indica que el idPriceList no pertenece a la empresa."El campo porcentaje debe ser un valor entre -100 y 100."
"El campo fijo debe tener al menos 0."