Wildberries API TypeScript SDK / MetaValidationFailError

Class: MetaValidationFailError

Defined in: errors/meta-validation-fail-error.ts:38

Error thrown when PATCH /api/v3/supplies/{supplyId}/deliver returns HTTP 409 with marking-code validation failures in the metaDetails response array.

From 2026-06-03, Wildberries validates Честный Знак (Honest Sign) marking codes server-side for B2C FBS orders. Codes must be passed in full — with GS separators (ASCII 0x1D) and the cryptographic authenticity tail. Invalid codes trigger this error.

⚠️ Rate-limit penalty: every 409 response counts as 10 requests against the FBS supply/order budget. Use sdk.ordersFBS.getOrdersMetaBulk() for pre-flight validation to avoid burning budget on repeated failures.

Since

3.15.0

See

• https://dev.wildberries.ru/docs/openapi/orders-fbs — Orders FBS API
• Migration guide

Example

import { MetaValidationFailError } from 'daytona-wildberries-typescript-sdk';

try {
  await sdk.ordersFBS.updateSuppliesDeliver('WB-GI-1234');
} catch (err) {
  if (err instanceof MetaValidationFailError) {
    // Typed access to the failing marking codes
    err.metaDetails.forEach(d => {
      console.log(`key=${d.key} value="${d.value}" decision=${d.decision}`);
    });
    // err is still instanceof WBAPIError — existing catch-all blocks still work
  }
  throw err;
}

Extends

• WBAPIError

Constructors

Constructor

new MetaValidationFailError(
   message: string, 
   code: string, 
   metaDetails: MetaDetail[], 
   response?: unknown, 
   requestId?: string, 
   origin?: string, 
   timestamp?: string): MetaValidationFailError;

Defined in: errors/meta-validation-fail-error.ts:63

Creates a MetaValidationFailError

Parameters

Parameter	Type	Description
message	string	Human-readable error message from the API response
code	string	WB error code string (e.g. 'MetaValidationFail'). Defaults to 'Unknown' when WB omits the code field.
metaDetails	MetaDetail[]	Array of individual validation failures
response?	unknown	Raw API response body
requestId?	string	Correlation ID for debugging and tracing
origin?	string	Origin service identifier from RFC 7807 problem+json responses
timestamp?	string	ISO 8601 timestamp from RFC 7807 problem+json responses

Returns

MetaValidationFailError

Overrides

WBAPIError.constructor

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
<a id="statuscode"></a> statusCode?	readonly	number	HTTP status code if applicable	WBAPIError.statusCode	errors/base-error.ts:25
<a id="response"></a> response?	readonly	unknown	API response body if available	WBAPIError.response	errors/base-error.ts:30
<a id="requestid"></a> requestId?	readonly	string	Correlation ID for debugging and tracing requests	WBAPIError.requestId	errors/base-error.ts:35
<a id="origin"></a> origin?	readonly	string	Origin service identifier from RFC 7807 problem+json responses. Indicates which internal Wildberries service originated the error (e.g., "s2s-api-auth-catalog").	WBAPIError.origin	errors/base-error.ts:43
<a id="timestamp"></a> timestamp?	readonly	string	ISO 8601 timestamp from RFC 7807 problem+json responses. Indicates when the error occurred on the server side (e.g., "2024-09-30T06:52:38Z").	WBAPIError.timestamp	errors/base-error.ts:51
<a id="code"></a> code	readonly	string	WB error code from the response body (e.g. 'MetaValidationFail'). Defaults to 'Unknown' when WB omits the code field.	-	errors/meta-validation-fail-error.ts:43
<a id="metadetails"></a> metaDetails	readonly	MetaDetail[]	Array of individual marking-code validation failures. Each item exposes key (metadata type), value (the submitted code), and decision ('invalid' when the code failed validation).	-	errors/meta-validation-fail-error.ts:50

Methods

getUserMessage()

getUserMessage(): string;

Defined in: errors/meta-validation-fail-error.ts:84

Returns a user-friendly error message listing the failing marking codes.

Returns

string

Error message with metaDetails summary and recovery guidance

Overrides

WBAPIError.getUserMessage

---

toJSON()

toJSON(): {
  name: string;
  message: string;
  statusCode?: number;
  code: string;
  metaDetails: MetaDetail[];
  response?: unknown;
  requestId?: string;
};

Defined in: errors/meta-validation-fail-error.ts:122

Custom JSON serialization to include metaDetails and code properties

Returns

{
  name: string;
  message: string;
  statusCode?: number;
  code: string;
  metaDetails: MetaDetail[];
  response?: unknown;
  requestId?: string;
}

Object representation including metaDetails and code

Name	Type	Defined in
name	string	errors/meta-validation-fail-error.ts:123
message	string	errors/meta-validation-fail-error.ts:124
statusCode?	number	errors/meta-validation-fail-error.ts:125
code	string	errors/meta-validation-fail-error.ts:126
metaDetails	MetaDetail[]	errors/meta-validation-fail-error.ts:127
response?	unknown	errors/meta-validation-fail-error.ts:128
requestId?	string	errors/meta-validation-fail-error.ts:129

Overrides

WBAPIError.toJSON