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) |
404 | Recurso no encontrado | IDs enviados en la operació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.
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.