Enviar gasto
POST /api/spot/gastos con skip_pay_order_id — envía la boleta que destraba la rendición AAPD.
POST /api/spot/gastos?public_key={tu_public_key}&rut={rut_paciente}
Content-Type: multipart/form-dataEnviar el gasto es un paso obligatorio del flujo AAPD: después de que el paciente paga el 30%, tu backend debe mandarnos la boleta de la prestación (con su metadata, y la orden médica si aplica) para que Skip presente el reembolso ante la ISAPRE/seguro. Es el mismo endpoint que Spot → Enviar gasto, con un campo extra: skip_pay_order_id.
El campo que hace la diferencia
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
skip_pay_order_id | string | sí (para AAPD) | El hash (order_token) que devolvió POST /orders. Liga la boleta a esa orden AAPD. |
El resto de campos del formulario (uploaded_files obligatorio, más name, date, receipt_id, receipt_rut, doctor_rut, total) son idénticos a los de Spot → Enviar gasto.
Qué hace skip_pay_order_id
- Marca el gasto como AAPD. Sin el campo, el gasto se registra como Spot estándar y el reembolso AAPD nunca se gatilla.
- Destraba la presentación ISAPRE. Esta subida es una de las dos condiciones que gatillan el reembolso de la orden (la otra es que la orden llegue a
paid). Ver Rendición y cobros. - Es idempotente por orden. Reenviar una boleta con el mismo
skip_pay_order_idreusa el gasto ya existente en vez de duplicarlo (Skip ignora espacios al inicio/fin). Reintentar una subida es seguro.
Cada skip_pay_order_id queda ligado a una sola ficha de paciente. Si intentas subir una boleta con un order_token que ya está ligado a otra ficha (otro rut), Skip la rechaza.
Errores
| Status | code | Causa |
|---|---|---|
| 401 | invalid_provider | public_key inválida. |
| 400 | no_files / too_many_files / file_too_large | Sin archivos, más de 5 archivos, o archivo > 2 MB. |
| 400 | processing_error | skip_pay_order_id ya ligado a otra ficha de paciente. |
| 404 | beneficiary_not_found | 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=15/04/2026" \
-F "receipt_id=DTE-2026-001" \
-F "receipt_rut=99999999-9" \
-F "doctor_rut=11111111-1" \
-F "total=50000" \
-F "skip_pay_order_id=2f88b330-f3ed-5521-aa1f-9d15af1fce8d" \
-F "uploaded_files=@boleta.pdf"El
skip_pay_order_ides elhashque devolvióPOST /orders. Para una boleta Spot sin orden AAPD, omítelo y usa Spot → Enviar gasto.