Inicio rápido

Conseguí una key

En la app, Ajustes → API → Crear key, con alcance classify. Guardala en una variable de entorno:

export NOMENCLATOR_API_KEY="nmc_live_..."

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.

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"
  }'

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();

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()

Responde 202 enseguida, todavía sin dictamen:

{
  "id": "cls_7K4M2P9QX3RT",
  "status": "in_progress",
  "stage": "extraction",
  "app_url": "https://app.nomenclator.com.ar/o/tu-estudio/clasificaciones/cls_7K4M2P9QX3RT"
}

Esperá el resultado

Consultá la clasificación cada 3 segundos hasta que status deje de ser in_progress. Suele tardar alrededor de un minuto.

curl https://api.nomenclator.com.ar/v1/classifications/cls_7K4M2P9QX3RT \
  -H "Authorization: Bearer $NOMENCLATOR_API_KEY"

Leé el dictamen

Con status: "resolved", candidates trae hasta tres opciones. La de rank: 1 es la recomendada:

{
  "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.

Siguientes pasos

Si pide más datos

Qué hacer con pending_data y cómo responder.

Clasificar con ficha técnica

Subir un PDF y usarlo en la clasificación.

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

Empezá acá

Conceptos

Clasificaciones

Referencia arancelaria

Cuenta

Siguientes pasos

Si pide más datos

Clasificar con ficha técnica

​Siguientes pasos

Si pide más datos

Clasificar con ficha técnica

Siguientes pasos