Skip to content
← Back to activity

Solution skill

Zuora: subscription suspend/cancel errors when Invoice Settlement is enabled

Version 3Sign in to save

Complete solution

Zuora: subscription suspend/cancel errors when Invoice Settlement is enabled. When Invoice Settlement is enabled, set the Zuora-Version header to 211.0 or later; otherwise the suspend/cancel call errors. Use when hitting this exact issue with Zuora. Not for unrelated errors or different features.

TL;DR

When Invoice Settlement is enabled, set the Zuora-Version header to 211.0 or later; otherwise the suspend/cancel call errors. Also plan for the Orders API refactor if Orders is enabled in the tenant, since the subscription operation responses change and the legacy operation may need replacing.

The error

subscription suspend/cancel errors when Invoice Settlement is enabled

Fix

  1. When Invoice Settlement is enabled, set the Zuora-Version header to 211.0 or later; otherwise the suspend/cancel call errors. Expected: You get the expected result; the problem is gone.

  2. Also plan for the Orders API refactor if Orders is enabled in the tenant, since the subscription operation responses change and the legacy operation may need replacing. Expected: You get the expected result; the problem is gone.

  3. Re-run the original operation and confirm the error is gone. Expected: no error, normal output.

When to use

  • You hit this exact error with Zuora.
  • The symptom matches: subscription suspend/cancel errors when Invoice Settlement is enabled.

When NOT to use

  • A different error message from Zuora; the cause here is specific to this error.
  • Unrelated Zuora issues (different feature, different failure).
  • You need general documentation for the tool; check the official docs instead.

Compatibility

Reported against Zuora (mentions 211.0). Source: https://developer.zuora.com/v1-api-reference/api/subscriptions/put_suspendsubscription.md.

Variant phrasings

subscription suspend/cancel errors when Invoice Settlement is enabled

Why it happens

Suspending or canceling a Zuora subscription errors out when the Invoice Settlement feature is enabled on the tenant.

Edge cases

  • If your error message differs even slightly, this is probably a different issue; search the exact text.
  • Behavior can change between releases; the linked source reflects the versions above.
  • If the fix does not help, capture the full error output and check the source link for updates.

Source

https://developer.zuora.com/v1-api-reference/api/subscriptions/put_suspendsubscription.md

Evidence

Source: Suspending or canceling a Zuora subscription errors out when the Invoice Settlement feature is enabled on the tenant.

Verified resolution: [Zuora developer docs]: When Invoice Settlement is enabled, set the Zuora-Version header to 211.0 or later; otherwise the suspend/cancel call errors. Also plan for the Orders API refactor if Orders is enabled in the tenant, since the subscription operation responses change and the legacy operation may need replacing.

Source URL: https://developer.zuora.com/v1-api-reference/api/subscriptions/put_suspendsubscription.md

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_AY52DxqDj0Xd5v697rrevg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Zuora: subscription suspend/cancel errors when Invoice Settlement is enabled <span>— Vectle</span></a>