MySklad: Product Synchronization via API

Important:

When running agents via cron, deactivation of products outside selected groups now works: with the option enabled, such products will start being deactivated.

Security:

Temporary files for importing current stock levels are protected from web access.

New:

Filter by MySklad groups: groups of any nesting level, tree-based selection with search, selection counter.

Blocks 'filtratsiya (transliterated Russian)' and 'aktivnost (transliterated Russian)' on entity tabs: settings in one place, tooltips, explanation 'kak rabotaet (transliterated Russian)'.

Separate price import filter: own groups and own flag property.

Option 'Update item even if there are no changes'.

Improved:

New design for settings blocks and documentation for them.

Fixed:

'aktivnost (transliterated Russian)' is handled by unified rules during import, webhooks, and deactivation agents; the additional activity field works in webhooks, archived and out-of-group products no longer toggle in a loop.

Modification webhooks now consider subgroups and the new parent group, and if the parent fails to load, TP is not deactivated.

Failure to load MySklad groups or additional fields no longer resets settings and does not deactivate products 'vne grupp (transliterated Russian)'.

Groups with %, _, and ; symbols in the name.

Modifications without a parent product are treated as skipped with a warning in the log.

The multiple-choice field for external agents no longer loses its value.

Error messages on the settings page, import log, and a typo in a tooltip.

New:

New setting "Create new items as inactive" for products, services, and kits: new items from MySklad appear on the site as disabled; the manager enables them, and the module no longer activates them.

Fixed:

Changing the article number and other string properties to a value with leading zeros (for example, from 33336 to 033336) is now transferred to the site.

Improved:

The authorization settings now include a choice of method: token or login and password. The module connects to MySklad only using the selected method, and data from the other method is cleared upon saving. It is now possible to switch between token and login/password (and vice versa) without manually clearing the fields.

Fixed:

File upload from additional fields of the 'file' type has been fixed when MySklad provides them from cloud storage: the file extension is now correctly determined.

With the 'Completely ignore activity' setting enabled, deleting a product in MySklad no longer deactivates the corresponding element on the site, and archived products and products outside the selected groups are no longer updated via webhooks.

Support for external event handlers of the module has been improved.

Improvements in profile functionality.

When updating products with group updates enabled, the element section is no longer overwritten on each run if the group in MySklad has not changed.

Sets are no longer overwritten on each import if their composition in MySklad has not changed.

Cron execution no longer overlaps with itself during long imports, which previously caused unnecessary requests to MySklad. A stuck execution now stops automatically after the time specified in the 'Maximum time for a single script run' setting (tab 'Other', default 30 minutes), and the next execution continues the import from where it stopped. The cron/log.txt file records the start, end, and duration of each run.

Images in additional properties: when an image is deleted or replaced for one product, it no longer disappears from other products sharing the same image; image replacement is recorded from the first run, and the photo order follows MySklad without re-uploading files.

Images in multiple properties: when an image is deleted or replaced in MySklad, unused files are now removed from the site if they are no longer used elsewhere. Files shared by multiple products or serving as the source for both the announcement and detailed images are preserved.

Product import errors via webhook (missing information block, empty group, element save error) are now logged in the module log.

New:

Profiles are now enabled by default and are visible in a separate panel: you can see which profile you are currently in, and switch, rename, set color and description, add, or remove profiles from a single window.

Each entity tab now includes a "Completely ignore activity" setting: with it enabled, the module does not change the activity of products, modifications, services, or kits during import or via webhooks — activity is fully controlled by the website. Individual deactivation agents continue to operate according to their own settings.

New events for external code: OnBeforeDeleteItem (triggered on deletion via webhook, even if the element does not exist in the catalog), OnBuildImportFilter (modifies the request filter to MySklad in any pipeline), OnWebhookSkipped (webhook for an unprocessed entity). OnAfterImportItems now passes the IDs of created elements. A log entry "Skipped during creation" has been added to the agent log. The API client methods put() and delete() now return the MySklad response — errors during webhook modification and deletion are no longer lost.

External code can add a custom agent to the module: it appears on the settings page as a block identical to the standard ones, with a toggle, interval, its own parameters, information about the last and next run, and cron-based execution. Agent states (current step, cutoffs) are no longer cleared when saving settings.

During import of prices and stock levels, an external handler can substitute its own catalog elements for products that the module could not find by XML_ID — including multiple elements for a single MySklad position.

The stock report can be configured externally: an external handler can modify the request parameters to MySklad — for example, requesting grouping by batches — and rows of types that the module cannot parse are passed to it for processing instead of being silently skipped.

Improved:

General security improvements for the module.

New items receive prices immediately upon creation, within the same import run, eliminating the need to wait for the next price agent execution. This applies to items, modifications, services, and sets that have price import enabled.

If a single MySklad webhook contains more events than the configured limit, the excess events are no longer silently dropped: they are logged in the module log (type, action, link).

Fixed:

Module settings: when authorization data is empty or invalid, the MySklad error message is displayed again, instead of the service string '[Code: #ERROR_ID#] #TEXT#'.

Import agents for items, prices, stock balances, quick stock balances, discounts, and groups no longer lose changes made in MySklad during a long full or incremental exchange: the next exchange retrieves them starting from the moment the previous exchange began.

Module cache is under control: once daily, a hidden agent automatically removes records with expired expiration dates, primarily service records for webhook processing that accumulated until manual cleanup. Active records are not affected. The agent is enabled after saving the module settings.

General improvements to language phrases.

- New groups of marked products have been added: motor oils and vegetable oils, cosmetics, household chemicals and personal hygiene products, canned foods, building materials, natural fur, radioelectronics, laptops and smartphones, grocery items, animal feed, and children's toys.

- Unknown marking groups received from MySklad are flagged with a warning in the import log.

- The modification article number can now be exported to an information block property.

- Fixed section assignment when creating products: a product without a group in MySklad could end up in the section of the previously imported product instead of the default section.

- General module fixes and improvements. Security enhancements.

Minimum PHP version for the module: 8.0

- Improved PHP code quality with PHPStan level 4 (PHP version compatibility: 8.0, 8.1, 8.2)

- Security update

- Added the ability to select multiple product groups for each entity: products, modifications, services, sets, and product groups.

- Added substring search in product group selection lists.

- Added a new "One-time Import" page in the administrative diagnostics with a request preview, log, and progress for each step. Documentation: ( ).

- Added one-time import of quick (current) stock levels from the new diagnostics page.

- Added automatic updating of parent products when stock levels, prices, or quick stock levels of their modifications change (enabled via a separate setting).

- Fixed saving of list property values for products that come from boolean properties in MySklad.

- Fixed deactivation of modifications.

- Improved performance with MySklad when requesting assortment, modification prices, and deactivation — requests use a lightweight mode, which speeds up the response from MySklad.

- Improved backward compatibility with old group settings: previously saved single values continue to work as before.

- Improved loading of resources for the module's administrative pages.

- Improved module security.

- Added product and section identification by UUID from MS (id field), enabled in the "Other" tab.

- When importing discounts with a specific price, it is no longer necessary to import the price itself (works if only products are selected in the discount).

- Improved logging information when importing kits.

- Added the ability to ignore section changes for products on the site that have more than 1 section selected.

- Added an option to ignore the section active flag when exchanging sections in the "Groups" tab.

- Fixed an error setting the marking type for product modifications from a parent product.

- Changed the names of deactivation settings in the "Groups" tab.

- Minor fixes in module settings.

- Module refactoring.

- Added the ability to rename exchange profiles.

- Added the ability to load group (section) descriptions.

- Fixed an issue with running manual and automatic full imports on the same day.

- Fixes in the InfoBlock element analysis tool.

- Added documentation for the analysis tool:

- A new section has been added to the module diagnostics called "Tools". It implements tools for tracking duplicate products by external code, and also allows viewing which products exist in MySklad but not on the website, as well as by external code.

- An event has been added to the module that is triggered after price import. More details:

Fixes in the activity mechanism based on a flag property

- Fixed an error updating the barcode in a product when the option "Import first barcode" is selected.

- Added the ability to manage product activity on the website directly via an additional MySklad product field (field type "checkbox"). More details:

- Added the ability to specify a default status for new partners

- Fixed an error when searching for a partner