Документ (RW_Document) - документ, по которому пассажир способен выезжать, заселяться в отель либо регистрироваться на перевозку. Документ идентифицирует пассажира во всех услугах и является обязательным атрибутом оказания услуги:
id_Document (пример: "123") - первичный ключ контакта.
Если мы создаем новый контакт, то значение не передаем, если редактируем существующий - передаем идентификатор;id_Person (пример: "123") - Ссылка на идентификатор персоны (обязательное поле, число);
id_Country (пример: "123") - Ссылка на идентификатор страны (обязательное поле, число);
id_DocumentType (пример: "2") - Ссылка на тип документа (обязательное поле, число);
1 - Паспорт РФ;
2 - Загранпаспорт;
3 - Паспорт другой страны;
4 - Свид. о рождении (тип доступен только при добавлении новой персоны).
DateGiven (пример: "2019-06-13T19:28:10.0280635+03:00") - дата выдачи документа (обязательное поле, строка);
DateValid (пример: "2019-06-13T19:28:10.0280635+03:00") - дата окончания действия документа (обязательное поле, строка);
Number (пример: "0308842962") - номер (или серия и номер) документа (обязательное поле, строка);
Номер документа валидируется в зависимости от переданного типа (id_DocumentType):1 - Паспорт РФ. Номер должен содержать 10 цифр без пробелов (например: "0308945371"), выражение для валидации "[0-9]{10}";
2 - Загранпаспорт. Номер должен содержать 9 цифр без пробелов (например: "123456789"), выражение для валидации "[0-9]{9}";
3 - Иностранный документ. Номер должен быть не пустым;
4 - Свидетельство о рождении. Заполняется следующим образом:
серия: римские цифры (необходимо набрать в латинском регистре буквами I, V, X), две буквы русской раскладкой клавиатуры;
далее без пробела номер (6 цифр).
Пример: VIМУ123123, или VIIАФ876522, или IДН761692. Регулярное выражение для валидации: "^[XVIxvi]{1,6}[а-яА-Я]{2}[0-9]{6}$".
В интерфейсе редактирование документов доступно в редакторе персон.
Агент может зайти туда через раздел "Travel management" в редакторе договоров; клиенту меню "Настройки > Персоны и пользователи" будет доступно в соответствии с настройкой его роли:
Мы попадаем в список персон и, кликнув по любой, в открывшемся окне видим список документов:
Соответствие полей интерфейса полям модели:
Для проведения любой операции необходимо пройти авторизацию, а также, если мы работаем от имени агента, получить контекст клиента
Для получения контекста клиента используется сервис DocumentManagement.asmx
WSDL можно скачать с демо-сайта: https://demo.corteos.ru/XmlGate/V3/StaticData/Documents/DocumentManagement.asmx
Для работы в продуктовой среде необходимо заменить demo.corteos.ru на свой домен (на котором работают пользователи вашей компании).
В API реализованы следующие методы для работы с документом:
GetV2 - получение документа по первичному ключу (RW_Document.id_Document);
SaveV2 - сохранение документа;
ListV2 - получение списка документов;
DeleteV2 - удаление документа.
Подробное описание данных методов:
Получение списка документов (ListV2)
Получить список документов можно по идентификатору персоны (id_Person), которой эти документы принадлежат. Данный параметр является обязательным.
Запрос на получение документа по первичному ключу (RW_Document.id_Document) - Запрос / Ответ
Создание нового документа или редактирование существующего (SaveV2) - Запрос на создание / Запрос на обновление / Ответ
Запрос на удаление документа (DeleteV2) - Запрос / Ответ