Saltar al contenido
Falmus

Integra la facturación de Falmus en tu aplicación

Emite y consulta documentos fiscales, sincroniza catálogos y administra puntos de venta conectados directamente al Servicio de Impuestos Nacionales (SIAT).

Autenticación:X-API-Key
Base URL:https://staging-api.falmus.com/api/v1

Primeros pasos

Tu primera solicitud

Crea una clave API desde la consola Falmus y envíala en la cabecera X-API-Key. La clave delimita de forma segura la empresa, ambiente (piloto o producción) y los permisos asignados.

  1. 01

    Crea tu clave API

    Desde la consola en Empresas > Claves API, genera una clave con los alcances necesarios.

  2. 02

    Almacénala en el backend

    Guárdala en una variable de entorno de tu servidor o microservicio; nunca la expongas en clientes web públicos.

  3. 03

    Envía la cabecera HTTP

    Todas las operaciones de la API validan autenticidad mediante la cabecera X-API-Key.

cURL · consultar estado de catálogos
export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'

curl --request GET \
  --url "$FALMUS_API_URL/catalogos-siat/estado" \
  --header "X-API-Key: $FALMUS_API_KEY"

La clave del ejemplo es ficticia. Reemplázala por una clave de pruebas creada en tu cuenta.

Referencia de rutas

Módulos y áreas de la API

Estructurada modularmente con especificaciones completas de cabeceras, parámetros, payloads JSON y respuestas.