# Epicentr + Krokul CRM

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.

**Status:** Via API and webhooks.

## What your team gets

### Epicentr orders in the sales pipeline

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.

### The deal stage changes the order status

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.

### A waybill from the deal card in the seller account

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.

### Offer prices and availability from the Krokul warehouse

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 in the deal feed

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.

## What moves between Epicentr and Krokul

| Epicentr | Krokul | Direction | When |
|---|---|---|---|
| Order (/v4/oms/orders) | «Epicentr No. …» deal with an external key | Epicentr → Krokul | Polling by the time of the last change |
| Order lines | Deal lines with catalog products | Epicentr → Krokul | Together with the deal |
| Client data (full name, phone) | Deal contact | Epicentr ↔ Krokul | A new order or a contact edit |
| Order status (change-status) | Deal stage | Epicentr ↔ Krokul | A stage change in Krokul or a status change in the seller account |
| Cancellation reason | Deal loss reason | Epicentr ↔ Krokul | An order is canceled |
| Waybill number (shipment-number) | Deal shipment | Krokul → Epicentr | After the waybill is created |
| Order comments | Entries in the deal feed | Epicentr ↔ Krokul | A new comment on either side |
| Offer price and availability (/v1/offers) | Product and warehouse stock | Krokul → Epicentr | A price or stock change |

## How to connect today

### Your own flow through the Krokul API and webhooks

1. Ask your Epicentr category manager to open the API tab in the company settings, and generate a seller token with the mp_ prefix there.
2. In Krokul, create an API key with scopes for deals, contacts and products. Read /v4/oms/orders on a schedule, call `card/api-create` for each new order and store the order number through `externalRef/api-upsert`.
3. Subscribe a Krokul webhook to `card.statusChanged` filtered by pipeline, check the `x-crm-signature` header and move the order in Epicentr with change-status.
4. Pass the waybill number from the deal to PATCH /v1/oms/orders/{orderId}/shipment-number, and write the response of each call to the deal feed through `activity/api-create`.

### For integrators

The Epicentr Merchant API takes the seller token in the Authorization header and returns all dates in UTC. On the Krokul side, the connection relies on the public API, webhooks signed with HMAC-SHA256, a delivery log with redelivery and `externalRef` external keys for orders and products. You can run the flow on a demo company in the Krokul sandbox.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul integrate with the Epicentr marketplace?

Yes. Epicentr orders become deals with catalog products, and the status, waybill, comments, prices and availability go back to the seller account.

### Where do I get an Epicentr Merchant API token?

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.

### How fast does an Epicentr order appear in Krokul?

After the next poll. Epicentr sends no events, so Krokul reads the orders changed since the previous pass on a schedule.

### Can I cancel an Epicentr order from the deal card?

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.

## Limits

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.

## Related services

- [Rozetka](https://krokul.com/en/integrations/rozetka/index.md)
- [Prom.ua](https://krokul.com/en/integrations/prom-ua/index.md)
- [Horoshop](https://krokul.com/en/integrations/horoshop/index.md)
- [Nova Poshta](https://krokul.com/en/integrations/nova-poshta/index.md)
- [Meest](https://krokul.com/en/integrations/meest/index.md)
- [Checkbox](https://krokul.com/en/integrations/checkbox/index.md)

[Marketplaces and shops (Ukraine)](https://krokul.com/en/integrations/category/marketplaces-ua/index.md)

Epicentr is a trademark of its owner. Krokul is not affiliated with Epicentr.

Updated: 2026-10-15

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs