La Cotización es un documento que da a conocer a los clientes los precios de venta de nuestros 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 Cotizacions con los servicios web del WServices.
Para agregar un cotización se debe enviar la esctructura que a continuación te presentamos la cual debe ser en JSON.
{
"apikey": "YOUR_APIKEY",
"provider": "Cotizacion",
"action": "AddCotizacion",
"data": {
"fecha": "2021-05-03",
"comentario": "String con un comentario maximo 50 caracteres",
"atencion":"Lucia León"
"moneda": "MXN",
"tipo_cambio": "1",
"referencia": "1234567890",
"condicion_venta": "",
"sucursal": "0001",
"almacen": "0001",
"cliente": {
"clave":"0000000001"
},
"vendedor": "0000000000",
"productos": [
{
"clave": "0000000002",
"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 Cotizacion se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Cotizacion generada: 01-0000001",
"data": {
"cotizacion": {
"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 la información de una cotización ya agregada, debes de enviar el folio de la cotización en el campo folio del objeto JSON. El wServices cancela el folio enviado y genera un nuevo folio.
Para consultar los valores de una cotización en específico deberás colocar el folio en el campo folio como en la siguiente estructura.
{
"apikey": "YOUR_APIKEY",
"provider": "Cotizacion",
"action": "GetCotizacion",
"data": {
"folio": "01-000002"
}
}
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": {
"cotizacion": {
"folio": "01-0000002",
"fecha": "2021-05-03",
"sucursal": "0001",
"almacen": "0001",
"cliente": "0000000001",
"vendedor": "0000000000",
"comentario": "String con un comentario maximo 50 caracteres",
"atencion": "Lucia León",
"condicion_venta": "",
"referencia": "1234567890",
"moneda": "MXN",
"tipo_cambio": "1",
"estatus": "AC",
"tabla": "",
"documento": "",
"productos": [
{
"clave": "0000000002",
"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": "1",
"unidad_control_1": "PZ",
"cantidad_control_2": "1",
"unidad_control_2": "PZ",
"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",
"partida": "1",
"partida_descripcion": "Partida",
"descripcion_ampleada": ""
},
{
"clave": "0000000003",
"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": "1",
"unidad_control_1": "PZ",
"cantidad_control_2": "1",
"unidad_control_2": "PZ",
"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",
"partida": "1",
"partida_descripcion": "Partida",
"descripcion_ampleada": ""
}
]
},
"fto_imp": "VN01TK"
}
}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 una cotización previamente realizada.
En el campo folio se coloca el folio de la cotización que se desea cancelar.
{
"apikey": "YOUR_APIKEY",
"provider": "Cotizacion",
"action": "DelCotizacion",
"data": {
"folio": "01-0000002"
}
}Si la acción se pudo procesar con existo se te devolvera una respuesta como la siguiente:
{
"type": "info",
"code": "200",
"message": "Cotizacion cancelada: 01-0000002",
"data": {
"cotizacion": {
"folio": "01-0000002",
"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"
}Devuelve una lista con las cotizaciones segun los criterios consultados.
Se puede realizar un filtro de busqueda por:
{
"apikey":"YOUR_APIKEY",
"provider":"cotizacion",
"action":"GetCotizacionLista",
"data":{
"registros":10,
"folio":"01-0000004,01-0000005",
"grupo_comercial":"0000000001"
}
}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": {
"cotizacion": [
{
"folio": "01-0000004",
"fecha": "01/11/2019",
"tabla": "",
"documento": "",
"referencia": "Fac01",
"atencion": "",
"comentario": "Pruebas desarrollo",
"sucursal": {
"clave": "0001",
"descripcion": "Central"
},
"almacen": {
"clave": "0001",
"descripcion": "Almacen general"
},
"cliente": {
"clave": "0000000001",
"descripcion": "Publico general"
},
"vendedor": {
"clave": "0000000001",
"descripcion": "Vendedor mostrador"
},
"condicion_venta": {
"clave": "CRED",
"descripcion": "Credito"
},
"moneda": "MXN",
"tipo_cambio": 1.00,
"totales": {
"precio": 1034.48276,
"descuento": 0,
"subtotal": 1034.48276,
"impuesto": 165.52,
"total": 1200
},
"productos": [
{
"id": "0001",
"clave": "0000000002",
"descripcion": "Consultoria por hora",
"talla": {
"clave": "00",
"descripcion": "SIN TALLA"
},
"color": {
"clave": "00",
"descripcion": "SIN COLOR"
},
"tipo": "99",
"serie": [],
"lote": [],
"cantidad": 4,
"unidad": "SR",
"cantidad_control_1": 4,
"unidad_control_1": "SR",
"cantidad_control_2": 4,
"unidad_control_2": "SR",
"factor_U1C1": 1,
"factor_C1C2": 1,
"precio": 258.62069,
"precio_importe": 1034.48276,
"descuento": 0,
"subtotal": 1034.48276,
"impuesto": 165.517242,
"total": 1200.000002,
"comentarios": ""
}
],
"estatus": "AC"
},
{
"folio": "01-0000005",
"fecha": "10/11/2019",
"tabla": "",
"documento": "",
...
}
],
"registros": 2
}
}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"
}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.