Статус документа

[lopik]

Доброго дня
Спостерігається деяка неузгодженість у відповідях щодо статусу документа
Описувати буду з точки зору Rest Api, але це ж скоріше за всього відноситься і до COM
Наприклад, виклики функцій GetPrimaryReestr, GetDocStatus, GetDocInfo повертають поле Status, і у випадку GetPrimaryReestr статус відноситься до реєстрації документа, а у двох інших функціях це вже відноситься до перевірки самого документа
нижче йдуть виклики щодо двох документів, один зареєстрований інший відхилений податковою

Документ зареєстровано

Код: Виділити все

{{baseUrl}}/api/Info/GetPrimaryReestr?idOrg=781&docType=10120&moveType=0&dateFrom=2023/10/16&dateEnd=2023/10/16
{
        "status": 4,
        "vatsum": null,
        "regdate": "2023-10-16T00:00:00",
        "doc_id": "DBE039F7-028C-4FF2-A19D-2DD033EE9CB6",
        "exdoc_id": null,
        "cardcode": 2288466,
	........
}

{{baseUrl}}/api/Info/GetDocStatus?cardCode=2288466
{
    "Code": 0,
    "Name": "Status",
    "Value": "2",
    "Message": null
}

{{baseUrl}}/api/Info/GetDocInfo?cardCode=2288466
{
......
        "STATUS": 2,
        "STATUSNAME": "Перевірений",
        "SENDSTT": 3,
        "SENDSTTNAME": "Підписано печаткою",
......
}

Документ відхилено

Код: Виділити все

{{baseUrl}}/api/Info/GetPrimaryReestr?idOrg=781&docType=10120&moveType=0&dateFrom=2023/10/16&dateEnd=2023/10/16
{
        "status": 3,
        "vatsum": null,
        "regdate": "2023-10-16T00:00:00",
        "doc_id": "F9A2D96D-9A95-40C3-9A93-DDA813DB6999",
        "exdoc_id": null,
        "cardcode": 2288433,
....
}
{{baseUrl}}/api/Info/GetDocStatus?cardCode=2288433
{
    "Code": 0,
    "Name": "Status",
    "Value": "2",
    "Message": null
}
{{baseUrl}}/api/Info/GetDocInfo?cardCode=2288433
{
....
        "STATUS": 2,
        "STATUSNAME": "Перевірений",
        "SENDSTT": 10,
        "SENDSTTNAME": "Не прийнято",        
....
}

А до цього всього якщо спробувати прочитати документ за допомогою GetValues, там є таке поле як SEND_DPA але ж у функції GetDocInfo є ще таке поле як SENDSTT яке теж відноситься до реєстрації документа але не співпадає за своїми значеннями

Код: Виділити все

{{baseUrl}}/api/Document/GetValues?cardCode=2288433
    {
        "TAB": 0,
        "LINE": 0,
        "NAME": "SEND_DPA",
        "VALUE": "11"
    },


{{baseUrl}}/api/Document/GetValues?cardCode=2288466
   {
        "TAB": 0,
        "LINE": 0,
        "NAME": "SEND_DPA",
        "VALUE": "12"
    }

Тобто виходить різні функції однаковий результат обробки документу (прийнято/не прийнято) присилають по різному
Для прикладу прийнятий документ
GetPrimaryReestr - "status": 4
GetDocInfo - "SENDSTT": 3,
GetValues -SEND_DPA: 12

Не прийнятий документ
GetPrimaryReestr - "status": 3,
GetDocInfo - "SENDSTT": 10,
GetValues -SEND_DPA: 11


І в решті решт інформаційні функції GetInTrashStatus, GetDocInfo, GetDocSendStt, GetDocStatus потребують трьох параметрів

Необхідно задати ідентифікатор установи та один з ідентифікаторів документа.
При використанні exDocID або docID обов'язково зазначається idOrg.

а GetDocKVT потребує тільки двох

[Marat Melnyk]

Добрий день!

GetPrimaryReestr - "status": 4
Статуси з переліку:
0 Готується
1 Відправлено в ДФС
2 Доставлено в ДФС
3 Відхилено в ДФС
4 Прийнято в ДФС
5 Відправлено контрагенту
6 Доставлено контрагенту
7 Затверджено контрагентом
8 Отриманий
9 Відхилено контрагентом

GetDocInfo - "SENDSTT": 3
Status - це статус документа (результат первірки або її відсутності).
SENDSTT - стан руху документа (результат його обробки або підготовки).
Можливі значення параметрів Status та SENDSTT вказані за посиланням: https://medoc.ua/faq/statusi-dokumenta

GetValues -SEND_DPA: 12
Статус реєстрації документа в ДПС:
0 Готується
9 Відправлено в ДПС
10 Доставлено в ДПС
11 Відхилено в ДПС
12 Прийнято в ДПС

Методи GetInTrashStatus, GetDocInfo, GetDocSendStt, GetDocStatus можуть працювати з одним параметром - cardCode.
В разі роботи з параметрами exDocID або docID потребується додатково вказувати параметр idOrg для отримання єдиного можливого значення.
Для метода GetDocKVT буде також додано обов'язковий параметр idOrg в разі зазначення параметру exDocID.