Actions30
Overview
This node integrates with the MoySklad API v1.2 to perform operations on various resources, including Products. Specifically, for the Product - Get operation, it retrieves detailed information about a single product by its ID from the MoySklad inventory system.
Typical use cases include:
- Fetching product details such as name, price, stock levels, and attributes for further processing or display.
- Integrating product data into other systems like e-commerce platforms, ERPs, or reporting tools.
- Automating workflows that require up-to-date product information from MoySklad.
For example, you might use this node to get a product's full details before updating your online store catalog or to verify stock availability before confirming an order.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the product to retrieve. This is required for the Get operation. |
| Additional Options | A collection of optional parameters to customize the request: |
| Expand | Comma-separated list of related entities to expand in the response (e.g., linked documents). |
| Filters | Semicolon-separated filters to apply when querying, supporting custom fields (e.g., attributes.name=value). Not typically used in Get but available. |
| Limit | Maximum number of items to return (used mainly in list operations, default 100). |
| Offset | Number of items to skip before starting to collect the result set (default 0). |
Output
The output JSON structure for the Get Product operation contains the full product object as returned by the MoySklad API. This includes all standard product fields such as:
- Product identifiers
- Names and descriptions
- Pricing and currency details
- Stock and availability information
- Linked entities expanded if requested (e.g., categories, images)
- Custom attributes and metadata
If the node encounters an error (e.g., invalid ID or authorization failure), it throws an error with the HTTP status code and the API response message.
No binary data output is produced by this operation.
Dependencies
- Requires a valid MoySklad API token credential configured in n8n.
- The node uses the official MoySklad REST API endpoint at
https://api.moysklad.ru/api/remap/1.2. - Network connectivity to the MoySklad API service is necessary.
- No additional external libraries beyond Axios (bundled) are required.
Troubleshooting
- Missing API credentials: The node will throw an error if the API token is not configured or missing.
- Invalid or non-existent product ID: The API may return 404 or other client errors if the provided ID does not correspond to any product.
- Rate limiting (HTTP 429): The node implements retry logic with exponential backoff, but excessive requests may still fail.
- Malformed filters or expand parameters: Incorrect formatting in filters or expand options can cause API errors.
- Timeouts or network issues: The node has a 60-second timeout; ensure stable internet connection.
To resolve errors, verify the API token, check the product ID correctness, and review the additional options syntax.