# Nomenclator

> Ayuda, referencia de la API y novedades de Nomenclator, la clasificación arancelaria NCM con justificación normativa.

- [Centro de ayuda](https://docs.nomenclator.com.ar/index.md): Todo lo que necesitás para clasificar con Nomenclator: guías paso a paso, respuestas a las dudas más comunes y la referencia de la API.
- [Qué es Nomenclator](https://docs.nomenclator.com.ar/ayuda/empezar/que-es-nomenclator.md): Clasificación arancelaria NCM con justificación normativa, para despachantes y equipos de comercio exterior.
- [Crear tu cuenta](https://docs.nomenclator.com.ar/ayuda/empezar/crear-tu-cuenta.md): Cómo conseguir acceso a Nomenclator y registrarte con un código o con una invitación.
- [Crear tu organización](https://docs.nomenclator.com.ar/ayuda/empezar/crear-tu-organizacion.md): El alta en dos pasos: tu perfil y los datos de tu organización.
- [Tu primera clasificación](https://docs.nomenclator.com.ar/ayuda/empezar/tu-primera-clasificacion.md): Operación, país y producto: los tres pasos para obtener un dictamen.
- [Describir el producto](https://docs.nomenclator.com.ar/ayuda/clasificar/describir-el-producto.md): Qué escribir para que el dictamen salga preciso a la primera.
- [Clasificar con ficha técnica](https://docs.nomenclator.com.ar/ayuda/clasificar/ficha-tecnica.md): Subir un PDF, qué pasa si no tiene texto y cuánto cuesta.
- [Cuando el clasificador pregunta](https://docs.nomenclator.com.ar/ayuda/clasificar/preguntas-del-clasificador.md): Qué hacer cuando una clasificación queda en «Faltan datos».
- [Entender el dictamen](https://docs.nomenclator.com.ar/ayuda/clasificar/entender-el-dictamen.md): Las opciones, el nivel de confianza, la justificación y la grilla jerárquica.
- [Aperturas SIM](https://docs.nomenclator.com.ar/ayuda/clasificar/aperturas-sim.md): Cómo verificamos los dígitos SIM y cuándo te toca elegir uno.
- [Elegir, revisar y compartir](https://docs.nomenclator.com.ar/ayuda/clasificar/elegir-revisar-y-compartir.md): Lo que hacés con un dictamen resuelto: usar otra opción, marcarlo como revisado, descargarlo y mandarlo.
- [Refinar un dictamen](https://docs.nomenclator.com.ar/ayuda/clasificar/refinar-un-dictamen.md): Sumar contexto a una clasificación resuelta y obtener una versión nueva.
- [Cuando una clasificación falla](https://docs.nomenclator.com.ar/ayuda/clasificar/cuando-una-clasificacion-falla.md): Los motivos posibles y qué hacer con cada uno. Una clasificación fallida no consume créditos.
- [Buscar y filtrar el historial](https://docs.nomenclator.com.ar/ayuda/historial/buscar-y-filtrar.md): Encontrar cualquier clasificación de tu organización.
- [Exportar y eliminar](https://docs.nomenclator.com.ar/ayuda/historial/exportar-y-eliminar.md): CSV, descarga de PDF en lote y eliminación de clasificaciones.
- [Calcular una importación](https://docs.nomenclator.com.ar/ayuda/calculadora/calcular-una-importacion.md): Estimá aranceles e impuestos a partir del NCM, el país de origen y el valor CIF.
- [Guardar y adjuntar cálculos](https://docs.nomenclator.com.ar/ayuda/calculadora/guardar-y-adjuntar.md): Guardar una liquidación para volver a ella y sumarla al dictamen.
- [Roles](https://docs.nomenclator.com.ar/ayuda/organizacion/roles.md): Qué puede hacer cada persona dentro de una organización.
- [Invitar a tu equipo](https://docs.nomenclator.com.ar/ayuda/organizacion/invitar-a-tu-equipo.md): Mandar, reenviar y revocar invitaciones.
- [Ajustes de la organización](https://docs.nomenclator.com.ar/ayuda/organizacion/ajustes-de-la-organizacion.md): Nombre, CUIT, preferencias de clasificación y URL.
- [Transferir, archivar y eliminar](https://docs.nomenclator.com.ar/ayuda/organizacion/transferir-archivar-y-eliminar.md): La zona de peligro: abandonar, transferir la propiedad, archivar y eliminar la organización.
- [Cómo funcionan los créditos](https://docs.nomenclator.com.ar/ayuda/planes/como-funcionan-los-creditos.md): Qué consume un crédito, qué no, y cómo se acumulan.
- [Comprar créditos adicionales](https://docs.nomenclator.com.ar/ayuda/planes/comprar-creditos.md): Sumar créditos con un pago único cuando te quedás corto.
- [Plan, pagos y baja](https://docs.nomenclator.com.ar/ayuda/planes/plan-y-pagos.md): Contratar un plan, ver tus pagos, dar de baja y reactivar.
- [Perfil y preferencias](https://docs.nomenclator.com.ar/ayuda/cuenta/perfil-y-preferencias.md): Tu nombre, tu email, el tema, la organización predeterminada y los avisos.
- [Ingreso y seguridad](https://docs.nomenclator.com.ar/ayuda/cuenta/ingreso-y-seguridad.md): Contraseña, ingreso con Google, recuperar el acceso y cerrar sesiones.
- [Problemas frecuentes](https://docs.nomenclator.com.ar/ayuda/problemas-frecuentes.md): Las dudas que más nos llegan, con su respuesta.
- [API de Nomenclator](https://docs.nomenclator.com.ar/api/introduccion.md): Clasificá productos en NCM de 8 dígitos y consultá dictámenes desde tus propios sistemas.
- [Inicio rápido](https://docs.nomenclator.com.ar/api/inicio-rapido.md): Creá una clasificación, esperá el dictamen y leelo, en tres pedidos.
- [Autenticación](https://docs.nomenclator.com.ar/api/autenticacion.md): Crear una key de la organización y mandarla en cada pedido.
- [Ciclo de una clasificación](https://docs.nomenclator.com.ar/api/ciclo-de-una-clasificacion.md): Los estados, cómo esperar el resultado y cómo responder cuando el clasificador pregunta.
- [Fichas técnicas](https://docs.nomenclator.com.ar/api/fichas-tecnicas.md): Subir un PDF y usarlo para clasificar.
- [Idempotencia](https://docs.nomenclator.com.ar/api/idempotencia.md): Reintentar sin crear clasificaciones duplicadas ni pagar dos veces.
- [Paginación](https://docs.nomenclator.com.ar/api/paginacion.md): Recorrer el historial con un cursor.
- [Errores](https://docs.nomenclator.com.ar/api/errores.md): El formato de los errores y el catálogo completo.
- [Límites](https://docs.nomenclator.com.ar/api/limites.md): Cuántos pedidos y cuántas clasificaciones simultáneas admite la API.
- [Facturación](https://docs.nomenclator.com.ar/api/facturacion.md): Qué se factura, cuánto y dónde ver el consumo.
- [Crear una clasificación](https://docs.nomenclator.com.ar/api-reference/crear-una-clasificacion.md): Encola la clasificación y responde `202` enseguida, sin dictamen. Consultá `GET /classifications/{id}` hasta que `status` sea `resolved`, `pending_data` o `failed`.
- [Obtener una clasificación](https://docs.nomenclator.com.ar/api-reference/obtener-una-clasificacion.md): El estado y, cuando está resuelta, el dictamen completo. Con `in_progress` trae la etapa en `stage`; con `pending_data`, las preguntas en `questions` y, si la hay, una propuesta provisional en `candidates`; con `failed`, el motivo en `failure_reason`.
- [Listar clasificaciones](https://docs.nomenclator.com.ar/api-reference/listar-clasificaciones.md): El historial de tu organización, de la más nueva a la más vieja salvo que pidas otro orden. Sin `status`, trae las resueltas, las que esperan datos y las que están en curso. Las eliminadas nunca aparecen.
- [Responder las preguntas](https://docs.nomenclator.com.ar/api-reference/responder-las-preguntas.md): Responde las preguntas de una clasificación en `pending_data` y la vuelve a `in_progress`. No suma costo: la clasificación se factura una sola vez, al resolverse. Hay una sola ronda de preguntas; sin respuesta en 30 días pasa a `abandoned` y no se factura. Requiere una key con alcance `classify`.
- [Descargar el PDF del dictamen](https://docs.nomenclator.com.ar/api-reference/descargar-el-pdf.md): Redirige (`302`) a una URL firmada y temporal del PDF. Incluye el cálculo de costos si se adjuntó uno. Solo existe con `status` `resolved`; antes responde `409`.
- [Subir una ficha técnica](https://docs.nomenclator.com.ar/api-reference/subir-una-ficha-tecnica.md): Pide una URL firmada para subir un PDF de hasta 10 MB. Subí el archivo con un `PUT` a `upload_url` y mandá el `file_url` que te devolvemos al crear la clasificación. La URL vence a los 10 minutos. Requiere una key con alcance `classify`.
- [Consultar aranceles](https://docs.nomenclator.com.ar/api-reference/consultar-aranceles.md): Los aranceles oficiales de un NCM para un país. Si no hay datos, responde `200` con `found: false` y el motivo en `reason`.
- [Consultar aperturas SIM](https://docs.nomenclator.com.ar/api-reference/consultar-aperturas-sim.md): Las aperturas SIM de 10 dígitos de un NCM. `available` trae las aperturas confirmadas; `none` significa que el registro oficial confirmó que no hay; `verifying`, que todavía no hay confirmación. Una lista vacía nunca se presenta como confirmada.
- [Listar países](https://docs.nomenclator.com.ar/api-reference/listar-paises.md): Los países que acepta el parámetro `country`, con su nombre y si son del MERCOSUR.
- [Consultar el saldo](https://docs.nomenclator.com.ar/api-reference/consultar-el-saldo.md): El saldo de créditos del plan, las clasificaciones en curso y el tope de clasificaciones simultáneas. Es informativo: la API no consume créditos y funciona con saldo 0.
- [Consultar el medidor de la API](https://docs.nomenclator.com.ar/api-reference/consultar-el-medidor.md): Las clasificaciones por API resueltas en el mes calendario en curso (hora de Buenos Aires) y su importe.
- [Novedades](https://docs.nomenclator.com.ar/novedades.md): Lo nuevo en Nomenclator: funciones, mejoras y cambios en la API.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)