Compras

Ultima actualización: Octubre 02, 2025
Version: 8.0.0.36 o superior

General

El modulo de compras incluye informacion relacionada a ordenes de compra, entradas de compras y proveedores.

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.

Metodos

GetOrdenCompraLista

Devuelve una lista con las ordenes de compra segun los criterios consultados.

Se puede realizar un filtro de busqueda por:

  • folio
  • sucursal
  • proveedor
  • fecha_inicio
  • fecha_final
  • categoria,departamento,marca,linea,familia,subfamilia
  • estado
Obtener Lista de Ordenes de Compra
{
    "apikey":"YOUR_APIKEY",
    "provider":"compra",
    "action":"GetOrdenCompraLista",
    "data":{
        "registros":10
    }
}
Respuesta del servicio

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": {
        "orden_compra": [
            {
                "folio": "01-0000165",
                "fecha": "02/10/2025",
                "fecha_entrega": "02/10/2025",
                "fecha_vencimiento": "02/10/2025",
                "tabla": "",
                "documento": "",
                "credito": "SI",
                "dias_credito": 0,
                "referencia": "XAXX0001",
                "atencion": "ALBERT KNOX",
                "comentario": "Orden de USBs",
                "sucursal": {
                    "clave": "0001",
                    "descripcion": "MATRIZ"
                },
                "proveedor": {
                    "clave": "0000000002",
                    "descripcion": "PROVEEDOR EX"
                },
                "moneda": "MXN",
                "tipo_cambio": 1,
                "totales": {
                    "precio": 2862,
                    "descuento": 0,
                    "subtotal": 2862,
                    "impuesto": 0,
                    "total": 2862
                },
                "productos": [
                    {
                        "id": "0001",
                        "clave": "0000000002",
                        "descripcion": "MEMORIA USB ROJA 16GB",
                        "talla": {
                            "clave": "00",
                            "descripcion": "SIN TALLA"
                        },
                        "color": {
                            "clave": "00",
                            "descripcion": "SIN COLOR"
                        },
                        "tipo": "03",
                        "codigo_barras": "9900000200008",
                        "codigo_proveedor": "STK9874",
                        "cantidad": 10,
                        "unidad": "PZ",
                        "cantidad_control_1": 10,
                        "unidad_control_1": "PZ",
                        "cantidad_control_2": 10,
                        "unidad_control_2": "PZ",
                        "factor_U1C1": 1,
                        "factor_C1C2": 1,
                        "precio": 286.2,
                        "precio_importe": 2862,
                        "descuento": 0,
                        "subtotal": 2862,
                        "impuesto": 0,
                        "total": 2862,
                        "comentarios": ""
                    }
                ],
                "estatus": "AC"
            }
        ],
        "registros": 1
    }
}

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:

  • registros
  • pagina

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": {
        "orden_compra": [...],
        "paginacion": {
            "pagina_actual": 1,
            "total_paginas": 5,
            "total_registros": 50,
            "inicio": 1,
            "fin": 10
        },
        "registros": 10
    }
}

Otros

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.