Datos del portafolio

Lee facturas y su rastro del esquema lynx por PostgREST, con la sesión y la seguridad a nivel de fila.

Lynx expone los datos del portafolio a través de la API PostgREST del esquema lynx. Se lee con el token de sesión y la clave publicable; la seguridad a nivel de fila decide qué ve cada sesión. Apunta al esquema con la cabecera Accept-Profile: lynx, o con .schema("lynx") en el cliente de Supabase.

Listar facturas

La función einvoice_rows devuelve las facturas de la organización, opcionalmente filtradas por periodo (YYYY-MM) y empresa.

POST /rest/v1/rpc/einvoice_rows

curl -X POST "$LYNX_SUPABASE_URL/rest/v1/rpc/einvoice_rows" \
  -H "Authorization: Bearer $LYNX_TOKEN" \
  -H "apikey: $LYNX_ANON_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept-Profile: lynx" \
  -d '{ "p_org": "3f1c9a2e-…", "p_period": "2026-09", "p_company": null }'

import { createClient } from "@supabase/supabase-js";

const supabase = createClient(process.env.LYNX_SUPABASE_URL, process.env.LYNX_ANON_KEY);
// La sesión de la persona autentica la llamada; la RLS decide qué ve.
const { data, error } = await supabase.schema("lynx")
  .rpc("einvoice_rows", { p_org, p_period: "2026-09", p_company: null });

El rastro de una factura

Con una factura a mano, lee su detalle de las tablas, filtrando por id:

Tabla	Filtro	Contiene
`invoice_lines`	`invoice_id=eq.<uuid>`	Las líneas: descripción, cantidad, precio unitario, impuestos.
`dian_events`	`submission_id=eq.<uuid>`	Los eventos ante la DIAN de una transmisión.
`invoice_deliveries`	`invoice_id=eq.<uuid>`	Los intentos de entrega y su estado.
`credit_notes`	`invoice_id=eq.<uuid>`	Notas crédito emitidas sobre la factura.

Selecciona solo lo que necesitas

Usa el select de PostgREST para elegir columnas, p. ej. ?invoice_id=eq.<uuid>&select=id,description,amount,tax_amount.

Mira cada campo en la referencia de la API.