# 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.