Reporte de productos vendidos o comprados
GET /api/reports/general-items
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista el detalle por producto (línea por línea) de ventas o compras del rango: comprobante, cliente/proveedor, cantidad, precios, impuestos, total y almacén.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). Devuelve directamente un arreglo (los campos varían según type), o {success: false, message} si un filtro por nombre no encuentra coincidencias.
Filtros por nombre: item_name, user_name, person_name y establishment_name buscan por coincidencia parcial (los _ se tratan como espacios) y usan el primer registro que coincide. Si no encuentran nada responden HTTP 200 con {success: false, message: "No se encontro ..."}. Sin date_start / date_end se usa el mes actual. Sin user_name se filtra por el usuario autenticado según user_type.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
type |
query | no | sale |
sale (por defecto) o purchase. |
date_start |
query | no | 2026-11-01 |
Fecha inicial YYYY-MM-DD. Por defecto, inicio del mes actual. |
date_end |
query | no | 2026-11-30 |
Fecha final. Por defecto, fin del mes actual. |
document_type_id |
query | no | Tipo de comprobante (01, 03, 80 nota de venta...). |
|
item_name |
query | no | Descripción (parcial) del producto. | |
user_name |
query | no | Nombre (parcial) del usuario. | |
user_type |
query | no | VENDEDOR |
CREADOR (quien registró) o VENDEDOR (vendedor asignado). |
person_name |
query | no | Nombre (parcial) del cliente. | |
establishment_name |
query | no | Nombre (parcial) del establecimiento. | |
brand_id |
query | no | Id de marca. | |
category_id |
query | no | Id de categoría. |
Respuestas
200 — Ventas por producto
[
{
"date_of_issue": "2026-11-04",
"user": "JUAN PEREZ",
"district": "MIRAFLORES",
"province": "LIMA",
"department": "LIMA",
"type_document": "FACTURA ELECTRÓNICA",
"serie": "F001",
"number": 219,
"purchase_order": null,
"web_platform": "",
"annulled": false,
"identity_document_customer": "RUC",
"number_document_customer": "20512345678",
"customer_name": "DISTRIBUIDORA ANDINA S.A.C.",
"seller": "JUAN PEREZ",
"observation": "",
"currency": "PEN",
"unit_type": "NIU",
"internal_id": "P0015",
"description": "GASEOSA 500 ML",
"quantity": 10,
"payments_method": "",
"unit_value": 2.54,
"unit_price": 3.0,
"discount": 0,
"total_value": 25.42,
"affectation_igv_type": "10",
"igv": 4.58,
"system_isc_type_id": null,
"total_isc": 0,
"total_plastic_bag_taxes": 0,
"total": 30.0,
"purchase_total": 18.0,
"exchange_rate_sale": 1.0,
"warehouse_description": "Almacén - Oficina Principal"
}
]
200 — Producto no encontrado
{
"success": false,
"message": "No se encontro el item GASEOSA 3L"
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.