Saltar al contenido

Referencia

Configuración

Categorías, centros de costo, campos propios, política de gastos, flujos de aprobación y agentes.

Listar categorías

GET/api/v1/categorias

Con su cuenta contable y su tope por gasto.

Parámetros de consulta

activas1
Solo las activas.

Pedido

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

Respuesta

Respuesta 200
{
  "categorias": [
    {
      "id": "b4beec61-4ea4-41ae-839b-56365013bd74",
      "nombre": "Alimentación",
      "codigoContable": "5106",
      "tope": null,
      "activa": true
    }
  ]
}

Crear una categoría

POST/api/v1/categorias

tope en pesos enteros: un gasto por sobre él queda fuera de política.

  • Quién: Administración y contabilidad.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 60 caracteres.
codigoContabletexto o null
Hasta 30 caracteres.
topeentero o null
Mayor que 0.
activabooleano
Por omisión: true.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/categorias" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Alimentación","codigoContable":"5106","tope":25000}'

Respuesta

Respuesta 201
{
  "id": "b4beec61-4ea4-41ae-839b-56365013bd74"
}

Cambiar una categoría

PATCH/api/v1/categorias/{id}

Manda la categoría completa; activa: false la saca de las opciones.

  • Quién: Administración y contabilidad.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 60 caracteres.
codigoContabletexto o null
Hasta 30 caracteres.
topeentero o null
Mayor que 0.
activabooleano
Por omisión: true.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/categorias/b4beec61-4ea4-41ae-839b-56365013bd74" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Alimentación","codigoContable":"5106","tope":30000,"activa":true}'

Respuesta

Respuesta 200
{
  "ok": true
}

Listar centros de costo

GET/api/v1/centros-costo

Parámetros de consulta

activos1
Solo los activos.

Pedido

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

Respuesta

Respuesta 200
{
  "centrosCosto": [
    {
      "id": "51e6abca-a8e0-4fbd-adf1-ebfe070f272d",
      "nombre": "Faena Antofagasta",
      "codigo": "CC-11",
      "activo": true
    }
  ]
}

Crear un centro de costo

POST/api/v1/centros-costo

codigo es el que va en el asiento.

  • Quién: Administración y contabilidad.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 80 caracteres.
codigotexto o null
Hasta 30 caracteres.
activobooleano
Por omisión: true.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/centros-costo" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Faena Antofagasta","codigo":"CC-11"}'

Respuesta

Respuesta 201
{
  "id": "51e6abca-a8e0-4fbd-adf1-ebfe070f272d"
}

Cambiar un centro de costo

PATCH/api/v1/centros-costo/{id}

Manda el centro completo.

  • Quién: Administración y contabilidad.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 80 caracteres.
codigotexto o null
Hasta 30 caracteres.
activobooleano
Por omisión: true.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/centros-costo/51e6abca-a8e0-4fbd-adf1-ebfe070f272d" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Faena Antofagasta","codigo":"CC-11","activo":true}'

Respuesta

Respuesta 200
{
  "ok": true
}

Listar campos propios

GET/api/v1/campos

Campos que la empresa agrega a gastos o rendiciones (por ejemplo, número de obra). Sus valores van en campos de cada gasto o rendición.

Parámetros de consulta

entidadtexto
gasto o rendicion.
activos1
Solo los que se llenan hoy.

Pedido

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

Respuesta

Respuesta 200
{
  "campos": [
    {
      "id": "9a4e2c71-0b3d-4e8f-a6c5-2f1d7e8b9c0a",
      "entidad": "gasto",
      "nombre": "Número de obra",
      "tipo": "texto",
      "opciones": [],
      "obligatorio": false,
      "activo": true,
      "orden": 0
    }
  ]
}

Crear un campo propio

POST/api/v1/campos

tipo lista necesita opciones.

  • Quién: Administración.

Cuerpo (JSON)

entidadtextoobligatorio
Uno de: gasto, rendicion.
nombretextoobligatorio
De 1 a 60 caracteres.
tipotextoobligatorio
Uno de: texto, numero, lista, fecha.
opcioneslista de texto
Hasta 100 elementos.
obligatoriobooleano
Por omisión: false.
activobooleano
Por omisión: true.
ordenentero
De 0 a 1.000. Por omisión: 0.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/campos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"entidad":"gasto","nombre":"Número de obra","tipo":"texto"}'

Respuesta

Respuesta 201
{
  "id": "9a4e2c71-0b3d-4e8f-a6c5-2f1d7e8b9c0a"
}

Cambiar un campo propio

PATCH/api/v1/campos/{id}

Manda el campo completo.

  • Quién: Administración.

Cuerpo (JSON)

entidadtextoobligatorio
Uno de: gasto, rendicion.
nombretextoobligatorio
De 1 a 60 caracteres.
tipotextoobligatorio
Uno de: texto, numero, lista, fecha.
opcioneslista de texto
Hasta 100 elementos.
obligatoriobooleano
Por omisión: false.
activobooleano
Por omisión: true.
ordenentero
De 0 a 1.000. Por omisión: 0.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/campos/9a4e2c71-0b3d-4e8f-a6c5-2f1d7e8b9c0a" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"entidad":"gasto","nombre":"Número de obra","tipo":"texto","obligatorio":true}'

Respuesta

Respuesta 200
{
  "ok": true
}

Ver la política de gastos

GET/api/v1/politica

Documentos aceptados, plazo para rendir, topes, tarifa por km y doble factor obligatorio.

Pedido

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

Respuesta

Respuesta 200
{
  "politica": {
    "documentosAceptados": [
      "boleta",
      "factura",
      "sin_documento"
    ],
    "plazoDias": null,
    "palabrasProhibidas": [],
    "topeSinDocumento": 10000,
    "autoTopeGasto": null,
    "autoTopeRendicion": null,
    "kmTarifa": 180,
    "kmBloquearMonto": true,
    "dobleFactorObligatorio": false
  }
}

Cambiar la política de gastos

PUT/api/v1/politica

Manda la política completa.

  • Quién: Administración.

Cuerpo (JSON)

documentosAceptadoslista de textoobligatorio
Valores: boleta, boleta_exenta, factura, factura_exenta, boleta_honorarios, nota_credito, comprobante, otro, sin_documento, kilometraje.
plazoDiasentero o nullobligatorio
De 1 a 365.
palabrasProhibidaslista de textoobligatorio
Hasta 50 elementos.
topeSinDocumentoentero o null
Mayor que 0.
kmTarifaentero o null
De 1 a 10.000.
kmBloquearMontobooleano
Por omisión: false.
dobleFactorObligatoriobooleano
Por omisión: false.
autoTopeGastoentero o null
Mayor que 0.
autoTopeRendicionentero o null
Mayor que 0.

Pedido

curl -X PUT "https://simpligastos.cl/api/v1/politica" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"documentosAceptados":["boleta","factura","sin_documento"],"plazoDias":30,"palabrasProhibidas":["botillería"],"topeSinDocumento":10000,"kmTarifa":180}'

Respuesta

Respuesta 200
{
  "ok": true
}

Listar flujos de aprobación

GET/api/v1/flujos

Qué pasos sigue una rendición según su monto, categorías, centros, grupos o personas. Sin flujo que calce, decide la jefatura o cualquier aprobador.

Pedido

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

Respuesta

Respuesta 200
{
  "flujos": [
    {
      "id": "4d6f8a2b-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
      "nombre": "Sobre un millón",
      "orden": 0,
      "activo": true,
      "montoDesde": 1000000,
      "montoHasta": null,
      "categoriaIds": [],
      "centroCostoIds": [],
      "grupoIds": [],
      "personaIds": [],
      "pasos": [
        {
          "tipo": "jefatura",
          "personaId": null,
          "rol": null,
          "grupoId": null
        },
        {
          "tipo": "rol",
          "personaId": null,
          "rol": "contabilidad",
          "grupoId": null
        }
      ]
    }
  ]
}

Crear un flujo de aprobación

POST/api/v1/flujos

De 1 a 10 pasos, en orden.

  • Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 80 caracteres.
ordenentero
De 0 a 1.000. Por omisión: 0.
activobooleano
Por omisión: true.
montoDesdeentero o null
Desde 0.
montoHastaentero o null
Mayor que 0.
categoriaIdslista de id
Hasta 200 elementos.
centroCostoIdslista de id
Hasta 200 elementos.
grupoIdslista de id
Hasta 200 elementos.
personaIdslista de id
Hasta 2.000 elementos.
pasoslista de objetoobligatorio
De 1 a 10 elementos.
pasos[].tipotextoobligatorio
Uno de: jefatura, persona, rol, grupo.
pasos[].personaIdid o null
Opcional.
pasos[].roltexto o null
Uno de: aprobador, contabilidad, administrador.
pasos[].grupoIdid o null
Opcional.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/flujos" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Sobre un millón","montoDesde":1000000,"pasos":[{"tipo":"jefatura"},{"tipo":"rol","rol":"contabilidad"}]}'

Respuesta

Respuesta 201
{
  "id": "4d6f8a2b-1c3e-4a5b-8d7f-9e0a1b2c3d4e"
}

Cambiar un flujo de aprobación

PATCH/api/v1/flujos/{id}

Manda el flujo completo. Lo que ya está en aprobación sigue con los pasos que tenía.

  • Quién: Administración.

Cuerpo (JSON)

nombretextoobligatorio
De 1 a 80 caracteres.
ordenentero
De 0 a 1.000. Por omisión: 0.
activobooleano
Por omisión: true.
montoDesdeentero o null
Desde 0.
montoHastaentero o null
Mayor que 0.
categoriaIdslista de id
Hasta 200 elementos.
centroCostoIdslista de id
Hasta 200 elementos.
grupoIdslista de id
Hasta 200 elementos.
personaIdslista de id
Hasta 2.000 elementos.
pasoslista de objetoobligatorio
De 1 a 10 elementos.
pasos[].tipotextoobligatorio
Uno de: jefatura, persona, rol, grupo.
pasos[].personaIdid o null
Opcional.
pasos[].roltexto o null
Uno de: aprobador, contabilidad, administrador.
pasos[].grupoIdid o null
Opcional.

Pedido

curl -X PATCH "https://simpligastos.cl/api/v1/flujos/4d6f8a2b-1c3e-4a5b-8d7f-9e0a1b2c3d4e" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Sobre un millón","montoDesde":1000000,"activo":false,"pasos":[{"tipo":"jefatura"}]}'

Respuesta

Respuesta 200
{
  "ok": true
}

Borrar un flujo de aprobación

DELETE/api/v1/flujos/{id}
  • Quién: Administración.

Pedido

curl -X DELETE "https://simpligastos.cl/api/v1/flujos/4d6f8a2b-1c3e-4a5b-8d7f-9e0a1b2c3d4e" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}

Ver los agentes

GET/api/v1/agentes

Configuración y métricas de los agentes de la empresa (rendidor, revisor, auditor, conciliador) y sus acciones recientes. Se prenden y se ajustan desde el panel.

Pedido

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

Respuesta

Respuesta 200
{
  "porAgente": {
    "revisor": {
      "acciones": 25,
      "revertidas": 0,
      "minutos": 25,
      "activo": true,
      "nivel": "sugiere",
      "parametros": {}
    }
  },
  "recientes": [
    {
      "id": "870a6d99-23db-4fe6-84f4-7ec807e9d393",
      "agente": "auditor",
      "entidad": "gasto",
      "entidadId": "692bc3e9-3f67-4822-8997-01522264f226",
      "accion": "alerta",
      "motivo": "Ignacio Vera rindió 3 gastos el mismo día en Ferretería El Perno",
      "creadaEn": "2026-10-11T15:38:27.640Z",
      "revertida": false
    }
  ]
}

Revertir lo que hizo un agente

POST/api/v1/agentes/acciones/{id}/revertir

Deshace una acción de un agente (por ejemplo, una aprobación automática).

  • Quién: Administración.

Pedido

curl -X POST "https://simpligastos.cl/api/v1/agentes/acciones/870a6d99-23db-4fe6-84f4-7ec807e9d393/revertir" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

Respuesta

Respuesta 200
{
  "ok": true
}