SpotBoletas
Subir boleta como archivo
POST /api/spot/gastos con uno o más archivos de boleta.
POST /api/spot/gastos?public_key={tu_public_key}&rut={rut_paciente}
Content-Type: multipart/form-dataEnvía 1–5 boletas como archivos en una sola request.
Campos del formulario
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
name | string | sí | Nombre del paciente (para logs). |
date | YYYY-MM-DD | sí | Fecha de atención de la boleta. |
receipt_id | string | sí | Tu ID interno de la boleta. Usado para idempotencia. |
receipt_rut | string | sí | RUT de la entidad emisora (la clínica). |
doctor_rut | string | sí | RUT del médico tratante. |
total | integer | sí | Monto en CLP, sin decimales. |
skip_pay_order_id | string | no | Setear si esta boleta corresponde a una orden AAPD. |
files | file × 1–5 | sí | PDF o imagen. Máx 2 MB por archivo. |
Respuesta
{
"status": "ok",
"processed_files": ["boleta_a.pdf", "boleta_b.jpg"]
}processed_files es la lista de archivos que Skip aceptó. Los archivos que fallan validación se descartan en silencio — chequea esta lista contra lo que enviaste.
Errores
| Status | Causa |
|---|---|
| 401 | public_key inválida. |
| 400 | Más de 5 archivos, archivo > 2 MB, o MIME no soportado. |
| 404 | No hay beneficiario para rut (el paciente no es usuario Skip con ISAPRE asociada). |
Ejemplo
curl -X POST "https://backend.getskip.ai/api/spot/gastos?public_key=pk_live_xxx&rut=12345678-9" \
-F "name=María González" \
-F "date=2026-04-15" \
-F "receipt_id=DTE-2026-001" \
-F "receipt_rut=99999999-9" \
-F "doctor_rut=11111111-1" \
-F "total=50000" \
-F "files=@boleta.pdf"