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 clientes

Devuelve la base completa de clientes en un unico request. Pensado para sincronizacion inicial o refresh periodico de la base de clientes hacia un sistema externo.

GETBETA/integraciones/terceros/exportar/clientes

Headers

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

Query parameters

Parametro	Tipo	Requerido	Descripcion
versionMayor	number	No	Solo trae clientes modificados con version mayor a este valor. Util para sincronizacion incremental.

Respuesta

EntidadPage

export interface EntidadPage {
  total: number;
  page: number;
  pageSize: number;
  data: Entidad[];
}

export interface Entidad {
  entidadId: number;
  nombre: string;
  razonSocial?: string;
  cuit?: string;
  dni?: string;
  email?: string;
  telefono?: string;
  celular?: string;
  direccion?: string;
  localidad?: string;
  provincia?: string;
  codigoPostal?: string;
  version: number;
  creado: string;
  modificado: string;
}

Limite de registros por plan

Este endpoint tiene un tope maximo de registros por request segun el plan contratado:

Plan	Limite
Comercio	6.000 clientes
Empresa	7.000 clientes
Corporativo	7.000 clientes
Otros	5.000 clientes

Si tu base de clientes supera el limite del plan, usa versionMayor para hacer la exportacion en pasadas incrementales, o combiná con GET /entidades para recorrer la base paginada.

Sincronizacion incremental con versionMayor

El campo version de cada entidad es un numero que crece cada vez que el cliente se modifica. Para sincronizar solo los cambios desde la ultima exportacion:

1. En la primera exportacion, guardar la version mas alta del resultado.
2. En la siguiente llamada, enviar ese valor como versionMayor.
3. El endpoint devuelve solo los clientes modificados despues de esa version.

# Primera exportacion completa
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/clientes' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

# Exportacion incremental — solo modificados desde version 18000
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/clientes?versionMayor=18000' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

Rate limiting

Este endpoint comparte la ventana de rate limit de datos: 10 minutos en produccion, 3 minutos en test. Si se consulta antes de que pase la ventana, la API responde 403 Forbidden.

---

Ver tambien

• Listado paginado de clientes — alternativa para recorrer clientes de a paginas
• Esquema de datos — contratos completos de la integracion
• Integracion de terceros — punto de entrada general