Это старая версия документа!

Документ описывает формат обмена данными Д24 с внешней системой.

Уведомления о создании / изменении заявки отправляются массивом POST методом с данными в формате JSON. В ответ на уведомление должен быть возвращен HTTP код 200, при отличном от 200 коде ответа, уведомление будет отправляться повторно.

Пример запрос на удаленный сервер при создании новой заявки с ID=12313123 и изменении заявки с ID=567567

[
    {
        "request_id": 12313123
    },
    {
        "request_id": 567567
    }
]

Документация ниже устарела и более не поддерживается

Online уведомления

Вы можете получать моментальные уведомления о событиях в системе, таких как:

- Новая заявка от жителя

- Изменение заявки

1. Изменение типа работ
2. Изменение причины обращения
3. Изменения статуса
4. Изменения исполнителя и ответственного
5. Изменение дома/квартиры/подъезда/этажа
6. Изменения телефонов/email собственника в заявке
7. Изменение описания заявки
8. Изменения типа заявки
9. Изменения стоимости и статуса оплаты
10. Изменения срока выполнения

- Комментарии для жителя по заявке

Уведомления отправляется POST методом с данными в формате JSON. В ответ на уведомление должен быть возвращен HTTP код 200, при отличном от 200 коде ответа, уведомление будет отправляться повторно.

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

Пример JSON

[{

  "create": {
      "rid": 1291461, -- id заявки
      "tid": 325,     -- id типа работ
      "sid": 1,       -- id статуса
      "eid": null,    -- id исполнителя
      "respid": null, -- id ответственного
      "essid": 4183,  -- id причины обращения
      "hid": 40783,   -- id дома
      "fnum": "1",    -- помещение 
      "ftype": "1",     -- тип помещение 
      "phc": "",      -- телефон контактный. мобильный без кода страны, городские с кодом города.
      "pha": "",      -- АОН 
      "note": "Замена дверных замков", -- тест заявки
      "flage": "Н",   -- аварийная?  варианты (Д)а/Н(ет)
      "flagp": "Д",   --платная варианты (Д)а/Н(ет)
      "floor": null,  -- этаж
      "entrance": "", -- подъезд
      "email": "",    -- email
      "price": null,  -- стоимость
      "paid": "Н"     -- оплачено? (Д)а/Н(ет)
      "edate": ""
  }

}, {

  "create": {
      "rid": 1291463,
      "tid": 23,
      "sid": 1,
      "eid": 29573,
      "respid": 29573,
      "essid": 1533,
      "hid": 40783,
      "fnum": "магазин ЭлитФрукт",
      "ftype" : "4",
      "phc": "9617489876",
      "pha": "",
      "note": "Топит канализационными стоками",
      "flage": "Д",
      "flagp": "Н",
      "floor": 2,
      "entrance": "2",
      "email": "",
      "price": null,
      "paid": "Н",
      "edate": "01.01.2019"
  }]

Изменения заявок отслеживается по тем же полям, что используются при оповещении о создании заявки. Могут доставляться одновременно с JSON о создании заявок. Пример JSON [{

"update": {
	"edate": "",
	"rid": 1292914
}

}, {

"update": {
	"eid": 27414,
	"rid": 1291667
}

}, {

"create": {
	"rid": 1292914,
	"tid": 21,
	"sid": 1,
	"eid": null,
	"respid": null,
	"essid": 3263,
	"hid": 40783,
	"fnum": "321",
              "ftype" : "1",
	"phc": "9617496539",
	"pha": "",
	"note": "Подаю заявку с личного кабинета с сайта ЮИТ",
	"flage": "Н",
	"flagp": "Н",
	"floor": null,
	"entrance": "",
	"email": "",
	"price": null,
	"paid": "Н"
}

}, {

"create": {
	"rid": 1293583,
	"tid": 23,
	"sid": 1,
	"eid": null,
	"respid": 29573,
	"essid": 1554,
	"hid": 40783,
	"fnum": "1",
              "ftype" : "3",
	"phc": "",
	"pha": "",
	"note": "Ремонт полотенцесушителя",
	"flage": "Н",
	"flagp": "Д",
	"floor": null,
	"entrance": "",
	"email": "",
	"price": null,
	"paid": "Н",
	"edate": "12.11.2019"
}

}, {

"update": {
	"sid": 3,
	"rid": 1291464
}

}, {

"update": {
	"edate": "",
	"rid": 1292914
}

}]

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

Пример JSON

[{

"comment": {
	"rid": 1291463,
	"comment": "Выполнено",
	"empfio": "Иванов Иван Иванович"
}

}]