En ManagementPro un cliente representa aquella persona que a cambio de un pago adquiere un bien o servicio, estó dependiendo del giro de la empresa que ocupe el sistema.
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 clientes con los servicios web del WServices.
Para agregar contactos 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":"catalogos",
"action":"addCliente",
"data":{
"clave":",
"descripcion":"Alejando Zapata",
"razon_social":"Alejando Zapata SA de CV"
"rfc":"XAXX010101000"
"direccion":{
"calle":"46",
"colonia":"Serapio Rendon",
"codigo_postal":"97280",
"ciudad":"Mérida",
"estado":"Yucatán",
"pais":"México"
}
}
}{
"apikey": "YOUR_APIKEY",
"provider": "catalogos",
"action": "addCliente",
"data": {
"clave": "",
"descripcion": "Alejando Zapata",
"razon_social": "Alejando Zapata SA de CV",
"rfc": "XAXX010101000",
"direccion":{
"calle": "46",
"colonia":"Serapio Rendon",
"codigo_postal":"97280",
"ciudad":"Mérida",
"estado":"Yucatán",
"pais":"México"
},
"sucursal": {
"clave":"0001"
},
"segmento": {
"clave":"0000"
},
"giro_comercial": {
"clave":"0000"
},
"vendedor":{
"clave":"0000000001"
},
"grupo_comercial":{
"clave":"0000000000"
},
"condicion_venta":{
"clave":"CONT"
},
"telefono_1": "9992800765",
"telefono_2": "9205305",
"telefono_3": "",
"contacto_1": "Alex",
"contacto_email_1": "Alex@gmail.com",
"contacto_2": "Marissa",
"contacto_email_2": "Marissa@gmail.com"
}
}Si el cliente se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Cliente agregado: 0000000004",
"data": {
"cliente": {
"clave": "0000000004"
}
}
}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"
}Para editar un contacto o actualiza información del cliente ya agregado, debes de enviar la clave del cliente en el campo clave del objeto JSON.
Para consultar los valores de un cliente en específico deberás colocar la clave en el campo cliente en la siguiente estructura.
{
"apikey": "a4175ffe0381c37e756132c41a8b05d8",
"provider": "catalogos",
"action": "GetCliente",
"data":{
"cliente": "0000000004"
}
}
Si la búsqueda se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Consulta realizada correctamente",
"data": {
"cliente": {
"clave": "0000000004",
"descripcion": "Alejando Zapata",
"razon_social": "Alejando Zapata SA de CV ",
"rfc": "XAXX010101000",
"direccion_1": "46 ",
"direccion_2": "Serapio Rendon",
"direccion_3": "97280",
"telefono_1": "9992800765",
"telefono_2": "9205305",
"telefono_3": "",
"direccion": {
"calle": "46",
"numero_exterior": "",
"numero_interior": "",
"cruzamiento_1": "",
"cruzamiento_2": "",
"colonia": "Serapio Rendon",
"codigo_postal": "97280",
"municipio": "",
"ciudad": "Mérida",
"estado": "Yucatán",
"pais": "México"
},
"contacto_1": "Alex",
"email_1": "Alex@gmail.com",
"contacto_2": "Marissa",
"email_2": "Marissa@gmail.com",
"condicion_venta": "",
"esquema_precio": "1",
"sucursal": "0001",
"segmento": "0000",
"giro_comercial": "0000",
"grupo_impuesto": "",
"estatus": "AC"
}
}
}Si ocurrio algún error el servicio respondera con el código y detalle del error:
{
"type": "error",
"code": "405",
"message": "Detalle del mensaje de error"
}Este método devuelve un listado de clientes con sus atributos de acuerdo a la coincidencia de los valores de búsqueda que se envían.
En el campo busqueda se coloca una cadena para hacer la búsqueda de clientes, la consulta se realiza por clave de cliente, descripcion, razon social o RFC.
Los campos clave, sucursal, grupo_comercial y vendedor hace referencia las claves de dichos campos en el cliente, puedes enviar mas de una clave separandolo por coma, por ejemplo:
"clave":"0000000001,000000002"
"sucursal":"0001"
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": "catalogos",
"action": "GetClienteLista",
"data": {
"busqueda":"",
"estado":"AC",
"clave":"",
"sucursal":"",
"grupo_comercial":"",
"vendedor":"",
"registros":"10"
}
}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": {
"cliente": [
{
"clave": "0000000001",
"descripcion": "Cliente generico",
"razon_social": "Cliente mostrador",
"rfc": "XAXX010101000",
"vendedor": {
"clave": "0000000001",
"descripcion": "Vendedor 1"
},
"sucursal": {
"clave": "0001",
"descripcion": "Sucursal 1"
},
"grupo_comercial": {
"clave": "0000000000",
"descripcion": "Sin grupo comercial"
},
"telefono_1": "9994000048",
"telefono_2": "",
"telefono_3": "",
"direccion_1": "61 No.217",
"direccion_2": "Francisco de montejo",
"direccion_3": "97203",
"direccion_entrega_1": "61 No.217",
"direccion_entrega_2": "Francisco de montejo",
"direccion_entrega_3": "97203",
"direccion": {
"calle": "61",
"numero_exterior": "217",
"numero_interior": "",
"cruzamiento_1": "42",
"cruzamiento_2": "44",
"colonia": "Francisco de montejo",
"codigo_postal": "97203",
"municipio": "Merida",
"ciudad": "Merida",
"estado": "Yucatán",
"pais": "México"
},
"contacto_1": "Mpro",
"email_1": "contacto@mproerp.com",
"contacto_2": "",
"email_2": "",
"estado": "AC"
},
{
"clave": "0000000008",
"descripcion": "Cliente 2",
"razon_social": "Cliente 2 ",
"rfc": "XAXX0101010001",
...
}
],
"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.