Yes. Krokul CRM integrates with the Epicentr marketplace through the seller Merchant API. An order from the Epicentr seller account becomes a deal with products from your catalog, and the buyer becomes a contact. Krokul sends the order status, the waybill number and manager comments back to Epicentr, and updates offer prices and availability from the Krokul warehouse.
Krokul requests /v4/oms/orders with the filter[updatedAt][from] filter and walks the pages with a cursor. Each new order becomes an «Epicentr No. …» deal in the pipeline of the connection, and the order number becomes its external key. Order lines match Krokul catalog products by the seller SKU, so the warehouse reserve is set at once. A repeated read creates no duplicate.
A manager confirms the order in Krokul, and the deal moves to the «Confirmed» stage. Krokul reads the allowed transitions from /v2/oms/orders/{orderId}/allowed-statuses and calls change-status with the confirmed_by_merchant code. To cancel, Krokul passes a reason from the Epicentr list, such as product_not_available, and closes the deal as lost with the same reason.
The manager creates a Nova Poshta or Ukrposhta shipment on the deal. Krokul writes the waybill number to the order with PATCH /v1/oms/orders/{orderId}/shipment-number. According to the Epicentr documentation, this number turns on tracking and completes the order once the parcel is picked up, and the completed status closes the deal as won.
When a product stock level or price changes, Krokul sends a batch to POST /v1/offers with the availability and prices.price fields by SKU. Epicentr accepts up to 1000 items in one request and returns a requestId. With it, Krokul reads the result of each item and shows items with the skipped or forbidden status in the log with the error code.
Order comments from /v2/oms/orders/{orderId}/comments appear in the deal feed next to the correspondence. The manager writes a note for Epicentr on the deal, and Krokul adds it to the order comments in the seller account.
| Epicentr | Direction | Krokul | When |
|---|---|---|---|
| Order (/v4/oms/orders) | Epicentr → Krokul | «Epicentr No. …» deal with an external key | Polling by the time of the last change |
| Order lines | Epicentr → Krokul | Deal lines with catalog products | Together with the deal |
| Client data (full name, phone) | Epicentr ↔ Krokul | Deal contact | A new order or a contact edit |
| Order status (change-status) | Epicentr ↔ Krokul | Deal stage | A stage change in Krokul or a status change in the seller account |
| Cancellation reason | Epicentr ↔ Krokul | Deal loss reason | An order is canceled |
| Waybill number (shipment-number) | Krokul → Epicentr | Deal shipment | After the waybill is created |
| Order comments | Epicentr ↔ Krokul | Entries in the deal feed | A new comment on either side |
| Offer price and availability (/v1/offers) | Krokul → Epicentr | Product and warehouse stock | A price or stock change |
card/api-create for each new order and store the order number through externalRef/api-upsert.card.statusChanged filtered by pipeline, check the x-crm-signature header and move the order in Epicentr with change-status.activity/api-create.Yes. Epicentr orders become deals with catalog products, and the status, waybill, comments, prices and availability go back to the seller account.
In the seller account, on the API tab of the company settings. The category manager opens this tab, because the API runs as a closed beta for a limited group of companies.
After the next poll. Epicentr sends no events, so Krokul reads the orders changed since the previous pass on a schedule.
Yes. The manager closes the deal as lost and picks a reason, and Krokul sends the cancellation with the matching reason from the Epicentr list.
Epicentr sends no events about new orders, so Krokul reads the order list on a schedule and takes the orders changed since the previous pass. The Merchant API runs as a closed beta for a limited group of companies, and your category manager opens the API tab in the company settings.
Tell us which service you use and what should move between it and Krokul. We reply with the way to do it and when it will be ready.
Request received. We reply to your email.
Epicentr is a trademark of its owner. Krokul is not affiliated with Epicentr.