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

# Fichas técnicas

> Subir un PDF y usarlo para clasificar.

Para clasificar con una ficha técnica en PDF, primero la subís y después mandás su `file_url` al crear la clasificación.

<Steps>
  <Step title="Pedí la URL de subida">
    ```bash theme={null}
    curl https://api.nomenclator.com.ar/v1/uploads \
      -H "Authorization: Bearer $NOMENCLATOR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "content_type": "application/pdf", "byte_size": 482133, "filename": "ficha-bomba.pdf" }'
    ```

    ```json theme={null}
    {
      "upload_url": "https://…",
      "file_url": "https://…",
      "expires_at": "2026-09-23T14:15:00Z"
    }
    ```
  </Step>

  <Step title="Subí el archivo">
    Un `PUT` con el PDF como cuerpo, antes de `expires_at` (10 minutos):

    ```bash theme={null}
    curl -X PUT "$UPLOAD_URL" \
      -H "Content-Type: application/pdf" \
      --data-binary @ficha-bomba.pdf
    ```
  </Step>

  <Step title="Clasificá con la ficha">
    ```json theme={null}
    {
      "operation": "import",
      "country": "CN",
      "description": null,
      "file_url": "https://…",
      "external_reference": null
    }
    ```
  </Step>
</Steps>

## Reglas

* Solo **PDF**, hasta **10 MB**. `byte_size` es el tamaño real del archivo; si pasa el máximo, `POST /uploads` responde `413 payload-too-large`.
* Podés mandar la ficha **con o sin** `description`. Si mandás las dos, el clasificador usa las dos.
* La ficha no cambia el precio: una clasificación resuelta se factura igual con o sin PDF.
* Si el PDF es un escaneo sin texto, no aporta datos. Sumá una `description`.

## Ficha en la ronda de preguntas

Cuando la clasificación está en `pending_data`, podés subir otro PDF de la misma forma y mandar su `file_url` junto con las respuestas.