Skip to main content

Фискальные документы

GET 

/v5/orgs/:org_guid/reports/operation/fiscal

Коды возможных ошибок:

[500]: "InternalServerError" - внутренняя ошибка сервера [429]: "TooManyRequests" - превышено ограничение на количество запросов в секунду [401]: "Unauthorized" - для выполнения операции требуется авторизация [403]: "NoPermissions" - нет прав на выполнение этой операции [404]: "NotFound" - запрашиваемый объект или его родительский объект не найдены [422]: "RequestIsNotValid" - параметры запроса не прошли валидацию

Request

Path Parameters

    org_guid uuidrequired

    GUID организации

Query Parameters

    date_from date-time

    Starting date

    date_to date-time

    End date

    page_token string

    Токен (курсор, ссылка) запрашиваемой страницы результатов списка. Если он не задан, то возвращается первая страница результатов. Размер страницы списка регулируется сервером.

    presentation PresentationModes

    Possible values: [compact, full]

    Режим представления результатов запроса

Header Parameters

    Accept-Language stringrequired

    Язык используемый для ответов

    Example: ru-RU
    X-LP-Client-Identifier stringrequired

    Идентификатор клиента

    Example: ab37246a-bec8-45b4-85ef-6b5c30c5d860
    X-LP-Client-Type stringrequired

    Possible values: [Unknown, App, WebApp, Service]

    Тип клиента

    Example: App
    X-LP-Client-Name string

    Имя клиента

    Example: Swagger
    X-LP-Client-OS-Name string

    ОС клиента

    Example: SwaggerDoc
    X-LP-Client-OS-Version string

    Версия ОС клиента

    Example: 1.0
    X-LP-Client-Screen-Resolution string

    Разрешение экрана ОС клиента

    Example: 1280x0900
    X-LP-Client-Model string

    Модель оборудования клиента

    Example: Chrome 75
    X-LP-Organization-Alias string

    Организация по умолчанию

    X-LP-Client-Extensions csv

    Поддерживаемые клиентом расширения моделей

Responses

Success

Schema

    items

    object[]

    nullable

    Список лементов типа <typeparamref name="T" />

  • Array [

  • cashier_name stringnullable

    Имя кассира

    customer_contacts stringnullable

    Контактная информация покупателя

    issued_at date-time

    Дата фискализации

    fiscal_form FiscalDocumentForms (string)

    Possible values: [RegistrationReport, ShiftOpeningReport, Receipt, StrictForm, ShiftClosingReport, FiscalDriveClosingReport, OperatorConfirmation, ReRegistrationReport, SettlementReport, ReceiptOfCorrection, StrictFormOfCorrection]

    Перечисление форм фискальных документов

    operation_type V5FEOperationTypes (string)

    Possible values: [Inflow, InflowRefund, Outflow, OutflowRefund]

    Типы операций (кассовых чеков, БСО)

    positions

    object[]

    nullable

    Позиции

  • Array [

  • method V5FESettlementMethods (string)

    Possible values: [Prepayment, PartialPrepayment, AdvancePayment, FullPayment, PartialPaymentAndCredit, Credit, CreditPayment]

    Способы расчета

    subject V5FESettlementSubjectTypes (string)

    Possible values: [Product, ExcisableProduct, Work, Service, GamblingBet, GamblingWin, LotteryBet, LotteryWin, IntellectualProperty, Payment, AgentCommission, Payout, Other, PropertyRights, NonRealizationIncome, OtherPayments, TradeFee, ResortFee, Bail, Outflow, ContributionForOPSIP, ContributionForOPS, ContributionForOMSIP, ContributionForOMS, ContributionForOOS, CasinoPayment, Cashout, ATNM, ATM, TNM, TM]

    Перечисление значений реквизита "признак предмета расчета" (Тэг ФФД: 1212).

    code bytenullabledeprecated

    Тэг ФФД: 1162. Код товарной номенклатуры. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная. Заголовок в печатной форме: «КТН». Длина: 32 байта.

    as_agent_type_of V5FEAgentTypes (string)

    Possible values: [BankPayingAgent, BankPayingSubagent, PayingAgent, PayingSubagent, Attorney, Consignee, Agent]

    Список признаков агента

    agent_data

    object

    Данные агента

    transfer_operator_name stringnullable

    Possible values: <= 64 characters

    Тэг ФФД: 1026. Наименование оператора перевода. Форма: печатная, электронная. Заголовок в печатной форме: «ОПЕРАТОР ПЕРЕВОДА».

    transfer_operator_phones string[]nullable

    Тэг ФФД: 1075. Телефон оператора перевода. Форма: печатная, электронная. Заголовок в печатной форме: «ТЛФ. ОП. ПЕРЕВОДА». Макс. длина: 19.

    transfer_operator_address stringnullable

    Possible values: <= 256 characters

    Тэг ФФД: 1005. Адрес оператора перевода. Форма: печатная, электронная. Заголовок в печатной форме: «АДР. ОП. ПЕРЕВОДА».

    transfer_operator_inn stringnullable

    Possible values: <= 12 characters

    Тэг ФФД: 1016. ИНН оператора перевода. Форма: печатная, электронная. Заголовок в печатной форме: «ИНН ОП. ПЕРЕВОДА».

    paying_agent_operation stringnullable

    Possible values: <= 24 characters

    Тэг ФФД: 1044. Операция платежного агента. Необязательный, кроме случаев, когда пользователь является банковским платежным агентом или банковским платежным субагентом. Форма: печатная, электронная. Заголовок в печатной форме: «ОП. АГЕНТА».

    paying_agent_phones string[]nullable

    Тэг ФФД: 1073. Телефон платежного агента. Форма: печатная, электронная. Заголовок в печатной форме: «ТЛФ. ПЛ. АГЕНТА». Макс. длина: 19.

    payment_operator_phones string[]nullable

    Тэг ФФД: 1074. Телефон оператора по приему платежей. Форма: печатная, электронная. Заголовок в печатной форме: «ТЛФ. ОП. ПР. ПЛАТЕЖА». Макс. длина: 19.

    type_of stringnullable

    Тип объекта

    supplier_data

    object

    Данные поставщика

    supplier_phones string[]nullable

    Тэг ФФД: 1171. Телефон поставщика. Форма: печатная, электронная. Заголовок в печатной форме: «ТЛФ. ПОСТ.». Макс. длина: 19.

    supplier_name stringnullable

    Possible values: <= 256 characters

    Тэг ФФД: 1225. Наименование поставщика. Форма: печатная, электронная.

    type_of stringnullable

    Тип объекта

    supplier_inn stringnullable

    Possible values: >= 10 characters and <= 12 characters

    Тэг ФФД: 1226. ИНН поставщика. Форма: печатная, электронная. Обязательность по ФЗ-54: Опциональный. Заголовок в печатной форме: «ИНН ПОСТАВЩИКА».

    name stringnullable

    Possible values: <= 128 characters

    Тэг ФФД: 1030. Наименование предмета расчета. Обязательность по ФЗ-54: Обязательный, за исключением случая если реквизит "признак способа расчета" (тег 1214) имеет значение, равное "3". Форма: печатная, электронная.

    country CountryCodes (string)

    Possible values: [AFG, ALB, ATA, DZA, ASM, AND, AGO, ATG, AZE, ARG, AUS, AUT, BHS, BHR, BGD, ARM, BRB, BEL, BMU, BTN, BOL, BIH, BWA, BVT, BRA, BLZ, IOT, SLB, VGB, BRN, BGR, MMR, BDI, BLR, KHM, CMR, CAN, CPV, CYM, CAF, LKA, TCD, CHL, CHN, TWN, CXR, CCK, COL, COM, MYT, COG, COD, COK, CRI, HRV, CUB, CYP, CZE, BEN, DNK, DMA, DOM, ECU, SLV, GNQ, ETH, ERI, EST, FRO, FLK, SGS, FJI, FIN, ALA, FRA, GUF, PYF, ATF, DJI, GAB, GEO, GMB, PSE, DEU, GHA, GIB, KIR, GRC, GRL, GRD, GLP, GUM, GTM, GIN, GUY, HTI, HMD, VAT, HND, HKG, HUN, ISL, IND, IDN, IRN, IRQ, IRL, ISR, ITA, CIV, JAM, JPN, KAZ, JOR, KEN, PRK, KOR, KWT, KGZ, LAO, LBN, LSO, LVA, LBR, LBY, LIE, LTU, LUX, MAC, MDG, MWI, MYS, MDV, MLI, MLT, MTQ, MRT, MUS, MEX, MCO, MNG, MDA, MNE, MSR, MAR, MOZ, OMN, NAM, NRU, NPL, NLD, CUW, ABW, SXM, BES, NCL, VUT, NZL, NIC, NER, NGA, NIU, NFK, NOR, MNP, UMI, FSM, MHL, PLW, PAK, PAN, PNG, PRY, PER, PHL, PCN, POL, PRT, GNB, TLS, PRI, QAT, REU, ROU, RUS, RWA, BLM, SHN, KNA, AIA, LCA, MAF, SPM, VCT, SMR, STP, SAU, SEN, SRB, SYC, SLE, SGP, SVK, VNM, SVN, SOM, ZAF, ZWE, ESP, SSD, SDN, ESH, SUR, SJM, SWZ, SWE, CHE, SYR, TJK, THA, TGO, TKL, TON, TTO, ARE, TUN, TUR, TKM, TCA, TUV, UGA, UKR, MKD, EGY, GBR, GGY, JEY, IMN, TZA, USA, VIR, BFA, URY, UZB, VEN, WLF, WSM, YEM, ZMB]

    Коды стран ISO 3166-1 alpha-3 / ISO 3166-1 numeric

    declaration_number stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1231. Номер декларации на товар. Обязательность по ФЗ-54: Опциональный. Включается в состав кассового чека (БСО), кассового чека коррекции (БСО коррекции) в случаях, установленных законодательством Российской Федерации о применении ККТ. Форма: печатная, электронная. Заголовок в печатной форме: «ДЕКЛАРАЦИЯ».

    price_per_unit int64

    Тэг ФФД: 1079. Цена за единицу предмета расчета с учетом скидок и наценок. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная.

    vat_per_unit int64nullable

    Тэг ФФД: 1198. Размер НДС за единицу предмета расчета. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная.

    quantity double

    Тэг ФФД: 1023. Количество предмета расчета. Обязательность по ФЗ-54: Опциональный. Если значение реквизита "количество предмета расчета" равно "0", то реквизит не включается в состав кассового чека. Форма: печатная, электронная.

    excise_fee int64nullable

    Тэг ФФД: 1229. Акциз. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная. Заголовок в печатной форме: «АКЦИЗ».

    vat_rate V5FEValueAddedTaxCodes (string)

    Possible values: [Vat1102, Vat1103, Vat1104, Vat1105, Vat1106, Vat1107]

    Перечисление ФФД-кодов ставок НДС

    total_vat int64nullable

    Тэг ФФД: 1200. Cумма НДС за предмет расчета. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная.

    total_price int64nullable

    Тэг ФФД: 1043. Стоимость предмета расчета с учетом скидок и наценок. Обязательность по ФЗ-54: Обязательный Форма: печатная, электронная.

    additional_attribute stringnullable

    Possible values: <= 64 characters

    Тэг ФФД: 1191. Дополнительный реквизит предмета расчета. Обязательность по ФЗ-54: Опциональный. Форма: печатная, электронная.

    measure_of_quantity V5FEMeasuresOfQuantity (string)

    Possible values: [Piece, Gram, Kilogram, Ton, Centimeter, Decimeter, Meter, SquareCentimeter, SquareDecimeter, SquareMeter, Milliliter, Liter, CubicMeter, KilowattHour, Gigacalorie, Day, Hour, Minute, Second, Kilobyte, Megabyte, Gigabyte, Terabyte, Other]

    Значения реквизита мера количества предмета расчета (тег 2108).

    good_code

    object

    Значения реквизитов, входящих в состав реквизита код товара (тег 1163).

    unknown stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1300. Нераспознанный код товара

    ean8 stringnullable

    Possible values: <= 8 characters

    Тэг ФФД: 1301. Код EAN-8

    ean13 stringnullable

    Possible values: <= 13 characters

    Тэг ФФД: 1302. Код EAN-13

    itf14 stringnullable

    Possible values: <= 14 characters

    Тэг ФФД: 1303. Код ITF-14

    gs1 stringnullable

    Possible values: <= 38 characters

    Тэг ФФД: 1304. Код GS1.0

    gs1m stringnullable

    Possible values: <= 38 characters

    Тэг ФФД: 1305. Код GS1.M

    kmk stringnullable

    Possible values: <= 38 characters

    Тэг ФФД: 1306. Код КМК

    mi stringnullable

    Possible values: <= 20 characters

    Тэг ФФД: 1307. Код МИ

    egais2 stringnullable

    Possible values: <= 33 characters

    Тэг ФФД: 1308. Код ЕГАИС-2.0

    egais3 stringnullable

    Possible values: <= 14 characters

    Тэг ФФД: 1309. Код ЕГАИС-3.0

    f1 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1320. Код Ф1

    f2 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1321. Код Ф2

    f3 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1322. Код Ф3

    f4 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1323. Код Ф4

    f5 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1324. Код Ф5

    f6 stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1325. Код Ф6

    control_code stringnullable

    Possible values: <= 4 characters

    Тэг ФФД: 2115. Контрольный код КМ. Обязательность по ФЗ-54: Опциональный. Включается в состав реквизита "предмет расчета" в случае если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. Форма: печатная.

    code_processing_mode booleannullable

    Тэг ФФД: 2102. Режим обработки кода маркировки. Обязательность по ФЗ-54: Опциональный. Включается в состав реквизита "предмет расчета" в случае если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. Форма: электронная.

    good_data_checking_result V5FEGoodDataCheckingResult (string)[]nullable

    Possible values: [KMChecked, KPKMCorrect, OISMStatusChecked, OISMStatusCorrect, KPKMCheckedAutonomously]

    Тэг ФФД: 2106. Результат проверки сведений о товаре. Обязательность по ФЗ-54: Опциональный. Включается в состав реквизита "предмет расчета" в случае если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. Форма: печатная, электронная.

    fractional_count_of_marked_position

    object

    Значения реквизита "дробное количество маркированного товара" (тег 1291)

    numerator int64

    Тэг ФФД: 1293. Числитель Обязательность по ФЗ-54: Обязательный. Форма: электронная.

    denominator int64

    Тэг ФФД: 1294. Знаменатель Обязательность по ФЗ-54: Обязательный. Форма: электронная.

    industry_attributes

    object[]

    nullable

    Тэг ФФД: 1260.

    Отраслевые реквизиты предмета расчета.

    Обязательность по ФЗ-54: Опциональный.

    Включается в состав кассового чека (БСО) в случае, если в составе реквизита "предмет расчета" (тег 1059)

    содержатся сведения о товаре, подлежащем обязательной маркировке средством идентификации и включение

    указанного реквизита предусмотрено НПА отраслевого регулирования для соответствующей товарной группы.

    Форма: электронная.

  • Array [

  • foiv V5FEFOIV (string)

    Possible values: [InternalAffairsMinistry, EmergencySituationsMinistry, ForeignAffairsMinistry, CommonwealthOfIndependentStatesFA, DefenseMinistry, MilitaryTechnicalCooperationFS, TechnicalAndExportControlFS, JusticeMinistry, PenitentiaryFS, BailiffsFS, StateCourierFS, IntelligenceFS, FederalSecurityFS, NationalGuardFS, ProtectiveFS, FinancialMonitoringFS, ArchivalFA, SpecialPresidentProgramsDirectorate, PresidentDirectorate, HealthMinistry, HealthcareSurveillanceFS, CultureMinistry, ScienceandHigherEducationMinistry, NaturalResourcesAndEnvironmentMinistry, HydrometeorologyAndEnvironmentalMonitoringFS, NaturalResourcesSurveillanceFS, WaterResourcesFA, ForestryFA, MineralResourcesFA, IndustryAndTradeMinistry, TechnicalRegulationAndMetrologyFA, EducationMinistry, DevelopmentOfFarEastAndArcticMinistry, AgricultureMinistry, VeterinaryAndPhytosanitarySupervisionFS, FisheryFa, SportMinistry, ConstructionHousingAndUtilitiesMinistry, TransportMinistry, SupervisionOfTransportFS, AirTransportFA, RoadFA, RailTransportFA, MaritimeAndRiverTransportFA, LaborAndSocialProtectionMinistry, LaborAndEmploymentFS, FinanceMinistry, TaxationFS, AssayFS, AlcoholMarketRegulationFS, CustomsFS, TreasuryFS, StatePropertyManagementFA, DigitalDevelopmentCommunicationsAndMassMediaMinistry, SupervisionOfCommunicationsItAndMassMediaFS, PressAndMassMediaFA, CommunicationFA, EconomicDevelopmentMinistry, AccreditationFS, StateStatisticsFS, IntellectualPropertyFS, TourismFA, EnergyMinistry, AntimonopolyFS, StateRegistrationCadastreAndCartographyFS, ConsumerRightsProtectionAndHumanWellbeingFS, SupervisionInEducationAndScienceFS, EnvironmentalTechnologicalAndNuclearSupervisionFS, StateReservesFA, MedicalBiologicalFA, YouthFA, EthnicaffairsFA]

    Перечисление значений реквизита идентификатор ФОИВ (тег 1262).

    basis_document_date date-timenullable

    Тэг ФФД: 1263. Дата документа основания Обязательность по ФЗ-54: Опциональный. Форма: электронная. Формат: «ДД.ММ.ГГГГ»

    basis_document_number stringnullable

    Possible values: <= 32 characters

    Тэг ФФД: 1264. Номер документа основания Опциональный по ФЗ-54: Опциональный. Форма: электронная.

    attribute_value stringnullable

    Possible values: <= 256 characters

    Тэг ФФД: 1265. Значение отраслевого реквизита Опциональный по ФЗ-54: Опциональный. Форма: электронная.

  • ]

  • type_of stringnullable

    Тип объекта

  • ]

  • sum_by_prepayment int64nullable

    Сумма предоплаты

    amount_otherwise int64nullable

    Сумма иным способом

    total_sum int64nullable

    Итоговая сумма

    serial_number stringnullable

    Заводской номер

    shift_number int32nullable

    Номер смены

    receipt_number int32nullable

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

    number int32

    Номер фискального документа

    registration_number stringnullable

    Рег. номер ККТ

    fiscal_drive_number stringnullable

    ФН

    fiscal_sign int64nullable

    ФП/ФПД

    tax_system TaxSystems (string)

    Possible values: [Osn, Usn, UsnMinus, Envd, Esn, Patent]

    Перечисление систем налогообложения

    fiscal_document_format FiscalDataFormats (string)

    Possible values: [Version1, Version2, Version3, Version4]

    Версии ФФД

    results_of_checking_marked_positions stringnullable

    Маркированный товар

    type_of stringnullable

    Тип объекта

  • ]

  • next_page_token stringnullable

    Токен следующей страницы результатов списка

    page_number int32

    Номер текущей страницы. Если нумерация страниц не поддерживается, принимает значение -1 либо отсутствует. В остальных случаях принимает значения от 1 до total_pages включительно.

    pages_total int32

    общее кол-во страниц (>= 0)

    items_per_page int32

    кол-во элементов на странице (постоянное значение с сервера)

    items_total int32

    общее кол-во элементов списка

    type_of stringnullable

    Тип объекта

Loading...