WbFbs icon

WbFbs

n8n node to interact with WB API

Actions34

Overview

This node interacts with the Wildberries (WB) FBS (Fulfillment by Seller) API to request stickers for specific supply boxes. Specifically, it posts a request to retrieve TRBX stickers by a given supply ID. This is useful in logistics and warehouse management scenarios where you need to generate or fetch labels/stickers for shipment boxes associated with a particular supply.

Practical examples include:

  • Generating shipping labels in different formats (SVG, PNG, ZPL vertical/horizontal) for boxes in a supply.
  • Automating label printing workflows in fulfillment centers.
  • Integrating with WB's API to streamline packaging and dispatch processes.

Properties

Name Meaning
Supply Id The unique identifier of the supply for which the TRBX stickers are requested.
Type The format/type of the sticker to be returned. Options: svg, zplv (ZPL vertical), zplh (ZPL horizontal), png.
Trbx Ids A JSON array containing the list of box IDs (trbxIds) for which stickers should be generated or retrieved.

Output

The node outputs JSON data representing the requested stickers for the specified boxes within the supply. The exact structure depends on the API response but typically includes the sticker data in the requested format (e.g., SVG markup, PNG image data encoded as base64, or ZPL commands).

If binary data is returned (e.g., PNG images), it would be included accordingly, allowing downstream nodes to handle or save the images.

Dependencies

  • Requires access to the Wildberries API with appropriate authentication (an API key or token).
  • The node expects the base URL and endpoints defined in the bundled OpenAPI specification.
  • No additional external dependencies beyond the configured WB API credentials and network access.

Troubleshooting

  • Invalid Supply Id or Trbx Ids: If the supply ID or box IDs are incorrect or do not exist, the API may return errors or empty results. Verify the IDs before running the node.
  • Unsupported Sticker Type: Using an unsupported type value will likely cause the API to reject the request. Use one of the allowed options: svg, zplv, zplh, or png.
  • Authentication Errors: Ensure that the API credentials are correctly set up and valid; otherwise, the request will fail with authorization errors.
  • Malformed JSON in Trbx Ids: The trbxIds property expects a JSON array string. Invalid JSON formatting will cause parsing errors. Make sure the input is a valid JSON array string.

Links and References

Discussion