Saltar al contenido principal

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 a GetData, 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 por versionMayor (de a 500, con las bajas y un cursor siguiente).
  • Nuevo enum TipoOrigenCosto.
  • Los endpoints de clientes se rehicieron con el mismo esquema que el de artículos.
Cambios que pueden romper una integración existente

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:

  • page empieza en 1 (page=0 responde 400). Antes era en la práctica un desplazamiento de filas.
  • pageSize tiene un máximo de 100 (500 con versionMayor); 0 o negativo ya no devuelve todo: se recorta al máximo.
  • exportar/clientes dejó 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 400 con el motivo (antes algunos llegaban a la base).
  • exportar/clientes tiene su propia ventana de rate limit (30 s en producción) y ya no comparte la de 10 minutos.
  • GET /entidades queda deprecado. Sigue respondiendo igual que GET /exportar/clientes (mismo contrato y mismo permiso), pero la ruta documentada es exportar/clientes: migrá a esa.
  • El stock de exportar/articulos/paginado es, por defecto, el mismo que devuelve GetData (los depósitos de tu integración); con sucursalId o depositoId se elige otro origen, y stock.origen indica cuál. sucursalId pasó 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, GetDataCurva y del webhook de artículos suma publicable (boolean, opcional). Es false cuando el comercio excluyó esa variante para tu integración desde Ninox; en ese caso la variante llega igual, con unidades: 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, publicable no 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, /venta y /notacredito devuelven entidadId, cliente (origen, coincidePor, nombreFicha) y, si hay algo que revisar, advertencias ("CODIGO: mensaje"). La primera es CLIENTE_NOMBRE_DISTINTO: la ficha se encontró por DNI, CUIT o email pero el nombre no coincide.
  • Sin entidadId, un usuario.dni o usuario.cuit con formato inválido responde 400 con el motivo en texto plano. Un campo vacío no se valida; conviene mandarlo en null.
  • 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 ordenId ya anulado o facturado devuelve el estado real del comprobante.
  • Cambio retrocompatible salvo el 400 por 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=true completa app con el nombre del canal de origen. Antes la referencia lo nombraba, pero la API no lo leía y app nunca venía.
    • appId filtra por canal: el id de un canal, o -1 para traer solo los comprobantes sin canal (ventas de local / punto de venta). Otro valor responde 400.
  • La referencia de Exportar venta aclara qué costo traen costoItem (el del momento de la venta, guardado en el ítem) y costoArticulo (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/paginado y ventatotales/paginado aceptan comprobanteTipo (2, 4 y 33, separados por coma). Con 33 devuelven 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 con estado: 3, así que ya se puede detectar la anulación.
  • Exportar compra: compraitems/paginado y compratotales/paginado aceptan comprobanteTipo (1 o 3) 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, TipoArticulo y otros).
  • Cambios de contrato retrocompatibles: parámetro, campo y endpoint nuevos. Un comprobanteTipo que el endpoint no admite responde 400.
POST /facturar solo factura preventas de tu integración

POST /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/cancelar cancela 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ía tipo: 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/stock acepta un parámetro opcional uso (venta, compra o todos) que filtra por los tildes "permite venta" / "permite compra" del artículo, igual que el filtro de "Ver Stock" del ERP.
  • Cada StockItem suma permiteVenta y permiteCompra, para separar en una sola llamada el stock de venta del que todavía es solo de compra.
  • Aclaración de documentación: sin uso el export no filtra por venta/compra (incluye la mercadería solo "permite compra"), y web=true filtra 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 web o uso inválido responde 400 (antes, un web inválido daba 500).

2026-10-05 — Identificador de artículo, color y talle en los ítems exportados​

2026-10-01 — Actualizar y cambiar el estado de un pedido​

  • Pedidos documenta cómo actualizar un pedido (reenviando POST /pedido con el mismo ordenId) y cómo cambiar su estado: pagado + medioPago para pasar a PAGADO, POST /pedido/cancelar para anular y POST /facturar para facturar. Incluye ejemplos y la tabla de transiciones.
  • Esquema de datos: PedidoTerceros suma pagado, medioPago y listaPrecioId (opcionales) y se agrega ComprobanteEstado.
  • Correcciones de documentación: un total que no cuadra responde 200 con errores: true (no 422); el anti-duplicados de POST /pedido es de 30 segundos por numero; y POST /pedido/cancelar aplica a pedidos PENDIENTE y PAGADO.
  • 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, Venta y NotaCreditoTerceros aceptan ahora un entidadId opcional para atribuir el comprobante a un cliente ya existente en NinoxNet en vez de que se resuelva o cree automáticamente a partir de usuario.
  • Con entidadId, usuario pasa a ser opcional: no se busca por documento/CUIT/email ni se da de alta un cliente nuevo. Sin entidadId, usuario sigue siendo obligatorio (con al menos dni, cuit o email); si no se manda ninguno de los dos, la API responde 400.
  • Un entidadId que no corresponde a un cliente activo responde 403. Los ids válidos salen de GET /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/paginado para exportar ítems de compra por período (mismos criterios que ventaitems/paginado, con proveedor/empleado y precioCompra/precioCompraFinal en vez de la semántica de venta). Solo existe la variante paginada.
  • Nuevo GET /exportar/compratotales/paginado y 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.
  • Nuevo modo multidepósito informativo: el webhook de artículos incluye stockDepositos con 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, unidades pasa 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 /config ahora informa flujoDeposito, para que puedas detectar si vas a recibir stockDepositos sin tener que preguntarnos.
  • GetData y GetDataCurva aceptan un depositoId opcional 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 /empleados y GET /puntos-venta para descubrir los ids válidos de vendedor y punto de venta de tus sucursales habilitadas.
  • Pedido, Venta y NotaCreditoTerceros aceptan ahora un empleadoId opcional 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/* y POST /stock/movimiento responden 403 si 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 /notacredito para emitir notas de crédito directas desde tu integración, con facturaRefId opcional para vincularlas a la venta original.
  • Se dejó de documentar puntoVentaId en venta y notacredito: 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 opcional incluirMediosPago; pageSize del paginado queda con un máximo de 500.

2026-06-02 — Transferencias de stock​

  • Se aclaró el contrato de POST /stock/movimiento para transferencias: el depósito y la sucursal de destino se envían en depositoDosId y sucursalDosId. 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.