Организация (ORG_Organization)

Организация (ORG_Organization) - организация, в которой состоит клиент. Содержит базовые атрибуты (ИНН, КПП, телефон), также может содержать вложенную структуру департаментов:

  • id_Organization (пример: "123") - первичный ключ организации.
    Если мы создаем новую организацию, то значение не передаем; если редактируем существующую - передаем идентификатор;

  • id_Group (пример: "123") - компания, которой принадлежит юрлицо. Берется из Organizations.Group (обязательное поле, число);

  • Name (пример: "Ромашка") - наименование организации (обязательное поле, строка);

  • INN (пример: "7731347089") -  ИНН огранизации (обязательное поле, строка);

  • KPP (пример: "773101001") -  КПП организации (обязательное поле, строка);

  • LegalAdress (пример: "Ул васнецова 15") - юридический адрес организации (обязательное поле, строка);

  • Phone (пример: "+79189837491") - телефон организации (обязательное поле, строка).



Для клиента раздел доступен из меню "Настройки > Организации".

Агент имеет возможность открыть пункт "Организации" через раздел travel management в редакторе договоров:

image-20240508-141814-20240801-081341.png


Необходимо выбрать организацию из списка и тогда появится возможность редактировать ее реквизиты:


 Соответствие полей в интерфейсе полям в модели:

 Соответственно, действие, аналогичное редактированию организации из API, можно произвести на интерфейсе в разделе организаций .

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

Для получения контекста организации используется сервис OrganizationManagement.asmx

WSDL можно скачать с демо-сайта: https://stage1.corteos.ru/XmlGate/V3/StaticData/Organizations/OrganizationManagement.asmx?wsdl

Для работы в продуктовой среде необходимо заменить “stage1.corteos.ru на свой домен (на котором работают пользователи вашей компании).

В API реализованы следующие методы для работы с организациями:

  • GetV2 - получение организации по первичному ключу (ORG_Organization.id_Organization);

  • SaveV2 - сохранение организации. Дополнительно добавлена обработка смены названия при вызове метода SaveV2 - за это отвечает поле CustomerName, которое в случае заполнения переписывает название старой группы компаний. В лог добавляется такое сообщение:

  • ListV2 - получение списка организаций;

  • DeleteV2 - удаление организации.

Примеры запросов и ответов:

  • создание новой организации - запрос / ответ

  • редактирование существующей организации - запрос / ответ совпадает с ответом в п. "Создание новой организации"

  • получение организации по первичному ключу (id_Organization) - запрос / ответ

  • получение всех организаций - запрос / ответ

  • удаление организации с переданным первичным ключом - запрос / ответ