Saltar al contenido
Facturador

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.