# @dodobrands/pos-receipts-plugin-contracts 中文文档

规范地址：https://npmcn.com/package/%40dodobrands/pos-receipts-plugin-contracts/

版本：6\.1\.0
npm 元数据更新时间：2026-10-22T12:37:29.470Z
中文译文更新时间：2026-11-12T16:18:33.411Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dodobrands/pos-receipts-plugin-contracts
原文对照：https://npmcn.com/package/%40dodobrands/pos-receipts-plugin-contracts/?lang=original
项目主页：https://github.com/dodopizza/kiosk#readme
源码仓库：https://github.com/dodopizza/kiosk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：101 kB，18 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：v24\.18\.0
- 运行依赖：0 个
- 首次发布：2026-03-25T15:35:21.221Z
- 最新版本发布：2026-10-22T12:37:29.137Z
- 近 30 天下载量：2727（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

(原始内容存档于2018-09-21) (中文(中国大陆) ). {\\fn华文仿宋\\fs16\\1cHD1D1D1}好.

## 安装

```sh
npm install @dodobrands/pos-receipts-plugin-contracts
```

也可以使用：`pnpm add @dodobrands/pos-receipts-plugin-contracts`、`yarn add @dodobrands/pos-receipts-plugin-contracts`、`bun add @dodobrands/pos-receipts-plugin-contracts`

## README

# @dodobrands/pos-receipts-plugin-合同

(原始内容存档于2018-09-21) (中文(中国大陆) ). {\\fn华文仿宋\\fs16\\1cHD1D1D1}好.

校对:Soup [多多皮扎.github.io/ 现金app](https://dodopizza.github.io/cashierapp/)

* * *

## 校对:Soup `ICashRegister`

```ts
export interface ICashRegister {
  initialize?: (options: InitializationOptions) => Promise<void>;
  getSettings: () => Promise<CashRegisterSettings>;
  handleSale: (request: HandleSaleRequest) => Promise<PrintedReceipt>;

  // Опциональные
  handleRefund?: (request: HandleRefundRequest) => Promise<PrintedRefundReceipt>;
  makeXReport?: () => Promise<void>;
  makeZReport?: (options: MakeZReportOptions) => Promise<void>;
  withdrawCash?: (options: WithdrawCashOptions) => Promise<void>;
  depositCash?: (options: DepositCashOptions) => Promise<void>;
  printText?: (options: PrintTextOptions) => Promise<void>;
  showSettingsWindow?: () => Promise<void>;
}
```

`showSettingsWindow` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? Метод:если也.

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [`src/ICashRegister.ts`](https://npmcn.com/package/%40dodobrands/pos-receipts-plugin-contracts/src/ICashRegister.ts)。 。 。 .

Тип `Receipt` содержит,покупателе也;相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `Translations` (имя也.

`HandleSaleRequest` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `fiscalStage` (单位:千美元)`FiscalStage`数字 : `FullSettlementWithPayment` | `Advance` | `FullSettlementAfterAdvance`)————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————.

`printText` печатает,тип也 `type`。 。 。 `type` (или с `type: 'plainText'`{\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得呢 `data` -=YTET -伊甸园字幕组=- 翻译: Это:так也. Для `type: 'cashOrderInfoReceipt'` вместо `data` приходит `cashOrder` (单位:千美元)`orderNumber`, (中文(简体) ), `issuedAt`, (中文(简体) ), `amount`),"а","и"等.

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `supportedPrintTextTypes` 用户 `getSettings()` . . . . .

* * *

## Смежные

-   [`@dodopizza/pos-receipts-ipc-client`](https://npmcn.com/package/private/pos-receipts-ipc-client/README.md) - IPC - ・・・・・・・・・・・ 电子, ・・・・・・
-   [`@dodobrands/pos-plugins-shared-models`](https://npmcn.com/package/shared/pos-plugins-shared-models/README.md) - общие(модели)`Business`, (中文(简体) ), `Country`, (中文(简体) ), `ILogger`(中文(简体) )

## 常见问题

### @dodobrands/pos-receipts-plugin-contracts 是什么？

\(原始内容存档于2018-09-21\) \(中文\(中国大陆\) \)\. \{\\fn华文仿宋\\fs16\\1cHD1D1D1\}好\.

### 如何安装 @dodobrands/pos-receipts-plugin-contracts？

在项目目录运行 npm install @dodobrands/pos-receipts-plugin-contracts，或使用 pnpm add / yarn add / bun add。

### @dodobrands/pos-receipts-plugin-contracts 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dodobrands/pos-receipts-plugin-contracts 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @dodobrands/pos-receipts-plugin-contracts 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js v24\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dodobrands/pos-receipts-plugin-contracts 可以商用吗？

@dodobrands/pos-receipts-plugin-contracts 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @dodobrands/pos-receipts-plugin-contracts 的下载量有多少？

根据 npm 官方下载统计，@dodobrands/pos-receipts-plugin-contracts 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,727 次，日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dodobrands/pos-receipts-plugin-contracts 还在维护吗？

最新版本 6\.1\.0 发布于 2026/10/22（22 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/03/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。