Gestion de Ventas

Esta sección contiene la información de la gestión de servicios, el cual se puede acceder a través del POSTMAN en la siguiente dirección:


                    http://spring.informaticapp.com:1303/api/ventas

Listar ventas

Usa el siguiente endpoint para obtener la lista de ventas disponibles:

GET http://spring.informaticapp.com:1303/api/ventas

Respuesta:

Este endpoint retorna un arreglo JSON con las ventas registradas y sus detalles principales, como productos vendidos, tipo de pago, totales y demas datos asociados.

[
    {
        "id": 1,
        "detalles": [
            {
                "id": 1,
                "ventaId": 1,
                "productoId": 1,
                "cantidad": 2,
                "precioUnitario": 2,
                "subtotal": 4
            }
        ],
        "tipoPago": "Efectivo",
        "tipoDocumento": "Boleta",
        "total": 4,
        "montoPago": 4,
        "vuelto": 0,
        "sucursalId": 5,
        "usuarioId": 6,
        "mesaId": 1,
        "clienteId": 1,
        "nombreCliente": "Cliente",
        "tipoVentaId": 1,
        "cajaId": 1,
        "fecha": "2025-06-29T14:00:25",
        "estado": true
    },
    {
        "id": 2,
        "detalles": [
            {
                "id": 2,
                "ventaId": 2,
                "productoId": 1,
                "cantidad": 2,
                "precioUnitario": 2,
                "subtotal": 4
            }
        ],
        "tipoPago": "Efectivo",
        "tipoDocumento": "Boleta",
        "total": 4,
        "montoPago": 4,
        "vuelto": 0,
        "sucursalId": 5,
        "usuarioId": 10,
        "mesaId": 2,
        "clienteId": 1,
        "nombreCliente": "Cliente",
        "tipoVentaId": 1,
        "cajaId": 1,
        "fecha": "2025-06-29T14:26:51",
        "estado": true
    }
]

Obtener una venta específica

Usa el siguiente endpoint para obtener la información de una venta específica:

GET http://spring.informaticapp.com:1303/api/ventas/{id}

Respuesta:

Este endpoint retorna un objeto JSON con los detalles de la venta solicitada, incluyendo productos vendidos, tipo de pago, totales y demás datos asociados.

{
    "id": 1,
    "detalles": [
        {
            "id": 1,
            "ventaId": 1,
            "productoId": 1,
            "cantidad": 2,
            "precioUnitario": 2,
            "subtotal": 4
        }
    ],
    "tipoPago": "Efectivo",
    "tipoDocumento": "Boleta",
    "total": 4,
    "montoPago": 4,
    "vuelto": 0,
    "sucursalId": 5,
    "usuarioId": 6,
    "mesaId": 1,
    "clienteId": 1,
    "nombreCliente": "Cliente",
    "tipoVentaId": 1,
    "cajaId": 1,
    "fecha": "2025-06-29T14:00:25",
    "estado": true
}

Registrar una venta

Usa el siguiente endpoint para registrar una nueva venta:

POST http://spring.informaticapp.com:1303/api/ventas

Cuerpo de la solicitud (JSON):

        {
            "tipoPago": "Efectivo",
            "tipoDocumento": "Boleta",
            "total": 4,
            "montoPago": 8,
            "vuelto": 4,
            "sucursalId": 5,
            "usuarioId": 6,
            "mesaId": 1,
            "clienteId": "2",
            "tipoVentaId": 1,
            "cajaId": 1,
            "estado": true,
            "detalles": [
                {
                    "productoId": 1,
                    "cantidad": 2,
                    "precioUnitario": 2,
                    "subtotal": 4
                }
            ]
        }

Respuesta:

Este endpoint retorna un objeto JSON con los datos de la venta registrada.

{
    "id": 4,
    "detalles": [
        {
            "id": 4,
            "ventaId": 4,
            "productoId": 1,
            "cantidad": 2,
            "precioUnitario": 2,
            "subtotal": 4
        }
    ],
    "tipoPago": "Efectivo",
    "tipoDocumento": "Boleta",
    "total": 4,
    "montoPago": 8,
    "vuelto": 4,
    "sucursalId": 5,
    "usuarioId": 6,
    "mesaId": 1,
    "clienteId": 2,
    "nombreCliente": "Richard",
    "tipoVentaId": 1,
    "cajaId": 1,
    "fecha": "2025-06-29T16:47:33.014805085",
    "estado": true
}