Skip to main content
GET
Listar facturas paginadas con filtros

Authorizations

Authorization
string
header
required

Token de sesión Better Auth para rutas de backoffice; las rutas de portal usan su token propio.

Query Parameters

payment_status
enum<string>

Pago de facturas emitidas con total mayor que cero. Excluye borradores, pendientes de emisión, rechazadas, anuladas y notas de crédito; se intersecta con el estado comercial seleccionado.

Available options:
paid,
partial,
unpaid
dte_type
enum<string>

Tipo guardado en la factura. UNDEFINED selecciona NULL: la emisión resuelve la preferencia del receptor legal o infiere el tipo por RUT.

Available options:
FACTURA,
BOLETA,
UNDEFINED
type
enum<string>

Tipo de factura

Available options:
MANUAL,
MENSUAL
invoice_type
enum<string>

Tipo de facturación (regular, consolidada o filial)

Available options:
regular,
consolidated,
filial
client_id
string

UUID del cliente

Búsqueda por nombre, RUT, email o concepto

page
number
default:1

Número de página

limit
number
default:20

Límite por página

status
enum<string>[]

Estado(s) de la factura (eje comercial). Acepta un valor o lista separada por comas.

Available options:
DRAFT,
PUBLISHED,
DTE_SENT,
SII_ACCEPTED,
SII_REJECTED,
EMAIL_SENDING,
EMAIL_SENT,
EMAIL_FAILED,
PAID,
OVERDUE,
CREDIT_NOTE,
VOIDED
sii_status
enum<string>[]

Estado(s) del DTE ante el SII (local_status del XML), separados por comas. NOT_EMITTED filtra facturas sin DTE vigente.

Available options:
NOT_EMITTED,
DRAFT,
LOCAL_VALIDATED,
ODOO_DRAFT_CREATED,
ODOO_POSTED,
SII_PENDING,
SII_UPLOAD_UNCERTAIN,
SII_ACCEPTED,
SII_REJECTED,
SII_ERROR,
ODOO_ERROR
periodo
string

Período (YYYY-MM)

overdue_only
boolean

Solo facturas vencidas

requires_oc
boolean

Filtrar facturas de clientes que requieren OC (orden de compra) y no tienen OC cargada

sort_by
enum<string>
default:total_amount

Campo por el que ordenar

Available options:
created_at,
issue_date,
total_amount,
due_date
order
enum<string>
default:desc

Dirección de ordenamiento

Available options:
asc,
desc

Response

200 - application/json

Lista paginada de facturas

data
object[]
required
total
number
required
page
number
required
limit
number
required
total_pages
number
required