---
title: "Descargar archivo de documento"
description: "Descarga un archivo como recurso binario. Usa preview_pdf para renderizar un borrador CFDI sin timbrar; la vista previa no tiene validez fiscal."
language: es-MX
canonical_url: "https://exac.mx/docs/mcp/tools/get_document_file"
md_url: "https://exac.mx/docs/mcp/tools/get_document_file.md"
---

# Descargar archivo de documento

Descarga un archivo como recurso binario. Usa preview_pdf para renderizar un borrador CFDI sin timbrar; la vista previa no tiene validez fiscal.

Herramienta: `get_document_file`

## Propósito

Descarga un archivo como recurso binario. Usa preview_pdf para renderizar un borrador CFDI sin timbrar; la vista previa no tiene validez fiscal.

### Úsala cuando

Tienes un documentRef y necesitas un archivo disponible, incluida la vista previa de un borrador CFDI.

### No la uses cuando

Necesitas metadatos o una familia de documento no compatible.

| Detalle | Valor |
| --- | --- |
| Permisos | invoices:read / receipts:read / quotes:read / sat:read |
| Efectos secundarios | Ninguno |
| Idempotencia | Idempotente |

## Esquema de entrada

```json
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^cfdi:.+$",
          "description": "CFDI documentRef returned by search_documents"
        },
        "file": {
          "type": "string",
          "enum": [
            "pdf",
            "xml",
            "zip",
            "preview_pdf",
            "cancellation_pdf",
            "cancellation_xml"
          ]
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^withholding:.+$",
          "description": "Withholding documentRef returned by search_documents"
        },
        "file": {
          "type": "string",
          "enum": [
            "pdf",
            "xml",
            "zip"
          ]
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^sales_receipt:.+$"
        },
        "file": {
          "type": "string",
          "const": "pdf"
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^quote:.+$"
        },
        "file": {
          "type": "string",
          "const": "pdf"
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^declaration:.+$"
        },
        "file": {
          "type": "string",
          "enum": [
            "pdf",
            "payment_pdf",
            "full_pdf"
          ]
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "documentRef": {
          "type": "string",
          "pattern": "^tax_compliance_opinion:.+$"
        },
        "file": {
          "type": "string",
          "const": "pdf"
        }
      },
      "required": [
        "documentRef",
        "file"
      ],
      "additionalProperties": false
    }
  ]
}
```

## Herramientas relacionadas

- [`search_documents`](/docs/mcp/tools/search_documents.md) — **Buscar documentos**: Busca una familia de documentos usando referencias públicas estables.

- [`get_document`](/docs/mcp/tools/get_document.md) — **Leer documento**: Recupera un documento mediante su documentRef público.

- [`send_document`](/docs/mcp/tools/send_document.md) — **Enviar documento**: Entrega un CFDI, retención, recibo de venta o cotización a un destinatario.

## Flujo relacionado

[Consulta los flujos canónicos en la introducción](/docs.md)

## Operaciones REST equivalentes

- [`GET /v1/documents/{documentRef}/files/{file}`](/docs/api/documents/files-and-delivery/download-document-file.md)

Documentación completa: https://exac.mx/docs.md
Índice para agentes: https://exac.mx/docs/llms.txt