Consultar documentos emitidos e informes¶

Cómo leer lo que ya pasó: documentos emitidos por período, cotizaciones e informes de ventas e inventario. Es la guía para integraciones de contabilidad, BI o conciliación.

Prerrequisitos: Primeros pasos.

Documentos emitidos por período¶

GET /documento/emitidos/{tipoDte}/{idCliente}/{fechaInicio}/{fechaFin}

Consulta paginada con filtros en la ruta:

tipoDte: un código específico (33, 39, 52...) o 0 para todos los tipos consolidados (boletas, facturas, guías, notas de crédito y débito juntos).
idCliente: código del cliente, o 0 para todos.
Fechas yyyy-MM-dd.

Ejemplo, todo lo emitido en julio:

curl "https://api.opentpv.cl/documento/emitidos/0/0/2026-07-01/2026-07-31" \
  -H "Authorization: Bearer eyJhbGciOi..."

Cada documento viene con su folio, tipo, cliente, totales y el token con el que se obtienen sus archivos (ver Emitir DTE):

GET /documento/pdf/{token}       # también /pdf/80, /pdf/cedible
GET /documento/xml/{token}
GET /documento/estado/dte/{token}

Para reimprimir en el punto de venta existe además GET /documento/print-data/{tipoDte}/{folio}, que devuelve los datos crudos de impresión de un documento por tipo y folio.

Cotizaciones¶

GET /cotizaciones/listado                # con filtros de fecha/cliente
GET /cotizaciones/{folio}/detalle        # líneas de una cotización

Útil para que un portal B2B muestre las cotizaciones vigentes de un cliente y las convierta en pedido (ver Pedidos con nota de venta).

Informes¶

El módulo de informes expone el mismo catálogo que usa el ERP:

GET /Informes/tipos          # catálogo: código, descripción y categoría de cada informe

Atajos listos para usar¶

GET /Informes/ventas/resumen           # ventas del período, resumidas
GET /Informes/inventario/general       # existencias valorizadas
GET /Informes/inventario/bajo-stock    # productos bajo el mínimo
GET /Informes/movimientos              # movimientos de inventario
GET /Informes/dashboard                # indicadores ejecutivos del día

Informe genérico con filtros¶

curl -X POST https://api.opentpv.cl/Informes/generar \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipoInforme": "VENTAS_RESUMEN",
    "fechaDesde": "2026-07-01",
    "fechaHasta": "2026-07-31",
    "clienteId": 0,
    "pagina": 1,
    "tamanoPagina": 200
  }'

Los filtros disponibles dependen del informe (bodegaId, vendedorId, categoriaId, medioPagoId, productoId...); el catálogo de /Informes/tipos indica cuáles aplican. POST /Informes/exportar genera el mismo informe como archivo descargable.

Recomendaciones para integraciones contables o de BI¶

Consulta por rango de fechas cerrado (día o mes anterior), no "todo el historial": las respuestas son paginadas y los períodos cerrados no cambian.
Los documentos con nota de crédito posterior no desaparecen del listado: concilia sumando NC (61) como reversas, igual que en el libro de ventas.
Para el estado tributario fino de cada DTE (aceptado, reparo, rechazo ante el SII), usa estado/dte/{token} documento a documento; el listado de emitidos refleja la emisión, no la aceptación.