Saltar al contenido

Referencia

Fondos y pagos

Fondos por rendir, cajas chicas, solicitudes de fondos, viáticos, lo que la empresa le debe a su gente y las nóminas para el banco.

Listar fondos

GET/api/v1/fondos

Fondos por rendir y cajas chicas con su saldo. Contabilidad y administración ven todos; el resto, los propios.

Parámetros de consulta

estadotexto
abierto o cerrado.
propios1
Solo los de la persona que pregunta.

Pedido

curl "https://simpligastos.cl/api/v1/fondos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "fondos": [
    {
      "id": "0604288d-8cfb-4d13-a385-e48eae827a8a",
      "personaId": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
      "personaNombre": "Pedro Soto",
      "tipo": "fondo",
      "motivo": "Turno faena Calama",
      "viatico": null,
      "montoFijo": null,
      "estado": "abierto",
      "entregado": 250000,
      "rendido": 0,
      "devuelto": 0,
      "saldo": 250000,
      "porEntregar": 0,
      "enCurso": 2,
      "creadoEn": "2026-10-11T15:38:27.106Z",
      "ultimaRendicion": null,
      "cerradoEn": null
    }
  ]
}

Entregar un fondo

POST/api/v1/fondos

Crea un fondo por rendir o una caja chica para una persona. Con entregado: false queda por pagar (aparece en /pagos).

  • Quién: Contabilidad y administración.

Cuerpo (JSON)

personaIdidobligatorio
Opcional.
tipotextoobligatorio
Uno de: fondo, caja_chica.
motivotextoobligatorio
De 1 a 200 caracteres.
montoenteroobligatorio
De 1 a 1.000.000.000.
entregadobooleano
Por omisión: false.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/fondos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"personaId":"72efadfd-f668-4bec-a7c4-f728bbe2e3ca","tipo":"fondo","motivo":"Turno faena Calama","monto":250000,"entregado":true}'

Respuesta

Respuesta 201
{
  "id": "0604288d-8cfb-4d13-a385-e48eae827a8a"
}

Ver un fondo

GET/api/v1/fondos/{id}

El fondo con sus movimientos (entregas, rendiciones, devoluciones) y las rendiciones hechas contra él.

Pedido

curl "https://simpligastos.cl/api/v1/fondos/0604288d-8cfb-4d13-a385-e48eae827a8a" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "fondo": {
    "id": "0604288d-8cfb-4d13-a385-e48eae827a8a",
    "personaId": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    "personaNombre": "Pedro Soto",
    "tipo": "fondo",
    "motivo": "Turno faena Calama",
    "viatico": null,
    "montoFijo": null,
    "estado": "abierto",
    "entregado": 250000,
    "rendido": 0,
    "devuelto": 0,
    "saldo": 250000,
    "porEntregar": 0,
    "enCurso": 2,
    "creadoEn": "2026-10-11T15:38:27.106Z",
    "ultimaRendicion": null,
    "cerradoEn": null,
    "movimientos": [
      {
        "id": "57a2f741-35c1-454b-8755-254bb04a7114",
        "tipo": "entrega",
        "monto": 250000,
        "fecha": "2026-10-11",
        "rendicionId": null,
        "rendicionNumero": null,
        "personaNombre": "Ana Morales"
      }
    ],
    "rendiciones": [
      {
        "id": "c7031420-7f7d-4b53-b3f7-8484a7b9c7e5",
        "numero": 25,
        "titulo": "Gastos de octubre",
        "estado": "aprobada",
        "total": 157010
      }
    ]
  }
}

Abonar a un fondo

POST/api/v1/fondos/{id}/abonar

Agrega plata a un fondo abierto. Con entregado: false el abono queda por pagar.

  • Quién: Contabilidad y administración.

Cuerpo (JSON)

montoenteroobligatorio
De 1 a 1.000.000.000.
entregadobooleano
Por omisión: false.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/fondos/0604288d-8cfb-4d13-a385-e48eae827a8a/abonar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"monto":50000,"entregado":true}'

Respuesta

Respuesta 200
{
  "ok": true
}

Cerrar un fondo

POST/api/v1/fondos/{id}/cerrar

Cierra el fondo. Si le queda saldo, devolucionRecibida: true confirma que la persona lo devolvió.

  • Quién: Contabilidad y administración.

Cuerpo (JSON)

devolucionRecibidabooleano
Por omisión: false.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/fondos/0604288d-8cfb-4d13-a385-e48eae827a8a/cerrar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"devolucionRecibida":true}'

Respuesta

Respuesta 200
{
  "ok": true
}

Listar solicitudes de fondos

GET/api/v1/solicitudes

Los pedidos de fondos. puedoDecidir dice si quien pregunta los puede aprobar.

Parámetros de consulta

estadotexto
pendiente, aprobada, rechazada o retirada.
por_decidir1
Las que esperan la decisión de quien pregunta.
propias1
Solo las de quien pregunta.

Pedido

curl "https://simpligastos.cl/api/v1/solicitudes" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "solicitudes": [
    {
      "id": "36e4aa11-bf2a-4b59-bbde-9b86740b5905",
      "personaId": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
      "personaNombre": "Pedro Soto",
      "monto": 150000,
      "motivo": "Materiales obra Antofagasta",
      "estado": "pendiente",
      "aprobadorNombre": "Ana Morales",
      "decididaPorNombre": null,
      "decididaEn": null,
      "comentario": null,
      "fondoId": null,
      "viatico": null,
      "creadaEn": "2026-10-11T15:38:27.373Z",
      "puedoDecidir": false
    }
  ]
}

Pedir fondos

POST/api/v1/solicitudes

Una persona pide un fondo por rendir. aprobadaSola es true cuando nadie tiene que decidirla (no tiene jefatura ni hay otro aprobador).

  • En nombre de alguien: manda Simpligastos-Persona con el id de la persona.

Cuerpo (JSON)

montoenteroobligatorio
De 1 a 1.000.000.000.
motivotextoobligatorio
De 1 a 200 caracteres.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/solicitudes" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"monto":150000,"motivo":"Materiales obra Antofagasta"}'

Respuesta

Respuesta 201
{
  "id": "36e4aa11-bf2a-4b59-bbde-9b86740b5905",
  "aprobadaSola": false
}

Decidir una solicitud

POST/api/v1/solicitudes/{id}/decidir

aprobar: true crea el fondo; false la rechaza con el comentario. Necesita Simpligastos-Persona: una llave sin persona no decide.

  • En nombre de alguien: manda Simpligastos-Persona con el id de la persona.

Cuerpo (JSON)

aprobarbooleanoobligatorio
Opcional.
comentariotexto o null
Hasta 500 caracteres.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/solicitudes/36e4aa11-bf2a-4b59-bbde-9b86740b5905/decidir" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"aprobar":true,"comentario":null}'

Respuesta

Respuesta 200
{
  "ok": true
}

Retirar una solicitud

POST/api/v1/solicitudes/{id}/retirar

Quien la pidió la retira mientras está pendiente.

  • En nombre de alguien: manda Simpligastos-Persona con el id de la persona.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/solicitudes/36e4aa11-bf2a-4b59-bbde-9b86740b5905/retirar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca"

Respuesta

Respuesta 200
{
  "ok": true
}

Pedir un viático

POST/api/v1/viaticos

Pide fondos según una tabla de viáticos: el monto lo calcula la tabla con las fechas. Responde como una solicitud de fondos.

  • En nombre de alguien: manda Simpligastos-Persona con el id de la persona.

Cuerpo (JSON)

tablaIdidobligatorio
Opcional.
desdefechaobligatorio
AAAA-MM-DD, en hora de Chile.
hastafechaobligatorio
AAAA-MM-DD, en hora de Chile.
motivotextoobligatorio
De 1 a 200 caracteres.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/viaticos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"tablaId":"c6d053b9-d8c0-4fca-bafb-33060bc2d077","desde":"2026-10-20","hasta":"2026-10-23","motivo":"Turno en faena"}'

Respuesta

Respuesta 201
{
  "id": "36e4aa11-bf2a-4b59-bbde-9b86740b5905",
  "aprobadaSola": false
}

Listar tablas de viático

GET/api/v1/viaticos/tablas

Montos por día de alojamiento, alimentación y movilización, por destino y nivel.

Parámetros de consulta

mias1
Solo las que le sirven a quien pregunta (según su nivel).

Pedido

curl "https://simpligastos.cl/api/v1/viaticos/tablas" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "tablas": [
    {
      "id": "c6d053b9-d8c0-4fca-bafb-33060bc2d077",
      "destino": "Faenas del norte",
      "nivel": null,
      "alojamiento": 55000,
      "alimentacion": 22000,
      "movilizacion": 12000,
      "activa": true
    }
  ]
}

Crear una tabla de viático

POST/api/v1/viaticos/tablas

Montos diarios en pesos enteros.

  • Quién: Administración.

Cuerpo (JSON)

destinotextoobligatorio
De 1 a 80 caracteres.
niveltexto o null
Hasta 40 caracteres.
alojamientoenteroobligatorio
De 0 a 5.000.000.
alimentacionenteroobligatorio
De 0 a 5.000.000.
movilizacionenteroobligatorio
De 0 a 5.000.000.
activabooleano
Por omisión: true.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/viaticos/tablas" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"destino":"Faenas del norte","nivel":null,"alojamiento":55000,"alimentacion":22000,"movilizacion":12000}'

Respuesta

Respuesta 201
{
  "id": "c6d053b9-d8c0-4fca-bafb-33060bc2d077"
}

Cambiar una tabla de viático

PATCH/api/v1/viaticos/tablas/{id}

Manda la tabla completa con sus nuevos montos.

  • Quién: Administración.

Cuerpo (JSON)

destinotextoobligatorio
De 1 a 80 caracteres.
niveltexto o null
Hasta 40 caracteres.
alojamientoenteroobligatorio
De 0 a 5.000.000.
alimentacionenteroobligatorio
De 0 a 5.000.000.
movilizacionenteroobligatorio
De 0 a 5.000.000.
activabooleano
Por omisión: true.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/viaticos/tablas/c6d053b9-d8c0-4fca-bafb-33060bc2d077" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"destino":"Faenas del norte","nivel":null,"alojamiento":60000,"alimentacion":24000,"movilizacion":12000,"activa":true}'

Respuesta

Respuesta 200
{
  "id": "c6d053b9-d8c0-4fca-bafb-33060bc2d077"
}

Listar pagos

GET/api/v1/pagos

Lo que la empresa debe a su gente (reembolsos, entregas de fondos, reposiciones) con los datos bancarios de cada persona. Contabilidad ve todos; el resto, los propios.

Parámetros de consulta

estadotexto
pendiente, en_nomina, pagado o anulado.
propios1
Solo los de quien pregunta.

Pedido

curl "https://simpligastos.cl/api/v1/pagos?estado=pendiente" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "pagos": [
    {
      "id": "2edcc0c0-a2ef-410b-9074-ba904596a4f2",
      "personaId": "a08909a1-05c4-4970-b563-9479d23d59fe",
      "personaNombre": "Camila Rojas",
      "personaCorreo": "camila.rojas@montajesandessur.cl",
      "banco": {
        "rut": "16.511.177-K",
        "banco": "BancoEstado",
        "tipoCuenta": "rut",
        "numeroCuenta": "16511177"
      },
      "concepto": "reembolso",
      "monto": 14620,
      "rendicionId": "a1777b47-0439-4a16-a972-b6af020d334e",
      "rendicionNumero": 4,
      "fondoId": null,
      "fondoMotivo": null,
      "estado": "pendiente",
      "nominaId": null,
      "nominaNumero": null,
      "pagadoEn": null,
      "creadoEn": "2026-08-08T14:20:00.000Z"
    }
  ]
}

Marcar un pago como pagado

POST/api/v1/pagos/{id}/pagar

Se pagó por fuera de una nómina (por ejemplo, en efectivo).

  • Quién: Contabilidad y administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/pagos/2edcc0c0-a2ef-410b-9074-ba904596a4f2/pagar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}

Anular un pago

POST/api/v1/pagos/{id}/anular

El pago no se va a hacer.

  • Quién: Contabilidad y administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/pagos/2edcc0c0-a2ef-410b-9074-ba904596a4f2/anular" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}

Listar nóminas

GET/api/v1/nominas

Las nóminas de transferencias generadas.

  • Quién: Contabilidad y administración.

Pedido

curl "https://simpligastos.cl/api/v1/nominas" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "nominas": [
    {
      "id": "5b0f7c1e-3a2d-4f6b-9c8e-1d2a3b4c5d6e",
      "numero": 3,
      "estado": "generada",
      "total": 412350,
      "cantidad": 6,
      "creadaPorNombre": "Carolina Pérez",
      "creadaEn": "2026-10-10T13:05:12.000Z",
      "pagadaEn": null
    }
  ]
}

Generar una nómina

POST/api/v1/nominas

Junta pagos pendientes en una nómina para cargar en el banco.

  • Quién: Contabilidad y administración.

Cuerpo (JSON)

pagoIdslista de idobligatorio
De 1 a 1.000 elementos.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/nominas" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"pagoIds":["2edcc0c0-a2ef-410b-9074-ba904596a4f2"]}'

Respuesta

Respuesta 201
{
  "id": "5b0f7c1e-3a2d-4f6b-9c8e-1d2a3b4c5d6e"
}

Archivo de la nómina

GET/api/v1/nominas/{id}/archivo

El archivo para cargar en el banco, en el formato de la cuenta de pago de la empresa.

  • Quién: Contabilidad y administración.

Parámetros de consulta

formatotexto
generico, bci o santander: cambia el formato de la empresa y lo descarga así.

Pedido

curl "https://simpligastos.cl/api/v1/nominas/5b0f7c1e-3a2d-4f6b-9c8e-1d2a3b4c5d6e/archivo" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -o nomina-3.csv

Respuesta

Respuesta 200
200  Content-Type: text/csv
(el archivo: nomina-3.csv)

Marcar una nómina como pagada

POST/api/v1/nominas/{id}/pagar

El banco ya transfirió: todos sus pagos quedan pagados.

  • Quién: Contabilidad y administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/nominas/5b0f7c1e-3a2d-4f6b-9c8e-1d2a3b4c5d6e/pagar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}

Anular una nómina

POST/api/v1/nominas/{id}/anular

Sus pagos vuelven a quedar pendientes.

  • Quién: Contabilidad y administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/nominas/5b0f7c1e-3a2d-4f6b-9c8e-1d2a3b4c5d6e/anular" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}

Ver la cuenta de pago

GET/api/v1/cuenta-pago

El banco de la empresa: formato del archivo de nómina, RUT y cuenta de cargo.

Pedido

curl "https://simpligastos.cl/api/v1/cuenta-pago" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "cuenta": {
    "formato": "generico",
    "rutEmpresa": null,
    "cuentaCargo": null
  }
}

Cambiar la cuenta de pago

PUT/api/v1/cuenta-pago

Responde la cuenta guardada.

  • Quién: Contabilidad y administración.

Cuerpo (JSON)

formatotextoobligatorio
Uno de: generico, bci, santander.
rutEmpresatexto o null
Opcional.
cuentaCargotexto o null
Opcional.

Pedido

curl -X PUT "https://simpligastos.cl/api/v1/cuenta-pago" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"formato":"bci","rutEmpresa":"76.123.456-0","cuentaCargo":"12345678"}'

Respuesta

Respuesta 200
{
  "cuenta": {
    "formato": "bci",
    "rutEmpresa": "76.123.456-0",
    "cuentaCargo": "12345678"
  }
}