Contrato FFI

Referencia técnica para contrato ffi dentro del cliente local.

Bandeja REST local Arquitectura FFI Recuperación

Principio

La FFI es la superficie estable para que un host externo use el cliente local sin conocer detalles internos de persistencia, colas o SQLite.

Operaciones de alto nivel

bootstrap
sync_terminal
reserve_ranges
emit_xml
flush_outbox
get_state
get_health

Operaciones granulares

prepare_draft
sign_only
enqueue_signed
get_ranges
get_drafts
get_outbox
reconcile_state
get_pending_failures
retry_failed
test_printer
reprint_cfe

Contrato de respuesta

Toda operación debe interpretarse con el mismo envelope:

ok
payload
error
code
stage
retryable

Recomendaciones

no parsear mensajes libres para tomar decisiones
usar code y stage
tratar retryable=true como candidato a worker o backoff
registrar siempre uuid, tipo_cfe, profile_id y operation_id del lado host

Reimpresión

La operación reprint_cfe permite volver a imprimir un comprobante ya emitido y persistido localmente.

Acepta dos formas de localizar el comprobante:

por uuid
por tipo_cfe + serie + numero

La búsqueda siempre queda acotada al contexto del perfil activo, por lo que el host debe enviar el context correcto con cod_comercio y cod_terminal.