Almacenamiento y retención

Facta no es el archivo fiscal de nadie: el documento firmado tiene que aterrizar en un destino de almacenamiento que la empresa controla. Esta guía cuenta las dos piezas que hacen eso cierto — el requisito de tener un destino conectado, y la copia temporal que existe mientras esa escritura se confirma.

Un destino conectado es un requisito, no un extra

Antes de reservar cualquier correlativo, el servidor comprueba que la empresa tiene al menos un destino de almacenamiento —Drive, S3, R2, Supabase Storage, FTP/SFTP— conectado y verificado en los últimos 30 días. Sin eso, la petición se detiene con 422 no_storage_destination, y no gasta correlativo: corre antes que nada más, porque firmar un documento que no tiene dónde aterrizar lo dejaría sin ninguna copia salvo la de esa misma respuesta HTTP — y esa respuesta se pierde con el primer proceso que se cae.

Conecte el destino desde la app (vea el paso correspondiente en Empezar); no hay forma de resolver este error desde la API.

El área de retención: una copia de una hora

Cuando un documento se firma, una copia cifrada queda además en un área de retención propia de Facta, durante una hora. No es el destino real — es la red de seguridad para el tramo entre que el documento se firma y que su escritura al destino real se confirma.

GET /v1/dte/holding lista lo que hay ahí ahora mismo: evidencia de estado —dónde aterrizó, cuántos intentos, cuándo vence, cuántas veces se descargó—, nunca rutas de bucket ni el contenido en sí.

curl "$FACTA_API_BASE_URL/v1/dte/holding?limit=50" \
  -H "X-Facta-Key: $FACTA_API_KEY"

Pasada la hora, la descarga sigue funcionando

GET /v1/dte/{codigoGeneracion}/file no deja de contestar cuando la hora de retención termina: el documento se rearma desde la reserva del correlativo, que guarda el JWS sellado de forma permanente. La retención de una hora es sobre la copia de emergencia, no sobre la capacidad de recuperar el documento — vea Descargar el JSON y el PDF para el detalle completo.

Lo que este cliente todavía no hace

Otras guías