Guía rápida

Transmite una factura a la DIAN desde el Edge Function de facturación electrónica de Lynx en pocos minutos.

Antes de empezar

La URL de Supabase de tu despliegue y su clave publicable (apikey).
Un token de sesión de un usuario con rol admin u operador en la organización. Ver Autenticación.
El org_id de tu organización y los invoice_id que quieres transmitir.

Todo es POST, con el token de sesión

Las operaciones de facturación solo aceptan POST, y cada llamada necesita org_id. El token es el de la sesión de la persona, no una clave de API de larga vida.

Transmitir una factura

Llama a /transmit con la organización y las facturas. Hasta 50 por llamada; cada una se procesa por separado, así que un error en una no detiene las demás.

POST /functions/v1/lynx-einvoicing/transmit

curl -X POST "$LYNX_SUPABASE_URL/functions/v1/lynx-einvoicing/transmit" \
  -H "Authorization: Bearer $LYNX_TOKEN" \
  -H "apikey: $LYNX_ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "org_id": "3f1c9a2e-…", "invoice_ids": ["7b2e…", "9c4a…"] }'

# 200 OK
{ "results": [ { "invoice_id": "7b2e…", "status": "transmitida", "message": "Aceptada por la DIAN" } ] }

const res = await fetch(`${process.env.LYNX_SUPABASE_URL}/functions/v1/lynx-einvoicing/transmit`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    apikey: process.env.LYNX_ANON_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ org_id, invoice_ids: ["7b2e…", "9c4a…"] }),
});
const { results } = await res.json();

Leer el resultado

La respuesta trae un arreglo results, una entrada por factura:

Campo	Significado
`invoice_id`	La factura a la que se refiere la entrada.
`status`	Su estado tras la llamada, p. ej. `transmitida` o `error`.
`message`	Un detalle legible.

Siguientes pasos

Maneja errores y reintentos.
Mira cada operación en Facturación electrónica.
Lee facturas en Datos del portafolio.