@dodobrands/pos-receipts-plugin-contracts

Публичные контракты для плагинов фискальных касс (Cash Register). Реализуется авторами плагинов фискальных принтеров.

Полная документация: dodopizza.github.io/cashierapp

Основной интерфейс: ICashRegister

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>;
}

Начните с изучения src/ICashRegister.ts.

Тип Receipt содержит полную информацию о заказе, покупателе, налогах, организации и страно-специфичных данных маркировки (Россия, Беларусь, Узбекистан, Казахстан).

HandleSaleRequest содержит опциональное поле fiscalStage (FiscalStage: FullSettlementWithPayment | Advance | FullSettlementAfterAdvance) — стадия фискализации продажи, берётся из данных GetCheck.

Смежные пакеты

• @dodopizza/pos-receipts-ipc-client — готовый IPC-клиент для Electron, использующий эти контракты
• @dodobrands/pos-plugins-shared-models — общие модели (Business, Country, ILogger)