Errores comunes

Código	Descripción	Qué revisar
400	Request inválida	Formato del payload o parámetros
401	Token inválido o expirado	Header X-NX-TOKEN
403	Consulta fuera de la frecuencia permitida	Esperar la ventana mínima (límites)
403	Sucursal o depósito no habilitado	Las sucursales habilitadas para tu integración
404	Recurso no encontrado	IDs enviados en la operación. En comprobante/{id}, además: que el comprobante sea de tu integración
422	Error de validación	Totales del pedido y datos obligatorios
500	Error interno	Reintentar si corresponde y contactar soporte

Casos frecuentes

403 por frecuencia

Superaste un límite de frecuencia: 10 minutos en catálogo/exportaciones, 3 segundos en movimientos de stock, 60 segundos en endpoints de parámetros. Esperá la ventana mínima. Ver Alcance y límites.

403 por sucursal no habilitada

Tu integración solo puede leer y escribir sobre las sucursales que el administrador del ERP le habilitó en Configuración › Canales › tu integración. El mensaje del error indica cuáles tenés disponibles; también las devuelve GET /integraciones/terceros/config en sucursalesExportacion.

Variantes del mensaje:

• "La integracion no tiene sucursales habilitadas..." — no hay ninguna configurada. Pedile al administrador del ERP que las habilite.
• "La sucursal N no esta habilitada..." — enviaste un sucursalId fuera de la lista.
• "Debe indicar sucursalId..." — omitiste el parámetro y tenés más de una sucursal habilitada, así que hay que elegir explícitamente.
• "El deposito N pertenece a una sucursal no habilitada..." — el depositoId (o el destino de una transferencia, o un override por ítem) cae fuera del perímetro.
• "El sucursalId N no coincide con la sucursal del deposito M..." — en exportar/stock, omitir sucursalId y dejar que se derive del depósito.
• "El deposito N no esta configurado en esta integracion. Depositos disponibles: ..." — el depositoId que mandaste en GetData / GetDataCurva existe y su sucursal está habilitada, pero ese depósito no forma parte de tu integración. Los válidos los lista GET /integraciones/terceros/config/depositos.
• "El punto de venta N pertenece a una sucursal no habilitada..." — al crear un pedido, venta, nota de crédito o al facturar. El comprobante se emite en la sucursal del punto de venta de tu integración y esa sucursal quedó fuera de la lista habilitada; normalmente es una configuración incoherente del canal, no algo del request.
• "El empleadoId N no es un empleado valido..." — mandaste un empleadoId que no es un empleado activo, o que no pertenece a ninguna sucursal de tu perímetro. Los ids válidos los devuelve GET /empleados; acordate de que es el id de la entidad del empleado, no el de usuario.

404 al consultar un comprobante

GET /comprobante/{id} solo devuelve comprobantes creados por tu integración. Un id que no existe, que pertenece a otra integración o que se cargó desde el ERP responde 404 — no 403, para no confirmar que ese comprobante existe en el sistema. Revisá que estés usando el facturaId que te devolvió el alta.

422 al crear un pedido

Error de validación. Revisá que los totales cumplan total = subtotal + envio + recargo - descuento y que los campos obligatorios estén completos. Ver Pedidos.

401

Token inválido o expirado. Revisá el header X-NX-TOKEN. Ver Autenticación.

¿Seguís con problemas?

Si el error persiste, completá el formulario en ninoxnet.com/integraciones/terceros indicando el endpoint, el payload (sin el token) y la respuesta recibida.