Общие методы

Данные методы работают со всеми типами документов

Содержание:

• Поиск документов пользователя
• Перенос документов в папку «Архив» или «Корзина» либо восстановление из них

Поиск документов пользователя

Позволяет получить и отфильтровать список документов пользователя.

Можно указывать в теле запроса фильтры, например, по типу и/или нахождению документа в определенном разделе (например, во «Входящих»). По умолчанию документы из папок «Черновики», «Архив», и «Корзина» не возвращаются (для их получения нужно передать соответствующие параметры).

Поиск по документам

post /gw/tokugawa/v1/common_api/documents/search

Модель и примеры

Запрос

Модель

{...}

limit: integer

>=1 and <= 100

updated_at__lt: date-time

filters:{...}

query: string

type: enum

[СЧФ, СЧФДОППродавец, СЧФДОППокупатель, ДОППродавец, ДОППокупатель, КорСЧФ, КорСЧФДИСПродавец, КорСЧФДИСПокупатель, КорДИСПродавец, КорДИСПокупатель, ИзвещениеОПолучении, ПодтверждениеОператораОбОтправке, ПодтверждениеОператораОПолучении, УведомлениеОбУточнении, ЗапросНаАннулирование, заказ, заявка (к договору), заявка, поручение экспедитору, договор, акт, заказ услуги по оформлению пропусков в г. москва, договор-заявка, заказ (договор-заявка), заказ (табличный вид), заявка к договору (табличный вид), счет, счет-фактура, УПД (счет-фактура), уведомление об отказе от исполнения, уведомление о расторжении в двустороннем порядке, акт о срыве, уведомление о составлении акта о непредъявлении груза для перевозки, уведомление о составлении акта о непредъявлении транспортного средства под погрузку, доверенность, информационное письмо, другой, акт сверки, доп. соглашение (к договору), накладная, товарная накладная, транспортная накладная, товарно-транспортная накладная, поздравительная открытка, unknown]

An enumeration.

status: enum

[AWAITING_CONFIRMATION_SIGN, WAITING_FOR_REVOKE, CORRECTION_REQUESTED, AWAITING_DECISION, REVOKED, EDO_DONE, APPROVED, DECLINED, SIGNED, NEW_EDITION, CANCELLED, DRAFT]

An enumeration.

contragent_ati_code: string

edo_user: string

ID участника ЭДО(текущего пользователя)

number: string

Номер документа

date_from: date

date_to: date

direction: enum

[incoming, outgoing]

An enumeration.

is_deleted: boolean

is_archived: boolean

is_template: boolean

}

}

Пример запроса

CURL

curl 'https://api.ati.su/gw/tokugawa/v1/common_api/documents/search' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"limit":0,"updated_at__lt":"1970-01-01T00:00:00.000Z","filters":{"query":"string","type":"СЧФ","status":"AWAITING_CONFIRMATION_SIGN","contragent_ati_code":"^\\d+$","edo_user":"string","number":"string","date_from":"1970-01-01","date_to":"1970-01-01","direction":"incoming","is_deleted":false,"is_archived":false,"is_template":false}}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/tokugawa/v1/common_api/documents/search", "{""limit"":0,""updated_at__lt"":""1970-01-01T00:00:00.000Z"",""filters"":{""query"":""string"",""type"":""СЧФ"",""status"":""AWAITING_CONFIRMATION_SIGN"",""contragent_ati_code"":""^\\d+$"",""edo_user"":""string"",""number"":""string"",""date_from"":""1970-01-01"",""date_to"":""1970-01-01"",""direction"":""incoming"",""is_deleted"":false,""is_archived"":false,""is_template"":false}}");

Ответ

200 Successful Response

Модель

{...}

total*: integer

total_remaining*: integer

result*:[{...}]

id*: string

is_riak: boolean

direction*: enum

[incoming, outgoing]

An enumeration.

number: string

date: date

type*: enum

[УПД. Счет-фактура, УПД. Счет-фактура и акт, УПД. Акт, УКД. Корректировочный счет-фактура, УКД. Корректировочный счет-фактура и акт, УКД. Корректировочный акт, заказ, заявка (к договору), заявка, поручение экспедитору, договор, акт, заказ услуги по оформлению пропусков в г. москва, договор-заявка, заказ (договор-заявка), заказ (табличный вид), заявка к договору (табличный вид), счет, счет-фактура, УПД (счет-фактура), уведомление об отказе от исполнения, уведомление о расторжении в двустороннем порядке, акт о срыве, уведомление о составлении акта о непредъявлении груза для перевозки, уведомление о составлении акта о непредъявлении транспортного средства под погрузку, доверенность, информационное письмо, другой, акт сверки, доп. соглашение (к договору), накладная, товарная накладная, транспортная накладная, товарно-транспортная накладная, поздравительная открытка, unknown]

An enumeration.

status*: string

is_read*: boolean

updated_at*: date-time

contragent:{...}

ati_code*: string

name*: string

}

comments*:{...}

count*: integer

Количество комментариев

tail:{...}

name*: string

text*: string

timestamp*: date-time

}

}

flags*: [string]

highlight: enum

[failure, success, ]

An enumeration.

signs*:{...}

user:{...}

title*: string

valid_from*: string

valid_until*: string

}

contragent:{...}

title*: string

valid_from*: string

valid_until*: string

}

}

template_name: string

}]

}

Пример

{...}

"total":0,

"total_remaining":0,

"result":[...]

{...}

"id":"string",

"is_riak":false,

"direction":"incoming",

"number":"string",

"date":"1970-01-01",

"type":"УПД. Счет-фактура",

"status":"string",

"is_read":false,

"updated_at":"1970-01-01T00:00:00.000Z",

"contragent":{...},

"ati_code":"string",

"name":"string"

},

"comments":{...},

"count":0,

"tail":{...}

"name":"string",

"text":"string",

"timestamp":"1970-01-01T00:00:00.000Z"

}

},

"flags":[...],

"string"

],

"highlight":"failure",

"signs":{...},

"user":{...},

"title":"string",

"valid_from":"string",

"valid_until":"string"

},

"contragent":{...}

"title":"string",

"valid_from":"string",

"valid_until":"string"

}

},

"template_name":"string"

}

]

}

422 Validation Error

Модель

{...}

detail:[{...}]

loc*: [string]

Путь до поля, вызвавшего ошибку

msg*: string

Расшифровка ошибки

type*: string

Тип ошибки

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

{ "limit": 0, "updated_at__lt": "1970-01-01T00:00:00.000Z", "filters": { "query": "string", "type": "СЧФ", "status": "AWAITING_CONFIRMATION_SIGN", "contragent_ati_code": "^\\d+$", "edo_user": "string", "number": "string", "date_from": "1970-01-01", "date_to": "1970-01-01", "direction": "incoming", "is_deleted": false, "is_archived": false, "is_template": false } }

Перенос документов в папку «Архив» или «Корзина» либо восстановление из них

Переносит указанный документ в указанную папку либо восставливает из нее. Может принимать несколько документов за раз.

«Action» может принимать значения «trash», «archive», «restore_from_trash» или «restore_from_archive». При невозможности выполнения действия возвращается id документа(-ов), по которым действие не произведено.

Перемещение документов

post /gw/tokugawa/v1/common_api/documents/{action}

Модель и примеры

Запрос

Модель

[string]

Пример запроса

CURL

curl 'https://api.ati.su/gw/tokugawa/v1/common_api/documents/{action}' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["string"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/tokugawa/v1/common_api/documents/{action}", "[""string""]");

Ответ

200 Successful Response

Модель

[string]

Пример

[...]

"string"

]

422 Validation Error

Модель

{...}

detail:[{...}]

loc*: [string]

Путь до поля, вызвавшего ошибку

msg*: string

Расшифровка ошибки

type*: string

Тип ошибки

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

action

[ "string" ]