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
200 con errores: true	La operación no se pudo completar (por ejemplo, totales del pedido que no cuadran)	datos.error de la respuesta
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.

200 con errores: true al crear o actualizar un pedido

Las operaciones de alta (pedido, venta, notacredito, facturar) responden 200 aun cuando la validación de negocio falla: el fallo viene en el cuerpo, con errores: true y el detalle en datos.error. Revisá siempre errores, no solo el código HTTP.

El caso típico es "Los totales no coinciden": revisá que se cumpla total = subtotal + envio + recargo - descuento. 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.