> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

Obtenga una licencia, ejecute FineParser con Docker y analice su primer documento a DocLang en menos de cinco minutos.

<h2 id="before-you-begin">
  Antes de comenzar
</h2>

* [Docker](https://docs.docker.com/get-docker/) instalado y en ejecución
* Un PDF o archivo de imagen para analizar
* Un archivo de licencia de FineParser. Suscríbase a un plan en [fineparser.ai](https://www.fineparser.ai/#pricing) y recibirá un archivo `.fineparserlicense`. Consulte [Licencias y planes](/es/fine-parser/basics/licenses-and-plans).
* Acceso saliente al servidor de licencias de ABBYY. Si su red restringe el tráfico saliente, permita primero los rangos indicados en [Requisitos de red](/es/fine-parser/reference/data-privacy#network-requirements).

<Steps>
  <Step title="Obtener una licencia">
    Suscríbase a un plan en [fineparser.ai](https://www.fineparser.ai/#pricing). El plan gratuito le ofrece 1000 páginas al mes. Recibirá un archivo `.fineparserlicense` para su cuenta.
  </Step>

  <Step title="Iniciar FineParser">
    Pase el contenido de su archivo de licencia en la variable de entorno `FINEPARSER_LICENSE_DATA` y publique el puerto 8080:

    ```bash theme={null}
    docker run -d --name fineparser -p 8080:8080 \
      -e FINEPARSER_LICENSE_DATA="$(cat acme.fineparserlicense)" \
      -v fineparser-output:/app/output \
      abbyyteam/fineparser
    ```

    El volumen almacena los resultados del análisis. Sin él, se pierden al eliminarse el container.

    <Note>
      En un host ARM, como un Mac con Apple silicon, agregue `--platform linux/amd64` al comando anterior. Por ahora, la imagen es solo para amd64 y se ejecuta mediante emulación, lo que resulta más lento. Consulte [Ejecución en ARM](/es/fine-parser/basics/configuration#running-on-arm).
    </Note>

    A continuación, confirme que la licencia se aceptó:

    ```bash theme={null}
    curl -s localhost:8080/healthz
    # {"code":"ok","ready":true,"telemetry":true}
    ```

    Si `ready` es `false`, el campo `detail` de la respuesta indica el motivo. Consulte [Confirmar la licencia](/es/fine-parser/basics/configuration#confirming-the-license).
  </Step>

  <Step title="Enviar un documento">
    ```bash theme={null}
    curl -s -X POST http://localhost:8080/parse \
      -F "file=@invoice.pdf" \
      -F "outputType=doclang"
    ```

    FineParser acepta el documento y devuelve de inmediato un ID de trabajo:

    ```json theme={null}
    {"jobId":"6c4f1f0e-...","file":"invoice.pdf"}
    ```
  </Step>

  <Step title="Esperar a que finalice">
    Consulte el trabajo mediante su ID hasta que `status` sea `successful`:

    ```bash theme={null}
    curl -s http://localhost:8080/jobs/6c4f1f0e-...
    ```

    ```json theme={null}
    {"status":"successful","file":"6c4f1f0e-.../invoice.pdf.doclang"}
    ```

    Una factura de una página tarda unos segundos. Si `status` es `failed`, la respuesta incluye un campo `error` que explica el motivo.
  </Step>

  <Step title="Descargar el resultado">
    Anexe el valor de `file` a `/jobs/`:

    ```bash theme={null}
    curl -OJ http://localhost:8080/jobs/6c4f1f0e-.../invoice.pdf.doclang
    ```

    El archivo contiene la estructura y el texto del documento en DocLang:

    ```xml theme={null}
    <doclang>
      <heading level="1">Invoice 4471</heading>
      <table>
        <ched/>Item<ched/>Qty<ched/>Amount<nl/>
        <fcel/>Consulting<fcel/>12<fcel/>$4,800.00<nl/>
      </table>
    </doclang>
    ```

    Para cambiar el formato, sustituya `doclang` por `json` o `txt` en el paso de envío.
  </Step>
</Steps>

<h2 id="next-steps">
  Próximos pasos
</h2>

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/es/fine-parser/concepts/rest-api">
    Envío, consultar, descarga y todos los códigos de respuesta.
  </Card>

  <Card title="Formatos de salida" icon="file-code" href="/es/fine-parser/basics/output-formats">
    DocLang, JSON o texto sin formato.
  </Card>

  <Card title="Configuración" icon="sliders" href="/es/fine-parser/basics/configuration">
    Modo de reconocimiento, idiomas y puertos.
  </Card>

  <Card title="Agentes de programación con IA" icon="robot" href="/es/fine-parser/getting-started/ai-agents">
    Dé acceso a esta documentación a Claude Code o Codex.
  </Card>
</CardGroup>
