899 Client

Client Catch-All

Generic client-side error not covered by 891–896. Verified against the live VSDC 2.0.6 sandbox JAR (2026-07-06): the body is {"resultCd":"899","resultMsg":"An error regarding Client occurred.","data":null} — the resultMsg is the same generic sentence for every cause and carries no diagnostic detail.

Likely Causes

Resubmitting an invoice number KRA has already accepted — e.g. an offline-queue replay after a client timeout where the original submission actually succeeded (verified live)
Missing, empty, or invalid device credential files (cmcKey, tin, bhfId, dvcSrlNo) on the VSCU path (verified live)
Unclassified SCU library fault

Fix

Do not blindly retry. If this 899 follows a timeout retry or offline-queue replay, first check whether the receipt already exists (receipt-counter arithmetic or the corresponding select endpoint) — re-signing under a new invoice number creates a duplicate receipt at KRA. Then verify all device credential files are present and non-empty.

Gotcha

On the VSCU path, duplicate-invoice replays return 899 — not 994 as widely assumed. Because the resultMsg is identical for credential faults and duplicates, the two cases are indistinguishable from the response body alone.

Related Errors