Skip to main content
POST
Crear una clasificación
Los cinco campos del cuerpo son obligatorios: los que no uses van en null. Tiene que venir al menos description o file_url. Un campo que no está en la lista devuelve 422.
  • description: entre 10 y 5.000 caracteres. Mirá cómo describir el producto.
  • file_url: el que devuelve POST /uploads.
  • external_reference: tu referencia, hasta 100 caracteres. La app la muestra como «Ref.» en el dictamen.
La respuesta 202 no trae dictamen. Seguí el ciclo de una clasificación.

Autorizaciones

Authorization
string
header
requerido

API key de tu organización, creada en la app en Ajustes → API. Se manda como Authorization: Bearer nmc_live_…, nunca en la query string. Alcances: read (solo leer) y classify (clasificar y leer).

Encabezados

Idempotency-Key
string
requerido

Clave que elegís vos, de 16 a 128 caracteres entre letras sin acentos, números, - y _. Repetir el pedido con la misma clave devuelve la misma clasificación y no factura dos veces.

Pattern: ^[A-Za-z0-9_-]{16,128}$
Ejemplo:

"erp-pedido-000123-a"

Cuerpo

application/json
operation
enum<string>
requerido

import para importación, export para exportación.

Opciones disponibles:
import,
export
country
string
requerido

País en ISO 3166-1 alfa-2: de origen en una importación, de destino en una exportación.

Pattern: ^[A-Z]{2}$
description
string | null
requerido

Descripción del producto, de 10 a 5.000 caracteres. null si solo mandás ficha.

Required string length: 10 - 5000
file_url
string<uri> | null
requerido

El file_url de POST /uploads. null si no mandás ficha.

external_reference
string | null
requerido

Tu referencia, hasta 100 caracteres. null si no la usás.

Maximum string length: 100

Respuesta

Aceptada. Todavía no hay dictamen.

id
string
requerido

Id público de la clasificación.

Pattern: ^cls_[23456789ABCDEFGHJKMNPQRSTVWXYZ]{12}$
status
string
requerido

Siempre in_progress.

Allowed value: "in_progress"
stage
enum<string>
requerido

Etapa con la que arranca.

Opciones disponibles:
answers_intake,
extraction,
retrieval,
verdict,
validation,
sim
app_url
string<uri>
requerido

Link a la clasificación en la app.