Crear solicitud de factoring
curl --request POST \
--url https://api.pruff.com/api/clients/financing/factoringRequest/create \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"invoices": [
{
"id": "3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f",
"paymentDate": "2026-12-21"
}
],
"documents": [
{
"id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
"paymentDate": "2026-12-21"
}
],
"operationDate": "2026-11-09",
"createdBy": "ana.perez@example.com",
"recipient": "carlos.soto@example.com",
"advance": 98,
"rate": 2,
"arrearRate": 4,
"expensesCost": 15000,
"operationCostVariableAmount": 5000,
"operationCostFixed": 3000,
"guaranteeAmount": 10000,
"guaranteeObservation": "Retención de garantía por la operación",
"exception": false,
"responsibility": "WITH_RESPONSIBILITY",
"isDraft": false
}
'import requests
url = "https://api.pruff.com/api/clients/financing/factoringRequest/create"
payload = {
"invoices": [
{
"id": "3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f",
"paymentDate": "2026-12-21"
}
],
"documents": [
{
"id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
"paymentDate": "2026-12-21"
}
],
"operationDate": "2026-11-09",
"createdBy": "ana.perez@example.com",
"recipient": "carlos.soto@example.com",
"advance": 98,
"rate": 2,
"arrearRate": 4,
"expensesCost": 15000,
"operationCostVariableAmount": 5000,
"operationCostFixed": 3000,
"guaranteeAmount": 10000,
"guaranteeObservation": "Retención de garantía por la operación",
"exception": False,
"responsibility": "WITH_RESPONSIBILITY",
"isDraft": False
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoices: [{id: '3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f', paymentDate: '2026-12-21'}],
documents: [{id: 'c1d2e3f4-5678-90ab-cdef-1234567890ab', paymentDate: '2026-12-21'}],
operationDate: '2026-11-09',
createdBy: 'ana.perez@example.com',
recipient: 'carlos.soto@example.com',
advance: 98,
rate: 2,
arrearRate: 4,
expensesCost: 15000,
operationCostVariableAmount: 5000,
operationCostFixed: 3000,
guaranteeAmount: 10000,
guaranteeObservation: 'Retención de garantía por la operación',
exception: false,
responsibility: 'WITH_RESPONSIBILITY',
isDraft: false
})
};
fetch('https://api.pruff.com/api/clients/financing/factoringRequest/create', 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/financing/factoringRequest/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'invoices' => [
[
'id' => '3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f',
'paymentDate' => '2026-12-21'
]
],
'documents' => [
[
'id' => 'c1d2e3f4-5678-90ab-cdef-1234567890ab',
'paymentDate' => '2026-12-21'
]
],
'operationDate' => '2026-11-09',
'createdBy' => 'ana.perez@example.com',
'recipient' => 'carlos.soto@example.com',
'advance' => 98,
'rate' => 2,
'arrearRate' => 4,
'expensesCost' => 15000,
'operationCostVariableAmount' => 5000,
'operationCostFixed' => 3000,
'guaranteeAmount' => 10000,
'guaranteeObservation' => 'Retención de garantía por la operación',
'exception' => false,
'responsibility' => 'WITH_RESPONSIBILITY',
'isDraft' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pruff.com/api/clients/financing/factoringRequest/create"
payload := strings.NewReader("{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pruff.com/api/clients/financing/factoringRequest/create")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pruff.com/api/clients/financing/factoringRequest/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}"
response = http.request(request)
puts response.read_body{
"message": "Factoring request created successfully",
"factoringRequestId": 19
}Financiamiento
Crear solicitud de factoring
Crea una solicitud de factoring a partir de facturas y/o documentos que ya existen en tu cuenta.
Debes incluir al menos una factura o un documento. Todas las facturas y documentos deben pertenecer al mismo emisor (el cliente que cede). Cada factura referenciada genera automáticamente su documento asociado, o reutiliza el que ya existe.
Cada paymentDate debe ser un día hábil en Chile y no puede ser anterior a operationDate. Las dos fechas se comparan como días en hora de Chile: el mismo día de la operación es válido, y un instante ISO 8601 cuenta como el día que es en Chile en ese momento. La solicitud guarda ese día, sin la hora que enviaste. Ambas aceptan YYYY-MM-DD o un instante ISO 8601, y deben existir en el calendario: una fecha como 2026-02-30 o un texto que no sea una fecha responde 400. Los campos con valor null se ignoran, como si no se hubieran enviado.
Con isDraft en false (valor por defecto) la solicitud queda en estado “En revisión” y se evalúa con el motor de riesgo configurado para tu empresa. Con isDraft en true queda en estado “Borrador” y no se evalúa hasta que alguien la confirme desde Pruff.
El monto de la solicitud es la suma de los montos de las facturas y documentos incluidos. Con documentos en PEN ese monto se mide en céntimos. Los montos en dinero del body (expensesCost, costo variable, costo fijo y guaranteeAmount) van en la divisa de la solicitud: CLP si incluye facturas; si solo incluye documentos, la divisa de esos documentos. expensesCost y operationCostVariableAmount deben ser números enteros: con un valor con decimales la API responde 400 y no crea la solicitud.
Para el costo variable, envía operationCostVariableAmount u operationCostVariablePercentage, pero no ambos. Con operationCostVariablePercentage, el costo variable de la solicitud es porcentaje × monto total / 100, redondeado al entero más cercano.
No repitas un mismo id dentro de invoices ni dentro de documents: la API responde 400 All invoices must exist o All documents must exist.
Si la respuesta es 500 o 504, la solicitud puede haberse creado igual. Antes de reintentar, verifica que no exista para no duplicarla.
POST
/
financing
/
factoringRequest
/
create
Crear solicitud de factoring
curl --request POST \
--url https://api.pruff.com/api/clients/financing/factoringRequest/create \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"invoices": [
{
"id": "3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f",
"paymentDate": "2026-12-21"
}
],
"documents": [
{
"id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
"paymentDate": "2026-12-21"
}
],
"operationDate": "2026-11-09",
"createdBy": "ana.perez@example.com",
"recipient": "carlos.soto@example.com",
"advance": 98,
"rate": 2,
"arrearRate": 4,
"expensesCost": 15000,
"operationCostVariableAmount": 5000,
"operationCostFixed": 3000,
"guaranteeAmount": 10000,
"guaranteeObservation": "Retención de garantía por la operación",
"exception": false,
"responsibility": "WITH_RESPONSIBILITY",
"isDraft": false
}
'import requests
url = "https://api.pruff.com/api/clients/financing/factoringRequest/create"
payload = {
"invoices": [
{
"id": "3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f",
"paymentDate": "2026-12-21"
}
],
"documents": [
{
"id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
"paymentDate": "2026-12-21"
}
],
"operationDate": "2026-11-09",
"createdBy": "ana.perez@example.com",
"recipient": "carlos.soto@example.com",
"advance": 98,
"rate": 2,
"arrearRate": 4,
"expensesCost": 15000,
"operationCostVariableAmount": 5000,
"operationCostFixed": 3000,
"guaranteeAmount": 10000,
"guaranteeObservation": "Retención de garantía por la operación",
"exception": False,
"responsibility": "WITH_RESPONSIBILITY",
"isDraft": False
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoices: [{id: '3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f', paymentDate: '2026-12-21'}],
documents: [{id: 'c1d2e3f4-5678-90ab-cdef-1234567890ab', paymentDate: '2026-12-21'}],
operationDate: '2026-11-09',
createdBy: 'ana.perez@example.com',
recipient: 'carlos.soto@example.com',
advance: 98,
rate: 2,
arrearRate: 4,
expensesCost: 15000,
operationCostVariableAmount: 5000,
operationCostFixed: 3000,
guaranteeAmount: 10000,
guaranteeObservation: 'Retención de garantía por la operación',
exception: false,
responsibility: 'WITH_RESPONSIBILITY',
isDraft: false
})
};
fetch('https://api.pruff.com/api/clients/financing/factoringRequest/create', 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/financing/factoringRequest/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'invoices' => [
[
'id' => '3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f',
'paymentDate' => '2026-12-21'
]
],
'documents' => [
[
'id' => 'c1d2e3f4-5678-90ab-cdef-1234567890ab',
'paymentDate' => '2026-12-21'
]
],
'operationDate' => '2026-11-09',
'createdBy' => 'ana.perez@example.com',
'recipient' => 'carlos.soto@example.com',
'advance' => 98,
'rate' => 2,
'arrearRate' => 4,
'expensesCost' => 15000,
'operationCostVariableAmount' => 5000,
'operationCostFixed' => 3000,
'guaranteeAmount' => 10000,
'guaranteeObservation' => 'Retención de garantía por la operación',
'exception' => false,
'responsibility' => 'WITH_RESPONSIBILITY',
'isDraft' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pruff.com/api/clients/financing/factoringRequest/create"
payload := strings.NewReader("{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pruff.com/api/clients/financing/factoringRequest/create")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pruff.com/api/clients/financing/factoringRequest/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoices\": [\n {\n \"id\": \"3f2b8f2e-6d1a-4c1e-9a55-0d1b2c3d4e5f\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"documents\": [\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\n \"paymentDate\": \"2026-12-21\"\n }\n ],\n \"operationDate\": \"2026-11-09\",\n \"createdBy\": \"ana.perez@example.com\",\n \"recipient\": \"carlos.soto@example.com\",\n \"advance\": 98,\n \"rate\": 2,\n \"arrearRate\": 4,\n \"expensesCost\": 15000,\n \"operationCostVariableAmount\": 5000,\n \"operationCostFixed\": 3000,\n \"guaranteeAmount\": 10000,\n \"guaranteeObservation\": \"Retención de garantía por la operación\",\n \"exception\": false,\n \"responsibility\": \"WITH_RESPONSIBILITY\",\n \"isDraft\": false\n}"
response = http.request(request)
puts response.read_body{
"message": "Factoring request created successfully",
"factoringRequestId": 19
}Cuerpo
application/json
Documentos a incluir, con su fecha de pago. Cada id es el id de un documento devuelto por Obtener documentos (data[].id) o por Crear documentos (documentsCreated[].id o documentsRepetead[].id). Debes enviar al menos una factura o un documento. No repitas un mismo id. Si hay facturas, los documentos deben estar en CLP; si no, todos deben tener la misma divisa.
Show child attributes
Show child attributes
Costo variable como porcentaje del monto total. Es obligatorio si no envías operationCostVariableAmount; no puedes enviar ambos. El costo variable que se registra es porcentaje × monto total / 100, redondeado al entero más cercano.
Rango requerido:
0 <= x <= 100Ejemplo:
1