Changelog
Resumen de los cambios de la API de Integración de terceros. No repite el detalle de implementación: para eso está cada página de referencia, linkeada desde cada entrada.
2026-11-10 — Datos extendidos: artículos paginados y clientes saneado
- Nuevo
GET /exportar/articulos/paginado: el catálogo paginado, como alternativa aGetData, con el costo y su composición fiscal (precioCostoIva,precioCostoOrigen), el stock de una sucursal (opcionalmente por depósito) y los últimos precios de venta y de compra. Dos modos: recorrido ordenado (orden+dir, de a 100) y sincronización incremental porversionMayor(de a 500, con las bajas y un cursorsiguiente). - Nuevo enum
TipoOrigenCosto. - Los endpoints de clientes se rehicieron con el mismo esquema que el de artículos.
GET /exportar/clientes (y su alias GET /entidades) requieren ahora Datos extendidos. Sin que el administrador del
ERP lo habilite en Configuración › Canales › tu integración, responden 403. Si tu integración los usa
hoy, pedí que lo habiliten antes de que se despliegue este cambio.
Además, en esos dos endpoints:
pageempieza en 1 (page=0responde400). Antes era en la práctica un desplazamiento de filas.pageSizetiene un máximo de 100 (500 conversionMayor);0o negativo ya no devuelve todo: se recorta al máximo.exportar/clientesdejó de ser un volcado completo: se recorre por páginas, y el tope de clientes por plan se reemplazó por el modo incremental.- La respuesta cambió de forma (
items,totalRegistros,totalPaginas,paginaActual,pageSize,versionActual,siguiente). Antes:registros,page,size,entidades. - Un parámetro inválido responde
400con el motivo (antes algunos llegaban a la base). exportar/clientestiene su propia ventana de rate limit (30 s en producción) y ya no comparte la de 10 minutos.
GET /entidadesqueda deprecado. Sigue respondiendo igual queGET /exportar/clientes(mismo contrato y mismo permiso), pero la ruta documentada esexportar/clientes: migrá a esa.- El stock de
exportar/articulos/paginadoes, por defecto, el mismo que devuelveGetData(los depósitos de tu integración); consucursalIdodepositoIdse elige otro origen, ystock.origenindica cuál.sucursalIdpasó a ser opcional. Detalle en Exportar artículos. - Detalle de clientes: Exportar clientes.
2026-11-05 — publicable en las variantes del catálogo y de los webhooks
- Cada variante de
GetData,GetDataCurvay del webhook de artículos sumapublicable(boolean, opcional). Esfalsecuando el comercio excluyó esa variante para tu integración desde Ninox; en ese caso la variante llega igual, conunidades: 0. - Un artículo con todas sus variantes excluidas llega con todas en
publicable: false, no como baja. - Cambio retrocompatible: sin la función activada en el comercio,
publicableno viaja (ausente = se publica). Los pedidos de una variante excluida se aceptan igual.
2026-10-28 — Identificación del cliente en pedidos, ventas y notas de crédito
POST /pedido,/ventay/notacreditodevuelvenentidadId,cliente(origen,coincidePor,nombreFicha) y, si hay algo que revisar,advertencias("CODIGO: mensaje"). La primera esCLIENTE_NOMBRE_DISTINTO: la ficha se encontró por DNI, CUIT o email pero el nombre no coincide.- Sin
entidadId, unusuario.dniousuario.cuitcon formato inválido responde400con el motivo en texto plano. Un campo vacío no se valida; conviene mandarlo ennull. - Cuando el nombre no coincide, a la ficha encontrada ya no se le completan datos. El DNI y el
CUIT solo se completan con un formato válido, también cuando mandás
entidadId. - El reenvío de un
ordenIdya anulado o facturado devuelve elestadoreal del comprobante. - Cambio retrocompatible salvo el
400por formato: los campos nuevos solo se agregan.
2026-10-19 — Canal de origen en las exportaciones de comprobantes
- Los exports de comprobantes (venta,
compra y gastos)
aceptan dos parámetros nuevos:
incluirApps=truecompletaappcon el nombre del canal de origen. Antes la referencia lo nombraba, pero la API no lo leía yappnunca venía.appIdfiltra por canal: el id de un canal, o-1para traer solo los comprobantes sin canal (ventas de local / punto de venta). Otro valor responde400.
- La referencia de Exportar venta aclara qué
costo traen
costoItem(el del momento de la venta, guardado en el ítem) ycostoArticulo(el actual del artículo). - Cambio retrocompatible: sin los parámetros nuevos, la respuesta es la misma de antes.
2026-10-15 — Preventas, estado y gastos en las exportaciones
- Exportar venta:
ventaitems/paginadoyventatotales/paginadoaceptancomprobanteTipo(2,4y33, separados por coma). Con33devuelven las preventas todavía sin facturar. Sin el parámetro siguen devolviendo ventas y notas de crédito (2,4), como hasta ahora. - Las filas de venta, compra y gastos suman
estado. Una venta anulada sigue saliendo conestado: 3, así que ya se puede detectar la anulación. - Exportar compra:
compraitems/paginadoycompratotales/paginadoaceptancomprobanteTipo(1o3) para acotar. - Nuevo
GET /exportar/gastos/paginado: el reporte del módulo Gastos, una fila por gasto con cuenta, categoría y subcategoría. Comparte la ventana de 30 segundos de los paginados de comprobante. - Nueva página Enums y códigos con todos los valores numéricos que
devuelve y acepta la API (
ComprobanteTipo,ComprobanteEstado,TipoDocumento,TipoMedio,TipoFormaPago,TipoArticuloy otros). - Cambios de contrato retrocompatibles: parámetro, campo y endpoint nuevos. Un
comprobanteTipoque el endpoint no admite responde400.
POST /facturar solo factura preventas de tu integraciónPOST /facturar ya no factura preventas
creadas por otro canal o por el punto de venta: responde igual que si la preventa no
existiera (errores: true, "No se encontro la factura"). Es una corrección de seguridad.
Si tu integración facturaba preventas ajenas, tenés que dejar de hacerlo.
2026-10-15 — Cancelar un pedido con la mercadería ya transferida
POST /pedido/cancelarcancela el pedido aunque, con el reparto entre varios depósitos activado, la mercadería ya se haya transferido al depósito de despacho. Antes respondíatipo: 0. Si el pedido ya está en preparación, despachado o viajando entre depósitos, sigue sin cancelarse.- Sin cambios de contrato.
2026-10-08 — Exportar stock: filtro por venta/compra
GET /exportar/stockacepta un parámetro opcionaluso(venta,compraotodos) que filtra por los tildes "permite venta" / "permite compra" del artículo, igual que el filtro de "Ver Stock" del ERP.- Cada
StockItemsumapermiteVentaypermiteCompra, para separar en una sola llamada el stock de venta del que todavía es solo de compra. - Aclaración de documentación: sin
usoel export no filtra por venta/compra (incluye la mercadería solo "permite compra"), yweb=truefiltra por publicado en web, no por "permite venta". - Cambio de contrato retrocompatible: parámetro y campos nuevos, sin cambios en el
comportamiento por defecto. Un
webousoinválido responde400(antes, unwebinválido daba500).
2026-10-05 — Identificador de artículo, color y talle en los ítems exportados
- Cada ítem de
GET /exportar/ventaitems,GET /exportar/ventaitems/paginadoyGET /exportar/compraitems/paginadosumaarticuloIdy, si el artículo tiene curva,colorIdytalleId. Sirven para cruzar el ítem con tu catálogo sin depender del texto decodigo. colorIdytalleIdllegan ennullcuando el artículo no tiene curva.- Cambio de contrato retrocompatible: campos nuevos, ninguna integración existente necesita cambios.
2026-10-01 — Actualizar y cambiar el estado de un pedido
- Pedidos documenta cómo
actualizar un pedido (reenviando
POST /pedidocon el mismoordenId) y cómo cambiar su estado:pagado+medioPagopara pasar aPAGADO,POST /pedido/cancelarpara anular yPOST /facturarpara facturar. Incluye ejemplos y la tabla de transiciones. - Esquema de datos:
PedidoTercerossumapagado,medioPagoylistaPrecioId(opcionales) y se agregaComprobanteEstado. - Correcciones de documentación: un total que no cuadra responde
200conerrores: true(no422); el anti-duplicados dePOST /pedidoes de 30 segundos pornumero; yPOST /pedido/cancelaraplica a pedidosPENDIENTEyPAGADO. - Sin cambios de contrato: describe el comportamiento vigente.
2026-09-29 — Varios depósitos desde plan Empresa
- Leer varios depósitos con una misma integración, incluido el modo multidepósito informativo de los webhooks, está disponible desde el plan Empresa. Es experimental y lo activa NinoxNet en el canal a pedido.
- Alcance y límites ya no dice "un token = un depósito + un punto de venta": los pedidos y ventas siguen yendo contra el depósito y el punto de venta de la integración, pero leer varios depósitos no requiere integraciones separadas.
- Sin cambios de contrato.
2026-08-26 — Cliente explícito en pedido, venta y nota de crédito
Pedido,VentayNotaCreditoTercerosaceptan ahora unentidadIdopcional para atribuir el comprobante a un cliente ya existente en NinoxNet en vez de que se resuelva o cree automáticamente a partir deusuario.- Con
entidadId,usuariopasa a ser opcional: no se busca por documento/CUIT/email ni se da de alta un cliente nuevo. SinentidadId,usuariosigue siendo obligatorio (con al menosdni,cuitoemail); si no se manda ninguno de los dos, la API responde400. - Un
entidadIdque no corresponde a un cliente activo responde403. Los ids válidos salen deGET /entidades. - Cambio de contrato retrocompatible: campo nuevo y opcional, ninguna integración existente necesita cambios.
2026-08-20 — Exportación de compras y totales de comprobante
- Nuevo
GET /exportar/compraitems/paginadopara exportar ítems de compra por período (mismos criterios queventaitems/paginado, conproveedor/empleadoyprecioCompra/precioCompraFinalen vez de la semántica de venta). Solo existe la variante paginada. - Nuevo
GET /exportar/compratotales/paginadoy su equivalente de venta,GET /exportar/ventatotales/paginado: una fila por comprobante, sin el detalle de ítems, para quien solo necesita los totales de cabecera. - Los cuatro endpoints paginados de comprobante (
ventaitems,ventatotales,compraitems,compratotales) comparten los mismos query params y un único bucket de rate limit corto (30 s producción / 3 s test), para poder paginar de corrido sin esperar el bucket masivo.
2026-08-18 — Stock por depósito y selección de depósito en el catálogo
- Nuevo modo multidepósito informativo: el webhook de artículos incluye
stockDepositoscon el stock desglosado de cada depósito de la integración. Pensado para quienes administran varios locales y hasta ahora necesitaban un token por depósito. Requiere plan Corporativo y lo activa NinoxNet en el canal. - En ese modo,
unidadespasa a ser el stock del depósito principal y no la suma del array. El campo no viaja si tu integración no está en ese modo, así que si ya integraste, nada cambia. GET /configahora informaflujoDeposito, para que puedas detectar si vas a recibirstockDepositossin tener que preguntarnos.GetDatayGetDataCurvaaceptan undepositoIdopcional para consultar el stock de un depósito puntual.
2026-08-13 — Comprobantes, empleados, puntos de venta y vendedor
- Nuevo
GET /comprobante/{id}para reconsultar una preventa, venta o nota de crédito ya creada por tu integración (útil para reconciliar después de un timeout o corte de red). - Nuevos
GET /empleadosyGET /puntos-ventapara descubrir los ids válidos de vendedor y punto de venta de tus sucursales habilitadas. Pedido,VentayNotaCreditoTercerosaceptan ahora unempleadoIdopcional para fijar el vendedor del comprobante.- Se corrigió un bug: Terceros era el único canal que no propagaba el vendedor
configurado al comprobante resultante. Si no mandás
empleadoId, ahora se aplica el vendedor de tu integración (antes quedaba sin asignar).
2026-08-06 — Sucursales habilitadas
- La API ahora acota por sucursal: tu integración solo puede leer y escribir en las sucursales que le fueron habilitadas (no es algo que la integración pueda autoatribuirse). Ver alcance y límites.
- Las exportaciones,
saldos/*yPOST /stock/movimientoresponden403si la integración todavía no tiene sucursales habilitadas (deny-by-default). - El alta de comprobantes (
pedido,venta,notacredito,facturar) valida que el punto de venta caiga en una sucursal habilitada, pero no corta si esa lista aún no fue configurada: una integración que ya funcionaba sigue funcionando igual que antes.
2026-07-31 — Webhooks propios por API
- Ya no hace falta coordinar cada webhook con NinoxNet: alta, edición, baja y consulta se manejan solo con tu token. Ver webhooks.
2026-07-06 — Nota de crédito
- Nuevo
POST /notacreditopara emitir notas de crédito directas desde tu integración, confacturaRefIdopcional para vincularlas a la venta original. - Se dejó de documentar
puntoVentaIdenventaynotacredito: el punto de venta siempre sale de la configuración de tu integración.
2026-06-29/30 — Exportación de ventas
- Nuevo endpoint paginado
GET /exportar/ventaitems/paginado, recomendado para automatizaciones y meses completos (bucket de rate limit propio y corto para poder recorrer páginas de corrido). - El endpoint no paginado (
exportar/ventaitems) suma un tope de 10.000 ítems por request; por encima de eso, hay que usar el paginado. - Ambos suman filtro por rango de fechas
desde/hasta(máximo 30 días) y el parámetro opcionalincluirMediosPago;pageSizedel paginado queda con un máximo de500.
2026-06-02 — Transferencias de stock
- Se aclaró el contrato de
POST /stock/movimientopara transferencias: el depósito y la sucursal de destino se envían endepositoDosIdysucursalDosId. Ver stock.
¿Encontraste algo que no está reflejado acá? Este changelog cubre los últimos meses; para el historial completo de la API, o dudas sobre una versión anterior, contactanos por los canales de onboarding.