Obtener facturas

curl --request GET \
  --url https://api.pruff.com/api/clients/invoices \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.pruff.com/api/clients/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pruff.com/api/clients/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pruff.com/api/clients/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.pruff.com/api/clients/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3f2b8a3e-5d1c-4c7e-9a52-0d6f1c2b7a10",
      "businessIdentifier": "76111111-6",
      "stakeholderIdentifier": "96111111-0",
      "businessName": "Cliente Ejemplo SpA",
      "stakeholderName": "Pagador Ejemplo SpA",
      "paymentType": null,
      "issuedDate": "2024-11-15T00:00:00.000Z",
      "receiptDate": "2024-11-16T00:00:00.000Z",
      "amount": 4123123,
      "status": "Transable",
      "issuer": true,
      "code": "33",
      "folio": "1333",
      "creditNoteAmount": 250000,
      "debitNoteAmount": 0,
      "creditNotes": [
        {
          "folio": "1201",
          "code": "61",
          "issuedDate": "2024-11-20",
          "amount": 250000
        }
      ],
      "cessionary": "--",
      "cessionaries": [],
      "lastCessionDate": null,
      "confirmDate": "2024-11-18T00:00:00.000Z",
      "cancelDate": null,
      "enforceableTitle": true,
      "currency": "CLP"
    },
    {
      "id": "9c1d7e42-6b0a-4f3d-8e15-2a4b9d6c3f21",
      "businessIdentifier": "76111111-6",
      "stakeholderIdentifier": "96111111-0",
      "businessName": "Cliente Ejemplo SpA",
      "stakeholderName": "Pagador Ejemplo SpA",
      "paymentType": null,
      "issuedDate": "2024-11-10T00:00:00.000Z",
      "receiptDate": "2024-11-11T00:00:00.000Z",
      "amount": 3748500,
      "status": "Cedida",
      "issuer": true,
      "code": "33",
      "folio": "3213",
      "creditNoteAmount": 0,
      "debitNoteAmount": 0,
      "creditNotes": [],
      "cessionary": "Factoring Ejemplo SpA",
      "cessionaries": [
        {
          "giver": "Cliente Ejemplo SpA",
          "giverIdentifier": "76111111-6",
          "cessionary": "Factoring Ejemplo SpA",
          "cessionaryIdentifier": "77222222-K",
          "cessionDate": "2024-11-12T15:36:00.000Z"
        }
      ],
      "lastCessionDate": "2024-11-12T15:36:00.000Z",
      "confirmDate": null,
      "cancelDate": null,
      "enforceableTitle": true,
      "currency": "CLP"
    }
  ],
  "pagination": {
    "total": 24,
    "page": 1,
    "pageSize": 2,
    "totalPages": 12
  }
}

Facturas

Obtener facturas

Lista las facturas electrónicas (DTE) registradas en Pruff a las que tiene acceso tu empresa, de forma paginada y ordenada por fecha de emisión descendente (las más recientes primero) y, si dos facturas tienen la misma fecha, por id descendente. El orden es estable: al recorrer todas las páginas ninguna factura se repite ni se pierde.

Todos los filtros son opcionales y se combinan entre sí: una factura debe cumplir todos los que envíes. Los filtros de texto (businessName, folio) buscan coincidencia exacta.

Cada factura incluye su estado, el monto de sus notas de crédito y de débito, el detalle de las notas de crédito y el historial de cesiones. Una nota de crédito recién emitida puede tardar en aparecer hasta que Pruff la asocia a su factura.

El valor de status se calcula así, en este orden: si la factura tiene cesiones, es Transable cuando la última cesión la devolvió al emisor y Cedida en cualquier otro caso; si no tiene cesiones, es Reclamada si fue reclamada, Nota de crédito si la suma de sus notas de crédito, descontadas las notas de débito que las anulan, es exactamente igual al monto, Pago al contado si se pagó al contado y Transable en cualquier otro caso.

GET

invoices

Obtener facturas

curl --request GET \
  --url https://api.pruff.com/api/clients/invoices \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.pruff.com/api/clients/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pruff.com/api/clients/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pruff.com/api/clients/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.pruff.com/api/clients/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3f2b8a3e-5d1c-4c7e-9a52-0d6f1c2b7a10",
      "businessIdentifier": "76111111-6",
      "stakeholderIdentifier": "96111111-0",
      "businessName": "Cliente Ejemplo SpA",
      "stakeholderName": "Pagador Ejemplo SpA",
      "paymentType": null,
      "issuedDate": "2024-11-15T00:00:00.000Z",
      "receiptDate": "2024-11-16T00:00:00.000Z",
      "amount": 4123123,
      "status": "Transable",
      "issuer": true,
      "code": "33",
      "folio": "1333",
      "creditNoteAmount": 250000,
      "debitNoteAmount": 0,
      "creditNotes": [
        {
          "folio": "1201",
          "code": "61",
          "issuedDate": "2024-11-20",
          "amount": 250000
        }
      ],
      "cessionary": "--",
      "cessionaries": [],
      "lastCessionDate": null,
      "confirmDate": "2024-11-18T00:00:00.000Z",
      "cancelDate": null,
      "enforceableTitle": true,
      "currency": "CLP"
    },
    {
      "id": "9c1d7e42-6b0a-4f3d-8e15-2a4b9d6c3f21",
      "businessIdentifier": "76111111-6",
      "stakeholderIdentifier": "96111111-0",
      "businessName": "Cliente Ejemplo SpA",
      "stakeholderName": "Pagador Ejemplo SpA",
      "paymentType": null,
      "issuedDate": "2024-11-10T00:00:00.000Z",
      "receiptDate": "2024-11-11T00:00:00.000Z",
      "amount": 3748500,
      "status": "Cedida",
      "issuer": true,
      "code": "33",
      "folio": "3213",
      "creditNoteAmount": 0,
      "debitNoteAmount": 0,
      "creditNotes": [],
      "cessionary": "Factoring Ejemplo SpA",
      "cessionaries": [
        {
          "giver": "Cliente Ejemplo SpA",
          "giverIdentifier": "76111111-6",
          "cessionary": "Factoring Ejemplo SpA",
          "cessionaryIdentifier": "77222222-K",
          "cessionDate": "2024-11-12T15:36:00.000Z"
        }
      ],
      "lastCessionDate": "2024-11-12T15:36:00.000Z",
      "confirmDate": null,
      "cancelDate": null,
      "enforceableTitle": true,
      "currency": "CLP"
    }
  ],
  "pagination": {
    "total": 24,
    "page": 1,
    "pageSize": 2,
    "totalPages": 12
  }
}

Autorizaciones

x-api-key

string

header

requerido

API key que Pruff entrega a tu empresa.

Parámetros de consulta

page

integer

predeterminado:1

Número de página, desde 1.

Rango requerido: x >= 1

pageSize

integer

predeterminado:10

Cantidad de facturas por página. Máximo 500.

Rango requerido: 1 <= x <= 500

businessIdentifier

string

RUT del emisor de la factura, sin puntos y con guion. Solo trae las facturas que ese RUT emitió, no las que recibió. Para las que recibió, usa stakeholderIdentifier. Si el RUT no tiene facturas registradas, la respuesta es una página vacía.

stakeholderIdentifier

string

RUT del receptor de la factura (el deudor), sin puntos y con guion.

startDate

string

Fecha de emisión desde la cual quieres facturas (inclusive). Fecha ISO 8601; si envías solo la fecha se interpreta a las 00:00 UTC.

endDate

string

Fecha de emisión hasta la cual quieres facturas (inclusive). Fecha ISO 8601; si envías solo la fecha, se compara contra las 00:00 UTC de ese día.

businessName

string

Nombre exacto del emisor de la factura, tal como figura en Pruff.

folio

string

Folio exacto de la factura.

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

Respuesta

Página de facturas.

data

object[]

requerido

Show child attributes

pagination

object

requerido

Show child attributes

Inicio

API de clientes

Webhooks

Conector MCP

Obtener facturas

Autorizaciones

Parámetros de consulta

Respuesta