К статье
Практический материал

Другое · 7 мин

Идентификатор клиента в 1С: как получить и проверить

Как получить идентификатор клиента в 1С: где искать в карточке, через запросы и при обмене данными, проверка результата и ограничения самостоятельной работы.

В 1С:Предприятии нет единого поля с названием «идентификатор клиента», которое одинаково работает во всех конфигурациях. Под этим термином могут понимать код контрагента, уникальный идентификатор объекта, идентификатор сеанса или код для обмена с внешней системой. Поэтому сначала нужно определить, для какой задачи нужен идентификатор.

Если цель — внутренний учет, достаточно карточки клиента в справочнике «Контрагенты» или «Клиенты». Если данные передаются в интернет-магазин, мобильное приложение или другую информационную систему, потребуется идентификатор, поддерживаемый механизмом обмена: GUID, внешний код или код из регистра сведений.

Получать идентификатор самостоятельно можно только в копии информационной базы или на тестовом контуре. Прямое изменение конфигурации, программных модулей или таблиц базы без резервной копии может привести к потере данных и нарушению работы учета.

Обычно идентификатор начинают искать в форме карточки клиента. Откройте справочник клиентов, выберите нужного контрагента и посмотрите поля «Код», «Наименование», «Внешний код» или реквизиты, добавленные разработчиком конфигурации. Некоторые поля скрыты из обычного вида и открываются через настройку формы или команду «Еще».

Если нужный идентификатор не отображается, проверьте права доступа пользователя. Ограничения прав могут скрывать реквизиты даже при наличии записи в базе. Отсутствие поля в интерфейсе не означает отсутствия значения в программе.

Что может быть идентификатором клиента в 1С

В типовых конфигурациях клиент часто представлен контрагентом. Его основной идентификатор — код справочника, который присваивается при создании. Помимо кода есть наименование, ИНН, КПП, адрес и реквизиты дополнительных сведений. Для интеграции может использоваться отдельный реквизит «Внешний код» или уникальный идентификатор объекта в базе.

Уникальный идентификатор объекта не всегда виден пользователю. Он может храниться в служебных таблицах и использоваться платформой для связи записей. Пытаться угадать такое значение по внешнему виду карточки не стоит: лучше получить его через запрос или настройки обмена.

Если конфигурация поддерживает обмен с сайтом или маркетплейсом, идентификатор клиента может дублироваться в регистре сведений «Клиенты интернет-магазина» или аналогичном справочнике. В этом случае важно следить за соответствием внутреннего кода и внешнего идентификатора партнера.

Как найти идентификатор в карточке клиента

Откройте раздел продаж или CRM, найдите справочник клиентов и откройте карточку нужного контрагента. Посмотрите заголовок формы, панель реквизитов и закладки с дополнительными данными. Код контрагента часто отображается рядом с наименованием или в строке состояния.

Порядок действий в карточке
  1. 1
    Открыть справочник клиентов или контрагентов
  2. 2
    Найти и выделить нужного клиента
  3. 3
    Посмотреть поля Код, Внешний код и реквизиты обмена
  4. 4
    При отсутствии поля открыть настройку формы или свойства объекта
  5. 5
    Скопировать значение и проверить его на соответствие задаче

Если форма настроена индивидуально, нужный реквизит может быть перенесен на отдельную закладку или скрыт полностью. В этом случае обратитесь к администратору информационной базы или сотруднику, отвечающему за поддержку конфигурации.

Не копируйте идентификатор из сообщения об ошибке или из заголовка окна без понимания его смысла. Такое значение может быть временным, сеансовым или внутренним для разработчика, а не постоянным кодом клиента.

Получение идентификатора через запросы и отчеты

Когда идентификатор не выводится на форме, его можно получить запросом к справочнику клиентов. В языке запросов 1С выбираются поля «Ссылка», «Код», «Наименование» и пользовательские реквизиты. Результат выводится в таблицу, из которой значение копируется в буфер обмена.

Контрольные точки

Как проверить результат

Полученное значение
Норма

Соответствует карточке клиента и повторяется при повторном запросе

Тревожный признак

Отличается от значения в форме или меняется без причины

Перед использованием идентификатора в обмене данными сведите его с карточкой клиента. Одно и то же лицо может иметь несколько записей: физическое лицо, индивидуальный предприниматель и юридическое лицо. Путать их нельзя, иначе данные запишут не тому клиенту.

Если запрос возвращает несколько одинаковых клиентов, проверьте дубли в справочнике. Дублирующие записи с разными кодами создают ошибки при отгрузке, расчетах и выгрузке в внешние системы.

Идентификатор при обмене данными и интеграции

Для выгрузки заказов, каталогов или сделок в другую систему используется настройка обмена данными. Там указывается, какое поле 1С соответствует идентификатору клиента на стороне приемника. Это может быть внешний код, GUID или код контрагента, выбранный при настройке правил обмена.

Сравнение вариантов идентификатора

Код контрагента

Подходит для внутреннего учета, но может меняться при перенумерации справочника

Внешний код

Удобен для интеграции, если ведется в конфигурации и синхронизируется с партнером

Уникальный идентификатор объекта

Надежен внутри базы, но не всегда доступен для обмена без доработки

Перед выгрузкой проверьте, заполнен ли выбранный идентификатор у всех клиентов, участвующих в обмене. Пустые значения приведут к пропуску записей или созданию новых дублей на стороне приемника.

Не передавайте идентификаторы клиентов по открытым каналам без необходимости. Значение может использоваться для доступа к личным данным или истории сделок, поэтому его обработка должна соответствовать правилам конфиденциальности компании.

Ограничения, типичные ошибки и безопасность

Самостоятельно безопасно просматривать значения и копировать их для отчетов. Опасно менять коды клиентов вручную, удалять записи или редактировать таблицы базы без понимания зависимостей. Это может нарушить связь с договорами, заказами и платежами.

Ручная правка кодов может привести к потере связи с историей сделок и документацией. Лучше зафиксировать текущее значение и согласовать любые изменения с администратором информационной базы.

Типичные ошибки
01
Путать код контрагента с идентификатором сеанса или заказа
02
Использовать пустой или не заполненный внешний код при выгрузке
03
Изменять идентификатор клиента без проверки связанных документов

Если идентификатор нужен для программной интеграции через OData, COM-соединение или веб-сервисы, уточните у разработчика, какой метод возвращает идентификатор и какие права требуются. Пробовать подобрать адреса сервисов или пароли самостоятельно небезопасно.

Результат получения идентификатора фиксируйте в инструкции пользователя: откуда взято значение, для какой системы предназначено и кто отвечает за его актуальность. Это упростит поиск ошибки при сбое обмена.

Как зафиксировать и использовать результат

После получения идентификатора введите его в целевую систему и выполните тестовую выгрузку одного клиента. Сравните имя, адрес и историю сделок в обеих системах. Если данные совпадают, идентификатор получен верно.

Итог

Что важно запомнить

Идентификатор клиента в 1С выбирается под задачу, проверяется в карточке и запросе, а изменения вносятся только после резервного копирования и согласования с администратором.

Нужен ли программист для получения идентификатора?

Не всегда. Код или внешний код часто можно посмотреть в карточке клиента без программирования. Если значение скрыто или нужно настроить обмен, потребуется администратор или разработчик конфигурации.

Можно ли использовать код контрагента как идентификатор для сайта?

Можно, если конфигурация и сайт согласовали это поле и оно уникально для каждого клиента. Убедитесь, что код не меняется при перенумерации и не совпадает у разных контрагентов.

Что делать, если идентификатор не отображается в форме?

Проверьте права доступа, настройку формы и наличие реквизита в конфигурации. При отсутствии поля обратитесь к сотруднику, поддерживающему 1С, а не правьте конфигурацию самостоятельно.

Безопасно ли копировать идентификатор из сообщения об ошибке?

Не рекомендуется. Такое значение может быть временным или внутренним и не соответствовать постоянному коду клиента. Используйте значения из карточки или запроса к справочнику.