Saltar al contenido principal

Pedidos

La integración permite enviar pedidos a NinoxNet.

Sucursal de la preventa

La preventa se crea en la sucursal del punto de venta configurado para tu integración, y esa sucursal tiene que estar dentro de las habilitadas para el canal. En la práctica esto solo falla si el administrador del ERP habilitó sucursales que no incluyen la del punto de venta del canal: es un aviso de configuración incoherente, no algo que dependa de lo que mandes en el body.

Si el canal no tiene sucursales cargadas, no se restringe nada: se usa la sucursal de sus depósitos o de su punto de venta.

Crear pedido​

POST/integraciones/Terceros/Pedido

Request:

PedidoTerceros

Respuesta:

PedidoResultado

El detalle de ambos tipos está en Esquema de datos.

Según la configuración de tu integración, el pedido puede generar:

  • un pedido de venta
  • una preventa o reserva
Validación de totales

El campo total debe coincidir con la fórmula subtotal + envio + recargo - descuento. Si no cuadra, la API responde 422.

Idempotencia

Usá un ordenId único y estable por orden para poder reintentar sin duplicar. Persistí la correlación entre tu orden local y la respuesta de NinoxNet.

Vendedor del comprobante (opcional)

pedidoTerceros acepta un empleadoId opcional para atribuir el comprobante a un vendedor. Si no lo mandás se usa el vendedor por defecto configurado en tu integración. Los ids válidos salen de GET /empleados.

Cliente explícito (opcional)

pedidoTerceros acepta un entidadId opcional con el id de un cliente ya existente en NinoxNet. Si lo mandás, se usa esa entidad directo y no se busca por documento/CUIT/email ni se crea un cliente nuevo — en ese caso usuario pasa a ser opcional. Sin entidadId, seguís necesitando usuario con al menos dni, cuit o email para identificar o dar de alta al cliente; sin 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.

Cancelar pedido​

POST/integraciones/Terceros/Pedido/cancelar

Parámetros:

  • facturaid (number): identificador del comprobante a cancelar

Respuesta:

NxResultado

Consultar comprobante​

Devuelve un comprobante creado por tu integración: preventa, venta o nota de crédito. Los tres salen por el mismo endpoint y se distinguen por comprobanteTipo.

GETBETA/integraciones/terceros/comprobante/{id}

Parámetros de ruta:

  • id (number): el facturaId que devolvió el alta del comprobante

Respuesta:

Comprobante

Incluye cabecera, cliente, ítems, totales y medios de pago. El detalle está en Esquema de datos.

Solo tus comprobantes

El endpoint devuelve únicamente comprobantes creados por tu integración. Un id inexistente, de otra integración o cargado desde el ERP responde 404 — no 403, para no confirmar que ese comprobante existe en el sistema.

Para qué sirve en la práctica

Es la forma de reconciliar cuando perdiste la respuesta del alta (timeout, reintento, corte de red) o cuando necesitás el estado actual de una preventa antes de facturarla. Para volúmenes grandes seguí usando las exportaciones, que están pensadas para lote.

Ejemplo​

curl --request GET \
  --url 'https://api.test-ninox.com.ar/integraciones/terceros/comprobante/12345' \
  --header 'X-NX-TOKEN: {TU_TOKEN}'

Ventas y facturación​

Para crear una venta directa (sin preventa) o facturar una preventa existente, mirá Ventas (BETA).