WbProducts icon

WbProducts

n8n node to interact with WB API

Actions41

Overview

This node is designed to interact with the Wildberries (WB) API, specifically for updating product cards ("Карточки Товаров"). The "Post Cards Update" operation allows users to send updated product information such as dimensions, characteristics, and sizes including SKUs. This is useful in scenarios where product details need to be programmatically maintained or synchronized from an external system into WB's catalog.

Practical examples include:

  • Automatically updating product specifications after changes in inventory or packaging.
  • Syncing detailed product attributes from a PIM (Product Information Management) system.
  • Bulk updating multiple product cards with new size or SKU data.

Properties

Name Meaning
Body JSON object containing the product card update data. It includes:
- dimensions: Object specifying product dimensions.
- characteristics: Array of objects describing product features.
- sizes: Array of size objects, each containing an array of SKUs to update.

The property expects a JSON structure similar to:

{
  "dimensions": {},
  "characteristics": [{}],
  "sizes": [
    {
      "skus": [null]
    }
  ]
}

Users must provide valid JSON matching the expected schema for the product card update.

Output

The node outputs JSON data representing the response from the WB API after attempting to update the product card. This typically includes confirmation of the update status or error details if the update failed.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating requests to the WB API.
  • The node uses a base URL configured from an imported OpenAPI specification.
  • HTTP headers are preset to accept and send JSON content.

Troubleshooting

  • Invalid JSON in Body: If the JSON provided in the Body property is malformed, the request will fail. Ensure the JSON is correctly formatted.
  • Authentication Errors: Missing or invalid API credentials will cause authorization failures. Verify that the API key is correctly configured.
  • API Response Errors: The WB API may return errors if required fields are missing or data formats are incorrect. Review the API documentation for required fields and data types.
  • Empty or Null SKUs: Providing null or empty SKUs in the sizes array may lead to unsuccessful updates. Ensure SKUs are valid identifiers.

Links and References

Discussion