El catalogo de vendedores incluye funciones para agregar, modificar o eliminar vendedores de los catalogos de ManagementPro.
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 Ventas con los servicios web del WServices.
Devuelve una lista con las ordenes de compra segun los criterios consultados.
Se puede realizar un filtro de busqueda por:
{
"apikey":"YOUR_APIKEY",
"provider":"catalogos",
"action":"GetVendedorLista",
"data":{
"registros":10
}
}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": {
"vendedor": [
{
"clave": "0000000005",
"descripcion": "ALEJANDRO OSORIO PATRON",
"nivel": "3",
"operador": "ALEX",
"grupo_vendedor": {
"clave": "0003",
"descripcion": "GRUPO A"
},
"sucursal": {
"clave": "0001",
"descripcion": "MATRIZ"
},
"direccion": {
"direccion_1": "",
"direccion_2": "",
"direccion_3": "",
"colonia": "",
"codigo_postal": "",
"ciudad": "",
"estado": "",
"pais": "",
},
"email": "",
"telefono_1": "",
"telefono_2": "",
"telefono_3": "",
"estatus": "AC"
},
{
...
},...
],
"registros": 10
}
}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"
}Puedes activar la paginacion de la consulta enviado los siguientes filtros:
Si activaste la paginacion, traera la informacion de pagina despues de los registros en el nodo "data":
{
"type": "info",
"code": "200",
"message": "Consulta realizada correctamente",
"data": {
"vendedor": [...],
"paginacion": {
"pagina_actual": 1,
"total_paginas": 5,
"total_registros": 50,
"inicio": 1,
"fin": 10
},
"registros": 10
}
}Envia informacion general para crear un vendedor en ManagementPro.
Para crear el vendedor se requiere unicamente el nombre o descripcion, pero puede enviarse datos detallados como la direccion, telefono, etc.
{
"apikey": "YOUR_APIKEY",
"provider": "catalogos",
"action": "AddVendedor",
"data": {
"clave":"",
"descripcion":"Alejandro Osorio",
"grupo_vendedor": {
"clave": "0001"
},
"direccion":{
"direccion_1":"C. 61 N217 x 42 y 44",
"direccion_2":"Francisco de montejo",
"direccion_3":"97203",
"ciudad":"Merida",
"estado":"Yucatan",
"pais":"Mexico"
}
}
}Si la búsqueda se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Vendedor agregado: 0000000010",
"data": {
"vendedor": {
"clave": "0000000010"
}
}
}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"
}Con esta funcion se puede editar tambien los datos de un vendedor ya existente, solo debes enviar el parametro "clave".
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.