Simplified shipment

Instructions for Simplified Shipment

What the add-on does

Creates shipments from order data, requests CDEK numbers through rus_sdek2 and saves them to shipments. It produces PDF barcode labels and copies selected shipping methods for new vendors.

Where to find the add-on

Open Add-ons → Manage add-ons → Simplified Shipment. Shipment creation is available on the order page. “Print barcode for FBS” is available in shipment information and the print menu for selected orders. The add-on settings also contain a rus_sdek2 patch section.

Prerequisites and settings

Configure the rus_sdek2 connection and shipping tariff first. Verify the order address, phone and CDEK 2 shipping method. Enter CDEK credentials only through the protected shipping configuration interface, not in chat.

• Carrier: select CDEK 2. Legacy CDEK may also appear, but the current quick workflow requests a number only when both the shipping service and carrier are sdek2.
• Order status: the status passed when creating a shipment; choose the appropriate workflow stage.
• Notification text: passed as the shipment comment. Notification delivery follows store rules.
• Show tracking number, order number and delivery service name: printed label captions, enabled by default.
• Hide shipping information block: controls the order page block, disabled by default.
• Pass seller data: disabled by default. Check the seller name, tax ID, phone and ownership form, and the corresponding rus_sdek2 modification before using it.

Quick creation uses settings for the order’s storefront. The shipping method comes from the order; there is no separate shipping-method selector in the add-on settings.

Creating a shipment

1. Open the order and verify products, quantities, address and shipping method.
2. Start simplified shipment creation. It passes all product quantities from the order; use the detailed form and check the contents for partial dispatch.
3. Check messages and the tracking number. A local shipment record alone does not confirm acceptance by CDEK.

Orders with multiple shipping methods may not provide the single shipping ID needed by the quick workflow. Use detailed creation. If a number is delayed or an error occurs, inspect the existing shipment and CDEK account before retrying: repeated clicks are not guaranteed to prevent duplicate shipments.

Printing labels

For a shipment with a tracking number, select “Print barcode for FBS”. The PDF contains a Code 128 barcode and enabled captions. This is a tracking label, not proof of carrier handover.

The current batch-printing code replaces the HTML on each iteration, so the PDF may contain only the last label. Order printing also collects all tracked shipments without filtering the supplied shipment_id. Verify the number and label count before use; orders with several shipments require additional verification and a printing fix.

rus_sdek2 patches

Two groups are available: CDEK calculation changes (declared value, INSURANCE and handling of 5% VAT) and actual seller data transmission. These modify files in the related add-on rather than merely changing settings.

1. Back up rus_sdek2 files and try the operation on a test copy.
2. Apply only the required group and read the result message.
3. Verify the shipping calculation or seller data in a test shipment.
4. Rollback is shown when the relevant backup exists. Recheck patch compatibility after updating rus_sdek2; do not blindly reapply changes over modified files.

Shipping methods for new vendors

In Multi-Vendor, mark active marketplace shipping methods for copying to new vendors. The new vendor must have a city. Adding the vendor triggers copying and city substitution; editing an existing vendor does not trigger it. Verify the copied method’s city, rate areas and parameters. Unmarked methods are not copied.

API integration

The package includes the MsShipments entity for CS-Cart API shipment operations. This is a separate integration workflow and does not replace shipping configuration. Use the installed version’s API schema for supported operations and parameters; keep access credentials in protected integration configuration.

How to check the result

1. Create a shipment for a test order with one CDEK 2 shipping method. Verify contents, status, comment and tracking number.
2. Compare the shipment in CDEK, including address, tariff and seller details when enabled.
3. Print a label and compare its number and captions with the shipment.
4. Check the shipping information block and settings in each storefront used.
5. Add a test vendor with a city and verify that only marked shipping methods are copied.

If no number appears, check the carrier, order shipping method, rus_sdek2 connection settings and service messages. If printing is empty, check for a tracking number. Do not create another shipment merely to print a label.