Авторизация

HTTP запрос для получения кода действующей сессии (токена). Данный код обязателен к использованию практически во всех запросах API. Стандартное время жизни сессии восемь часов.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
keynumber [String]* - номер лицензии
codesync [String]* - код синхронизации
* - обязательно
Ответ:
ses [String] - код действующей сессии
Отрицательные ответы:
!IncorrectDataEntered - данные указаны неверно или доступ отключен
!SomethingWentWrong - сбой при обработке данных

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

HTTP запрос для формирования списка документов. Список состоит из двухсот последних отредактированных Документов. Максимальное количество отображаемых строк можно задать в параметрах запроса.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
task [String]* = 'listoflastdocs'
fields [String] - перечень полей, индексы указываются через запятую, полей в запросе должно быть не более десяти
countofdocs [Integer] - количество отображаемых строк с информацией из документа
* - обязательно
Ответ:
Массив в виде таблицы, где первые три колонки содердат: индекс документа, дата и время последнего изменения, основной индекс бланка (используемого при создании документа)
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!CountOfFieldsVeryLarge - количество полей очень большое
!CountOfDocumentsVeryLarge - код сессии указан неверно

Работа с Документом

Создание нового Документа

HTTP запрос для создания нового Документа в архиве, на основе кода необходимого бланка (конфигурации).
Варианты индексов действующих бланков:
ACT00100 - Акт-осмотра
AST00100 - ОСАГО
AXP00100 - КАСКО
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
bnk [String]* - код бланка
* - обязательно
Ответ:
doc [String] - индекс созданного документа
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно

Получение содержимого поля Документа

HTTP запрос возвращающий содержимое поля формы.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
frmfield [String]* - индекс поля
* - обязательно
Ответ:
val [String] - содержимое поля
    где: null - пустое значение
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!FieldNotFound - индекс поля ненайден

Получение содержимого нескольких полей Документа

HTTP запрос возвращающий содержимое нескольких полей формы.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
frmfields [String]* - перечисленные индексы полей через запятую
* - обязательно
Ответ:
Массив в виде списка с индексами и содержимым соответствующих полей
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

Изменение содержимого поля Документа

HTTP запрос для внесения нового значения в поле формы.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
frmfield [String]* - индекс поля
val [String]* - новое значение
    где: null - пустое значение
* - обязательно
Ответ:
OK - изменение успешно внесено
NC - изменения отсутствуют
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!FieldNotFound - индекс поля ненайден
!DateFormatIsNotCorrect - формат даты неверный

Изменение содержимого нескольких полей Документа

HTTP запрос для внесения изменений в нескольких полях формы, одновременно.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
frmfields [String]* - перечисленные индексы полей через запятую
vals [String]* - перечисленные новые значения через разделитель - [s]
    где: null - пустое значение
* - обязательно
Ответ:
OK - изменение успешно внесено
NC - изменения отсутствуют
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!FieldsCountNotMatch - количество полей и значений не равное
!FieldNotFound - индекс поля ненайден
!DateFormatIsNotCorrect - формат даты неверный

Получение содержимого таблицы Документа

HTTP запрос для получения всех записей заданной таблицы.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* - 'tblrows'
table [String]* - индекс таблицы
* - обязательно
Ответ:
Массив в виде таблицы.
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!TableNotFound - таблица не найдена

Добавление записей в таблицу Документа

HTTP запрос для добавления записей в заданную таблицу.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* - 'tbladdrows'
table [String]* - индекс таблицы
rows [String]* - массив строк в Json
* - обязательно
    пример для tblDETAILS:
[
  {
    "c0": "Запчасть для первой строки",
    "c1": 100,
    "c3": 1.2,
    "c7": "16542684"
  },
  {
    "c0": "Запчасть для второй строки",
    "c1": 200,
    "c3": 1.7,
    "c7": "45876215"
  },
  {
    "c0": "Запчасть для третьей строки",
    "c1": 300,
    "c3": 2.1,
    "c7": "34587642"
  }
]

Ответ:
OK - записи успешно добавлены
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!NewRowsNotFound - строки в массиве отсутствуют
!TableNotFound - тьблица не найдена
!TableUnsupportedAddRows - таблица не поддерживает добавление строк

Удаление записей в таблице Документа

HTTP запрос для удаления записей в заданной таблице.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* - 'tbldelrows'
table [String]* - индекс таблицы
rows [String]* - перечисленные индексы записей через запятую
* - обязательно
Ответ:
OK - записи успешно удалены
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!NewRowsNotFound - строки в таблице отсутствуют

Получение статуса Документа

HTTP запрос возвращающий текущий статус Документа.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'getdocstatus'
* - обязательно
Ответ:
docstatus [String] - текущий статус
    где: null - пустое значение
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

Получение статуса Документа, включая время

HTTP запрос возвращающий текущий статус Документа, включая время его установки.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'getdocstatuswtime'
* - обязательно
Ответ:
docstatusname [String] - текущий статус
    где: null - пустое значение
docstatustime [String] - время установки статуса
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

Изменение статуса Документа

HTTP запрос для изменения текущего статуса Документа.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'setdocstatus'
val [String]* - новое значение
    где: null - пустое значение
* - обязательно
Ответ:
OK - изменение успешно внесено
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

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

HTTP запрос возвращающий текущий символ признака Документа.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'getdocsymbol'
* - обязательно
Ответ:
docsymbol [String] - текущий символ
    где: null - пустое значение
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

Изменение символа признака Документа

HTTP запрос для изменения текущего символа признака Документа.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'setdocsymbol'
val [String]* - новое значение
где: null - пустое значение
доступные варианты: alert, express, phone, print, flag, light
* - обязательно
Ответ:
OK - изменение успешно внесено
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!DocSymbolIsNotCorrect - формат символа неверный

Добавление изображения в Документ

HTTP запрос для включения изображений (*.jpeg, *.jpg, *.png) в Документ используя многокомпонентный формат MIME с 'Content-Type' заголовком HTTP 'multipart/form-data'.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'addimage'
gallery [String]* - индекс раздела (галереи) в документе
comment [String] - текстовое описание изображения
geoposlat [String] - геопозиция по широте
geoposlon [String] - геопозиция по долготе
* - обязательно
Ответ:
OK - файл успешно добавлен
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!ImageMissing - файл с изображением отсутствует
!FileIsNotImage - файл не является изображением
!TooManyImages - файлов слишком много, должно быть не более одного

Получение списка изображений из Документа

HTTP запрос для получения списка изображений из Документа.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'listofimages'
gallery [String]* - индекс раздела (галереи) в документе
* - обязательно
Ответ:
Массив в виде таблицы, где колонки содержат: индекс изображения, описание, геоданные, дата и время добавления
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден

Получение изображения из Документа

HTTP запрос для получения изображения из Документа. Формат изображения - Jpeg.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
image [String]* - индекс изображения
* - обязательно
Ответ:
Массив с 'ContentType' заголовком 'image/jpg'
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!ImageNotFound - изображение ненайдено

Добавление файла в Документ

HTTP запрос для включения файлов (*.doc, *.docx, *.xls, *.xlsx, *.pdf, *.jpg, *.jpeg, *.png, *.bmp, *.psc, *.mp4) в Документ используя многокомпонентный формат MIME с 'Content-Type' заголовком HTTP 'multipart/form-data'.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'addfile'
* - обязательно
Ответ:
OK - файл успешно добавлен
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!FileMissing - файл отсутствует
!UnsupportedFormat - неподдерживаемый формат файла
!FileIsVeryLarge - файл слишком большого рамера, рамер не должен превышать 30MB
!FileNameExists - файл с таким именем уже существует

Оценка транспорта

Подбор каталога по VIN

HTTP-запрос для получения списка с вариантами доступных каталогов для заданного VIN-кода.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
task [String]* = 'catalogsbyvin'
vin [String]* = VIN-код
* - обязательно
Ответ:
Массив в виде списка подходящих вариантов доступных каталогов
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!VINIsNotCorrect - VIN указан неверно
!NotFindOptimalCatalog - ненайден подходищий каталог

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

HTTP-запрос для привязки каталога к заданному документу.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'fixcatalog'
marka [String]* = индекс марки каталога
axp [String]* = код AXP используемого каталога
made [String]* = год выпуска транспортного средства: [yyyy]
* - обязательно
Ответ:
OK - привязка успешно выполнена
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!DateMadeIsNotCorrect - формат года выпуска указан неверно
!UnsupportedMarka - индекс марки не поддерживается или указан некорректно

Формирование выборки из текста

HTTP-запрос для добавления в таблицу tblLGSEL записей, извлеченных из описания ремонта ТС, где точка с запятой или жёсткий перенос должны определять разделение между описываемыми элементами.
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'lgselectident'
text [String]* = текст с произвольным описанием ремонтных воздействий
* - обязательно
Ответ:
OK - выборка успешно сформирована
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!CatalogNotSelected - для данного документа не задан каталог, вероятно пустое поле - laborguidused
!UnsupportedCatalog - заданный для документа каталог не поддерживается или указан некорректно

Расчёт калькуляции из выборки

HTTP-запрос для получения калькуляции на основании выборки расположенной в таблице tblLGSEL и данных указанных в обязательных полях. Результатом являются заполненные разделы документа: ремонт, окраска, запчасти и материалы.
GET https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'lgselectcalc'
* - обязательно
Обязательные поля:
{model} - модель;
{laborguidused} - используемый каталог;
{datemade} - дата выпуска;
{datedtp} - дата ДТП (страхового случая);
{kmfact} - пробег;
{rufedsubject} - субъект федерации.
Ответ:
OK - калькуляция успешно сформирована, необходимые таблицы заполнены
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!CatalogNotSelected - для данного документа не задан каталог, вероятно пустое поле - laborguidused
!SelectionNotFound - Раздел для выборки не заполнен
!LimitIsReached - Количество расчётов превысило допустимое число
!CalcUnknownError - При формировании калькуляции произошла неизвестная ошибка

Актуализация цен на запчасти

HTTP-запрос для получения цен на запчасти в таблицу tblDETAILS, согласно указаными в ней номерами. Документ должен содержать заполненные поля: model, datedtp, rufedsubject
POST https://pscw.autoxp.ru/api.aspx
Запрос:
ses [String]* - код действующей сессии
doc [String]* - индекс документа
task [String]* = 'regpartprices'
src [String]* = применяемый источник:
доступные варианты: rsa, rrc, arc
* - обязательно
Ответ:
OK - актуализация цен успешно проведена
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно
!NoDocumentSpecified - документ не найден
!SourceNotFound - применяемый источник не опознан
!DetailsNotFound - таблица tblDETAILS пустая

Получение списка моделей каталога

HTTP-запрос для получения полного списка моделей в каталоге для заданной марки ТС.
POST https://pscw.autoxp.ru/api_lg.aspx
Запрос:
ses [String]* - код действующей сессии
task [String]* = 'listofmodels'
marka [String]* = индекс марки каталога
* - обязательно
Ответ:
Массив в виде списка моделей с основными техническими характеристиками: код-AXP, серия, модель, год начала выпуска, год окончания выпуска, тип кузова, кол-во дверей, тип топлива, объем двигателя, л.с., кВт, КПП.
Отрицательные ответы:
!SessionNotValid - сессия не действительна
!InvalidSessionFormat - код сессии указан неверно