Организация (ORG_Organization) - организация, в которой состоит клиент. Содержит базовые атрибуты (ИНН, КПП, телефон), также может содержать вложенную структуру департаментов:
id_Organization (пример: "123") - первичный ключ организации.
Если мы создаем новую организацию, то значение не передаем; если редактируем существующую - передаем идентификатор;id_Group (пример: "123") - компания, которой принадлежит юрлицо. Берется из Organizations.Group (обязательное поле, число);
Name (пример: "Ромашка") - наименование организации (обязательное поле, строка);
INN (пример: "7731347089") - ИНН огранизации (обязательное поле, строка);
KPP (пример: "773101001") - КПП организации (обязательное поле, строка);
LegalAdress (пример: "Ул васнецова 15") - юридический адрес организации (обязательное поле, строка);
Phone (пример: "+79189837491") - телефон организации (обязательное поле, строка).
Для клиента раздел доступен из меню "Настройки > Организации".
Агент имеет возможность открыть пункт "Организации" через раздел travel management в редакторе договоров:
Необходимо выбрать организацию из списка и тогда появится возможность редактировать ее реквизиты:
Соответствие полей в интерфейсе полям в модели:
Для проведения любой операции необходимо пройти авторизацию, а также, если мы работаем от имени агента, получить контекст клиента Для получения контекста клиента используется сервис MetaCodeOnOrganizationManagement.asmx WSDL можно скачать с демо-сайта: https://demo.corteos.ru/XmlGate/V3/StaticData/MetaCodeOnOrganization/MetaCodeOnOrganizationManagement.asmx Для работы в продуктовой среде необходимо заменить demo.corteos.ru на свой домен (на котором работают пользователи вашей компании). |
В API реализованы следующие методы для работы с договором:
GetV2 - получение организации по первичному ключу (ORG_Organization.id_Organization);
SaveV2 - сохранение организации.Дополнительно добавлена обработка смены названия при вызове метода SaveV2 - за это отвечает поле CustomerName, которое в случае заполнения переписывает название старой группы компаний. В лог добавляется такое сообщение:
ListV2 - получение списка организаций;
DeleteV2 - удаление организации.
Разберем эти методы более подробно.
Примеры запросов и ответов:
редактирование существующей организации - запрос / ответ совпадает с ответом в п. "Создание новой организации"
получение организации по первичному ключу (id_Organization) - запрос / ответ
удаление организации с переданным первичным ключом - запрос / ответ
____