ave-cms/help/en/modules/commerceml.md

Exchange with 1C (CommerceML)

The commerceml module accepts standard 1C HTTP exchange and stream parses XML via XMLReader. To work, you need the Products and Scheduler modules. This commerce package is not published in the general module catalog for a clean installation.

Safe launch

1. Create a profile and select a product category.
2. Compare the external ID, article, price and balance with the real fields of the category.
3. Leave Create unknown products turned off.
4. Download the test XML and check the log.
5. After verification, allow creation; Include publication of new products separately.

Exchange address: /exchange/1c/<profile-code>. Each profile has its own login and password. The password is stored in a secure secret vault and is not displayed in panels. Names of uploaded files are normalized, only XML is allowed, parsing executed with LIBXML_NONET.

After checkauth, the server creates an isolated temporary exchange session. The init, chunk upload, and import steps require the issued ave_commerceml cookie. Concurrent and sequential exchanges therefore cannot append XML to one another. A chunk is limited to 20 MB and the complete session to 200 MB. Request data is streamed in small blocks, and the temporary session is removed after an import attempt. The commerceml.cleanup scheduler task removes incomplete sessions older than three days.

First, the product is searched by the saved external ID link, then by the article field. An unknown item is either skipped or created in the selected category. All runs save the number of processed, created, updated and errored positions.

Filter commerceml.document.payload allows you to change payload before saving the document. Events commerceml.item.failed and commerceml.import.completed are suitable for notifications and integration log.