---
name: pdf_save
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def pdf_save(doc, output_path) -> str | bytes"
description: "Serializa el documento PDF a disco o retorna los bytes en memoria. Si output_path es None retorna bytes para transmision directa (HTTP response, almacenamiento en BD). Si se especifica, escribe el archivo y retorna el path."
tags: [pdf, save, output, builder, infra]
uses_functions: []
uses_types: [pdf_doc_py_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: doc
    desc: "PDFDoc con al menos una pagina y contenido añadido"
  - name: output_path
    desc: "ruta del archivo PDF a crear en disco; None retorna bytes del PDF en memoria"
output: "output_path (str) si se escribio a disco, o bytes del PDF si output_path es None"
tested: true
tests: ["guardar PDF a archivo", "retornar bytes del PDF", "PDF valido comienza con %PDF"]
test_file_path: "python/functions/infra/pdf_save_test.py"
file_path: "python/functions/infra/pdf_save.py"
---

## Ejemplo

```python
# Guardar a disco
path = pdf_save(doc, "reporte.pdf")
print(f"PDF guardado en: {path}")

# Obtener bytes (para HTTP response o guardar en BD)
pdf_bytes = pdf_save(doc)
assert pdf_bytes[:4] == b"%PDF"

# En un endpoint web (ejemplo conceptual)
return Response(pdf_save(doc), content_type="application/pdf")
```

## Notas

Llama a `fpdf2.output()`. Si el documento usa `alias_nb_pages()` (activado por `pdf_add_header_footer` con `page_numbers=True`), fpdf2 reemplaza el alias con el total real de paginas al serializar. Para retornar bytes, `output()` retorna un `bytearray` que se convierte a `bytes` para compatibilidad con APIs que esperan `bytes`.
