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 ventas

Exporta los items de ventas realizadas en un periodo. Util para sincronizar movimientos de venta hacia un sistema de BI, contabilidad o ERP externo.

GETBETA/integraciones/terceros/exportar/ventaitems

Headers

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

Query parameters

Parametro	Tipo	Requerido	Descripcion
sucursalId	number	Si	ID de la sucursal a exportar
fecha	string	Uno de los dos	Fecha especifica en formato YYYY-MM-DD
anio + mes	string	Uno de los dos	Anio y mes en formato YYYY y MM. Alternativa a fecha
incluirMediosPago	boolean	No	Si es true, incluye el detalle de medios de pago por venta

Se requiere fecha o la combinacion anio + mes, ademas de sucursalId.

Respuesta

VentaItem[]

export interface VentaItem {
  facturaId: number;
  numero: number;
  pvNumero: number;
  fecha: string;
  entidadId?: number;
  entidadNombre?: string;
  articuloId: number;
  articuloCodigo: string;
  articuloDescripcion: string;
  colorId?: number;
  talleId?: number;
  cantidad: number;
  precio: number;
  subtotal: number;
  descuento: number;
  total: number;
}

Rate limiting

Mismo rate limit que exportar clientes: 10 minutos en produccion.

Ejemplos

# Exportar ventas de un dia especifico
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/ventaitems?sucursalId=1&fecha=2026-05-07' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

# Exportar ventas de un mes completo con medios de pago
curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/exportar/ventaitems?sucursalId=1&anio=2026&mes=04&incluirMediosPago=true' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

---

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