WbProducts icon

WbProducts

n8n node to interact with WB API

Overview

This node interacts with the Wildberries (WB) API, specifically focusing on the "Карточки Товаров" (Product Cards) resource. The "Get Cards Error List" operation retrieves a list of errors related to product cards. This can be useful for sellers or managers who want to audit and troubleshoot issues in their product listings on the WB platform.

Typical use cases include:

  • Automatically fetching error reports for product cards to monitor data quality.
  • Integrating error lists into dashboards or alerting systems.
  • Supporting workflows that trigger corrective actions based on detected errors.

Properties

Name Meaning
Locale Language selection parameter for the response field values that support multilingual content. Options: any string representing locale codes (e.g., "en", "ru"). Not used in sandbox mode.

Output

The node outputs JSON data containing the list of errors associated with product cards. The structure corresponds to the API's response schema for the "Get Cards Error List" endpoint. It typically includes details such as error codes, descriptions, affected product identifiers, and possibly timestamps.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Wildberries API.
  • The node uses a base URL defined by the imported OpenAPI specification.
  • Proper network access to the WB API endpoints is necessary.
  • No additional environment variables are explicitly required beyond standard API authentication.

Troubleshooting

  • Common Issues:
    • Incorrect or missing API credentials will cause authentication failures.
    • Using unsupported locale codes may result in default language responses or errors.
    • Network connectivity problems can prevent successful API calls.
  • Error Messages:
    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors may occur if parameters are malformed; ensure the "Locale" value is a valid string.
    • API rate limits might cause temporary blocking; consider implementing retry logic or reducing request frequency.

Links and References

  • Wildberries API documentation (for product cards and error lists) — consult the official WB developer portal.
  • n8n documentation on creating custom nodes and using API credentials.

Discussion