3.3.4.8. Метод GetStatus
|
|
Метод GetStatus возвращает статус документооборота по его docflow ID.
byte[] GetStatus(string docflowId);
| |
docflowId
|
атрибут docflow ID, полученный с помощью метода GetDocflowsList
|
Об изменении статуса документооборота
После отправки документа его документооборот получает статус InProgress.
После того, как Оператор подтвердит получение электронного документа от его отправителя (cформирует и отправит PostDateConfirmation), документооборот получает статус Sent.
После того, как получатель в ответ на первичный документ сформировал ReceiveNotice, возможны два варианта:
1.
|
Для Счёта-фактуры, Корректировочного счёта-фактуры, Неформализованного документа без требования переподписи статус примет значение Success. Если после этого получатель счёта-фактуры или корректировочного счёта-фактуры отправит Уведомление об уточнении (CorrectionNotice), то статус примет значение Warning, а после того, как будет сформировано Извещение о получении Уведомления об уточнении (CorrectionNoticeReceiveNotice), статус примет значение CompletedWithWarning.
|
2.
|
Для ТОРГ-12, АКТ выполненных работ, Неформализованного документа с требованием переподписи статус примет значение ResignWaiting. После отправки положительного ответа (подписания документа) документооборот ТОРГ-12, Акта выполненных работ или Неформализованного документа с требованием переподписи получит статус Success. Если документ будет отклонен, то статус документооборота примет значение Warning.
|
При выявлении ошибки статус документооборота принимает значение Error. Результат метода GetStatus в этом случае будет содержать код ошибки (ApiErrorCode).
Для этапа проверки пересылаемого документа предусмотрены следующие коды ошибок:
Код Такском-Доклайнз
|
Код HTTP
|
Описание ошибки
|
6100
|
400
|
Ошибка форматологического контроля документа
|
6101
|
400
|
Неверно указан подписант в документе
|
6102
|
400
|
Неверно указан отправитель документе
|
6103
|
400
|
Неверно указан получатель документе
|
6104
|
400
|
Ошибка в названии файла документа
|
6105
|
400
|
Ошибка проверки документа по XSD схеме
|
Таблица видов и типов ошибок, а также описание классов исключений приведены в п. 3.3.6. Обработка ошибок.
Примеры XML результата метода GetStatus
Пример 1
<ContainerDescription RequestDateTime="2012-01-25 18:18:35.979">
<DocFlow Id="2313888a-5565-43e2-817d-77fb00dd028f"
Status="InProgress" StatusChangeDateTime="2012-01-25 18:13:36.920">
<Documents>
<Document>
<Definition>
<Identifiers InternalId="9295a8da-3123-4da7-9fb1-f8f260bb2f24" />
</Definition>
</Document>
</Documents>
</DocFlow>
</ContainerDescription>
Пример 2
<?xml version="1.0" encoding="utf-8"?>
<ContainerDescription RequestDateTime = "2014-10-17 11:27:40.117"
IsLast = "true"
xmlns = "http://api-invoice.taxcom.ru/meta">
<DocFlow Id = "08ab9900-0101-49fc-a1f7-64e97a4e480f"
Status = "Error"
ErrorType = "DocflowError"
StatusChangeDateTime = "2014-10-17 11:27:20.043"
ApiErrorCode = "3202">
<Documents>
<Document>
<Definition>
<Identifiers InternalId = "6820536b-8edc-4b41-a08a-fc9255343e62"/>
</Definition>
</Document>
</Documents>
</DocFlow>
</ContainerDescription>
Пример 3
<ContainerDescription RequestDateTime="2014-09-02 14:47:27.510" IsLast="true" xmlns="http://api-invoice.taxcom.ru/meta">
<DocFlow Id="73f72b2d-adc5-469a-9df7-23a4dc8ce1ca"
Status="Sent" StatusChangeDateTime="2014-07-10 15:49:18.050">
<Documents>
<Document>
<Definition>
<Identifiers InternalId="f83af2ae-bcbc-4c3f-af66-3346258ec986" />
</Definition>
</Document>
</Documents>
</DocFlow>
</ContainerDescription>
Пример 4
<ContainerDescription RequestDateTime="2014-09-02 14:47:27.510" IsLast="true" xmlns="http://api-invoice.taxcom.ru/meta">
<DocFlow Id="73f72b2d-adc5-469a-9df7-23a4dc8ce1ca"
Status="ResignWaiting" StatusChangeDateTime="2014-07-10 15:49:18.050">
<Documents>
<Document>
<Definition>
<Identifiers InternalId="f83af2ae-bcbc-4c3f-af66-3346258ec986" />
</Definition>
</Document>
</Documents>
</DocFlow>
</ContainerDescription>