---
title: "Deliverypoints: выбор ПВЗ СДЭК в Joomla Form | WT CDEK - WebTolk"
description: "Deliverypoints для Joomla: выбор ПВЗ и постаматов по адресу. Документация WT CDEK, параметры полей и XML-примеры для Joomla Form."
url: "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints"
date: "2026-11-02T13:05:51+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT CDEK library](/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Документация](/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > Deliverypoints: выбор ПВЗ СДЭК в Joomla Form

# Deliverypoints: выбор ПВЗ СДЭК в Joomla Form

WT CDEK library - Документация

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Версии](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

Deliverypoints в библиотеке WT CDEK для Joomla: выбор ПВЗ и постаматов по адресу. На странице — назначение, параметры и примеры XML для Joomla Form.

С версии **1.4.0** поле `Deliverypoints` выбирает один пункт СДЭК и сохраняет его **код**, например `SAR141`. По умолчанию доступны ПВЗ, постаматы и пункты только выдачи. Библиотека не привязана к компоненту магазина.

Для стандартного AJAX-поиска включите `System - WT CDEK` и настройте аккаунт библиотеки. Поле подключает WebAsset самостоятельно; писать JS для наблюдения за адресом не нужно.

## Адрес из полей формы

```
<form addfieldprefix="Webtolk\Cdekapi\Fields">
  <fieldset name="delivery">
    <field name="destination_city" type="text" label="Город" />
    <field name="destination_zip" type="text" label="Индекс" />
    <field name="delivery_point" type="Deliverypoints" label="Пункт СДЭК"
           watchfield='{"city":"destination_city","zip":"destination_zip"}' />
  </fieldset>
</form>
```

Имена в `watchfield` относятся к текущей группе Joomla Form. Для другой группы используйте `address.city`. Префикс формы может отличаться от `jform`. Поле реагирует на `input` с задержкой 250 мс, на `change` — без этой задержки. Несколько полей могут использовать одни источники; повторяемый subform поддерживается автоматически.

## XML-атрибуты

| Атрибут | Значение по умолчанию | Назначение |
| --- | --- | --- |
| `city` | Не задан | Название города в XML |
| `zip` | Не задан | Почтовый индекс в XML |
| `fias_guid` | Не задан | UUID населённого пункта ФИАС |
| `watchfield` | Не задан | JSON-карта с ключами `city`, `zip`, `fias_guid`; достаточно одного |
| `point_type` | `ALL` | `ALL`, `PVZ` или `POSTAMAT` |
| `is_reception` | Без ограничения | Приём отправлений: `true`, `false`, `1`, `0`; пустой атрибут снимает ограничение |
| `is_handout` | Без ограничения | Выдача отправлений: те же значения |
| `watchfield-data-source` | `ajax` | `ajax`, `scriptoptions` или alias `onpage` |
| `watchfield-data-url` | URL `com_ajax` текущего клиента Joomla | Адрес собственного AJAX-провайдера |
| `watchfield-data-options` | Не задан | Точный ключ Joomla Script Options для данных страницы |
| `watchfield-data-path` | `data.0.options` для стандартного AJAX | Точечный путь до массива вариантов; при смене режима по умолчанию пустой |

**Наличие** любого адресного атрибута `city`, `zip`, `fias_guid`, включая `city=""`, полностью отключает `watchfield`. Значения XML и наблюдаемые значения не смешиваются. Фильтры типов и услуг сами по себе не отключают наблюдение.

```
<field name="fixed_point" type="Deliverypoints"
       addfieldprefix="Webtolk\Cdekapi\Fields"
       city="Саратов" point_type="ALL" label="Пункт СДЭК" />

<field name="locker" type="Deliverypoints"
       addfieldprefix="Webtolk\Cdekapi\Fields"
       fias_guid="bf465fda-7834-47d5-986b-ccdb584a85a6"
       point_type="POSTAMAT" is_handout="true" label="Постамат" />

<field name="pickup_only" type="Deliverypoints"
       addfieldprefix="Webtolk\Cdekapi\Fields"
       watchfield='{"city":"destination_city","zip":"destination_zip"}'
       point_type="PVZ" is_reception="false" is_handout="true"
       label="Пункт только выдачи" />
```

Кнопки «Обновить список ПВЗ» нет: при XML-адресе список загружается при инициализации, при наблюдении — также при изменении источников.

## UUID и API СДЭК

`fias_guid` — UUID **ФИАС**, а не `city_uuid` СДЭК. Например, для Саратова API возвращает `fias_guid=bf465fda-7834-47d5-986b-ccdb584a85a6` и другой `city_uuid`.

Непустой FIAS UUID направляется в `GET /v2/deliverypoints` без предварительного поиска города. Без UUID библиотека ищет город по названию и/или индексу. Несколько различных кодов города дают пустой список, чтобы не выбирать населённый пункт произвольно.

## Собственные данные

Провайдер передаёт массив `[{"value":"SAR141","text":"Адрес пункта"}]`. Стандартный `com_ajax` помещает его в `data[0].options`. Поле обращается к единому обработчику `plugin=wtcdek` с `action=deliverypoints`; он работает на сайте и в админке. Для собственного endpoint задайте его URL и путь до массива в JSON-ответе. В POST ключ `zip` преобразуется в `postal_code`; передаются также фильтры `type`, `is_reception`, `is_handout` и CSRF-токен Joomla.

Можно использовать данные страницы:

```
use Joomla\CMS\Factory;

Factory::getApplication()->getDocument()->addScriptOptions('shop.delivery', [
    'points' => [['value' => 'SAR141', 'text' => 'Пункт на проспекте']]],
);
```

```
<field name="delivery_point" type="Deliverypoints"
       addfieldprefix="Webtolk\Cdekapi\Fields"
       city="Саратов" watchfield-data-source="scriptoptions"
       watchfield-data-options="shop.delivery" watchfield-data-path="points" />
```

Общий контракт источников и событий описан в [Watchfield](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-watchfield).

## Выбор и ошибки

При смене адреса прежний выбор сбрасывается. Отсутствующий в первоначальном ответе сохранённый код остаётся выбранным с предупреждением. Пустой список, отсутствующий адрес и ошибка загрузки имеют отдельные сообщения. Устаревшие AJAX-ответы не заменяют новые; при удалении поля запрос отменяется. Подписи пунктов выводятся текстом.

[Обзор и начало работы](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

## Серверная проверка значения

Не используйте validate="options" для новых AJAX-вариантов: серверный список Deliverypoints содержит только пустой и сохранённый код. Проверяйте код и его соответствие адресу в серверной логике своего расширения.

## Поля Joomla Form

- [Tarifflist](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-tarifflist)
- [Tariffinfo](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-tariffinfo)
- [Deliverypoints](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints)
- [Watchfield](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-watchfield)

[Обзор и начало работы](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

[Исходный код WT CDEK 1.4.0 на GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Fields/DeliverypointsField.php)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Документация"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "Deliverypoints: выбор ПВЗ СДЭК в Joomla Form"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints",
            "name": "Deliverypoints: выбор ПВЗ СДЭК в Joomla Form | WT CDEK - WebTolk",
            "description": "Deliverypoints для Joomla: выбор ПВЗ и постаматов по адресу. Документация WT CDEK, параметры полей и XML-примеры для Joomla Form.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "Deliverypoints: выбор ПВЗ СДЭК в Joomla Form",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints",
            "description": "Deliverypoints в библиотеке WT CDEK для Joomla: выбор ПВЗ и постаматов по адресу. На странице — назначение, параметры и примеры XML для Joomla Form.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-fields-deliverypoints"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " СДЭК API",
                " WT CDEK",
                " Deliverypoints",
                " Joomla Form"
            ]
        }
    ]
}
```