Referencia

Cuenta y avisos

Quién pregunta, sus avisos y el registro de cambios de la empresa.

GET/yoQuién pregunta
PATCH/yoCambiar el RUT propio
GET/avisosListar avisos
POST/avisosMarcar avisos como leídos
GET/registroRegistro de cambios

Quién pregunta

GET/api/v1/yo

La persona de la llave (o la de Simpligastos-Persona) con su RUT, la empresa, cuántas rendiciones esperan su decisión, sus avisos sin leer y si el plan permite subir documentos. Es el mejor primer pedido para probar una llave.

Pedido

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

const respuesta = await fetch("https://simpligastos.cl/api/v1/yo", {
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.get(
    "https://simpligastos.cl/api/v1/yo",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "persona": {
    "id": "65498fef-26f9-4350-b74c-71be32ae2c88",
    "nombre": "Integración: ERP",
    "correo": "integracion+65498fef-26f9-4350-b74c-71be32ae2c88@simpligastos.local",
    "rut": null,
    "roles": [
      "contabilidad",
      "administrador"
    ]
  },
  "empresa": {
    "id": "UGe5Km77Y9yVWAjyNr96FjLpih3avDbD",
    "nombre": "Montajes Andes Sur SpA"
  },
  "empresas": [],
  "porAprobar": 0,
  "avisosNoLeidos": 0,
  "suscripcion": {
    "habilitada": true,
    "documentos": null
  }
}

Cambiar el RUT propio

PATCH/api/v1/yo

El RUT de quien pregunta, el que va en el formulario de sus rendiciones (es el mismo de sus datos bancarios). Se valida con su dígito verificador y se guarda como 12.345.678-5; null lo borra.

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

Cuerpo (JSON)

ruttexto o nullobligatorio: Opcional.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/yo" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"rut":"15.200.000-6"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/yo", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "rut": "15.200.000-6"
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.patch(
    "https://simpligastos.cl/api/v1/yo",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}",
        "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    },
    json={
        "rut": "15.200.000-6",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true,
  "rut": "15.200.000-6"
}

Listar avisos

GET/api/v1/avisos

Los avisos de quien pregunta (por aprobar, aprobada, rechazada, pagado...), del más nuevo al más antiguo, y cuántos no ha leído.

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

Pedido

curl "https://simpligastos.cl/api/v1/avisos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca"

const respuesta = await fetch("https://simpligastos.cl/api/v1/avisos", {
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.get(
    "https://simpligastos.cl/api/v1/avisos",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}",
        "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "avisos": [
    {
      "id": "0d9c8b7a-6f5e-4d3c-9b1a-0f9e8d7c6b5a",
      "tipo": "aprobada",
      "titulo": "Rendición aprobada",
      "texto": "Tu rendición N° 25 Gastos de octubre fue aprobada.",
      "enlace": "/movil/rendiciones/c7031420-7f7d-4b53-b3f7-8484a7b9c7e5",
      "leido": false,
      "creadoEn": "2026-10-12T00:28:01.573Z"
    }
  ],
  "noLeidos": 1
}

Marcar avisos como leídos

POST/api/v1/avisos

Los avisos de ids, o todos si no vienen.

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

Cuerpo (JSON)

idslista de id: Hasta 200 elementos.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/avisos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"ids":["0d9c8b7a-6f5e-4d3c-9b1a-0f9e8d7c6b5a"]}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/avisos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "ids": [
      "0d9c8b7a-6f5e-4d3c-9b1a-0f9e8d7c6b5a"
    ]
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.post(
    "https://simpligastos.cl/api/v1/avisos",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}",
        "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    },
    json={
        "ids": ["0d9c8b7a-6f5e-4d3c-9b1a-0f9e8d7c6b5a"],
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Registro de cambios

GET/api/v1/registro

Lo que pasó en la empresa, del más nuevo al más antiguo, hasta 200 por pedido.

Quién: Administración.

Parámetros de consulta

grupotexto: Uno de: rendiciones, gastos, plata, personas, configuracion, soporte.
personaid: Lo que hizo esa persona.
desdefecha: AAAA-MM-DD.
hastafecha: AAAA-MM-DD.
antesfecha y hora: El creadoEn del último evento recibido, para pedir los anteriores.
formatotexto: csv para descargar hasta 5000 eventos.

Pedido

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

const respuesta = await fetch("https://simpligastos.cl/api/v1/registro", {
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.get(
    "https://simpligastos.cl/api/v1/registro",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "eventos": [
    {
      "id": "8831",
      "entidad": "rendicion",
      "entidadId": "c7031420-7f7d-4b53-b3f7-8484a7b9c7e5",
      "accion": "aprobada",
      "detalle": {
        "comentario": "Todo en orden"
      },
      "personaNombre": "Ana Morales",
      "etiqueta": null,
      "creadoEn": "2026-10-12T00:28:01.573Z"
    }
  ]
}