WbReports icon

WbReports

n8n node to interact with WB API

Actions26

Overview

This node interacts with a reports API to retrieve analytics data related to goods labeling within a specified date range. It is designed to fetch retention reports, specifically the "Get Analytics Goods Labeling" report under the resource "Отчёты Об Удержаниях" (Retention Reports). This node is useful for users who need to analyze product labeling data over time, such as quality control teams, compliance officers, or business analysts monitoring product information accuracy.

Practical examples include:

  • Generating monthly reports on goods labeling compliance.
  • Tracking changes in product labels over a specific period.
  • Integrating labeling analytics into broader business intelligence workflows.

Properties

Name Meaning
Date From The start date of the reporting period in YYYY-MM-DD format.
Date To The end date of the reporting period in YYYY-MM-DD format.

Both properties are required and define the time window for which the analytics data will be retrieved.

Output

The node outputs JSON data containing the analytics results for goods labeling within the specified date range. The exact structure depends on the API response but typically includes metrics and details relevant to product labeling analytics.

If the node supports binary data output, it would represent files or documents related to the report, but based on the provided code and context, the output is primarily JSON.

Dependencies

  • Requires an API key credential for authentication with the external reports API.
  • The node uses a base URL defined in an imported Swagger/OpenAPI specification.
  • No additional environment variables or configurations are explicitly required beyond the API credential.

Troubleshooting

  • Common issues:

    • Invalid date formats: Ensure dates are provided in YYYY-MM-DD format.
    • Missing required parameters: Both "Date From" and "Date To" must be set.
    • Authentication errors: Verify that the API key credential is correctly configured and has necessary permissions.
    • Network or API downtime: Check connectivity and API service status.
  • Error messages:

    • Errors related to invalid query parameters usually indicate incorrect date formatting or missing fields.
    • Authentication failures suggest problems with the API key or its configuration.
    • Unexpected API responses may require checking the API documentation or contacting support.

Links and References

  • Date Format Reference
  • Relevant API documentation should be consulted for detailed response schema and error codes (not provided here).

Discussion