Интеграция 1С-Битрикс с МоёДело

Интеграция 1С-Битрикс с МоёДело

МоёДело — облачный сервис бухгалтерского и налогового учёта для малого бизнеса. Его аудитория — ИП и небольшие ООО на УСН, которые продают через интернет-магазин на Битрикс. Ручной перенос заказов в МоёДело — типичная боль: каждый заказ нужно завести как реализацию, контрагента создать вручную, счёт сформировать отдельно. МоёДело предоставляет публичный API для автоматизации этих операций.

API МоёДело

API документация: https://api.moedelo.org/. Авторизация через API-ключ (Header: X-DM-Auth-Token). Основные ресурсы: counteragents (контрагенты), documents/sale (документы реализации), invoices (счета), payments/income (входящие платежи).

class MoeDelоClient
{
    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'),
    ]);
}

Автоматизация через события

Состав работ

• PHP-клиент МоёДело API
• Поиск и создание контрагентов (физлица и юрлица)
• Создание документов реализации и счетов
• Регистрация платежей и возвратов
• Таблица синхронизации, обработка ошибок и повторные попытки

Сроки: 3–5 недель базовая интеграция. 6–8 недель с возвратами, прикреплением PDF-счетов и мониторингом.