Výpisy z účtu

Výpisy přicházejí jako binární data s pomocnými metodami pro content type a text — vhodné pro archivaci nebo párovací joby.

getAccountStatement vyžádá výpis za období, měnu a formát.

import { Currency, StatementFormat } from 'gopay-sdk';

const statement = await client.getAccountStatement({
  goid: 8123456789,
  date_from: '2026-01-01',
  date_to: '2026-01-31',
  currency: Currency.CZK,
  format: StatementFormat.CSV_A,
});

Tvar odpovědi

type AccountStatementResponse = {
  data: ArrayBuffer;
  contentType: string | null;
  contentDisposition: string | null;
  toText(encoding?: string): string;
};

Příklad:

console.log(statement.contentType);
console.log(statement.contentDisposition);
console.log(statement.toText().slice(0, 200));

Podporované formáty

Hodnoty enumu StatementFormat, např.:

XLS_A, XLS_B, XLS_C
CSV_A, CSV_B, CSV_C, CSV_D, CSV_E
ABO_A, ABO_B
PDF_A

Tipy

Pro strojové zpracování často stačí varianty CSV.
Z contentDisposition lze odvodit název souboru.
Binární data ukládejte bezpečně, pokud výpisy archivujete.