NestJS Monobank

Отримати фіскальні чеки

Як отримати список фіскальних чеків за рахунком

У цьому розділі ми розглянемо, як отримати фіскальні чеки для конкретного рахунку за допомогою методу getFiscalReceipts із сервісу MonobankService.

Виклик методу для отримання фіскальних чеків

Для отримання фіскальних чеків необхідно передати invoiceId у метод getFiscalReceipts.

import { Injectable } from '@nestjs/common';
import { MonobankService } from 'nestjs-monobank';

@Injectable()
export class ReceiptService {
     constructor(private readonly monobankService: MonobankService) {}

     async getFiscalReceipts(invoiceId: string) {
          const checks = await this.monobankService.getFiscalReceipts(invoiceId);
          return checks;
     }
}

Обробка відповіді від API

Метод повертає об'єкт Checks, який містить масив фіскальних чеків.

{
     "checks": [ // масив фіскальних чеків
          {
               "id": "a2fd4aef-cdb8-4e25-9b36-b6d4672c554d", // унікальний ідентифікатор чеку
               "type": "sale", // тип операції (наприклад, 'sale' - продаж)
               "status": "done", // статус чеку (наприклад, 'done' - успішно завершено)
               "statusDescription": "", // опис статусу (може бути порожнім)
               "taxUrl": "https://cabinet.tax.gov.ua/cashregs/check", // посилання на перевірку чеку на сайті податкової
               "file": "CJFVBERi0xLj4QKJaqrrK0KMSAw123I4G9ia3go38PAovQ43JlYXRvciAoQXBhY2hl5IEZPUCBWZXJzaW9uIfDIuMykKL...", // закодований файл чеку (формат Base64)
               "fiscalizationSource": "monopay" // джерело фіскалізації (наприклад, 'monopay')
          }
     ]
}

Ці дані можна використовувати для відображення інформації про фіскальні чеки або для завантаження PDF-файлів чеків на стороні клієнта.