Департаменты 1С API

Owned by Александр Киричок
Last updated: Apr 19, 2023
2 min read

Данный справочник содержит информацию о подразделения (Id, Name, OrganizationId, orgname).

Id - INT (идентификатор записи)

Name - String (имя департамента)

OrganizationId - INT (идентификатор организации)

orgname - String (имя организации)

OutLinkId - String (Внешний ID)

Получение данных по одному департаменту

Чтобы получить информацию по одному департаменту, нужно отправить GET запрос на адрес https://teletrack.ua/api/v2/<token>/departs/<Id>, где

tokenТокен, полученный при авторизации *
IdId департамента из БД *

 * - обязательный параметр


В случае успешного выполнения запроса, приходит ответ следующего формата:

{
 "data": [ {
 "Id": 7,
 "Name": "DepSOROKA",
 "OrganizationId": 5,
 "OutLinkId": "ghe5rtgdd",
 "Parent": "53a294672eb21fb66500e57e",
 "Parent_type": "diler",
 "orgname": "Org33"
 }],
 "err": null,
 "status": true
}

Получение списка департаментов

Чтобы получить список всех департаментов, нужно отправить GET запрос на адрес https://teletrack.ua/api/v2/<token>/departs/, где

tokenТокен, полученный при авторизации *

 * - обязательный параметр


В случае успешного выполнения запроса, приходит ответ со списком департаментов следующего формата:

{
 "data": [
 {
 "Id": 1, 
 "Name": "Dep1", 
 "OrganizationId": 5, 
 "OutLinkId": 65987, 
 "Parent": "53a294672eb21fb66500e57e", 
 "Parent_type": "diler", 
 "orgname": "Org33"
 }, 
 {
 "Id": 7, 
 "Name": "DepSOROKA", 
 "OrganizationId": 5, 
 "OutLinkId": null, 
 "Parent": "53a294672eb21fb66500e57e", 
 "Parent_type": "diler", 
 "orgname": "Org33"
 }
 ], 
 "err": null, 
 "status": true
}

UPD 19/04/2023:

В связи с тем, что в справочнике Организаций записи с Level=1 и Level=2 имеют одинаковый OutLinkID, были добавленные перечисленные ниже API, которые по умолчанию используют в справочнике departments только организации Level = 1.

Создание новой записи

Для создания новой записи, необходимо отправить POST запрос на адрес https://teletrack.ua/api/v2/<token>/departs/organ_outlink/, где 

NameИмя нового департамента *
OrganizationIdВнешний OutLinkID организации *
tokenТокен, полученный при авторизации *
OutLinkIdВнешний OutLinkID департамента

 * - обязательный параметр

В случае успешного выполнения запроса, приходит ответ следующего вида:

{
  "data": {
    "Id": 149
  }, 
  "err": null, 
  "status": true
}
IdID новой записи в БД

Редактирование записи

Для редактирования существующей записи, необходимо отправить  PUT запрос на адрес https://teletrack.ua/api/v2/<token>/departs/organ_outlink/<Id>, где

IdID записи в БД *
NameИзмененное имя *
OrganizationIdВнешний OutLinkID организации *
tokenТокен, полученный при авторизации *
OutLinkIdВнешний OutLinkID департамента
DeleteMarked
Пометка удаления: true / false

 * - обязательный параметр


В случае успешного выполнения запроса, приходит ответ следующего вида:

{
  "data": null, 
  "err": null, 
  "status": true
}

Удаление записи

Для удаления существующей записи, необходимо отправить  DELETE запрос на адрес https://teletrack.ua/api/v2/<token>/departs/<Id>, где

IdID записи в БД которою нужно удалить *
tokenТокен, полученный при авторизации *

 * - обязательный параметр


В случае успешного выполнения запроса, приходит ответ следующего вида:

{
  "data": null, 
  "err": null, 
  "status": true
}