iVendNext N8N - Troubleshooting

iVendNext N8N - Troubleshooting

12.1 — Connection & credentials

Symptom

Cause & fix

Credential test fails on save

Re-check the API Key and Secret. Confirm Domain is the full address with https:// and no trailing slash, e.g. https://acme.ivendnext.com.

"Unable to authenticate"

Keys are wrong or were regenerated. Generate fresh keys in iVendNext and update the credential.

Certificate / SSL error

Only relevant for a temporary test environment. Enable Ignore SSL Issues for that case only; never in production.

Redirect / wrong-address error

The tenant address is slightly off. Verify the exact URL you use to log in and match it exactly.


12.2 — DocTypes & fields

Symptom

Cause & fix

DocType dropdown is empty

The credential is invalid, or the integration user lacks permission to list Document Types. Re-test the credential; grant the user the needed role.

"Document Type unavailable" / access denied

The integration user has no permission on that Document Type. Add the appropriate role to the user in iVendNext.

A field won't save on Create/Update

Use the field's exact internal name in Meta Fields, and wrap numbers, dates, or line-item tables in an n8n expression.

Line items / child tables not appearing

Pass them as an array via a Meta Field expression (see the Magento orders example, 11.1).


12.3 — Triggers

Symptom

Cause & fix

Trigger never fires

Confirm the workflow is Active. Confirm the chosen Event matches the action you take in iVendNext (e.g. On Submit only fires on submit, not on save).

Duplicate triggers firing

An older listener with a similar Trigger Name still exists. Give each trigger a unique name; enable Auto Delete so old ones clean up on deactivation.

iVendNext seems to wait on the workflow

Turn on Respond Immediately in the trigger's Additional Options.


12.4 — Runtime & reliability

Symptom

Cause & fix

One bad record stops the whole run

Enable Continue On Fail on the node and route errored items to a review/alert branch.

Get Many returns too few rows

Switch Return All on, or raise Limit.

Need to see what happened

Open the workflow's Executions tab — every run is logged step by step with the exact data.



Idea

Still stuck?

Capture the workflow name, the failing node, and the execution log, then contact your iVendNext support channel. The execution log almost always pinpoints the cause.



    • Related Articles

    • iVendNext Foresight - Troubleshooting & Support

      Because Foresight is delivered as a cloud service, there is no infrastructure for customers or partners to manage. Most issues are functional (data or configuration) and can be resolved on screen. Anything beyond that is handled by iVendNext support. ...
    • iVendNext AI Copilot - Troubleshooting

      If something does not look right Most issues resolve in a step or two. Work down this list before escalating. What you see What to do The Copilot button is missing Confirm Copilot is enabled for your environment and that you are signed in. Refresh ...
    • Troubleshooting Common Loyalty Scenarios

      Overview This article gives you an overview of common iVendNext loyalty issues and easy fixes to keep points accurate and customers happy. 1. Enrollment and Account Issues Symptoms and Solutions Problem Possible Causes Resolution Steps Customer can't ...
    • Monitoring and Troubleshooting Promotions

      Overview This article provides a step-by-step guide to monitoring and troubleshooting promotions in iVendNext. Prerequisites Before monitoring or troubleshooting promotions, ensure the following are set up correctly: Promotions are created and marked ...
    • Troubleshooting Deferred Accounting

      Overview Deferred accounting handles advance payments and prepaids, ensuring accurate financial records. iVendNext automates much of this, but issues can still arise. This article covers common problems, their causes, and how to fix them. Before you ...