AAPD

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-data

Enviar 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

CampoTipoObligatorioNotas
skip_pay_order_idstringsí (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_id reusa 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

StatuscodeCausa
401invalid_providerpublic_key inválida.
400no_files / too_many_files / file_too_largeSin archivos, más de 5 archivos, o archivo > 2 MB.
400processing_errorskip_pay_order_id ya ligado a otra ficha de paciente.
404beneficiary_not_foundNo 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_id es el hash que devolvió POST /orders. Para una boleta Spot sin orden AAPD, omítelo y usa Spot → Enviar gasto.

On this page