Solicitud

Identificador único de la solicitud. Es un valor tipo GUID generado por el cliente para garantizar que la petición sea única

Identificador único del suscriptor autorizado en el sistema https://apps.kiai.co/facturacion. Este valor debe coincidir con un suscriptor previamente registrado y autorizado para emitir documentos electrónicos.

Clave de idempotencia de la petición, generada por el cliente (patrón Idempotency-Key de Stripe/PayPal/AWS). Identifica una factura lógica, no un intento de envío. Obligatoria únicamente para suscriptores con SuscAdministraConsecutivo activo, en los que Kiai genera el consecutivo. Para el resto se ignora y el comportamiento no cambia (por eso no lleva [Required]: exigirla siempre rompería a todos los suscriptores actuales). Reglas: única por factura lógica y estable entre reintentos de esa misma factura. Reenviar la misma clave con el mismo contenido devuelve el documento ya emitido, sin consumir otro consecutivo. Reutilizarla con un contenido distinto produce un error explícito.

Sede desde la que se emite, cuando la empresa factura desde varias y cada una tiene su propia resolución. Es el identificador que Kiai entrega por sede; el cliente no lo inventa. Opcional. Se omite si la empresa factura desde una sola sede, y se ignora por completo en los suscriptores donde Kiai no administra el consecutivo. Es lo que reemplaza a enviar el prefijo o el número de resolución: el cliente dice de qué sede es la factura y Kiai resuelve con qué resolución sale. Así, al renovar una resolución —que cambia prefijo y número— la integración del cliente no se toca.