Descargar el JSON y el PDF

GET /v1/dte/{codigoGeneracion}/file entrega los bytes exactos que se archivaron al firmar — nunca parseados ni vueltos a serializar. Con ?kind=json (el valor por defecto) es el JSON firmado; con ?kind=pdf, la representación gráfica.

curl "$FACTA_API_BASE_URL/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json" \
  -H "X-Facta-Key: $FACTA_API_KEY" \
  -o 7875BC7A.json

Por qué son los bytes exactos, y no un JSON reconstruido

Volver a serializar el objeto documento no reproduce los mismos bytes cuya firma validó Hacienda — el orden de las claves, los espacios, la codificación de un acento, todo cuenta para una firma criptográfica. Por eso el archivo que llega aquí es el mismo que se guardó al firmar, sin pasar por un JSON.stringify nuevo: { "codigoGeneracion", "ambiente", "jws" }, el mismo jws compacto que ya recibió en la respuesta de /v1/dte o /v1/dte/sign.

El área de retención dura una hora, y la ruta sigue contestando después

La retención es una copia cifrada de una hora del documento firmado, para el caso en que la escritura a su destino de almacenamiento real falle. No es el archivo fiscal de nadie — es la red de seguridad mientras esa escritura se confirma.

Pasada esa hora, esta ruta sigue contestando: el documento se rearma desde la reserva del correlativo, que guarda el JWS sellado permanentemente. Los bytes son los mismos; lo único que cambia es de dónde salen.

El PDF es null hasta que hay sello

representacionGrafica en la respuesta de emisión —y por tanto el kind=pdf de esta ruta— no existe mientras el documento esté en contingencia: la hoja lleva el sello y el código QR del Ministerio, así que no se puede dibujar sin ellos. Un PDF ausente no invalida el jws, que es el artefacto fiscal real.

El destino real, aparte

Nada de esto reemplaza tener su propio destino de almacenamiento conectado — es un requisito para emitir, no un extra (vea el paso correspondiente en Empezar). El área de retención es la copia de emergencia; su copia definitiva vive donde usted la conectó.

Otras guías