Exportar venta BETA

Endpoints en beta

Pueden cambiar de contrato, comportamiento o ser retirados antes de su release definitivo.

Exportar ventas

Exporta los ítems de ventas realizadas en un período. Útil para sincronizar movimientos de venta hacia un sistema de BI, contabilidad o ERP externo.

GETBETA/integraciones/terceros/exportar/ventaitems

Query parameters

Parámetro	Tipo	Requerido	Descripción
sucursalId	number	Sí	ID de la sucursal a exportar
fecha	string	Uno de los dos	Fecha específica en formato YYYY-MM-DD
anio + mes	string	Uno de los dos	Año 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 combinación anio + mes, además de sucursalId.

Respuesta

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

Bucket compartido de exportaciones: 10 minutos en producción.

Ejemplos

# Exportar ventas de un día específico
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 también

• Listado paginado de clientes — recorrer clientes de a páginas.
• Esquema de datos — contratos completos.