Referencia

Personas

Quienes usan Simpligastos en la empresa: invitaciones, roles, jefaturas, grupos, datos bancarios y la sincronización con RR.HH.

GET/personasListar personas
POST/personasInvitar a una persona
GET/personas/{id}Ver una persona
PATCH/personas/{id}Cambiar una persona
POST/personas/importarInvitar a varias
POST/personas/sincronizarSincronizar con RR.HH.
PUT/personas/{id}/datos-bancariosDatos bancarios
POST/personas/{id}/actividadActivar o desactivar
POST/personas/{id}/invitacionRenovar la invitación
POST/personas/{id}/reemplazarReasignar lo pendiente
POST/personas/{id}/borrar-datosBorrar datos personales
GET/gruposListar grupos
POST/gruposCrear un grupo
PATCH/grupos/{id}Cambiar un grupo
DELETE/grupos/{id}Borrar un grupo
GET/delegacionesListar delegaciones
POST/delegacionesCrear una delegación
DELETE/delegaciones/{id}Terminar una delegación

Listar personas

GET/api/v1/personas

Personas de la empresa con roles, jefatura, grupos y datos bancarios. Las personas técnicas de las llaves no aparecen.

Pedido

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

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas", {
  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/personas",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "personas": [
    {
      "id": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
      "nombre": "Pedro Soto",
      "correo": "pedro.soto@montajesandessur.cl",
      "celular": "+56981234510",
      "rut": "15.200.000-6",
      "roles": [
        "rendidor"
      ],
      "nivelViatico": null,
      "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798",
      "jefaturaNombre": "Ana Morales",
      "grupoIds": [
        "1307e9d4-f6e3-4f78-abde-47fc796faf4b"
      ],
      "banco": {
        "rut": "15.200.000-6",
        "banco": null,
        "tipoCuenta": null,
        "numeroCuenta": null
      },
      "estado": "activa",
      "invitacionVence": null,
      "creadaEn": "2026-06-13T16:38:20.341Z"
    }
  ]
}

Invitar a una persona

POST/api/v1/personas

Crea la persona y le manda la invitación por correo. token es el del enlace de invitación, por si quieres mandarlo tú.

Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio: De 1 a 120 caracteres.
correotextoobligatorio: Opcional.
celulartexto o null: Opcional.
ruttexto o null: Opcional.
roleslista de textoobligatorio: Valores: rendidor, aprobador, contabilidad, administrador, auditor.
jefaturaIdid o null: Opcional.
grupoIdslista de id: Hasta 100 elementos.
nivelViaticotexto o null: Hasta 40 caracteres.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Pedro Soto","correo":"pedro.soto@montajesandessur.cl","celular":"+56981234510","rut":"15.200.000-6","roles":["rendidor"],"jefaturaId":"2a2aea11-0356-4547-94e7-50ef4b093798"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nombre": "Pedro Soto",
    "correo": "pedro.soto@montajesandessur.cl",
    "celular": "+56981234510",
    "rut": "15.200.000-6",
    "roles": [
      "rendidor"
    ],
    "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798"
  }),
});
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/personas",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "nombre": "Pedro Soto",
        "correo": "pedro.soto@montajesandessur.cl",
        "celular": "+56981234510",
        "rut": "15.200.000-6",
        "roles": ["rendidor"],
        "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 201

{
  "id": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
  "token": "Wq3...(token de un solo uso)"
}

Ver una persona

GET/api/v1/personas/{id}

Pedido

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

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca", {
  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/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "persona": {
    "id": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    "nombre": "Pedro Soto",
    "correo": "pedro.soto@montajesandessur.cl",
    "celular": "+56981234510",
    "rut": "15.200.000-6",
    "roles": [
      "rendidor"
    ],
    "nivelViatico": null,
    "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798",
    "jefaturaNombre": "Ana Morales",
    "grupoIds": [
      "1307e9d4-f6e3-4f78-abde-47fc796faf4b"
    ],
    "banco": {
      "rut": "15.200.000-6",
      "banco": null,
      "tipoCuenta": null,
      "numeroCuenta": null
    },
    "estado": "activa",
    "invitacionVence": null,
    "creadaEn": "2026-06-13T16:38:20.341Z"
  }
}

Nombre, correo, celular, RUT, roles, jefatura, grupos o nivel de viático. El RUT es opcional y se valida con su dígito verificador; si no viene, se mantiene el que tenía, y null lo borra. Es el mismo de los datos bancarios. Si cambia el correo de alguien que no ha aceptado, responde un token de invitación nuevo.

Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio: De 1 a 120 caracteres.
correotextoobligatorio: Opcional.
celulartexto o null: Opcional.
ruttexto o null: Opcional.
roleslista de textoobligatorio: Valores: rendidor, aprobador, contabilidad, administrador, auditor.
jefaturaIdid o null: Opcional.
grupoIdslista de id: Hasta 100 elementos.
nivelViaticotexto o null: Hasta 40 caracteres.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Pedro Soto","correo":"pedro.soto@montajesandessur.cl","celular":"+56981234510","rut":"15.200.000-6","roles":["rendidor","aprobador"],"jefaturaId":"2a2aea11-0356-4547-94e7-50ef4b093798"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nombre": "Pedro Soto",
    "correo": "pedro.soto@montajesandessur.cl",
    "celular": "+56981234510",
    "rut": "15.200.000-6",
    "roles": [
      "rendidor",
      "aprobador"
    ],
    "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798"
  }),
});
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/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "nombre": "Pedro Soto",
        "correo": "pedro.soto@montajesandessur.cl",
        "celular": "+56981234510",
        "rut": "15.200.000-6",
        "roles": ["rendidor", "aprobador"],
        "jefaturaId": "2a2aea11-0356-4547-94e7-50ef4b093798",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true,
  "token": null
}

Invitar a varias

POST/api/v1/personas/importar

Hasta 500 filas. jefaturaCorreo une a cada una con su jefatura por correo; rut es opcional, con dígito verificador.

Quién: Administración.

Cuerpo (JSON)

filaslista de objetoobligatorio: De 1 a 500 elementos.
filas[].nombretextoobligatorio: De 1 a 120 caracteres.
filas[].correotextoobligatorio: Opcional.
filas[].celulartexto o null: Opcional.
filas[].ruttexto o null: Opcional.
filas[].roleslista de texto: Valores: rendidor, aprobador, contabilidad, administrador, auditor. Por omisión: ["rendidor"].
filas[].jefaturaCorreotexto o null: Opcional.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/importar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"filas":[{"nombre":"Pedro Soto","correo":"pedro.soto@montajesandessur.cl","rut":"15.200.000-6","roles":["rendidor"],"jefaturaCorreo":"ana.morales@montajesandessur.cl"}]}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/importar", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "filas": [
      {
        "nombre": "Pedro Soto",
        "correo": "pedro.soto@montajesandessur.cl",
        "rut": "15.200.000-6",
        "roles": [
          "rendidor"
        ],
        "jefaturaCorreo": "ana.morales@montajesandessur.cl"
      }
    ]
  }),
});
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/personas/importar",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "filas": [
            {
                "nombre": "Pedro Soto",
                "correo": "pedro.soto@montajesandessur.cl",
                "rut": "15.200.000-6",
                "roles": ["rendidor"],
                "jefaturaCorreo": "ana.morales@montajesandessur.cl",
            },
        ],
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 201

{
  "invitadas": [
    {
      "nombre": "Pedro Soto",
      "correo": "pedro.soto@montajesandessur.cl",
      "token": "Wq3...(token de un solo uso)"
    }
  ]
}

Sincronizar con RR.HH.

POST/api/v1/personas/sincronizar

Manda la nómina completa de colaboradores: crea a quien falta, actualiza a quien cambió y, con desactivarAusentes, desactiva a quien ya no viene. Se reconoce a cada persona por su correo. rut, si viene, reemplaza el de la ficha; si no viene, se mantiene.

Quién: Administración.

Cuerpo (JSON)

colaboradoreslista de objetoobligatorio: De 1 a 5.000 elementos.
colaboradores[].nombretextoobligatorio: De 1 a 120 caracteres.
colaboradores[].correotextoobligatorio: Opcional.
colaboradores[].celulartexto o null: Opcional.
colaboradores[].ruttexto o null: Opcional.
colaboradores[].roleslista de texto: Valores: rendidor, aprobador, contabilidad, administrador, auditor.
colaboradores[].jefaturaCorreotexto o null: Opcional.
colaboradores[].nivelViaticotexto o null: Hasta 40 caracteres.
desactivarAusentesbooleano: Por omisión: false.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/sincronizar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"colaboradores":[{"nombre":"Ana Morales","correo":"ana.morales@montajesandessur.cl","roles":["aprobador"]},{"nombre":"Pedro Soto","correo":"pedro.soto@montajesandessur.cl","rut":"15.200.000-6","roles":["rendidor"],"jefaturaCorreo":"ana.morales@montajesandessur.cl"}],"desactivarAusentes":false}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/sincronizar", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "colaboradores": [
      {
        "nombre": "Ana Morales",
        "correo": "ana.morales@montajesandessur.cl",
        "roles": [
          "aprobador"
        ]
      },
      {
        "nombre": "Pedro Soto",
        "correo": "pedro.soto@montajesandessur.cl",
        "rut": "15.200.000-6",
        "roles": [
          "rendidor"
        ],
        "jefaturaCorreo": "ana.morales@montajesandessur.cl"
      }
    ],
    "desactivarAusentes": false
  }),
});
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/personas/sincronizar",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "colaboradores": [
            {
                "nombre": "Ana Morales",
                "correo": "ana.morales@montajesandessur.cl",
                "roles": ["aprobador"],
            },
            {
                "nombre": "Pedro Soto",
                "correo": "pedro.soto@montajesandessur.cl",
                "rut": "15.200.000-6",
                "roles": ["rendidor"],
                "jefaturaCorreo": "ana.morales@montajesandessur.cl",
            },
        ],
        "desactivarAusentes": False,
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "creadas": 1,
  "actualizadas": 1,
  "desactivadas": 0
}

Datos bancarios

PUT/api/v1/personas/{id}/datos-bancarios

Donde se le transfieren los reembolsos.

Quién: Administración y contabilidad.

Cuerpo (JSON)

ruttextoobligatorio: Opcional.
bancotextoobligatorio: De 2 a 60 caracteres.
tipoCuentatextoobligatorio: Uno de: corriente, vista, ahorro, rut.
numeroCuentatextoobligatorio: Opcional.

Pedido

curl -X PUT "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/datos-bancarios" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"rut":"12.345.678-5","banco":"BancoEstado","tipoCuenta":"rut","numeroCuenta":"12345678"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/datos-bancarios", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "rut": "12.345.678-5",
    "banco": "BancoEstado",
    "tipoCuenta": "rut",
    "numeroCuenta": "12345678"
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).error);
const datos = await respuesta.json();

import os

import requests

respuesta = requests.put(
    "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/datos-bancarios",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "rut": "12.345.678-5",
        "banco": "BancoEstado",
        "tipoCuenta": "rut",
        "numeroCuenta": "12345678",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Activar o desactivar

POST/api/v1/personas/{id}/actividad

activa: false la desactiva: deja de entrar y no aparece para aprobar. Lo rendido se conserva.

Quién: Administración.

Cuerpo (JSON)

activabooleanoobligatorio: Opcional.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/actividad" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"activa":false}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/actividad", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "activa": false
  }),
});
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/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/actividad",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "activa": False,
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Renovar la invitación

POST/api/v1/personas/{id}/invitacion

Genera un enlace de invitación nuevo; el anterior deja de servir.

Quién: Administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/invitacion" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/invitacion", {
  method: "POST",
  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.post(
    "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/invitacion",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "token": "Wq3...(token de un solo uso)"
}

Reasignar lo pendiente

POST/api/v1/personas/{id}/reemplazar

Lo que espera la decisión de esta persona pasa a otra, para siempre (para una ausencia con fecha de término, usa /delegaciones). reasignadas dice cuántas.

Quién: Administración.

Cuerpo (JSON)

aPersonaIdidobligatorio: Opcional.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/2a2aea11-0356-4547-94e7-50ef4b093798/reemplazar" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"aPersonaId":"a524e91a-550d-4120-82c0-4de3570b534a"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/2a2aea11-0356-4547-94e7-50ef4b093798/reemplazar", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "aPersonaId": "a524e91a-550d-4120-82c0-4de3570b534a"
  }),
});
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/personas/2a2aea11-0356-4547-94e7-50ef4b093798/reemplazar",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "aPersonaId": "a524e91a-550d-4120-82c0-4de3570b534a",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "reasignadas": 3
}

Borrar datos personales

POST/api/v1/personas/{id}/borrar-datos

Anonimiza a una persona desactivada; lo rendido se conserva a nombre de Persona eliminada. No se deshace.

Quién: Administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/borrar-datos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

const respuesta = await fetch("https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/borrar-datos", {
  method: "POST",
  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.post(
    "https://simpligastos.cl/api/v1/personas/72efadfd-f668-4bec-a7c4-f728bbe2e3ca/borrar-datos",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Listar grupos

GET/api/v1/grupos

Grupos de personas, para flujos de aprobación y presupuestos.

Pedido

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

const respuesta = await fetch("https://simpligastos.cl/api/v1/grupos", {
  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/grupos",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "grupos": [
    {
      "id": "1307e9d4-f6e3-4f78-abde-47fc796faf4b",
      "nombre": "Faenas del norte",
      "personaIds": [
        "72efadfd-f668-4bec-a7c4-f728bbe2e3ca"
      ]
    }
  ]
}

Crear un grupo

POST/api/v1/grupos

Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio: De 1 a 60 caracteres.
personaIdslista de id: Hasta 2.000 elementos.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/grupos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Faenas del norte","personaIds":["72efadfd-f668-4bec-a7c4-f728bbe2e3ca"]}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/grupos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nombre": "Faenas del norte",
    "personaIds": [
      "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.post(
    "https://simpligastos.cl/api/v1/grupos",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "nombre": "Faenas del norte",
        "personaIds": ["72efadfd-f668-4bec-a7c4-f728bbe2e3ca"],
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 201

{
  "id": "1307e9d4-f6e3-4f78-abde-47fc796faf4b"
}

Cambiar un grupo

PATCH/api/v1/grupos/{id}

Manda el grupo completo, con todas sus personas.

Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio: De 1 a 60 caracteres.
personaIdslista de id: Hasta 2.000 elementos.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Faenas del norte","personaIds":["72efadfd-f668-4bec-a7c4-f728bbe2e3ca"]}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nombre": "Faenas del norte",
    "personaIds": [
      "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.patch(
    "https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
    json={
        "nombre": "Faenas del norte",
        "personaIds": ["72efadfd-f668-4bec-a7c4-f728bbe2e3ca"],
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Borrar un grupo

DELETE/api/v1/grupos/{id}

Quién: Administración.

Pedido

curl -X DELETE "https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

const respuesta = await fetch("https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b", {
  method: "DELETE",
  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.delete(
    "https://simpligastos.cl/api/v1/grupos/1307e9d4-f6e3-4f78-abde-47fc796faf4b",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "ok": true
}

Listar delegaciones

GET/api/v1/delegaciones

Las ausencias en que otra persona decide por alguien. Por omisión, las de quien pregunta (hechas o recibidas).

Parámetros de consulta

todas1: Todas las de la empresa (administración).

Pedido

curl "https://simpligastos.cl/api/v1/delegaciones?todas=1" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

const respuesta = await fetch("https://simpligastos.cl/api/v1/delegaciones?todas=1", {
  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/delegaciones?todas=1",
    headers={"Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}"},
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 200

{
  "delegaciones": [
    {
      "id": "7e1a9c3d-5b2f-4d8e-a0c6-3f4b5a6d7e8f",
      "dePersonaId": "2a2aea11-0356-4547-94e7-50ef4b093798",
      "deNombre": "Ana Morales",
      "aPersonaId": "a524e91a-550d-4120-82c0-4de3570b534a",
      "aNombre": "Carolina Pérez",
      "desde": "2026-10-20",
      "hasta": "2026-10-31",
      "motivo": "Vacaciones",
      "vigente": false
    }
  ]
}

Crear una delegación

POST/api/v1/delegaciones

Mientras dure, aPersonaId decide lo que espera a dePersonaId. Solo administración delega por otra persona; sin dePersonaId, delega quien pregunta.

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

Cuerpo (JSON)

dePersonaIdid: Opcional.
aPersonaIdidobligatorio: Opcional.
desdefechaobligatorio: AAAA-MM-DD, en hora de Chile.
hastafechaobligatorio: AAAA-MM-DD, en hora de Chile.
motivotexto o null: Hasta 200 caracteres.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/delegaciones" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca" \
  -H "Content-Type: application/json" \
  -d '{"aPersonaId":"a524e91a-550d-4120-82c0-4de3570b534a","desde":"2026-10-20","hasta":"2026-10-31","motivo":"Vacaciones"}'

const respuesta = await fetch("https://simpligastos.cl/api/v1/delegaciones", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIGASTOS_LLAVE}`,
    "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "aPersonaId": "a524e91a-550d-4120-82c0-4de3570b534a",
    "desde": "2026-10-20",
    "hasta": "2026-10-31",
    "motivo": "Vacaciones"
  }),
});
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/delegaciones",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLIGASTOS_LLAVE']}",
        "Simpligastos-Persona": "72efadfd-f668-4bec-a7c4-f728bbe2e3ca",
    },
    json={
        "aPersonaId": "a524e91a-550d-4120-82c0-4de3570b534a",
        "desde": "2026-10-20",
        "hasta": "2026-10-31",
        "motivo": "Vacaciones",
    },
)
respuesta.raise_for_status()
datos = respuesta.json()

Respuesta

Respuesta 201

{
  "id": "7e1a9c3d-5b2f-4d8e-a0c6-3f4b5a6d7e8f"
}

Terminar una delegación

DELETE/api/v1/delegaciones/{id}

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

Pedido

curl -X DELETE "https://simpligastos.cl/api/v1/delegaciones/7e1a9c3d-5b2f-4d8e-a0c6-3f4b5a6d7e8f" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Simpligastos-Persona: 72efadfd-f668-4bec-a7c4-f728bbe2e3ca"

const respuesta = await fetch("https://simpligastos.cl/api/v1/delegaciones/7e1a9c3d-5b2f-4d8e-a0c6-3f4b5a6d7e8f", {
  method: "DELETE",
  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.delete(
    "https://simpligastos.cl/api/v1/delegaciones/7e1a9c3d-5b2f-4d8e-a0c6-3f4b5a6d7e8f",
    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

{
  "ok": true
}