MoySklad

Interact with MoySklad API v1.2

Actions30

Overview

This node integrates with the MoySklad API v1.2 to manage product data within the MoySklad inventory system. Specifically, for the Product - Create operation, it allows users to create new product entries by sending raw JSON data that conforms to the MoySklad API schema.

Typical use cases include automating product catalog updates, bulk importing new products from external sources, or integrating product creation into broader workflows such as order processing or inventory management.

For example, a user might prepare a JSON object describing a new product's name, price, and attributes, then use this node to add that product directly into their MoySklad account without manual entry.

Properties

Name Meaning
Body Raw JSON body representing the product details as required by the MoySklad API.
Additional Options Collection of optional parameters:
  Expand Comma-separated list of related entities to expand in the response (e.g., linked categories).
  Filters Semicolon-separated filters to apply when querying, supports custom fields (not used in create).
  Limit Number limiting the amount of returned items (default 100, max 1000) (not used in create).
  Offset Number offset for pagination (default 0) (not used in create).

Note: For the Create operation, only the Body property is relevant since it sends data to create a new product. The additional options mainly apply to retrieval operations.

Output

The output JSON contains the newly created product object as returned by the MoySklad API. This typically includes all product fields such as ID, name, metadata, and any expanded relations if specified.

Example output structure (simplified):

{
  "id": "product-uuid",
  "name": "New Product",
  "code": "SKU123",
  "description": "Product description",
  "attributes": [...],
  "meta": {...}
}

No binary data is produced by this node.

Dependencies

  • Requires an active MoySklad API token credential configured in n8n.
  • Uses Axios HTTP client internally to communicate with the MoySklad REST API at https://api.moysklad.ru/api/remap/1.2.
  • Network connectivity to MoySklad API endpoints is necessary.

Troubleshooting

  • Missing API credentials error: If the node throws "Missing MoySklad API credentials," ensure you have configured a valid API token credential in n8n.
  • HTTP errors (status >= 400): The node surfaces API errors with status codes and messages. Common issues include invalid JSON in the Body, missing required fields, or permission issues. Verify the JSON payload matches the MoySklad API specification.
  • Rate limiting (HTTP 429): The node implements retry logic with exponential backoff on rate limits. If requests repeatedly fail due to rate limits, consider reducing request frequency or contacting MoySklad support.
  • Invalid JSON in Body: Ensure the Body input is valid JSON. Malformed JSON will cause parsing errors before the request is sent.

Links and References

Discussion