Реалізація експорту товарів із сайту в 1С (CommerceML)

Реалізація експорту товарів з сайту в 1С (CommerceML)

Якщо імпорт з 1С — це синхронізація каталогу на сайт, то експорт — обернена задача: передача заказів, залишків або даних про клієнтів назад в 1С. Часто потребує у інтернет-магазинах, де 1С — система обліку, а сайт — точка продажу.

Що передається в 1С

Найбільш поширені сценарії:

Протокол обміну (сторона сайту)

1С запрошує дані за протоколом CommerceML2:

GET /1c-exchange/?type=sale&mode=checkauth
GET /1c-exchange/?type=sale&mode=init
GET /1c-exchange/?type=sale&mode=query        — отримати список замовлень
POST /1c-exchange/?type=sale&mode=success     — підтвердження отримання
GET /1c-exchange/?type=sale&mode=file&filename=sale.xml — скачати файл

Генерація sale.xml

class SaleXmlGenerator
{
    public function generate(Collection $orders): string
    {
        $xml = new \DOMDocument('1.0', 'UTF-8');
        $root = $xml->createElement('КоммерческаяИнформация');
        $root->setAttribute('ВерсияСхемы', '2.10');
        $xml->appendChild($root);

        foreach ($orders as $order) {
            $orderNode = $xml->createElement('Документ');

            $this->addElement($xml, $orderNode, 'Ід', $order->uuid);
            $this->addElement($xml, $orderNode, 'Номер', $order->number);
            $this->addElement($xml, $orderNode, 'Дата', $order->created_at->format('Y-m-d'));
            $this->addElement($xml, $orderNode, 'Сумма', number_format($order->total, 2, '.', ''));

            // Контрагент
            $client = $xml->createElement('Контрагенты');
            $agent = $xml->createElement('Контрагент');
            $this->addElement($xml, $agent, 'Наименование', $order->customer_name);
            $client->appendChild($agent);
            $orderNode->appendChild($client);

            // Товари
            $products = $xml->createElement('Товары');
            foreach ($order->items as $item) {
                $product = $xml->createElement('Товар');
                $this->addElement($xml, $product, 'Ід', $item->product->onec_guid);
                $this->addElement($xml, $product, 'Наименование', $item->product->name);
                $this->addElement($xml, $product, 'Количество', $item->quantity);
                $products->appendChild($product);
            }
            $orderNode->appendChild($products);

            $root->appendChild($orderNode);
        }

        return $xml->saveXML();
    }
}

Підтвердження отримання замовлень

1С після успішного отримання відправляє список GUID оброблених замовлень. Сайт помічає їх як передані в 1С:

public function markAsSent(Request $request): Response
{
    $guids = explode("\n", $request->getContent());

    Order::whereIn('uuid', array_filter($guids))
         ->update(['sent_to_1c' => true, 'sent_to_1c_at' => now()]);

    return response('success');
}

Оновлення статусів з 1С

1С може повертати статуси обробки замовлень (оплачен, відгружен, отменён). Сайт приймає оновлені замовлення через POST /1c-exchange/?type=sale&mode=file:

public function processSaleResponse(string $xmlPath): void
{
    $xml = simplexml_load_file($xmlPath);

    foreach ($xml->Документ as $doc) {
        $guid = (string) $doc->Ід;
        $status = (string) $doc->Статус;

        Order::where('uuid', $guid)->update([
            'status' => $this->mapOnecStatus($status),
            'onec_status' => $status,
        ]);
    }
}

private function mapOnecStatus(string $onecStatus): string
{
    return match($onecStatus) {
        'Оплачен' => 'paid',
        'Отгружен' => 'shipped',
        'Отменён' => 'cancelled',
        default => 'unknown',
    };
}

Типичні складності

• Пусті GUID товарів — якщо товар створен на сайте, а не імпортований з 1С, його GUID в 1С невідомий. Потрібна логіка створення нового товара в 1С або зіставлення за артикулом
• Кодування — деякі версії 1С вимагають файли в Windows-1251
• Тестування — потрібен доступ до тестової бази 1С клієнта на етапі розробки

Лінія часу

Експорт замовлень в 1С з підтвердженням отримання та оновленням статусів: 8–14 робочих днів.