> ## 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.

# Inicio rápido

> Creá una clasificación, esperá el dictamen y leelo, en tres pedidos.

<Steps>
  <Step title="Conseguí una key">
    En la app, **Ajustes → API → Crear key**, con alcance `classify`. Guardala en una variable de entorno:

    ```bash theme={null}
    export NOMENCLATOR_API_KEY="nmc_live_..."
    ```
  </Step>

  <Step title="Creá la clasificación">
    Mandá la descripción, el tipo de operación y el país. El header `Idempotency-Key` es obligatorio: usá un valor único por clasificación, por ejemplo el id del pedido en tu sistema.

    <CodeGroup>
      ```bash curl theme={null}
      curl https://api.nomenclator.com.ar/v1/classifications \
        -H "Authorization: Bearer $NOMENCLATOR_API_KEY" \
        -H "Content-Type: application/json" \
        -H "Idempotency-Key: erp-pedido-000123-a" \
        -d '{
          "operation": "import",
          "country": "CN",
          "description": "Bomba centrifuga monobloc de 3 HP, cuerpo de hierro fundido, para agua limpia, uso industrial.",
          "file_url": null,
          "external_reference": "PED-000123"
        }'
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch("https://api.nomenclator.com.ar/v1/classifications", {
        method: "POST",
        headers: {
          Authorization: `Bearer ${process.env.NOMENCLATOR_API_KEY}`,
          "Content-Type": "application/json",
          "Idempotency-Key": "erp-pedido-000123-a",
        },
        body: JSON.stringify({
          operation: "import",
          country: "CN",
          description:
            "Bomba centrifuga monobloc de 3 HP, cuerpo de hierro fundido, para agua limpia, uso industrial.",
          file_url: null,
          external_reference: "PED-000123",
        }),
      });
      const accepted = await response.json();
      ```

      ```python Python theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.nomenclator.com.ar/v1/classifications",
          headers={
              "Authorization": f"Bearer {os.environ['NOMENCLATOR_API_KEY']}",
              "Idempotency-Key": "erp-pedido-000123-a",
          },
          json={
              "operation": "import",
              "country": "CN",
              "description": "Bomba centrifuga monobloc de 3 HP, cuerpo de hierro fundido, para agua limpia, uso industrial.",
              "file_url": None,
              "external_reference": "PED-000123",
          },
          timeout=30,
      )
      accepted = response.json()
      ```
    </CodeGroup>

    Responde `202` enseguida, todavía sin dictamen:

    ```json theme={null}
    {
      "id": "cls_7K4M2P9QX3RT",
      "status": "in_progress",
      "stage": "extraction",
      "app_url": "https://app.nomenclator.com.ar/o/tu-estudio/clasificaciones/cls_7K4M2P9QX3RT"
    }
    ```
  </Step>

  <Step title="Esperá el resultado">
    Consultá la clasificación **cada 3 segundos** hasta que `status` deje de ser `in_progress`. Suele tardar alrededor de un minuto.

    ```bash theme={null}
    curl https://api.nomenclator.com.ar/v1/classifications/cls_7K4M2P9QX3RT \
      -H "Authorization: Bearer $NOMENCLATOR_API_KEY"
    ```
  </Step>

  <Step title="Leé el dictamen">
    Con `status: "resolved"`, `candidates` trae hasta tres opciones. La de `rank: 1` es la recomendada:

    ```json theme={null}
    {
      "id": "cls_7K4M2P9QX3RT",
      "status": "resolved",
      "chosen_ncm": "84137010",
      "candidates": [
        {
          "rank": 1,
          "ncm": "84137010",
          "description": "Bombas centrífugas monocelulares",
          "confidence": 91,
          "confidence_band": "high",
          "rationale": "…",
          "applied_rules": ["1", "6"],
          "sim": { "status": "auto_selected", "code": "8413701010", "options": [], "verified_at": "2026-09-23T14:06:10Z" }
        }
      ],
      "pdf_url": "https://…"
    }
    ```

    El ejemplo está recortado; la forma completa está en [obtener una clasificación](/api-reference/obtener-una-clasificacion).
  </Step>
</Steps>

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Si pide más datos" icon="circle-question" href="/api/ciclo-de-una-clasificacion">
    Qué hacer con `pending_data` y cómo responder.
  </Card>

  <Card title="Clasificar con ficha técnica" icon="file-pdf" href="/api/fichas-tecnicas">
    Subir un PDF y usarlo en la clasificación.
  </Card>
</CardGroup>

<Warning>
  Cada clasificación que llega a `resolved` se factura en el medidor, también las que crees desde el playground de esta documentación.
</Warning>