Skip to content
NeoApp Ingeniería SAS NeoPOS API Docs

Reportes

Reportes

Prefijo: /api/reportes
Requiere Auth: Sí
Permiso requerido: reportes, *

Módulo de reportes con 11 endpoints para consultas de negocio: ventas generales, desglose de impuestos, facturación electrónica, egresos, productos y cierre de caja.

GET /api/reportes/ventas

Descripción: Reporte general de ventas
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1,
    "cliente": "Cliente Ejemplo",
    "vendedor": "Juan Pérez",
    "total": 10000,
    "montoRecibido": 12000,
    "vueltos": 2000,
    "descuento": 0,
    "totalf": "10000",
    "tipo_consumo": "LOCAL",
    "medioPago": "Efectivo",
    "tipoPago": "CONTADO",
    "fecha": "2025-01-15",
    "hora": "14:30:00",
    "tipo_impuesto": "IVA",
    "codigo_impuesto": "01",
    "valor_impuesto": 1900,
    "valor_base": 10000
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/ventas -H "Authorization: Bearer <token>"

Python:

import httpx
resp = httpx.get("http://localhost/api/reportes/ventas", headers={"Authorization": f"Bearer {token}"})
reporte = resp.json()

JavaScript:

const resp = await fetch('http://localhost/api/reportes/ventas', {
  headers: {'Authorization': `Bearer ${token}`}
});
const reporte = await resp.json();

GET /api/reportes/ventas-inc

Descripción: Reporte de ventas con impuesto INC
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl http://localhost/api/reportes/ventas-inc -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-iva

Descripción: Reporte de ventas con desglose de IVA
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl http://localhost/api/reportes/ventas-iva -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-electronicas

Descripción: Reporte de ventas electrónicas (facturación DIAN)
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "cliente": "Cliente Ejemplo",
    "vendedor": "Juan Pérez",
    "total": 10000,
    "totalf": "10000",
    "medioPago": "Efectivo",
    "iva_venta": 1900,
    "valor_iva": 1900,
    "precio_iva": 11900,
    "NumeroFact": "FAC-001",
    "cufe": "a1b2c3d4e5f6...",
    "fecha": "2025-01-15",
    "hora": "14:30:00"
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/ventas-electronicas -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-electronicas-mes-actual

Descripción: Reporte de ventas electrónicas del mes actual
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl http://localhost/api/reportes/ventas-electronicas-mes-actual -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-por-fecha

Descripción: Reporte de ventas filtrado por fecha específica
Requiere Auth: Sí
Permiso requerido: reportes, leer

Parámetros query:

ParámetroTipoObligatorioDescripción
fechadate✅Fecha a consultar

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl "http://localhost/api/reportes/ventas-por-fecha?fecha=2025-01-15" -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-por-mes

Descripción: Reporte de ventas filtrado por mes y año
Requiere Auth: Sí
Permiso requerido: reportes, leer

Parámetros query:

ParámetroTipoObligatorioDescripción
mesint✅Número del mes (1-12)
anioint✅Año

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl "http://localhost/api/reportes/ventas-por-mes?mes=1&anio=2025" -H "Authorization: Bearer <token>"

GET /api/reportes/ventas-electronica-por-mes

Descripción: Reporte de ventas electrónicas por mes y año
Requiere Auth: Sí
Permiso requerido: reportes, leer

Parámetros query:

ParámetroTipoObligatorioDescripción
mesint✅Número del mes (1-12)
anioint✅Año

Respuesta exitosa: 200 OK

cURL:

Terminal window
curl "http://localhost/api/reportes/ventas-electronica-por-mes?mes=1&anio=2025" -H "Authorization: Bearer <token>"

GET /api/reportes/egresos

Descripción: Reporte de egresos
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1,
    "categoria": "Servicios",
    "descripcionPago": "Pago de luz",
    "fechaPago": "2025-01-15",
    "metodoPago": "Efectivo",
    "montoPagado": 150000,
    "recibePago": "Empresa Eléctrica",
    "responsablePago": "Juan Pérez"
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/egresos -H "Authorization: Bearer <token>"

GET /api/reportes/productos

Descripción: Reporte de productos con stock, precios y utilidad
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "codigo": "PROD001",
    "nombre": "Café Latte",
    "proveedor": "Proveedor Ejemplo",
    "categoria": "Bebidas",
    "stock": 50,
    "precioC": 3500,
    "precio": 5000,
    "utilidad": 1500,
    "iva": 19,
    "valor_iva": 950,
    "precio_iva": 5950
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/productos -H "Authorization: Bearer <token>"

GET /api/reportes/cierre

Descripción: Reporte de cierre de caja
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "base": 500000,
    "gastos": 50000,
    "cierre": 850000,
    "efectivo": 700000,
    "credito": 100000,
    "total": 750000,
    "fecha": "2025-01-15"
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/cierre -H "Authorization: Bearer <token>"

GET /api/reportes/detalle

Descripción: Reporte de detalle de productos vendidos
Requiere Auth: Sí
Permiso requerido: reportes, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "cod_pro": "PROD001",
    "cantidad": 150,
    "tamano": "",
    "precio": 3500,
    "id_venta": 1,
    "fecha": "2025-01-15"
  }
]

cURL:

Terminal window
curl http://localhost/api/reportes/detalle -H "Authorization: Bearer <token>"