Назначение

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

PluggetSystemTypeStoreHouse

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


Формат запроса

{
  "taskType": "ShGetEDocs",
  "params": {
    "sync": {
      "objectId": 199990377,
       "timeout": 120
    },
     
    "dateFrom": "2025-01-01",
    "dateTo": "2025-10-28",
    "rid": 1,
    "kppRid": 1
   }
}


taskTypestring+Тип задачи
sync

Синхронный вызов метода (либо синхронный, либо асинхронный)
timeoutint-Время ожидания ответа от агента в секундах, по умолчанию 120 секунд
dateFromstring+Дата с в формате yyyy-MM-dd
dateTostring+Дата по в формате yyyy-MM-dd
ridint+Собственное Юр лицо Rid
kppRidint+Rid Код спецификаций контрагента 
mask
int- Бинарная маска типов накладных:   1-подтверждение, 2-расхождение, 4-отказ, 8-отменено ,16-не обработано. Null - Всё

Формат ответа

// Успешный ответ
{
  "taskResponse":{     
   "filter": {
    "fsRarId": "string",
    "attributes": "string"
   },
   "invoices": [
     {
      "rid": number,
      "invoiceDate": "yyyy-MM-dd",
      "shipmentDate": "yyyy-MM-dd",
      "packedFlag": number,
      "wayBillRegId": "string",
      "identityEgais": "string",
      "numberEgais": "string",
      "comment": string,
      "xmlVersion": number,
      "options": null,
      "wbTypeEgais": number,
      "docType": number,
      "supplierEgais": {
        "rid": number,
        "type": number,
        "codeEgais": "string",
        "fullName": "string",
        "shortName": "string,
        "inn": "string",
        "kpp": "string",
        "countryCode": "string",
        "regionCode": "string",
        "attributes": "string"
      },
      "recipientEgais": {
        "rid": number,
        "type": number,
        "codeEgais": "string",
        "fullName": "string,
        "shortName": "string,
        "inn": "string",
        "kpp": "strnig",
        "countryCode": "string",
        "regionCode": "strnig",
        "attributes": "strnig"
      },
      "recipientRid": number,
      "recipientKpp": "string",
      "recipientFsRarId": "string",
      "recipientAttribute1": "string",
      "recipientAttribute2": "string",
      "recipientAttribute3": "strnig,
      "recipientAttribute4": "strnig",
      "linkInvoice": {
        "dateString": "string",
        "options": number,
        "supplierRid": number,
        "receiverRid": number,       
        "rid": number
      },
      "shipmentType": number,
      "changeOwnership": "string",
      "tranType": "string",
      "companyName": "string",
      "tranNumer": "string",
      "trailer": "string",
      "customer": "string",
      "driver": "string",
      "forwarder": "string",
      "loadingLocation": "string",
      "unloadingLocation": "string",
      "redirection": "string",
      "parentRid": number,
      "parentNumber": "string",
      "withoutConfirmation": nubmer,
      "ticketOptions": number,
      "ttn": number
     }
   ],
   "receipts": [
    {
      "rid": number,
      "result": "string",
      "message": "string",
      "date": "string",
      "typeEgais": "string",
      "type": number,
      "textEgais": "string",
      "egaisRequestRid": number,
      "replyId": "string",
      "egaisRid": number,
      "wbRegId": "string"
     }
   ]
 },
 "responseCommon":{
      "taskGuid":"string",
      "taskType":"ShGetEDocs",
      "objectId":"number"
   }
}
   
// Ответ с ошибкой
{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "ShGetEDocs",
    "objectId": number
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}



invociesarray
 Список заголовков накладных
|-ridnumber
Rid накладной
|-invoiceDatestring (yyyy-MM-dd)
 Дата документа
|-shipmentDatestring (yyyy-MM-dd)
 Дата отгрузки
|-packedFlagnumber
 Товар упакован   . Для 1-й версии XML ( значение поля "18"==0)  : 0-Packed, 1-Unpacked . Для последующих версий XML :всегда 0.    Для Rec_Type == 0:   2 - сверка прошла,
|-wayBillRegIdstring
 WayBillRegId в ЕГАИС
|-identityEgaisstring
 Identity  в ЕГАИС
|-numberEgaisstring
 Number в ЕГАИС
|-commentstring
 Комментарии
|-xmlVersionnumber
 Xml версия: 0-первая, 1-вторая 2-третья
|-optionsnull
 Опции накладной 0-подтверждение, 1 - расхожд, 2-отказ, 3 отмена провед.,4 накл
|-wbTypeEgaisnumber
 Тип WBType ЕГАИС : 0- WBInvoiceFromMe,1-WBReturnToMe, 2-WBInvouceToMe,3-WBReturnFromMe
|-docTypenumber
 Тип документа : 0-приход, 4 расх, 5 возврат, 11  внутреннее перемещение,  100 -акты,
|-supplierEgaisobject
 Поставщик ЕГАИС
|--ridnumber
 Контрагент ЕГАИС: Rid
|--typenumber
 Для 1-й версии XML: всегда-0 ,вторая версия (0-UL 1-FL 2-FO Иностранец 3-TS таможенный союз)
|--codeEgaisstring
 Код ЕГАИС
|--fullNamestring
 Полное наименование
|--shortNamestring
 Короткое наименование
|--innstring
  ИНН
|--kppstring
 КПП
|--countryCodestring
 Код страны
|--regionCodestring
 Код Региона
|--attributesstring
 Описание
|-recipientEgaisobject
 Получатель ЕГАИС
|--ridnumber
 Контрагент ЕГАИС: Rid
|--typenumber
 Для 1-й версии XML: всегда-0 ,вторая версия (0-UL 1-FL 2-FO Иностранец 3-TS таможенный союз)
|--codeEgaisstring
 Код ЕГАИС
|--fullNamestring
 Полное наименование
|--shortNamestring
 Короткое наименование
|--innstring
  ИНН
|--kppstring
 КПП
|--countryCodestring
 Код страны
|--regionCodestring
 Код Региона
|--attributesstring
 Описание
|-recipientRidnumber
 Rid контрагента
|-recipientKppstring
 КПП получателя
|-recipientFsRarIdstring
 FSRAR_ID получателя
|-recipientAttribute1string
 Атрибуты 
|-recipientAttribute2string
 Дополнительные  атрибуты 
|-recipientAttribute3string
 Атрибуты 
|-recipientAttribute4string
 Атрибуты 
|-linkInvoiceobject
 Связанная накладная SH
|--dateStringstring
 Накладная: DateStamp
|--optionsnumber
 Накладная: Опции
|--supplierRidnumber
 Поставщик SH Rid
|--receiverRidnumber
 Получатель SH Rid
|--ridnumber
 Накладная: Rid
|--numberstring
 Накладная: Номер
|--typeMasknumber
 Накладная: Тип
|-shipmentTypenumber
 Тип   перевозки
|-changeOwnershipstring
 ChangeOwnership
|-tranTypestring
 TRAN_TYPE
|-companyNamestring
  Название компании
|-tranNumerstring
 Номер транспорта
|-trailerstring
 Прицеп
|-customerstring
 Заказчики
|-driverstring
 Водитель
|-forwarderstring
 Экспедитор
|-loadingLocationstring
 Место погрузки
|-unloadingLocationstring
 Место разгрузки
|-redirectionstring
 Перенаправление
|-parentRidnumber
 Родительская ТТН Rid
|-parentNumberstring
 Родительская ТТН Number
|-withoutConfirmationnumber
 Битовая маска:  1-"Без подтверждения"
|-ticketOptionsnumber
 Опции тикетов:  ,битовая маска: 1 - есть WayBillTicket Rejected,  2 - есть RequestRepealWB Rejected
|-ttnnumber
 ТТН: Сверка: 1-сверка прошла 
receiptsarray
 Список квитанций
|-ridnumber
 Тикет: Rid
|-resultstring
  Тикет: Результат
|-messagestring
 Тикет: Сообщение
|-datestring
 Тикет: Дата тикета
|-typeEgaisstring
 Тикет: Тип документа ЕГАИС
|-typenumber
 Тип тикета : 0-Ticket0, 1-Ticket1, 2-WayBillAct,3-WayBillTicket,4-ConfirmTicket
|-textEgaisstring
 Текст от ЕГАИС
|-egaisRequestRidnumber
 Запрос в ЕГАИС Rid запроса
|-replyIdstring
  Запрос в ЕГАИС ReplyId
|-egaisRidnumber
 Ссылка на накладную ЕГАИС Rid
|-wbRegIdstring
 Ссылка на накладную ЕГАИС WBRegId


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

{
  "taskType": "ShGetEDocs",
  "params": {
    "sync": {
      "objectId": 199990377,
       "timeout": 120
    },
   
    "dateFrom": "2025-01-01",
    "dateTo": "2025-10-28",
    "rid": 1,
    "kppRid": 1
   }
}