En ManagementPro los Productos son los bienes o servicios que se compran para revender o se producen con la finalidad de venderlos.
Para realizar los procesos es necesario enviar los datos necesarios para cada uno al sitio de servicios web. Los datos para el envío son los siguentes:
Metodo: POST
Url: http://localhost/wservices/ *
Content-Type: application/json
*La URL puede variar
Los datos se pueden enviar de dos maneras, por medio de parametros o formulario en un campo con nombre data o por medio de archivos JSON.
A continuación te listamos las operaciones que puedes realizar para los productos con los servicios web del WServices.
Para consultar el registro de un producto hay dos tipos de estructuras o modos de envío, el modo simplificado y el completo, a continuación te presentamos ambas estructuras en JSON.
{
"apikey": "YOUR_APIKEY",
"provider": "Producto",
"action": "GetProducto",
"data": {
"producto":"0000000001"
}
} {
"apikey": "YOUR_APIKEY",
"provider": "Producto",
"action": "GetProducto",
"data": {
"producto":"0000000001",
"cliente":"0000000004",
"moneda":"MXN",
"sucursal":"0001",
"almacen":"0001",
"talla":"00",
"color":"00",
"fecha":"22/05/2020",
...
}
}Si el cliente se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Consulta realizada correctamente",
"data": {
"producto": {
"clave": "0000000001",
"clave_corta": "000001",
"descripcion": "GRAPA # 10 C/1000 MOD-1012",
"descripcion_corta": "GRAPA # 10 C/1000 MOD-1012",
"codigo_barras": "7501214907251",
"tipo": "01",
"unidad": "PZ",
"unidad_control_1": "PZ",
"unidad_control_2": "PZ",
"maneja_talla": "SI",
"maneja_color": "SI",
"talla": "00",
"color": "00",
"moneda": "MXN",
"codigo_sat": "01010101",
"precio": "10.5",
"impuesto": "0",
"existencia": "0",
"estatus": "AC"
}
}
}Si ocurrio algún error el servicio respondera con el código y detalle del error:
{
"type": "error",
"code": "404",
"message": "Detalle del mensaje de error"
}Este método devuelve un listado de productos con sus atributos de acuerdo a la coincidencia de los valores de búsqueda que se envían.
Se puede realizar la consulta con los siguientes filtros:
El campo estado hace referencia al status del registro en la base de datos de ManagementPro, por ejemplo:
AC = Activo
BA = Baja
El campo registros determina el número máximo de resultados que arroje la consulta, de no incluir este campo, por defecto se devolverá un máximo de 10 registros por coincidencia en la consulta.
{
"apikey":"YOUR_APIKEY",
"provider":"producto",
"action":"GetProductoLista",
"data":{
"registros":2,
"categoria":"0000",
"linea":"0000,0001"
}
}Si el contacto se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Consulta realizada correctamente",
"data": {
"producto": [
{
"clave": "0000000001",
"clave_corta": "000001",
"descripcion": "Producto 1",
"descripcion_corta": "Producto 1",
"descripcion_ampliada": "Se listara la descripcion completa o detallada del producto",
"codigo_barras": "9900000100001",
"tipo": "01",
"unidad": "PZ",
"unidad_control_1": "PZ",
"unidad_control_2": "PZ",
"categoria": {
"clave": "0000",
"descripcion": "SIN CATEGORIA"
},
"departamento": {
"clave": "0000",
"descripcion": "SIN DEPARTAMENTO"
},
"marca": {
"clave": "0000",
"descripcion": "SIN MARCA"
},
"linea": {
"clave": "0000",
"descripcion": "SIN LINEA"
},
"familia": {
"clave": "0000",
"descripcion": "SIN FAMILIA"
},
"subfamilia": {
"clave": "0000",
"descripcion": "SIN SUB-FAMILIA"
},
"proveedor": {
"clave": "0000000000",
"descripcion": "PROVEEDORES VARIOS"
},
"moneda": "MXN",
"codigo_sat": "80101706",
"numero_parte": "000011",
"variantes": [
{
"talla": {
"clave": "00",
"descripcion": "SIN TALLA"
},
"color": {
"clave": "00",
"descripcion": "SIN COLOR"
},
"codigo": "",
"precio": 215.51724
}
],
"precios": {
"precio_1": 215.51724,
"precio_2": -1,
"precio_3": -1,
"precio_4": -1,
"precio_5": 189.65517
},
"impuesto": 0.16,
"estatus": "AC"
},
{
"clave": "0000000002",
"clave_corta": "000002",
"descripcion": "Producto 2",
...
}
],
"registros": 2
}
}Si ocurrio algún error el servicio respondera con el código y detalle del error:
{
"type": "error",
"code": "404",
"message": "Detalle del mensaje de error"
}Por el momento no hay mas métodos disponibles, estos se estarán actualizando con el tiempo. Si consideras que hace falta algún método, envía un mensaje a dev@mproerp.com y se analizará la posibilidad de agregarlo al servicio web.