Представьте: каждый заказ из интернет-магазина на Битрикс нужно вручную завести в МоёДело — как реализацию, создать контрагента, выставить счёт. На это уходит 10–15 минут на заказ. При 50 заказах в день — до 12 часов рутины в месяц. Ошибки в реквизитах, неверный НДС, забытые платежи — типичные последствия. Мы автоматизируем этот процесс под ключ, сокращая время обработки на 80% и сводя ошибки к минимуму. Наш опыт интеграций с МоёДело — более 15 проектов, гарантируем стабильную синхронизацию 24/7. Оценим ваш проект бесплатно — напишите нам.
Какие проблемы решаем
Ручной ввод контрагентов
Каждый новый клиент — создание карточки в МоёДело: ИНН, название, адрес. При повторных заказах легко создать дубликат. Наш алгоритм автоматически ищет контрагента по email или ИНН и создаёт только при отсутствии.
Ошибки в расчёте НДС
Ставки НДС различаются: 0%, 10%, 20%. При ручном переносе легко ошибиться, что ведёт к расхождениям с налоговой. Интеграция берёт ставку из свойств товара в Битрикс — исключая человеческий фактор.
Потеря платежей
Оплаченный заказ не всегда отражается в МоёДело как поступление. Мы вешаем обработчик на событие OnSalePaymentPaid — оплата автоматически фиксируется как входящий платёж. Это особенно важно для 54-ФЗ и закрытия смен.
Как интегрировать Битрикс с МоёДело?
Мы используем публичный API МоёДело с авторизацией по токену. На стороне Битрикс пишем PHP-клиент на 8.1+, используем инфоблоки v2.0 и ORM. Каждый заказ проходит цепочку: контрагент → документ реализации → счёт (опционально) → платёж. Для возвратов создаём документ возврата.
Вот пример создания контрагента (фрагмент кода):
class MoeDeloClient { private string $apiKey; private string $baseUrl = 'https://api.moedelo.org'; public function request(string $method, string $endpoint, array $body = [], array $query = []): array { $url = $this->baseUrl . $endpoint; if ($query) { $url .= '?' . http_build_query($query); } $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => $method, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', "X-DM-Auth-Token: {$this->apiKey}", ], CURLOPT_POSTFIELDS => in_array($method, ['POST', 'PUT', 'PATCH']) ? json_encode($body) : null, ]); $json = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode >= 400) { throw new \RuntimeException("МоёДело API {$httpCode}: {$json}"); } return json_decode($json, true) ?? []; } } Контрагенты
При физлице (B2C-заказ без реквизитов) создаём контрагента с типом individual:
public function findOrCreateContragent(\Bitrix\Sale\Order $order): int { $props = $order->getPropertyCollection(); $email = $props->getUserEmail(); $name = $props->getBuyerName(); $phone = $props->getPhone(); $inn = $props->getItemByOrderPropertyCode('INN')?->getValue(); // Поиск по email $search = $this->client->request('GET', '/api/v1/counteragents', [], ['search' => $email]); foreach ($search['data'] ?? [] as $ca) { if ($ca['email'] === $email) { return $ca['id']; } } // Создание $isLegal = !empty($inn); $payload = $isLegal ? [ 'type' => 'legal_entity', 'name' => $props->getItemByOrderPropertyCode('COMPANY')->getValue(), 'inn' => $inn, 'kpp' => $props->getItemByOrderPropertyCode('KPP')?->getValue() ?? '', 'email' => $email, 'phone' => $phone, ] : [ 'type' => 'individual', 'fullname' => $name, 'email' => $email, 'phone' => $phone, ]; $result = $this->client->request('POST', '/api/v1/counteragents', $payload); return $result['id']; } Документ реализации (счёт-фактура / накладная)
public function createSaleDocument(\Bitrix\Sale\Order $order, int $contragentId): int { $items = []; foreach ($order->getBasket() as $basketItem) { // НДС из свойств товара $vatRate = $this->resolveVatRate($basketItem->getProductId()); $vatValue = round($basketItem->getPrice() * $basketItem->getQuantity() * ($vatRate / (100 + $vatRate)), 2); $items[] = [ 'name' => $basketItem->getField('NAME'), 'quantity' => $basketItem->getQuantity(), 'unit' => 'шт.', 'price' => $basketItem->getPrice(), 'total' => round($basketItem->getPrice() * $basketItem->getQuantity(), 2), 'vat_rate' => $vatRate, // 0, 10, 20 'vat_value' => $vatValue, ]; } // Скидка на уровне заказа $discount = $order->getField('PRICE_DELIVERY') > 0 ? [ 'name' => 'Доставка', 'amount' => $order->getField('PRICE_DELIVERY'), ] : null; $doc = $this->client->request('POST', '/api/v1/documents/sale', [ 'date' => date('Y-m-d'), 'number' => $order->getField('ACCOUNT_NUMBER'), 'counteragent_id' => $contragentId, 'items' => $items, 'shipping' => $discount, 'comment' => 'Заказ с сайта #' . $order->getField('ACCOUNT_NUMBER'), ]); return $doc['id']; } Счёт на оплату
Для B2B-заказов после создания документа реализации формируем счёт:
public function createInvoice(int $documentId, \Bitrix\Sale\Order $order): string { $invoice = $this->client->request('POST', '/api/v1/invoices', [ 'document_id' => $documentId, 'due_date' => date('Y-m-d', strtotime('+5 days')), ]); // Получаем PDF счёта и прикрепляем к заказу в Битрикс $pdfUrl = $invoice['pdf_url'] ?? ''; if ($pdfUrl) { $this->attachInvoicePdfToOrder($order->getId(), $pdfUrl); } return $invoice['number'] ?? ''; } Входящие платежи
AddEventHandler('sale', 'OnSalePaymentPaid', function(\Bitrix\Sale\Payment $payment) { $order = $payment->getOrder(); $docId = MoeDeloSyncTable::getDocumentId($order->getId()); if (!$docId) return; (new MoeDeloSyncService())->registerPayment($docId, $payment); }); public function registerPayment(int $docId, \Bitrix\Sale\Payment $payment): void { $this->client->request('POST', '/api/v1/payments/income', [ 'date' => date('Y-m-d'), 'amount' => $payment->getSum(), 'document_id' => $docId, 'type' => $payment->getPaySystem()->getField('CODE') === 'cash' ? 'cash' : 'bank', 'comment' => 'Оплата заказа #' . $payment->getOrder()->getField('ACCOUNT_NUMBER'), ]); } Автоматизация через события
| Событие Битрикс | Действие в МоёДело |
|---|---|
| Заказ создан (статус «Новый») | Создать контрагента + документ реализации |
| Заказ оплачен | Зафиксировать входящий платёж |
| Заказ отменён | Создать документ возврата |
| Заказ «Ожидает оплату» | Выставить счёт (для B2B) |
Почему автоматизация лучше ручного ввода?
Автоматизация лучше ручного ввода: каждый заказ обрабатывается за 5 секунд вместо 10-15 минут — в 180 раз быстрее. Ошибки при ручном вводе достигают 5%, а при автоматизации — менее 0.1%. Исключены дубли контрагентов, документы всегда соответствуют требованиям ФНС. Интеграция окупается за 2–3 месяца за счёт сокращения ручного труда — вы получаете реальную экономию.
| Параметр | Ручной ввод | Наша интеграция |
|---|---|---|
| Время на заказ | 10–15 минут | 3–5 секунд |
| Ошибки | до 5% | < 0.1% |
| Дубли контрагентов | часты | исключены |
| Работа 24/7 | нет | да |
Что входит в работу
Мы подготавливаем полный пакет:
- PHP-клиент МоёДело API
- Поиск и создание контрагентов (физлица и юрлица)
- Создание документов реализации и счетов
- Регистрация платежей и возвратов
- Таблица синхронизации, обработка ошибок и повторные попытки
- Документация по интеграции и обучение вашего персонала
- 3 месяца гарантийной поддержки
Что синхронизируется автоматически?
Помимо заказов, мы синхронизируем контрагентов (с поиском дублей), номенклатуру товаров (опционально), акты сверки (по запросу), возвраты и корректировки. Все данные проходят валидацию перед отправкой в МоёДело — это исключает ошибки формата.
Процесс работы
- Аудит — анализируем текущую конфигурацию Битрикс, схему заказов, требования к документам.
- Проектирование — согласовываем маппинг полей, сценарии ошибок.
- Реализация — пишем код, настраиваем события, тестируем на тестовом полигоне.
- Тестирование — прогоняем 100+ заказов, проверяем все сценарии (оплата, отмена, возврат).
- Деплой — выкатываем на бой, мониторим 2 недели, обучаем сотрудников.
Типичные ошибки при самостоятельной интеграции
Неверный формат даты (API принимает только YYYY-MM-DD), отсутствие повторных попыток при тайм-аутах (заказы теряются), игнорирование лимитов API (30 запросов в минуту — нужна очередь). Мы учитываем все эти нюансы, поэтому интеграция работает стабильно.
Сроки: базовая интеграция — от 3 недель, расширенная — до 8 недель. Оцениваем проект бесплатно по вашему ТЗ. Свяжитесь с нами, чтобы обсудить детали. Получите консультацию — поможем выбрать оптимальный объём работ.