Empezar

Primeros pasos

Crea una llave en el panel y haz tu primer pedido en dos minutos.

Crear una llave

Entra al panel con una cuenta de administración y abre Integraciones.
Elige Nueva llave, escribe para qué sistema es (por ejemplo, el ERP de contabilidad) y el permiso: Solo lectura para reportes o Lectura y escritura si vas a crear o cambiar algo.
Copia la llave: se muestra una sola vez. Si se pierde, revócala y crea otra.

Guárdala en una variable de entorno, no en el código. Todos los ejemplos de esta documentación la leen de ahí:

Terminal

export SIMPLIGASTOS_LLAVE="sg_ejemplo_reemplaza_por_tu_llave"

¿Todavía no tienes cuenta? Crea una desde la página de inicio; la API viene en todos los planes, también en el gratis.

Tu primer pedido

GET /yo dice de qué empresa es la llave y con qué roles actúa. Es la forma más corta de saber que todo está bien.

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()

La respuesta

Cada llave actúa como una persona técnica, con roles de contabilidad y administración, que no aparece en las listas de la empresa.

200 OK

{
  "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
  }
}

Si responde 401, la llave no se copió entera o fue revocada. Revisa que el encabezado sea exactamente Authorization: Bearer sg_..., con un espacio después de Bearer.

Siguiente paso

Un pedido útil de verdad: las rendiciones aprobadas que tu ERP todavía no registra, de a 50.

curl "https://simpligastos.cl/api/v1/rendiciones?estado=aprobada&contabilizada=0&limite=50" \
  -H "Authorization: Bearer $SIMPLIGASTOS_LLAVE"

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

Sigue con Autenticación para actuar en nombre de una persona, o salta a la referencia de rendiciones.