0569bd5a0f
Изменения: - Интеграция СУП/ → Работа/Интеграция СУП/ (рабочие заметки вместе) - Релизы/ → Работа/Релизы/ (рабочие заметки вместе) - Другое/Собеседование .Net → Работа/ (рабочая тема) - Другое/Своя игра → Личное/ (хобби) - Smart home/ → Квартира/ (всё про квартиру в одном месте) - Flutter/, Go/ → Dev/Flutter/, Dev/Go/ (учебные роадмапы) - Dev/Pulse/competitors-analysis → Projects/Pulse/ (проект Pulse в одной папке) - Twilio.md → Dev/ (техническая заметка) - Tokens.md → Личное/Tokens (API keys).md - Игры.md → Личное/Игры.md - Удалены пустые папки: Другое/, Smart home/, Интеграция СУП/, Релизы/ Структура: Авто/ — автомобили Dev/ — разработка, изучение (Go, Flutter, репозитории) Квартира/ — квартира + умный дом Личное/ — личное, токены, игры, команды Мама/ — проекты для мамы Projects/ — Pulse App Работа/ — BPMSoft, интеграции, релизы Япония/ — путешествие saved-articles/ — сохранённые статьи voice-notes/ — голосовые заметки
91 lines
2.6 KiB
Markdown
91 lines
2.6 KiB
Markdown
## Авторизация
|
||
|
||
Используется кастомный header `X-Erp-Integration`
|
||
Значение хранится в конфигах у системы СУП.
|
||
Для дев и прод разные значения.
|
||
При получении значения необходимо его сравнить со значением хранящимся в конфиге.
|
||
Если значения не соответствуют, то вернуть ошибку.
|
||
## Создание клиента
|
||
|
||
Используется endpoint с методом POST
|
||
|
||
Предлагаемый вариант
|
||
`api/1.0/openRequest/createClient`
|
||
### Запрос
|
||
|
||
```json
|
||
{
|
||
"name": "Альфа-Пласт",
|
||
"shortName": "Альфа-Пласт",
|
||
"managerId": "00123456", // Значение ИНС сотрудника
|
||
"countryCode": "RU", // Двухбуквенный код страны
|
||
"industryCode": "0015", // Код отрасли ERP
|
||
"authorId": "00123456", // Значение ИНС сотрудника
|
||
"accountId": "57ef229c-d8e4-4da5-b87a-7205e7eb7c42"
|
||
}
|
||
```
|
||
|
||
```
|
||
"name" - Наименование клиента
|
||
"shortName" - Краткое название
|
||
"managerId" - Менеджер по продажам
|
||
"countryCode" - Страна
|
||
"industryCode" - Отрасль
|
||
"authorId" - Автор клиента в CRM
|
||
"accountId" - Id контрагента в CRM
|
||
```
|
||
### Ответ
|
||
|
||
Успешный
|
||
```json
|
||
{
|
||
"success": true,
|
||
"errorMessage": ""
|
||
}
|
||
```
|
||
|
||
Неуспешный
|
||
```json
|
||
{
|
||
"success": false,
|
||
"errorMessage": "Текст ошибки"
|
||
}
|
||
```
|
||
## Проверка готовности создания клиента
|
||
|
||
Используется endpoint с методом GET
|
||
|
||
Предлагаемый вариант
|
||
`api/1.0/openRequest/viewAccount?accountId={accountId}`
|
||
|
||
Главная суть метода, что мы по значению `accountId` из пункта `Создание клиента` получаем готовность создания клиента.
|
||
Клиент считается созданным, если у него заполнено поле `ClientId` (уточнить как называется в базе данных поле `Код клиента из R3`)
|
||
### Ответ
|
||
|
||
Клиент еще создается
|
||
```json
|
||
{
|
||
"status": "Waiting",
|
||
"clientId": "",
|
||
"errorMessage": ""
|
||
}
|
||
```
|
||
|
||
Создание клиента завершено
|
||
```json
|
||
{
|
||
"status": "Success",
|
||
"clientId": "0000101202",
|
||
"errorMessage": ""
|
||
}
|
||
```
|
||
|
||
Ошибка при создании клиента
|
||
```json
|
||
{
|
||
"status": "Error",
|
||
"clientId": "",
|
||
"errorMessage": "Описание ошибки"
|
||
}
|
||
```
|