Saltar al contenido principal

Exportaciones BETA

Endpoints para exportar datos del ERP hacia sistemas externos. A diferencia de los endpoints de lectura incremental, las exportaciones devuelven volumenes mayores en un unico request y estan pensadas para sincronizaciones batch.

Endpoints en beta

Estos endpoints estan disponibles para uso anticipado pero pueden cambiar de contrato, comportamiento o ser retirados antes de su release definitivo.

Exportar stock​

Exporta el snapshot de stock de una sucursal (opcionalmente acotado a un deposito). Util para sincronizar inventario hacia un sistema externo (BI, e-commerce, WMS).

GETBETA/integraciones/terceros/exportar/stock

Headers​

X-NX-TOKEN: tu_token
Content-Type: application/json

Query parameters​

ParametroTipoRequeridoDescripcion
sucursalIdnumberSiID de la sucursal a exportar
depositoIdnumberNoID del deposito para acotar el resultado
tipoArticulonumberNoFiltro por tipo de articulo (ver enum TipoArticuloDTO en el esquema)
webbooleanNoSi es true, solo articulos publicados en web

Respuesta​

StockPage
export interface StockPage {
  registros: number;
  cantidad: number;
  reservado: number;
  total: number;
  stock: StockItem[];
}

export interface StockItem {
  articuloId: number;
  codigo: string;
  descripcion: string;
  sucursalId?: number;
  sucursal: string;
  depositoId?: number;
  deposito: string;
  colorId?: number;
  colorNombre?: string;
  talleId?: number;
  talleNombre?: string;
  cantidad: number;
  reservado: number;
  total: number;
  fechaModificacion?: string;
}

La respuesta real del servidor incluye campos adicionales internos del ERP (por ejemplo totalrows, stockProductoId, transaccionId). Solo los campos listados forman parte del contrato estable; el resto puede cambiar sin aviso.

Rate limiting​

Mismo rate limit que el resto de exportaciones de terceros: 10 minutos en produccion (3 minutos en test). El cooldown se comparte con exportar/clientes y exportar/ventaitems, por lo que solo se puede ejecutar una exportacion por tenant dentro de la ventana. La respuesta es 403 Forbidden si se llama antes de que expire.

Adicionalmente, este endpoint requiere plan empresa o superior; si el tenant no cumple, el endpoint responde con un error de validacion.

Ejemplos​

# Snapshot completo del stock de una sucursal
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/stock?sucursalId=1' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

# Stock de un deposito puntual, solo articulos publicados en web
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/stock?sucursalId=1&depositoId=4&web=true' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

Ver tambien​