DOCSEARCHbyAlgolia
Submit Docs

CDEK WordPress Plugin

website·Indexed 30 days ago

https://cdek-it.github.io/wordpress

Integration with CDEK delivery service for WooCommerce stores. Documentation covers plugin setup, Yandex JavaScript API and Geocoder configuration, order creation, cash-on-delivery (COD) support, and compatibility with both shortcode and block-based checkout versions.

Tokens
4.9K
Snippets
4
Records
43
Agent score
72%

What's inside CDEK

  1. Understand CDEK plugin behavior in WordPress Block Checkout

    When using the new WordPress Block-based checkout, the CDEK plugin modifies the delivery selection flow:

    1. Delivery options are displayed directly below the delivery address field after the address has been entered.
    2. For 'to warehouse' delivery methods, the pick-up point selection map is displayed inline below the delivery methods instead of appearing in a pop-up window.

  2. CDEK plugin behavior on the new WordPress checkout page

    When using the new version of the checkout page, the CDEK plugin modifies the delivery selection process as follows:

    • Delivery options are displayed below the shipping address field after the address has been entered.
    • The standard 'select pickup point' button is replaced by an interactive map showing available pickup points.

  3. Configure cargo shipment addresses and map behavior

    In the setup interface, select the addresses used for cargo shipments on the map. You must define:

    • Pick-up points: Used for 'from warehouse' rates.
    • Addresses: Used for 'from door' rates.

    Optional: Enable the checkbox "Close map after selecting pick-up point" to automatically close the map interface once a buyer has made a selection. To select multiple rates simultaneously, press and hold the CTRL key.

  4. Install the CDEKDelivery plugin in WordPress

    Follow these steps to install and activate the CDEK delivery integration:

    1. Navigate to the WordPress admin panel: Plugins -> Add New Plugin.
    2. Search for CDEKDelivery.
    3. Click Install Now.
    4. Once the installation completes, click Activate.

    If the Install Now button is unavailable, ensure that WooCommerce is installed and activated on your site first.

  5. Create a CDEK shipment order from the WordPress admin panel

    To create a shipment in the CDEK system, navigate to the specific order page in the WordPress admin panel and locate the 'Delivery' section. Fill in the package dimensions (which must be specified in centimeters) and submit the order.

    Note: Order information is not automatically transmitted to CDEK unless explicitly enabled in the plugin settings. By default, dimension fields are pre-filled with values calculated during the initial order placement.

  6. Manage delivery and pick-up points in classic WordPress checkout

    In the classic shortcode checkout version, delivery options with various rates and prices are displayed on the order creation page after items are added to the cart. Users can change the delivery address, which triggers a price recalculation. For 'to warehouse' or 'to parcel terminal' rates, a 'Choose pick-up' button is provided. Clicking this button opens a map to select a pick-up point. Once selected, the chosen point is displayed next to a 'Re-select pick-up' button. Note that the exact position of these blocks may vary depending on the WordPress theme used, but the map button is typically located near the delivery options.

  7. Meet minimum system requirements for CDEK WooCommerce integration

    To integrate a WooCommerce store with CDEK delivery services, the server and software environment must meet the following minimum version requirements:

    • PHP: 7.4 or higher
    • MySQL: 5.67 or higher OR MariaDB: 10.4 or higher
    • WordPress: 6.3 or higher
    • WooCommerce: 6.9 or higher
    • Account: A CDEK Personal Account (lk.cdek.ru) or an Integration Account on the Developer Portal (my.cdek.ru/integration).

    Additionally, ensure the server complies with the standard WooCommerce server requirements.

  8. Meet system requirements for CDEK WooCommerce plugin

    To use the CDEK delivery service integration plugin, your environment must meet the following minimum version requirements:

    • PHP: 7.4 or above
    • MySQL: 5.67 or above OR MariaDB: 10.4 or above
    • WordPress: 6.3 or above
    • WooCommerce: 6.9 or above
    • A CDEK account with the Integration API enabled.

  9. Manage CDEK waybills and barcodes

    After submitting the shipment order form, a waybill is created in the CDEK system and the waybill number is displayed. The following actions are available:

    • Cancel the order: Deletes the waybill from the CDEK system, allowing you to edit form data and resubmit.
    • Get waybill: Generates a hard copy of the waybill.
    • Get barcode: Generates barcodes for each cargo place. The print format for barcodes (A4, A5, or A6) can be configured in the delivery settings.

  10. Create and manage CDEK shipping orders in WordPress admin

    To send order information to CDEK, ensure that automatic transmission is enabled in the settings. In the WordPress admin order page, locate the 'Доставка' (Shipping) section to find the form for submitting package dimensions and creating the CDEK order.

    Key operational details:

    • Dimensions: Package dimensions must be entered in centimeters. By default, the fields are pre-filled with values calculated during the checkout process.
    • Order Creation: After submitting the form, a waybill (накладная) is created in the CDEK system, and its number is displayed.
    • Modifying Orders: Use the Отменить (Cancel) button to delete the waybill, which allows you to edit the form data and resubmit the order.
    • Documentation:
      • Use the Получить квитанцию (Get Receipt) button to generate a printable version of the waybill.
      • Use the Получить ШК (Get Barcodes) button to generate barcodes for each shipment item.
    • Barcode Formatting: The print format for barcodes (A4, A5, or A6) is configurable in the shipping settings.

  11. Manage multi-package orders using Multi-seater mode

    Multi-seater mode allows products from a single order to be distributed across multiple packages of varying sizes. In the admin panel order page, users can select a package size and then specify which products and how many units of each product should be included in that specific package.

    Product allocation is constrained by the total quantity ordered; for example, if 5 units of a product are ordered and 3 are assigned to the first package, only 2 units remain available for subsequent packages. Once all products are distributed, the system displays a list of packages with their dimensions and contents. Clicking 'Create Order' transmits the data to the CDEK system, returning an order number and an invoice link. Users can verify the 'package number' column to confirm that multiple packages were successfully created.

  12. Manage multi-package shipments in WordPress CDEK admin

    When the 'Многоместка' (Multi-package) mode is enabled, administrators can split order items into multiple packages, each with its own dimensions.

    On the order page in the admin panel, the system allows selecting specific products and quantities for each package. The quantity of a product that can be added to a package is limited by the total quantity of that product in the order. For example, if 5 units of 'Product 1' are in the order and 3 are assigned to Package 1, only 2 units remain available for subsequent packages.

    Once all items are distributed, the system displays a list of packages with their dimensions and contents. Clicking 'Создать заказ' (Create Order) transmits the data to the CDEK system, which returns an order number and a receipt link. The 'номер упаковки' (package number) field confirms the creation of multiple packages.