Operación actualizar_items_pricelist

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)

{
    "service": {
        "provision": "PriceList",
        "operacion": "actualizar_items_pricelist",
        "version": "1_0_0_0",
        "response_date": "2020-11-17 22:01:25"
    },
    "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 - Variación por Importe

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],
		"importe": 20	 	
	}
}

Respuesta exitosa para actualizar los precios de los Ítems de una Lista de Precios - Variación por Importe

Respuesta actualizar_items_pricelist ("importe": 20)

{
    "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 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)

{
    "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],
		"is_disabled": 1
	}
}

Respuesta exitosa para habilitar o deshabilitar Ítems de una Lista de Precios

Respuesta actualizar_items_pricelist ("is_disabled": 1)

{
    "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
        }
    }
}

Errores posibles

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"

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."