WbPromotion icon

WbPromotion

n8n node to interact with WB API

Actions28

Overview

This node is designed to interact with a calendar promotions system, specifically allowing users to upload promotion data to the calendar. It is useful in scenarios where businesses or marketers want to programmatically manage promotional campaigns by uploading details such as promotion IDs and associated product nomenclatures. For example, a retailer could use this node to schedule and upload multiple promotions for different products at once, automating the process of updating their promotional calendar.

Properties

Name Meaning
Data JSON object containing the promotion details to upload. It includes:
- promotionID: Numeric identifier of the promotion.
- uploadNow: Boolean indicating whether to upload immediately.
- nomenclatures: Array of numeric identifiers representing the products involved in the promotion.

Example of the Data property value:

{
  "promotionID": 1,
  "uploadNow": true,
  "nomenclatures": [
    1,
    3,
    642
  ]
}

Output

The node outputs JSON data reflecting the response from the calendar promotions upload operation. This typically includes confirmation of the upload status, any errors encountered, or details about the processed promotions. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external promotions calendar service.
  • The node uses a base URL configured from an imported OpenAPI specification.
  • Proper configuration of HTTP headers (Accept: application/json, Content-Type: application/json) is set by default.
  • No additional environment variables are explicitly required beyond the API authentication token.

Troubleshooting

  • Common Issues:
    • Invalid or missing promotion ID in the input JSON may cause the upload to fail.
    • Incorrect formatting of the nomenclatures array (e.g., non-numeric values) can lead to errors.
    • Network or authentication failures if the API key is invalid or missing.
  • Error Messages:
    • Errors related to authorization usually indicate issues with the provided API key; verify credentials.
    • Validation errors from the API often point to malformed JSON or missing required fields; ensure the Data property matches the expected schema.
  • To resolve these, double-check the input JSON structure, confirm API credentials, and ensure network connectivity.

Links and References

  • No direct external links are provided in the source code.
  • Users should refer to the external calendar promotions API documentation for detailed schema and error codes.

Discussion