List orders with filters by status, customer name, number, and created-date range. Returns (summary): pagination + array of {id, number, status, total, customer, phone, itemCount, createdAt}. Use detail:'full' for line items/delivery/payments, raw:true for the untouched payload.

Get a single order by RetailCRM id or externalId. Returns a shaped order; detail:'full' adds items, delivery, payments, comments.

Create an order with line items and delivery. Link an existing customer via customer_id/customer_external_id, or pass first_name (+phone/email) to create one inline. Returns {success, id, order?}.

Update an order (status, customer, delivery, comments). Only the fields you pass are sent. Returns {success}.

Order change history incl. status transitions; supports incremental sync via filter_since_id and a date window. Returns {history[], pagination}.

List/search customers by name, email, phone, created-date. Returns (summary): pagination + array of {id, name, email, phone, ordersCount, totalSpent}. detail:'full' adds address/externalId/all phones.

Get a single customer by id or externalId. Returns a shaped customer; detail:'full' adds address and contact details.

Create a customer with name, contacts, address, optional externalId. Returns {success, id}.

Edit an existing customer (name, email, phones, address) by id or externalId. Only the fields you pass are sent. Returns {success}.

Merge duplicate customers into a target; merged records are DELETED. Returns {success}.

Customer field-change log for growth/churn signals and incremental sync. Returns {history[], pagination}.

List catalog products with filters by name, active, group, price range. Returns pagination + array of {id, name, article, active, url, groups, offers}.

List product groups (category tree). Returns {productGroup[], pagination}.

Stock levels (and cost prices) per offer/warehouse. Use details:true for the per-store breakdown. Returns {offers[], pagination}.

Record a payment against an order (amount, type, status, paid_at). Returns {success, id}.

Edit an existing order payment (amount/status/paid_at). Returns {success}.

Delete an order payment by id. Returns {success}.

List free-text notes attached to customers. Returns {notes[], pagination}.

Add a note to a customer (by id or externalId). Returns {success, id}.

Delete a customer note by id. Returns {success}.

List follow-up tasks/reminders, filterable by status/performer/customer. Returns {tasks[], pagination}.

Create a task (text, due datetime, performer, linked order/customer). Returns {success, id}.

Edit a task or mark it complete. Returns {success}.

List customer segments (RFM/marketing cohorts). Returns {segments[], pagination}.

List expense records (for margin/profit analytics) by date and cost group. Returns {costs[], pagination}.

Create an expense record, optionally attributed to an order. Returns {success, id}.

List files attached to orders/customers. Returns {files[], pagination}.

Get a file's metadata by id. Returns {file}.

Upload a file (UTF-8 text or base64 binary). Returns {success, file}.

All order statuses (codes, names, groups, ordering). Call before filtering/updating orders by status.

All delivery types with codes, names, default costs.

All payment types with codes and names.

All warehouses/stores (codes, names, types).

All sites/stores the API key can act on — use the returned code as the site param on multi-site create/edit.

Valid country ISO codes for addresses/delivery.

All order types (codes/names) — valid values for create_order's order_type.

All order methods (acquisition channels).

Period-scoped order summary: exact totalCount for the date range plus revenue, average order value, and status distribution aggregated over up to max_pages×100 orders (partial:true if the window exceeds that).

Period-scoped new-customer count for a date range. Returns {period, newCustomers}.