Описание: Возвращает список приходных документов.
Максимальная длина ответа - не более 1000 документов или не более 20000 строк в документах.
Если первый документ превышает 20000 строк, то в ответе будет только этот документ.
Если в ответе сервера updCount равен значению updCount в параметрах запроса, то это означает, что новых данных нет - повторите запрос через несколько минут.
Доступные документы:
- Код 1. Приход от поставщика.
- Код 5. Возврат покупателя.
- Код 6. Инвентаризация (Приход).
- Код 9. Переоценка (Приход).
- Код 11. Перемещение (Приход).
- Код 27. Возврат предоплаты.
Ресурс: GoodsMoveIn
Параметры:
- parentId: Код контрагента владельца. Целое число (4 байта).
- customerId: Код контрагента. Целое число (4 байта).
- branchId: Код филиала. Целое число (4 байта).
- updCount: Счётчик обновлений. Целое число (8 байт).
- naklTitleId: Номер документа. Целое число (8 байт).
- docTypeId: Код типа документа. Целое число (4 байта).
- dateType: Тип диапазона дат. Целое число (4 байта). Возможные варианты:
- 0 - Дата не учитывается.
- 1 - Дата проводки документа.
- 2 - Дата изменения документа.
- 3 - Дата документа поставщика.
- d1: Начало диапазона. Дата/Время. Формат yyyy-MM-dd HH:mm:ss.SSS.
- d2: Конец диапазона. Дата/Время. Формат yyyy-MM-dd HH:mm:ss.SSS.
- isIgnoreUpdCount: Игнорирование параметра updCount. (true/false):
- true - ресурс возвращает ответ без учета UpdCount, т.е. будут присутствовать все документы за выбранный период.
- false - ресурс возвращает ответ с учетом UpdCount.
Подсказка по указанию параметров:
При указании параметра parentId выбор документов осуществляется по всем филиалам всех контрагентов, относящихся к указанному владельцу.
При указании параметра customerId выбор документов осуществляется по всем филиалам указанного контрагента. Параметр parentId игнорируется.
При указании параметра branchId выбор документов осуществляется по указанному филиалу. Параметры customerId и parentId игнорируются.
При указании параметра docTypeId выбор документов осуществляется только по типу документа, код которого указан в данном параметре.
При указании параметра naklTitleId возвращаются данные только по данному документу.
При указании параметра isIgnoreUpdCount = true, периода дат d1, d2 и указании значения параметра naklTitleId - в ответе будут присутствовать все документы со значениями, больше переданного naklTitleId.
Это необходимо использовать, если за выбранный период более 1000 документов или не более 20000 строк в документах.
Пример запроса: https://api.farmbazis.ru/GoodsMoveIn?parentId=123&customerId=0&branchId=0&updCount=0&docTypeId=1&dateType=1&naklTitleId=0&d1=2017-05-15 00:00:00.000&d2=2017-05-16 00:00:00.000
Пример ответа:
{
"status": "0",
"date": "2017-10-02 14:07:06.747",
"updCount": 0,
"document":[
{
"naklTitleId": 123,
"isDisable": false,
"docTypeId": 1,
"docType": "Приход от поставщика",
"branchId": 12,
"distrId": 3974,
"distr": "ООО \"Поставщик\" ",
"docDate": "2017-05-16",
"createDate": "2017-06-01 15:04:27.82",
"docNumber": "пст-777",
"inBuh": true,
"sumOptNoNDS": 35.78,
"sumOptWNDS": 42.22,
"sumRoznNoNDS": 64,
"sumRoznWNDS": 72,
"naklTitleRId": 321,
"NumberSession": 1804,
"DeviceID": 123456,
"dateModify": "2017-06-01 15:04:27.82",
"status": [{
"id": "4",
"name": "Проведен"
}],
"SFactura": "00000647",
"FacturaDate": "2019-08-07",
"row": [{
"sortIndex": 1,
"naklDataId": 333,
"regId": 654,
"quantity": 1,
"priceFabrNoNDS": 0,
"priceFabrWNDS": 0,
"priceOptNoNDS": 35.78,
"priceOptWNDS": 42.22,
"priceRoznWNDS": 72,
"reestrPrice": 0,
"reestrPriceSpr": 0,
"nds": 18,
"srokG": "2019-02-01",
"seria": "s500",
"barCodeFabr": "111111111111",
"isDisable": false,
"jv": false,
"naklDataRId": 3569845,
"firstNaklDataId": 778,
"isService": false,
"isIntZak": false,
"naklDataIdReal": 1235645
"isMarked": true
"GTIN": "04602876003121"
"customDeclaration": "10013160/051020/0546367"
"sertifNumber": "ЛП-№(000082)-(РГ-RU)"
"sertifDate": "2015-05-01"
"sertifExpireDate": "2020-05-01"
"sertifLab": "МЗРФ"
"otherSideNaklDataID": "1329658382"
"otherSideRegId": "М-00015465",
"commission": false
}]
}...]
}
Описание полей в ответе сервера:
- status: Статус запроса. 0 - Запрос выполнен успешно.
- date: Текущее время сервера. Дата/Время. Формат yyyy-MM-dd HH:mm:ss.SSS.
- updCount: Счётчик обновлений. Целое число (8 байт).
- document: Список документов:
- naklTitleId: Внутренний номер документа. Целое число (8 байт).
- isDisable: Признак удаления. Логическое.
- docTypeId: Код типа документа. Целое число (4 байта).
- docType: Тип документа. Строка (50).
- branchId: Код филиала. Целое число (4 байта).
- distrId: Код поставщика. Целое число (4 байта)(Указывается только для типов документа 1).
- distr: Поставщик. Строка (250)(Указывается только для типов документа 1).
- docDate: Дата документа поставщика. Дата. Формат yyyy-MM-dd.
- createDate: Дата проводки. Дата/Время. Формат yyyy-MM-dd HH:mm:ss.SSS.
- docNumber: № документа поставщика. Строка (20) (Указывается только для типов документа 1).
- inBuh: Признак выгрузки в бухгалтерию. Логическое.
- sumOptNoNDS: Сумма документа оптовая (закупочная) без НДС. Число с плавающей точкой (точность 15,2).
- sumOptWNDS: Сумма документа оптовая (закупочная) с НДС. Число с плавающей точкой (точность 15,2).
- sumRoznWNDS: Сумма документа розничная (отпускная) с НДС. Число с плавающей точкой (точность 15,2).
- sumRoznNoNDS: Сумма документа розничная (отпускная) без НДС. Число с плавающей точкой (точность 15,2).
- sumRoznWNDSvsDiscount: Сумма документа розничная (отпускная) с НДС, со скидкой. Число с плавающей точкой (точность 15,2)(Указывается только для типов документа 5).
- naklTitleRId: Внутренний номер парного расходного документа. Целое число (8 байт)(Указывается только для типов документа 5).
- NumberSession: Номер кассовой смены. Целое число (8 байт)(Указывается только для типов документа 5).
- DeviceID: Номер кассового устройства. Целое число (8 байт)(Указывается только для типов документа 5).
- dateModify: Дата последнего изменения документа. Дата/Время. Формат yyyy-MM-dd HH:mm:ss.SSS.
- SFactura: Номер счет фактуры. Строка (20)(Указывается только для типов документа 1).
- FacturaDate: Дата счет фактуры. Дата. Формат yyyy-MM-dd.(Указывается только для типов документа 1)
- donorBranchId: Код филиала поставщика по документу перемещение (приход). Целое число (4 байта). (Указывается только для типов документа 11)
- status: Статусы документа. Список:
- id: Код статуса. Целое число (4 байта).
- name: Статус. Строка (50).
- Возможные варианты (подсказка: не является полем спиcка):
- Код 0. Удалён.
- Код 1. В процессе редактирования.
- Код 2. Товар получен.
- Код 3. Расценка завершена.
- Код 4. Проведен.
- Код 5. Ожидает авт. проводки.
- Код 6. Проведен автоматически.
- Код 7. Ожидает коррекции.
- row: Строки. Список:
- sortIndex: Порядковый номер строки в документе. Целое число (4 байта).
- naklDataId: Айди строки (Код партии товара). Целое число (8 байт).
- regId: Код товара. Целое число (4 байта).
- quantity: Количество. Число с плавающей точкой (точность 15,5).
- priceFabrNoNDS: Цена производителя без НДС. Число с плавающей точкой (точность 15,2).
- priceFabrWNDS: Цена производителя с НДС. Число с плавающей точкой (точность 15,2).
- priceOptNoNDS: Цена оптовая (закупочная) без НДС. Число с плавающей точкой (точность 15,2).
- priceOptWNDS: Цена оптовая (закупочная) с НДС. Число с плавающей точкой (точность 15,2).
- priceRoznWNDS: Цена розничная (отпускная) с НДС. Число с плавающей точкой (точность 15,2).
- priceRoznNoNDS: Цена розничная (отпускная) без НДС. Число с плавающей точкой (точность 15,2).
- reestrPrice: Цена реестра. Число с плавающей точкой (точность 15,2).
- reestrPriceSpr: Цена реестра (справочно). Число с плавающей точкой (точность 15,2).
- sumOptNoNDS: Сумма оптовая (закупочная) без НДС. Число с плавающей точкой (точность 15,2).
- sumOptWNDS: Сумма оптовая (закупочная) с НДС. Число с плавающей точкой (точность 15,2).
- sumRoznNoNDS: Сумма розничная (отпускная) без НДС. Число с плавающей точкой (точность 15,2).
- sumRoznWNDS: Сумма розничная (отпускная) с НДС. Число с плавающей точкой (точность 15,2).
- nds: НДС. Целое число (4 байта).
- srokG: Срок годности. Дата. Формат yyyy-MM-dd.
- seria: Серия. Строка (50).
- barCodeFabr: Штрих-код (производителя). Строка (50)
- barCodeInner: Штрих-код (внутренний). Строка (13)
- isDisable: Признак удаления. Логическое.
- jv: Признак ЖНВЛС. Логическое.
- naklDataRId: Айди строки в парном расходном документе. Целое число (8 байт).
- firstNaklDataId: Айди строки приходного документа (Код родительской партии). Целое число (8 байт).
- isService: Признак услуги. Логическое.
- isIntZak: Признак интернет заказа. Логическое.
- naklDataIdReal: Код партии прихода товара в аптечную сеть (истинный приход). Целое число (8 байт).
- isMarked: Признак маркировки. Логическое.
- GTIN: Номер GTIN. Строка(14)
- customDeclaration: Номер ГТД. Строка(100)
- sertifNumber: Номер сертификата. Строка(110)
- sertifDate: Дата начала действия сертификата. Дата. Формат yyyy-MM-dd
- sertifExpireDate: Дата окончания действия сертификата. Дата. Формат yyyy-MM-dd
- sertifLab: Лаборатория, выдавшая сертификат. Строка (150)
- otherSideNaklDataID: Номер партии стороннего ПО. Строка (50)
- otherSideRegId: Код товара поставщика. Строка (20)
- commission: Признак комиссионного товара. Логическое.