Saltar al contenido principal
GET
Obtener facturas transables

Autorizaciones

x-api-key
string
header
requerido

API key que Pruff entrega a tu empresa.

Parámetros de consulta

email
string<email>

Email de un usuario de tu empresa. Filtra por las facturas de los clientes en la cartera de ese usuario.

startDate
string<date>

Fecha de emisión desde la cual quieres facturas (inclusive), en formato YYYY-MM-DD. Por defecto son 5 días antes de endDate.

endDate
string<date>

Fecha de emisión hasta la cual quieres facturas (inclusive), en formato YYYY-MM-DD. Se compara contra las 00:00 UTC de ese día. Por defecto es el momento de la consulta.

businessIdentifiers
string

RUTs de los emisores, sin puntos y con guion. Separa varios con comas.

stakeholderIdentifiers
string

RUTs de los deudores, sin puntos y con guion. Separa varios con comas.

code
enum<string>

Tipo de DTE de la factura. 33 es factura afecta, 34 es factura exenta y 46 es factura de compra.

Opciones disponibles:
33,
34,
46
strictEmailFilter
enum<string>
predeterminado:false

Con true, restringe el resultado a los clientes asignados directamente al usuario (el de email o, si no lo envías, el de tu API key), sin los de sus subordinados, e ignora su permiso de lectura total.

Opciones disponibles:
true,
false

Respuesta

Arreglo de facturas transables. Es un arreglo vacío si ninguna cumple los filtros.

id
string<uuid>
requerido

Identificador único de la factura.

Ejemplo:

"dc5a0090-5458-477f-8934-d86c6679bea5"

folio
string
requerido

Folio de la factura.

Ejemplo:

"101"

code
string
requerido

Tipo de DTE de la factura, por ejemplo 33 (afecta), 34 (exenta) o 46 (de compra).

Ejemplo:

"33"

businessIdentifier
string
requerido

RUT del emisor de la factura.

Ejemplo:

"11111111-1"

businessName
string
requerido

Nombre del emisor de la factura.

Ejemplo:

"Cliente Ejemplo SpA"

amount
integer
requerido

Monto total de la factura, en CLP.

Ejemplo:

10000000

confirmDate
string<date-time> | null
requerido

Fecha del acuse de recibo. Es null si no se ha confirmado.

Ejemplo:

null

issuedDate
string<date-time>
requerido

Fecha de emisión de la factura, en formato ISO 8601 (UTC).

Ejemplo:

"2026-05-14T00:00:00.000Z"

receiptDate
string<date-time>
requerido

Fecha de recepción de la factura. Si Pruff no la conoce, es igual a issuedDate.

Ejemplo:

"2026-05-15T00:00:00.000Z"

cancelDate
string<date-time> | null
requerido

Fecha de cancelación de la factura. Como las facturas reclamadas no son transables, siempre es null.

Ejemplo:

null

status
string
requerido

Estado de la factura. Siempre Transable.

Ejemplo:

"Transable"

cessionaryName
string
requerido

Nombre del cesionario de la primera cesión de la factura. Es -- si la factura nunca se cedió.

Ejemplo:

"--"

stakeholderIdentifier
string
requerido

RUT del deudor de la factura.

Ejemplo:

"33333333-3"

stakeholderSalesSegment
integer | null
requerido

Segmento de ventas del deudor, según su información tributaria más reciente. Es null si no está disponible.

Ejemplo:

6

stakeholderName
string
requerido

Nombre del deudor.

Ejemplo:

"Deudor Ejemplo SpA"

paymentType
string | null
requerido

Forma de pago informada en la factura. Los valores conocidos son P (pago al contado), C y A. Las facturas pagadas al contado (P) no son transables, por lo que en este endpoint es C, A o null.

Ejemplo:

null

enforceableTitle
boolean
requerido

Indica si la factura tiene mérito ejecutivo. Es true si tiene acuse de recibo o si pasaron al menos 9 días desde su fecha de recepción; en cualquier otro caso es false.

Ejemplo:

false

executiveName
string

Nombre del usuario ejecutivo asignado al emisor. Se omite si el emisor no tiene ejecutivo en tu cartera. Es cadena vacía si el ejecutivo no tiene nombre registrado. Si el emisor tiene varios ejecutivos, se devuelve el de mayor identificador de usuario.

Ejemplo:

"Ana Pérez"