HW agent API 2.15.3
API агента API облака MCP облака Справка OpenAPI English

Справка

Модели данных

Поля запросов и ответов в JSON. Суммы — копейки, date-time — ISO 8601 с поясом. Пустые поля в ответе не выводятся.

AgentInfoCashRequestCheckCheckoutRequestCheckRequestCodeInfoCodeRequestComputerCorrectionCorrectionRequestCustomerDeviceInfoDisplayRequestEmergencyReversalRequestEmulatorInfoExchangeRequestExchangeResultFileContentFileInfoFnStatusInfoInterfaceJobLabelLabelPrintRequestMarkingMarkingSettingsModeModeRequestOperationOperationErrorOperatorOperatorRequestPaymentRequestPowerPrinterInfoPrinterSettingsPrintJobRequestPrintOptionsQrRequestReceiptReceiptItemReceiptPaymentRenderedResultReversalRequestScannerInfoScannerListScanSettingsShiftStateSseEmitterStateStatusTextLineTextRequestWeight

AgentInfo#

  • statusstring
  • versionstring
  • startedAtstring date-time
  • powerPower

CashRequest#

Check#

  • allowedboolean
  • itemsмассив Result

CheckoutRequest#

  • registerIdinteger int32
  • terminalIdinteger int32
  • receiptReceiptобязательное
  • originalPaymentRefstring
  • printSlipboolean

CheckRequest#

  • typestring
    значения: SELL SELL_RETURN BUY BUY_RETURN
  • registerIdinteger int32
  • codesмассив CodeRequestобязательное
    от 1

CodeInfo#

  • cisstring
  • gtinstring
  • foundboolean
  • validboolean
  • utilisedboolean
  • verifiedboolean
  • realizableboolean
  • soldboolean
  • blockedboolean
  • ogvsмассив string
  • grayZoneboolean
  • expireDatestring date
  • groupIdsмассив integer int32
  • mrpinteger int64
  • smpinteger int64
  • innerUnitCountinteger int32
  • errorCodeinteger int32
  • messagestring
  • packageTypestring
  • ownerboolean

CodeRequest#

  • codestringобязательное
    от 1
  • priceinteger int64
  • fractionstring

Computer#

  • machineIdstring
  • hostnamestring
  • userstring
  • osstring
  • osVersionstring
  • archstring
  • agentVersionstring
  • interfacesмассив Interface

Correction#

  • typestringобязательное
    значения: SELF INSTRUCTION
  • baseDatestring dateобязательное
  • baseNumberstring

CorrectionRequest#

Customer#

  • contactstring
  • namestring
  • innstring

DeviceInfo#

  • idinteger int32
  • kindstring
    значения: FISCAL_REGISTER PAYMENT_TERMINAL BARCODE_SCANNER PRINTER CASH_DRAWER CUSTOMER_DISPLAY CARD_READER CHANNEL SCALE
  • typestring
  • namestring
  • activeboolean
  • infoсловарь → любое значение

DisplayRequest#

  • linesмассив stringобязательное
    от 0
    до 20

EmergencyReversalRequest#

  • amountinteger int64
  • paymentRefstring

EmulatorInfo#

  • numberinteger int32
  • typestring
  • namestring
  • modeState

ExchangeRequest#

  • hexstring
  • base64string
  • textstring
  • charsetstring
  • readTimeoutMsinteger int32
    от 0
    до 60000
  • maxBytesinteger int32
    от 1
    до 65536
  • untilstring
  • startstring
  • lengthinteger int32
    от 1
  • lengthOffsetinteger int32
    от 0
  • lengthBytesinteger int32
  • lengthAdjustinteger int32
  • crcstring
  • crcSkipinteger int32
    от 0

ExchangeResult#

  • bytesinteger int32
  • hexstring
  • base64string
  • textstring
  • crcValidboolean

FileContent#

  • pathstring
  • textstring
  • base64string

FileInfo#

  • pathstring
  • sizeinteger int64
  • modifiedstring date-time
  • directoryboolean

FnStatus#

  • validUntilstring date
  • daysLeftinteger int64
  • notSentinteger int64
  • firstNotSentinteger int64
  • firstNotSentAtstring date-time

Info#

  • productNamestring
  • vendorstring
  • supportEmailstring
  • supportUrlstring
  • accentColorstring
  • customIconboolean

Interface#

  • namestring
  • displayNamestring
  • macstring
  • ipv4массив string
  • ipv6массив string
  • virtualboolean

Job#

  • idstring
  • documentstring
  • statusstring
  • pagesinteger int32
  • submittedstring

Label#

  • namestring
  • titlestring
  • languagestring
    значения: ZPL TSPL EZPL ESCPOS
  • charsetstring
  • descriptionstring
  • bodystring
  • sampleсловарь → string
  • builtInboolean
  • fieldsмассив string

LabelPrintRequest#

  • dataсловарь → string
  • deviceinteger int32
  • printerstring
  • rolestring
  • copiesinteger int32
    от 1
    до 100

Marking#

Код маркировки позиции

  • codestringобязательное
    от 1
  • fractionstring
    шаблон: \d+/\d+
  • measurestring
    значения: PIECE GRAM KILOGRAM TON CENTIMETER DECIMETER METER SQUARE_CENTIMETER SQUARE_DECIMETER SQUARE_METER MILLILITER LITER CUBIC_METER KILOWATT_HOUR GKAL DAY HOUR MINUTE SECOND KILOBYTE MEGABYTE GIGABYTE TERABYTE OTHER
  • industryPropsstring

MarkingSettings#

  • enabledboolean
  • sourcesмассив string
  • piotUrlstring
  • lmUrlstring
  • lmLoginstring
  • lmPasswordstring
  • tokenstring
  • sandboxboolean
  • fnNumberstring
  • timeoutMsinteger int32
  • offlineSaleboolean
  • clientIdstring
  • clientTokenstring

Mode#

  • idstring
  • titlestring
  • descriptionstring

ModeRequest#

  • modestring
  • onceboolean

Operation#

  • idstring uuid
  • typestring
  • idempotencyKeystring
  • resourcesмассив string
  • statusstring
    значения: QUEUED RUNNING SUCCEEDED FAILED UNKNOWN
  • stagestring
  • createdAtstring date-time
  • startedAtstring date-time
  • finishedAtstring date-time
  • resultлюбое значение
  • errorOperationError
  • warningsмассив string

OperationError#

  • codestring
  • messagestring
  • detailsлюбое значение

Operator#

  • namestringобязательное
    от 1
  • innstring

OperatorRequest#

PaymentRequest#

  • amountinteger int64

Power#

  • sourcestring
    значения: AC BATTERY UNKNOWN
  • batteryboolean
  • batteryPercentinteger int32
  • minutesLeftinteger int32
  • atstring date-time

PrinterInfo#

PrinterSettings#

  • scalingstring
    значения: ACTUAL FIT SHRINK
  • orientationstring
    значения: AUTO PORTRAIT LANDSCAPE
  • paperWidthMmnumber double
  • paperHeightMmnumber double

PrintJobRequest#

  • urlsмассив string
  • documentstring
  • imagesмассив string
  • rawstring
  • textмассив TextLine
  • printerstring
  • deviceinteger int32
  • rolestring
  • copiesinteger int32
    от 1
    до 20
  • htmlstring
  • htmlUrlstring
  • optionsPrintOptions
  • expireAfterSecinteger int32
    от 1

PrintOptions#

Настройки задания печати

  • pagesstring
  • duplexstring
    значения: ONE_SIDED LONG_EDGE SHORT_EDGE
  • traystring
  • colorstring
    значения: COLOR MONOCHROME
  • dpiinteger int32
  • nUpinteger int32
    от 1
    до 16
  • collateboolean
  • orientationstring
    значения: AUTO PORTRAIT LANDSCAPE
  • rotationinteger int32
  • scalingstring
    значения: ACTUAL FIT SHRINK
  • paperWidthMmnumber double
  • paperHeightMmnumber double
  • marginsMmstring
  • jobNamestring

QrRequest#

  • payloadstring
    от 0
    до 2000
  • topstring
    от 0
    до 100
  • bottomstring
    от 0
    до 100

Receipt#

Кассовый чек

  • typestringобязательное
    значения: SELL SELL_RETURN BUY BUY_RETURN
  • taxationstring
    значения: OSN USN_INCOME USN_INCOME_OUTCOME ESHN PATENT
  • operatorOperator
  • customerCustomer
  • headerмассив TextLine
  • itemsмассив ReceiptItemобязательное
    от 1
  • paymentsмассив ReceiptPaymentобязательное
    от 1
  • footerмассив TextLine
  • electronicboolean
  • senderEmailstring
  • settlementPlacestring

ReceiptItem#

  • namestringобязательное
    от 1
  • priceinteger int64
    от 0
  • quantitynumberобязательное
  • amountinteger int64
    от 0
  • vatstringобязательное
    значения: NONE VAT0 VAT5 VAT7 VAT10 VAT20 VAT22 VAT105 VAT107 VAT110 VAT120 VAT122
  • paymentMethodstringобязательное
    значения: FULL_PREPAYMENT PREPAYMENT ADVANCE FULL_PAYMENT PARTIAL_PAYMENT CREDIT CREDIT_PAYMENT
  • paymentObjectstringобязательное
    значения: COMMODITY EXCISE JOB SERVICE GAMBLING_BET GAMBLING_PRIZE LOTTERY LOTTERY_PRIZE INTELLECTUAL_ACTIVITY PAYMENT AGENT_COMMISSION COMPOSITE ANOTHER
  • departmentinteger int32
  • markingMarking

ReceiptPayment#

  • typestringобязательное
    значения: CASH CARD PREPAID CREDIT OTHER
  • amountinteger int64

Rendered#

  • textstring

Result#

  • codestring
  • cisstring
  • gtinstring
  • allowedboolean
  • reasonsмассив string
  • warningsмассив string
  • sourcestring
  • offlineboolean
  • industryPropsstring
  • infoCodeInfo
  • checkedAtstring date-time

ReversalRequest#

  • amountinteger int64
  • paymentRefstringобязательное
    от 1

ScannerInfo#

  • idstring
  • driverstring
  • namestring
  • manufacturerstring
  • sourcesмассив string

ScannerList#

ScanSettings#

  • devicestring
  • sourcestring
  • dpiinteger int32
    от 50
    до 1200
  • colorstring
  • formatstring
  • pageSizestring
  • widthMmnumber double
    от 10
    до 1000
  • heightMmnumber double
    от 10
    до 1000
  • brightnessinteger int32
    от -1000
    до 1000
  • contrastinteger int32
    от -1000
    до 1000
  • qualityinteger int32
    от 10
    до 100
  • maxPagesinteger int32
    от 1
    до 500

ShiftState#

  • statusstring
    значения: OPENED CLOSED EXPIRED
  • numberinteger int32

SseEmitter#

  • timeoutinteger int64

State#

  • modestring
  • onceboolean
  • modesмассив Mode

Status#

  • enabledboolean
  • unlockedboolean

TextLine#

  • kindstringобязательное
    значения: TEXT PAIR SEPARATOR
  • textstring
  • rightstring
  • alignstring
    значения: LEFT CENTER RIGHT

TextRequest#

  • linesмассив TextLineобязательное
    от 1

Weight#

Показания весов

  • deviceIdinteger int32
  • weightnumber
  • stableboolean
  • atstring date-time