El Pedido es una petición de compra, que un cliente hace a un proveedor, en este caso nuestra empresa, dicho pedido solicita productos o servicios.
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 pedidos con los servicios web del WServices.
Para agregar un pedido se debe enviar la esctructura que a continuación te presentamos la cual debe ser en JSON.
{
"apikey": "YOUR_APIKEY",
"provider": "Pedido",
"action": "AddPedido",
"data": {
"fecha": "2021-05-03",
"comentario": "String con un comentario maximo 50 caracteres",
"moneda": "MXN",
"tipo_cambio": "1",
"referencia": "1234567890",
"condicion_venta": "",
"sucursal": "0001",
"almacen": "0001",
"cliente": {
"clave":"0000000001"
},
"vendedor": "0000000000",
"productos": [
{
"clave": "0000000001",
"descripcion": "Descripción del producto que se imprimirá en el pedido, maximo 100 caracteres",
"talla": "00",
"color": "00",
"cantidad": "1",
"unidad": "PZ",
"precio": "13.5"
},
{
"clave": "0000000001",
"talla": "00",
"color": "00",
"descripcion": "Descripción del producto que se imprimirá en el pedido, maximo 100 caracteres",
"cantidad": "1",
"unidad": "PZ",
"precio": "13.5"
}
]
}
}
Si el Pedido se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Pedido generado: 01-0000001",
"data": {
"pedido": {
"folio": "01-0000001",
"operador": ""
}
}
}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 o actualizar información de un pedido ya agregado, debes de enviar el folio del pedido en el campo folio del objeto JSON.
Para consultar los valores de un pedido en específico deberás colocar el folio en el campo folio como en la siguiente estructura.
{
"apikey": "YOUR_APIKEY",
"provider": "Pedido",
"action": "GetPedido",
"data": {
"folio": "01-000001"
}
}
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": {
"pedido": {
"folio": "01-0000001",
"fecha": "2021-05-03",
"sucursal": "0001",
"almacen": "0001",
"cliente": "0000000001",
"vendedor": "0000000000",
"comentario": "String con un comentario maximo 50 caracteres",
"condicion_venta": "",
"referencia": "1234567890",
"moneda": "MXN",
"tipo_cambio": "1",
"estatus": "AC",
"tabla": "",
"documento": "",
"productos": [
{
"clave": "0000000001",
"descripcion": "Descripción del producto que se imprimirá en el pedido, maximo 100 caracteres",
"numero_parte": "",
"talla": "00",
"color": "00",
"cantidad": "1",
"unidad": "PZ",
"cantidad_control_1": "0",
"unidad_control_1": "SR",
"cantidad_control_2": "1",
"unidad_control_2": "SR",
"precio": "13.5",
"precio_importe": "13.5",
"descuento_factor": "0",
"descuento_importe": "0",
"precio_descontado": "13.5",
"precio_descontado_importe": "13.5",
"impuesto_factor": "0",
"impuesto_importe": "0",
"precio_neto": "13.5",
"precio_neto_importe": "13.5",
"descripcion_ampleada": ""
},
{
"clave": "0000000001",
"descripcion": "Descripción del producto que se imprimirá en el pedido, maximo 100 caracteres",
"numero_parte": "",
"talla": "00",
"color": "00",
"cantidad": "1",
"unidad": "PZ",
"cantidad_control_1": "0",
"unidad_control_1": "SR",
"cantidad_control_2": "1",
"unidad_control_2": "SR",
"precio": "13.5",
"precio_importe": "13.5",
"descuento_factor": "0",
"descuento_importe": "0",
"precio_descontado": "13.5",
"precio_descontado_importe": "13.5",
"impuesto_factor": "0",
"impuesto_importe": "0",
"precio_neto": "13.5",
"precio_neto_importe": "13.5",
"descripcion_ampleada": ""
}
]
},
"fto_imp": "VN02TK"
}
}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 se ocupa para cancelar un pedido previamente realizado
En el campo folio se coloca el folio de pedido que se desea cancelar.
{
"apikey": "YOUR_APIKEY",
"provider": "Pedido",
"action": "DelPedido",
"data": {
"folio": "01-0000001"
}
}Si la acción se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Pedido cancelado: 01-0000001",
"data": {
"pedido": {
"folio": "01-0000001",
"operador": ""
}
}
}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.