Wildberries API TypeScript SDK / CardDocumentInput

Interface: CardDocumentInput

Defined in: types/products.types.ts:1193

A single product card document in create requests. Used in createCardsUpload() (per variant), createUploadAdd() (per card to add).

⚠️ WB recommends passing documents ONLY through this documents object. Passing documents via the characteristics array is now restricted: it keeps working only if the documents object was never used for the card AND the "Documents" block in the new WB seller cabinet was never filled — otherwise characteristics-based documents may be processed incorrectly.

Since

4.3.0

Example

const documents: CardDocumentsRequest = {
  items: [
    {
      type: 1, // Certificate of Conformity
      number: 'RU D-RU.АГ01.В.12345',
      tradeName: 'Product Trade Name',
      startDate: '2025-01-15T00:00:00Z',
      endDate: '2028-01-14T23:59:59Z',
      isEndless: false,
    },
  ],
};

Extended by

• CardUpdateDocumentInput

Properties

Property	Type	Description	Defined in
type?	CardDocumentType	Document type. See CardDocumentType for the full list of kinds.	types/products.types.ts:1195
number?	string	Document number	types/products.types.ts:1197
productNumber?	string	Additional document number	types/products.types.ts:1199
tradeName?	string	Trade name	types/products.types.ts:1201
applicant?	string	Representative of the medical device manufacturer	types/products.types.ts:1203
startDate?	string	Document start date and time (ISO 8601, e.g. 2025-01-15T00:00:00Z)	types/products.types.ts:1205
endDate?	string	Document end date and time (ISO 8601). Omit when isEndless: true	types/products.types.ts:1207
isEndless?	boolean	Is the document valid indefinitely: true — indefinite, false — has an expiration date	types/products.types.ts:1209