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

# API de Nomenclator

> Clasificá productos en NCM de 8 dígitos y consultá dictámenes desde tus propios sistemas.

La API te deja hacer desde tu ERP, tu sitio o tus procesos lo mismo que hacés en la app: crear clasificaciones, consultar el dictamen, descargar el PDF y consultar aranceles y aperturas SIM. Cada clasificación hecha por API queda en el **historial de tu organización**, con la etiqueta **API**.

```text theme={null}
https://api.nomenclator.com.ar/v1
```

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="bolt" href="/api/inicio-rapido">
    Tu primera clasificación en cinco minutos.
  </Card>

  <Card title="Autenticación" icon="key" href="/api/autenticacion">
    Crear una key y usarla.
  </Card>

  <Card title="Ciclo de una clasificación" icon="arrows-spin" href="/api/ciclo-de-una-clasificacion">
    Estados, consultas periódicas y preguntas.
  </Card>

  <Card title="Errores" icon="triangle-exclamation" href="/api/errores">
    El formato y el catálogo completo.
  </Card>
</CardGroup>

## Quién puede usarla

La API está disponible en el plan **Profesional**. En **Enterprise** se acuerda en cada contrato. Si tu organización todavía no la tiene, [agendá una demo](https://nomenclator.com.ar/demo) o escribinos a [hola@nomenclator.com.ar](mailto:hola@nomenclator.com.ar).

## Cómo se factura

El uso por API **no consume los créditos del plan**: cada clasificación resuelta se factura aparte, en un medidor mensual. Mirá [facturación](/api/facturacion).

## Convenciones

| Tema           | Regla                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| Formato        | JSON en el cuerpo y en la respuesta.                                                                                 |
| Fechas         | RFC 3339 en UTC, con `Z`: `2026-09-23T14:05:00Z`.                                                                    |
| Montos         | Entero en la unidad menor de la moneda, más la moneda ISO 4217: `{ "amount": 200, "currency": "USD" }` son USD 2,00. |
| NCM            | 8 dígitos, sin puntos: `84137010`. La SIM, 10 dígitos.                                                               |
| Países         | ISO 3166-1 alfa-2: `CN`, `BR`.                                                                                       |
| Ids            | Opacos y con prefijo: `cls_…` para clasificaciones, `req_…` para pedidos.                                            |
| Errores        | `application/problem+json` (RFC 9457).                                                                               |
| Valores nuevos | Los campos con valores cerrados, como `status`, pueden sumar valores. Tu integración tiene que tolerarlos.           |

Cada respuesta trae el header `X-Request-Id`. Si nos escribís por un problema, citalo.

## Uso permitido

La API es para uso propio de tu organización o al servicio de tus propios clientes. No se puede sublicenciar, revender ni ofrecer como servicio propio, y las keys quedan atadas a la organización que contrató el plan. El texto completo está en los [Términos](https://nomenclator.com.ar/terminos).

<Note>
  El dictamen es una segunda opinión auditable. La responsabilidad de la clasificación sigue siendo del despachante o importador que la presenta.
</Note>