brisa-sdk 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/errors.ts","../src/version.ts","../src/http.ts","../src/pagination.ts","../src/resources/documents.ts","../src/resources/others.ts","../src/webhooks.ts","../src/client.ts"],"names":["text"],"mappings":"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","file":"index.js","sourcesContent":["import type { Problem } from './types.js'\n\n/** Base de todos os erros do SDK. */\nexport class BrisaError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message, options)\n this.name = new.target.name\n }\n}\n\n/**\n * A API respondeu com um erro (RFC 9457, `application/problem+json`).\n * Programe contra `status`, `type` e `field`, não contra o texto de `detail` (em português, pode variar).\n */\nexport class BrisaApiError extends BrisaError {\n /** O estado HTTP. */\n readonly status: number\n /** `urn:brisa:...`: identificador estável do tipo de problema. */\n readonly type: string\n readonly title: string\n readonly detail?: string\n readonly instance?: string\n /** O campo que causou o erro (regras fiscais, `422`). */\n readonly field?: string\n /** Erros de validação (`400`): `campo: mensagem`. */\n readonly errors?: Record<string, string>\n /** O documento de erro completo, incluindo membros que o SDK não conhece. */\n readonly problem: Problem\n /** Segundos a esperar (`Retry-After`), quando a API os indicou. */\n readonly retryAfter?: number\n readonly headers: Headers\n\n constructor(problem: Problem, headers: Headers, retryAfter?: number) {\n super(`${problem.status} ${problem.title}${problem.detail ? `: ${problem.detail}` : ''}`)\n this.status = problem.status\n this.type = problem.type\n this.title = problem.title\n this.detail = problem.detail\n this.instance = problem.instance\n this.field = problem.field\n this.errors = problem.errors\n this.problem = problem\n this.headers = headers\n this.retryAfter = retryAfter\n }\n\n /** `true` para `429`, `502` e `503`: repetir mais tarde (com o mesmo `Idempotency-Key`). */\n get retryable(): boolean {\n return this.status === 429 || this.status === 502 || this.status === 503\n }\n}\n\n/** `400`: o corpo não é válido; `errors` diz quais campos. */\nexport class BrisaValidationError extends BrisaApiError {}\n/** `401`: chave inválida, expirada, revogada, de outro ambiente ou de um endereço não autorizado. */\nexport class BrisaAuthenticationError extends BrisaApiError {}\n/** `402`: o plano não permite (`limite-do-plano`, `plano-sem-api`) ou a subscrição está inativa. */\nexport class BrisaPlanError extends BrisaApiError {\n /** O que se esgotou (`invoices`, `clients`, `products`, `users`), nos erros de limite do plano. */\n get metric(): string | undefined {\n return this.problem.metric\n }\n /** O máximo do plano. */\n get limit(): number | undefined {\n return this.problem.limit\n }\n}\n/** `403`: a chave não tem a permissão necessária. */\nexport class BrisaPermissionError extends BrisaApiError {}\n/** `404`: não existe nesta empresa (ou está no outro ambiente). */\nexport class BrisaNotFoundError extends BrisaApiError {}\n/** `409`: o recurso ainda não está pronto (ex.: SAF-T ainda a gerar). */\nexport class BrisaConflictError extends BrisaApiError {}\n/** `422`: uma regra fiscal recusou a operação (ou um `Idempotency-Key` foi reutilizado com outro corpo). */\nexport class BrisaRuleError extends BrisaApiError {}\n/** `429`: demasiados pedidos; espere `retryAfter` segundos. */\nexport class BrisaRateLimitError extends BrisaApiError {}\n/** `5xx`: a AGT ou o serviço estão temporariamente indisponíveis. */\nexport class BrisaServerError extends BrisaApiError {}\n\n/** Não foi possível falar com a API (rede, DNS, TLS). */\nexport class BrisaConnectionError extends BrisaError {}\n/** A API não respondeu dentro do tempo (`timeoutMs`). */\nexport class BrisaTimeoutError extends BrisaConnectionError {}\n/** A assinatura de um webhook não é válida (ou está fora da tolerância de tempo). */\nexport class BrisaWebhookSignatureError extends BrisaError {}\n\nexport function errorFor(problem: Problem, headers: Headers, retryAfter?: number): BrisaApiError {\n const s = problem.status\n const C =\n s === 400\n ? BrisaValidationError\n : s === 401\n ? BrisaAuthenticationError\n : s === 402\n ? BrisaPlanError\n : s === 403\n ? BrisaPermissionError\n : s === 404\n ? BrisaNotFoundError\n : s === 409\n ? BrisaConflictError\n : s === 422\n ? BrisaRuleError\n : s === 429\n ? BrisaRateLimitError\n : s >= 500\n ? BrisaServerError\n : BrisaApiError\n return new C(problem, headers, retryAfter)\n}\n","export const VERSION = '0.2.0'\n","import { BrisaConnectionError, BrisaError, BrisaTimeoutError, errorFor } from './errors.js'\nimport type { Problem } from './types.js'\nimport { VERSION } from './version.js'\n\nexport const DEFAULT_BASE_URL = 'https://api.brisa.ao'\n\nexport interface BrisaOptions {\n /** A chave de API (`brk_...` em produção, `brk_sbx...` na sandbox). Por omissão, `process.env.BRISA_API_KEY`. */\n apiKey?: string\n /** Por omissão `https://api.brisa.ao` (ou `process.env.BRISA_API_URL`). A chave escolhe o ambiente, não o endereço. */\n baseUrl?: string\n /** Tempo máximo de cada tentativa, em milissegundos (por omissão 30 000). */\n timeoutMs?: number\n /** Repetições em `429`, `502`, `503` e falhas de rede (por omissão 2). */\n maxRetries?: number\n /** Espera máxima aceite de um `Retry-After`, em milissegundos (por omissão 60 000): acima disso o erro sobe logo. */\n maxRetryDelayMs?: number\n /** Uma implementação de `fetch` (por omissão a global). */\n fetch?: typeof fetch\n /** Cabeçalhos acrescentados a todos os pedidos. */\n headers?: Record<string, string>\n}\n\nexport interface RequestOptions {\n /** `Idempotency-Key` (8 a 128 caracteres `A-Z a-z 0-9 _ . : -`). Nas criações, o SDK gera um se não o indicar. */\n idempotencyKey?: string\n signal?: AbortSignal\n timeoutMs?: number\n maxRetries?: number\n headers?: Record<string, string>\n}\n\nexport interface RateLimit {\n /** Pedidos permitidos por minuto. */\n limit: number\n /** Pedidos que ainda pode fazer. */\n remaining: number\n /** Segundos até o contador repor. */\n reset: number\n}\n\nexport interface ApiResponse<T> {\n data: T\n status: number\n headers: Headers\n /** `true` quando a resposta é a de uma tentativa anterior com o mesmo `Idempotency-Key`. */\n replayed: boolean\n rateLimit?: RateLimit\n}\n\nexport type ResponseKind = 'json' | 'text' | 'bytes'\n\nexport interface Request {\n method: 'GET' | 'POST' | 'PUT' | 'DELETE'\n path: string\n query?: object\n body?: unknown\n /** Como ler a resposta (por omissão JSON). */\n as?: ResponseKind\n accept?: string\n}\n\nconst RETRYABLE = new Set([429, 502, 503])\n\nfunction env(name: string): string | undefined {\n const p = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n return p?.env?.[name]\n}\n\n/** Gera um `Idempotency-Key` aleatório (`brisa-js-<uuid>`). */\nexport function idempotencyKey(): string {\n const c = (globalThis as { crypto?: Crypto }).crypto\n if (c?.randomUUID) return `brisa-js-${c.randomUUID()}`\n const bytes = new Uint8Array(16)\n if (c?.getRandomValues) c.getRandomValues(bytes)\n else for (let i = 0; i < 16; i++) bytes[i] = Math.floor(Math.random() * 256)\n return `brisa-js-${Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')}`\n}\n\n/** Segundos de um `Retry-After` (número ou data HTTP). */\nexport function parseRetryAfter(value: string | null, now = Date.now()): number | undefined {\n if (!value) return undefined\n const n = Number(value)\n if (Number.isFinite(n)) return Math.max(0, n)\n const t = Date.parse(value)\n return Number.isNaN(t) ? undefined : Math.max(0, Math.ceil((t - now) / 1000))\n}\n\nfunction rateLimitOf(h: Headers): RateLimit | undefined {\n const limit = h.get('x-ratelimit-limit')\n if (limit === null) return undefined\n return { limit: Number(limit), remaining: Number(h.get('x-ratelimit-remaining') ?? 0), reset: Number(h.get('x-ratelimit-reset') ?? 0) }\n}\n\nconst sleep = (ms: number, signal?: AbortSignal) =>\n new Promise<void>((resolve, reject) => {\n if (signal?.aborted) return reject(signal.reason)\n const t = setTimeout(resolve, ms)\n signal?.addEventListener(\n 'abort',\n () => {\n clearTimeout(t)\n reject(signal.reason)\n },\n { once: true },\n )\n })\n\nexport class HttpClient {\n readonly baseUrl: string\n private readonly apiKey: string\n private readonly timeoutMs: number\n private readonly maxRetries: number\n private readonly maxRetryDelayMs: number\n private readonly fetchImpl: typeof fetch\n private readonly headers: Record<string, string>\n /** Os limites de pedidos da última resposta. */\n lastRateLimit?: RateLimit\n\n constructor(options: BrisaOptions = {}) {\n const apiKey = options.apiKey ?? env('BRISA_API_KEY')\n if (!apiKey) throw new BrisaError('Falta a chave de API: passe { apiKey } ou defina BRISA_API_KEY.')\n this.apiKey = apiKey\n this.baseUrl = (options.baseUrl ?? env('BRISA_API_URL') ?? DEFAULT_BASE_URL).replace(/\\/+$/, '')\n this.timeoutMs = options.timeoutMs ?? 30_000\n this.maxRetries = options.maxRetries ?? 2\n this.maxRetryDelayMs = options.maxRetryDelayMs ?? 60_000\n const f = options.fetch ?? (globalThis.fetch as typeof fetch | undefined)\n if (!f) throw new BrisaError('Não há fetch neste ambiente: use Node.js 18+ ou passe { fetch }.')\n this.fetchImpl = f\n this.headers = options.headers ?? {}\n }\n\n url(path: string, query?: object): string {\n const u = new URL(this.baseUrl + path)\n if (query) {\n for (const [k, v] of Object.entries(query)) {\n if (v === undefined || v === null) continue\n if (Array.isArray(v)) for (const x of v) u.searchParams.append(k, String(x))\n else u.searchParams.set(k, String(v))\n }\n }\n return u.toString()\n }\n\n async request<T>(req: Request, options: RequestOptions = {}): Promise<ApiResponse<T>> {\n const url = this.url(req.path, req.query)\n const headers: Record<string, string> = {\n Accept: req.accept ?? 'application/json',\n Authorization: `Bearer ${this.apiKey}`,\n ...this.headers,\n ...options.headers,\n }\n if (!(globalThis as { window?: unknown }).window) headers['User-Agent'] = `brisa-sdk-js/${VERSION}`\n if (options.idempotencyKey) headers['Idempotency-Key'] = options.idempotencyKey\n let body: string | undefined\n if (req.body !== undefined) {\n headers['Content-Type'] = 'application/json'\n body = JSON.stringify(req.body)\n }\n // a POST is repeated after a network failure only with an Idempotency-Key: otherwise it could be done twice\n const safeToRepeat = req.method !== 'POST' || options.idempotencyKey !== undefined\n const maxRetries = options.maxRetries ?? this.maxRetries\n const timeoutMs = options.timeoutMs ?? this.timeoutMs\n\n for (let attempt = 0; ; attempt++) {\n let res: Response\n const timeout = new AbortController()\n const timer = setTimeout(() => timeout.abort(), timeoutMs)\n const onAbort = () => timeout.abort()\n options.signal?.addEventListener('abort', onAbort, { once: true })\n try {\n res = await this.fetchImpl(url, { method: req.method, headers, body, signal: timeout.signal })\n } catch (e) {\n clearTimeout(timer)\n options.signal?.removeEventListener('abort', onAbort)\n if (options.signal?.aborted) throw e\n const err = timeout.signal.aborted\n ? new BrisaTimeoutError(`A API não respondeu em ${timeoutMs} ms (${req.method} ${req.path}).`, { cause: e })\n : new BrisaConnectionError(`Não foi possível falar com a API (${req.method} ${req.path}): ${(e as Error)?.message ?? e}`, { cause: e })\n if (safeToRepeat && attempt < maxRetries) {\n await sleep(backoff(attempt), options.signal)\n continue\n }\n throw err\n }\n try {\n this.lastRateLimit = rateLimitOf(res.headers) ?? this.lastRateLimit\n if (res.ok) {\n const data = await read<T>(res, req.as ?? 'json')\n return {\n data,\n status: res.status,\n headers: res.headers,\n replayed: res.headers.get('idempotent-replayed') === 'true',\n rateLimit: rateLimitOf(res.headers),\n }\n }\n const retryAfter = parseRetryAfter(res.headers.get('retry-after'))\n const problem = await problemOf(res, req)\n if (RETRYABLE.has(res.status) && attempt < maxRetries) {\n const wait = retryAfter !== undefined ? retryAfter * 1000 : backoff(attempt)\n if (wait <= this.maxRetryDelayMs) {\n await sleep(wait, options.signal)\n continue\n }\n }\n throw errorFor(problem, res.headers, retryAfter)\n } finally {\n clearTimeout(timer)\n options.signal?.removeEventListener('abort', onAbort)\n }\n }\n }\n}\n\n/** 0,5 s, 1 s, 2 s... (até 8 s), com variação aleatória. */\nfunction backoff(attempt: number): number {\n const base = Math.min(8000, 500 * 2 ** attempt)\n return Math.round(base / 2 + Math.random() * (base / 2))\n}\n\nasync function read<T>(res: Response, as: ResponseKind): Promise<T> {\n if (res.status === 204) return undefined as T\n if (as === 'bytes') return new Uint8Array(await res.arrayBuffer()) as T\n const text = await res.text()\n if (as === 'text') return text as T\n if (!text) return undefined as T\n return JSON.parse(text) as T\n}\n\nasync function problemOf(res: Response, req: Request): Promise<Problem> {\n const text = await res.text().catch(() => '')\n try {\n const p = JSON.parse(text)\n if (p && typeof p === 'object') return { ...p, status: typeof p.status === 'number' ? p.status : res.status, type: p.type ?? 'about:blank', title: p.title ?? res.statusText }\n } catch {\n // not JSON: a proxy or gateway answered\n }\n return { type: 'about:blank', title: res.statusText || `HTTP ${res.status}`, status: res.status, detail: text.slice(0, 500) || undefined, instance: req.path }\n}\n","import type { Page, PageParams } from './types.js'\n\n/**\n * Percorre todas as páginas de uma lista, pedindo a seguinte só quando é precisa.\n *\n * ```ts\n * for await (const doc of brisa.documents.listAll({ type: 'FT' })) console.log(doc.number)\n * ```\n */\nexport async function* paginate<T, P extends PageParams>(fetchPage: (params: P) => Promise<Page<T>>, params: P): AsyncGenerator<T, void, undefined> {\n let page = params.page ?? 0\n const size = params.size ?? 100\n let seen = 0\n for (;;) {\n const p = await fetchPage({ ...params, page, size })\n for (const item of p.items) yield item\n seen += p.items.length\n if (p.items.length === 0 || p.items.length < p.size || seen + (params.page ?? 0) * size >= p.total) return\n page++\n }\n}\n\n/** Junta numa lista todos os itens de um iterador assíncrono (cuidado com listas muito grandes). */\nexport async function collect<T>(it: AsyncIterable<T>, max = Number.POSITIVE_INFINITY): Promise<T[]> {\n const out: T[] = []\n for await (const x of it) {\n out.push(x)\n if (out.length >= max) break\n }\n return out\n}\n","import { type HttpClient, idempotencyKey, type RequestOptions } from '../http.js'\nimport { paginate } from '../pagination.js'\nimport type {\n CancelDocumentRequest,\n CreditedLine,\n CreditNoteRequest,\n DocumentDetail,\n DocumentExport,\n DocumentHistory,\n DocumentSummary,\n GlobalPaymentRequest,\n IssueDocumentRequest,\n IssuedDocument,\n ListDocumentsParams,\n Page,\n PayDocumentRequest,\n PaymentResult,\n PdfOptions,\n RectifyDocumentRequest,\n SendDocumentRequest,\n SendResult,\n} from '../types.js'\n\nconst id = (n: number | string) => encodeURIComponent(String(n))\n/** The operations that need (or recommend) an Idempotency-Key get one made here when none is given, so that a retry repeats the same key. */\nconst withKey = (o: RequestOptions = {}): RequestOptions => ({ ...o, idempotencyKey: o.idempotencyKey ?? idempotencyKey() })\n\n/** Documentos fiscais: emitir, consultar, PDF, pagamentos, anulações e notas de crédito. */\nexport class Documents {\n constructor(private readonly http: HttpClient) {}\n\n /** Emite `FT`, `FR`, `TV` ou `PF` (`POST /api/v1/documents`). Permissão `invoices.issue`. */\n async issue(body: IssueDocumentRequest, options?: RequestOptions): Promise<IssuedDocument> {\n return (await this.http.request<IssuedDocument>({ method: 'POST', path: '/api/v1/documents', body }, withKey(options))).data\n }\n\n /** Uma página de documentos, do mais recente para o mais antigo. Permissão `invoices.view`. */\n async list(params: ListDocumentsParams = {}, options?: RequestOptions): Promise<Page<DocumentSummary>> {\n return (await this.http.request<Page<DocumentSummary>>({ method: 'GET', path: '/api/v1/documents', query: params }, options)).data\n }\n\n /** Todos os documentos que correspondem aos filtros, página a página. */\n listAll(params: ListDocumentsParams = {}, options?: RequestOptions): AsyncGenerator<DocumentSummary, void, undefined> {\n return paginate((p) => this.list(p, options), params)\n }\n\n /** Um documento, com linhas, totais, valor em dívida e estado na AGT. */\n async get(documentId: number, options?: RequestOptions): Promise<DocumentDetail> {\n return (await this.http.request<DocumentDetail>({ method: 'GET', path: `/api/v1/documents/${id(documentId)}` }, options)).data\n }\n\n /** O PDF do documento (bytes). Conta como mais de um pedido no limite da chave: guarde-o em vez de o pedir de cada vez. */\n async pdf(documentId: number, params: PdfOptions = {}, options?: RequestOptions): Promise<Uint8Array> {\n return (await this.http.request<Uint8Array>({ method: 'GET', path: `/api/v1/documents/${id(documentId)}/pdf`, query: params, as: 'bytes', accept: 'application/pdf' }, options))\n .data\n }\n\n /** O documento como dados: JSON (por omissão) ou XML (texto). Permissão `invoices.export`. */\n export(documentId: number, format?: 'json', options?: RequestOptions): Promise<DocumentExport>\n export(documentId: number, format: 'xml', options?: RequestOptions): Promise<string>\n async export(documentId: number, format: 'json' | 'xml' = 'json', options?: RequestOptions): Promise<DocumentExport | string> {\n const xml = format === 'xml'\n return (\n await this.http.request<DocumentExport | string>(\n { method: 'GET', path: `/api/v1/documents/${id(documentId)}/export`, query: { format }, as: xml ? 'text' : 'json', accept: xml ? 'application/xml' : 'application/json' },\n options,\n )\n ).data\n }\n\n /** Paga o documento, no todo (sem `amount`) ou em parte, e emite o recibo (`RC`). Permissão `invoices.payments`. */\n async pay(documentId: number, body: PayDocumentRequest, options?: RequestOptions): Promise<PaymentResult> {\n return (await this.http.request<PaymentResult>({ method: 'POST', path: `/api/v1/documents/${id(documentId)}/payments`, body }, withKey(options))).data\n }\n\n /** Liquida várias faturas de um mesmo cliente num recibo global (`RG`). */\n async payGlobal(body: GlobalPaymentRequest, options?: RequestOptions): Promise<IssuedDocument> {\n return (await this.http.request<IssuedDocument>({ method: 'POST', path: '/api/v1/documents/payments/global', body }, withKey(options))).data\n }\n\n /** Anula o documento (numa fatura emitida, só com `basis`). Repetido, dá o mesmo resultado. Permissão `invoices.cancel`. */\n async cancel(documentId: number, body: CancelDocumentRequest, options?: RequestOptions): Promise<void> {\n await this.http.request<void>({ method: 'POST', path: `/api/v1/documents/${id(documentId)}/cancel`, body }, options)\n }\n\n /** Retifica: emite uma nota de crédito (`NC`) que espelha o original. */\n async rectify(documentId: number, body: RectifyDocumentRequest, options?: RequestOptions): Promise<IssuedDocument> {\n return (await this.http.request<IssuedDocument>({ method: 'POST', path: `/api/v1/documents/${id(documentId)}/rectify`, body }, withKey(options))).data\n }\n\n /** Nota de crédito parcial (ou total, sem `lines`). */\n async creditNote(documentId: number, body: CreditNoteRequest, options?: RequestOptions): Promise<IssuedDocument> {\n return (await this.http.request<IssuedDocument>({ method: 'POST', path: `/api/v1/documents/${id(documentId)}/credit-notes`, body }, withKey(options))).data\n }\n\n /** Quanto de cada linha já foi creditado e quanto ainda se pode creditar. */\n async credits(documentId: number, options?: RequestOptions): Promise<CreditedLine[]> {\n return (await this.http.request<CreditedLine[]>({ method: 'GET', path: `/api/v1/documents/${id(documentId)}/credits` }, options)).data\n }\n\n /** O histórico do documento (auditoria e envios). */\n async history(documentId: number, options?: RequestOptions): Promise<DocumentHistory> {\n return (await this.http.request<DocumentHistory>({ method: 'GET', path: `/api/v1/documents/${id(documentId)}/history` }, options)).data\n }\n\n /** Muda a data de vencimento (AAAA-MM-DD, até 365 dias depois da emissão). */\n async setDueDate(documentId: number, dueDate: string, options?: RequestOptions): Promise<void> {\n await this.http.request<void>({ method: 'PUT', path: `/api/v1/documents/${id(documentId)}/due-date`, body: { dueDate } }, options)\n }\n\n /** Envia o documento por e-mail. Com uma chave de API, só ao e-mail do cliente que consta do documento. Permissão `invoices.send`. */\n async send(documentId: number, body: SendDocumentRequest = {}, options?: RequestOptions): Promise<SendResult> {\n return (await this.http.request<SendResult>({ method: 'POST', path: `/api/v1/documents/${id(documentId)}/send`, body }, options)).data\n }\n}\n","import { BrisaError } from '../errors.js'\nimport { type HttpClient, idempotencyKey, type RequestOptions } from '../http.js'\nimport { paginate } from '../pagination.js'\nimport type {\n Category,\n Client,\n ClientInput,\n ClientStatement,\n CompanyTax,\n ExemptionReason,\n ListClientsParams,\n ListProductsParams,\n Page,\n Product,\n ProductInput,\n SaftExport,\n StockLevel,\n StockMovementRequest,\n} from '../types.js'\n\nconst seg = (v: number | string) => encodeURIComponent(String(v))\n\n/** Clientes da empresa. */\nexport class Clients {\n constructor(private readonly http: HttpClient) {}\n\n /** Regista um cliente e devolve o seu `id`. Permissão `clients.manage`. */\n async create(body: ClientInput, options: RequestOptions = {}): Promise<{ id: number }> {\n const o = { ...options, idempotencyKey: options.idempotencyKey ?? idempotencyKey() }\n return (await this.http.request<{ id: number }>({ method: 'POST', path: '/api/v1/clients', body }, o)).data\n }\n\n /** Substitui os dados do cliente: envie o corpo completo (com `taxId`). */\n async update(clientId: number, body: ClientInput & { taxId: string }, options?: RequestOptions): Promise<void> {\n await this.http.request<void>({ method: 'PUT', path: `/api/v1/clients/${seg(clientId)}`, body }, options)\n }\n\n async get(clientId: number, options?: RequestOptions): Promise<Client> {\n return (await this.http.request<Client>({ method: 'GET', path: `/api/v1/clients/${seg(clientId)}` }, options)).data\n }\n\n async list(params: ListClientsParams = {}, options?: RequestOptions): Promise<Page<Client>> {\n return (await this.http.request<Page<Client>>({ method: 'GET', path: '/api/v1/clients', query: params }, options)).data\n }\n\n listAll(params: ListClientsParams = {}, options?: RequestOptions): AsyncGenerator<Client, void, undefined> {\n return paginate((p) => this.list(p, options), params)\n }\n\n /** Ativa ou desativa o cliente. Permissão `clients.delete`. */\n async setActive(clientId: number, active: boolean, options?: RequestOptions): Promise<void> {\n await this.http.request<void>({ method: 'PUT', path: `/api/v1/clients/${seg(clientId)}/active`, body: { active } }, options)\n }\n\n /** A conta corrente do cliente (faturas, notas de crédito e recibos dia a dia, com o saldo). Permissões `clients.view` e `invoices.view`. */\n async statement(clientId: number, period: { from?: string; to?: string } = {}, options?: RequestOptions): Promise<ClientStatement> {\n return (await this.http.request<ClientStatement>({ method: 'GET', path: `/api/v1/clients/${seg(clientId)}/statement`, query: period }, options)).data\n }\n\n /** O extrato para imprimir (PDF, bytes). Pede também a permissão `reports.export`. */\n async statementPdf(clientId: number, period: { from?: string; to?: string } = {}, options?: RequestOptions): Promise<Uint8Array> {\n return (\n await this.http.request<Uint8Array>(\n { method: 'GET', path: `/api/v1/clients/${seg(clientId)}/statement`, query: { ...period, format: 'pdf' }, as: 'bytes', accept: 'application/pdf' },\n options,\n )\n ).data\n }\n\n /** O extrato em CSV (texto). Pede também a permissão `reports.export`. */\n async statementCsv(clientId: number, period: { from?: string; to?: string } = {}, options?: RequestOptions): Promise<string> {\n return (\n await this.http.request<string>(\n { method: 'GET', path: `/api/v1/clients/${seg(clientId)}/statement`, query: { ...period, format: 'csv' }, as: 'text', accept: 'text/csv' },\n options,\n )\n ).data\n }\n}\n\n/** Produtos do catálogo e stock. */\nexport class Products {\n constructor(private readonly http: HttpClient) {}\n\n /** Cria o produto se o código não existir; senão atualiza-o. Permissão `products.manage`. */\n async upsert(code: string, body: ProductInput, options?: RequestOptions): Promise<Product> {\n return (await this.http.request<Product>({ method: 'PUT', path: `/api/v1/catalog/products/${seg(code)}`, body }, options)).data\n }\n\n /** Um produto, com o stock atual. */\n async get(code: string, options?: RequestOptions): Promise<Product> {\n return (await this.http.request<Product>({ method: 'GET', path: `/api/v1/catalog/products/${seg(code)}` }, options)).data\n }\n\n async list(params: ListProductsParams = {}, options?: RequestOptions): Promise<Page<Product>> {\n return (await this.http.request<Page<Product>>({ method: 'GET', path: '/api/v1/catalog/products', query: params }, options)).data\n }\n\n listAll(params: ListProductsParams = {}, options?: RequestOptions): AsyncGenerator<Product, void, undefined> {\n return paginate((p) => this.list(p, options), params)\n }\n\n /** Entrada, saída ou acerto de stock. Permissão `stock.adjust`. */\n async moveStock(code: string, body: StockMovementRequest, options: RequestOptions = {}): Promise<StockLevel> {\n const o = { ...options, idempotencyKey: options.idempotencyKey ?? idempotencyKey() }\n return (await this.http.request<StockLevel>({ method: 'POST', path: `/api/v1/products/${seg(code)}/movements`, body }, o)).data\n }\n}\n\n/** Impostos, motivos de isenção e categorias. */\nexport class Catalog {\n constructor(private readonly http: HttpClient) {}\n\n /** Os impostos da empresa: o `id` é o `taxId` dos produtos; uma linha só aceita impostos daqui. */\n async taxes(params: { activeOnly?: boolean } = {}, options?: RequestOptions): Promise<CompanyTax[]> {\n return (await this.http.request<CompanyTax[]>({ method: 'GET', path: '/api/v1/catalog/taxes', query: params }, options)).data\n }\n\n /** Os motivos de isenção `M00`…`M94` aceites pela AGT. */\n async exemptionReasons(options?: RequestOptions): Promise<ExemptionReason[]> {\n return (await this.http.request<ExemptionReason[]>({ method: 'GET', path: '/api/v1/catalog/exemption-reasons' }, options)).data\n }\n\n async categories(options?: RequestOptions): Promise<Category[]> {\n return (await this.http.request<Category[]>({ method: 'GET', path: '/api/v1/catalog/categories' }, options)).data\n }\n}\n\n/** Ficheiros SAF-T (AO). Permissão `saft.export`. */\nexport class Saft {\n constructor(private readonly http: HttpClient) {}\n\n /** Pede a exportação de um período (o fim não pode ser no futuro). Gera-se em segundo plano: veja `get` ou `waitUntilReady`. */\n async request(period: { from: string; to: string }, options?: RequestOptions): Promise<SaftExport> {\n return (await this.http.request<SaftExport>({ method: 'POST', path: '/api/v1/saft/exports', body: period }, options)).data\n }\n\n async list(params: { limit?: number } = {}, options?: RequestOptions): Promise<SaftExport[]> {\n return (await this.http.request<SaftExport[]>({ method: 'GET', path: '/api/v1/saft/exports', query: params }, options)).data\n }\n\n async get(exportId: number, options?: RequestOptions): Promise<SaftExport> {\n return (await this.http.request<SaftExport>({ method: 'GET', path: `/api/v1/saft/exports/${seg(exportId)}` }, options)).data\n }\n\n /** O XML de uma exportação `READY` (`409` antes disso). Conta como vários pedidos no limite da chave. */\n async file(exportId: number, options?: RequestOptions): Promise<string> {\n return (await this.http.request<string>({ method: 'GET', path: `/api/v1/saft/exports/${seg(exportId)}/file`, as: 'text', accept: 'application/xml' }, options)).data\n }\n\n /** Espera até a exportação ficar `READY` (ou falha com `FAILED`). */\n async waitUntilReady(exportId: number, { intervalMs = 3000, timeoutMs = 300_000 } = {}, options?: RequestOptions): Promise<SaftExport> {\n const until = Date.now() + timeoutMs\n for (;;) {\n const e = await this.get(exportId, options)\n if (e.status === 'READY') return e\n if (e.status === 'FAILED') throw new BrisaError(`A exportação SAF-T ${exportId} falhou: ${e.error ?? 'sem detalhe'}`)\n if (Date.now() + intervalMs > until) throw new BrisaError(`A exportação SAF-T ${exportId} não ficou pronta em ${timeoutMs} ms (estado ${e.status}).`)\n await new Promise((r) => setTimeout(r, intervalMs))\n }\n }\n}\n","import { BrisaWebhookSignatureError } from './errors.js'\nimport type { WebhookEvent } from './types.js'\n\nexport interface VerifyWebhookOptions {\n /** Diferença máxima, em segundos, entre o `t` da assinatura e o relógio local (por omissão 300). */\n toleranceSeconds?: number\n /** O instante atual em segundos (para testes). */\n now?: number\n}\n\nconst encoder = new TextEncoder()\n\ntype Hmac = (secret: string, message: string) => Promise<string>\n\nlet hmacImpl: Hmac | undefined\n\nasync function hmacSha256Hex(secret: string, message: string): Promise<string> {\n if (!hmacImpl) {\n const subtle = (globalThis as { crypto?: Crypto }).crypto?.subtle\n if (subtle) {\n hmacImpl = async (s, m) => {\n const key = await subtle.importKey('raw', encoder.encode(s), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign'])\n return toHex(new Uint8Array(await subtle.sign('HMAC', key, encoder.encode(m))))\n }\n } else {\n // Node.js 18 without the global Web Crypto: the module, loaded only here so bundlers for the browser leave it out\n const name = 'node:crypto'\n const nodeCrypto = (await import(/* @vite-ignore */ /* webpackIgnore: true */ name)) as typeof import('node:crypto')\n hmacImpl = async (s, m) => nodeCrypto.createHmac('sha256', s).update(m).digest('hex')\n }\n }\n return hmacImpl(secret, message)\n}\n\nfunction toHex(bytes: Uint8Array): string {\n let s = ''\n for (const b of bytes) s += b.toString(16).padStart(2, '0')\n return s\n}\n\nfunction timingSafeEqual(a: string, b: string): boolean {\n if (a.length !== b.length) return false\n let diff = 0\n for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i)\n return diff === 0\n}\n\n/** `t=<segundos>,v1=<hex>[,v1=<hex>]` → `{ timestamp, signatures }`. */\nexport function parseSignatureHeader(header: string): { timestamp: number; signatures: string[] } {\n let timestamp = Number.NaN\n const signatures: string[] = []\n for (const part of header.split(',')) {\n const i = part.indexOf('=')\n if (i < 0) continue\n const k = part.slice(0, i).trim()\n const v = part.slice(i + 1).trim()\n if (k === 't') timestamp = Number(v)\n else if (k === 'v1' && /^[0-9a-f]+$/i.test(v)) signatures.push(v.toLowerCase())\n }\n return { timestamp, signatures }\n}\n\nfunction text(payload: string | Uint8Array | ArrayBuffer): string {\n if (typeof payload === 'string') return payload\n return new TextDecoder().decode(payload instanceof ArrayBuffer ? new Uint8Array(payload) : payload)\n}\n\n/**\n * Verifica a assinatura de um webhook (`Brisa-Signature`) e devolve o evento.\n *\n * Use o corpo **bruto**, tal como chegou (antes de o interpretar como JSON). Durante a troca do segredo vêm dois `v1`: basta um coincidir.\n * Lança `BrisaWebhookSignatureError` se a assinatura não coincidir ou se `t` estiver fora da tolerância.\n *\n * ```ts\n * app.post('/webhooks/brisa', express.raw({ type: 'application/json' }), async (req, res) => {\n * const event = await verifyWebhook(req.body, req.get('Brisa-Signature'), process.env.BRISA_WEBHOOK_SECRET)\n * res.sendStatus(200)\n * })\n * ```\n */\nexport async function verifyWebhook<D = Record<string, unknown>>(\n payload: string | Uint8Array | ArrayBuffer,\n signatureHeader: string | null | undefined,\n secret: string | string[],\n options: VerifyWebhookOptions = {},\n): Promise<WebhookEvent<D>> {\n if (!signatureHeader) throw new BrisaWebhookSignatureError('Falta o cabeçalho Brisa-Signature.')\n const { timestamp, signatures } = parseSignatureHeader(signatureHeader)\n if (!Number.isFinite(timestamp) || signatures.length === 0) throw new BrisaWebhookSignatureError('Cabeçalho Brisa-Signature mal formado.')\n const tolerance = options.toleranceSeconds ?? 300\n const now = options.now ?? Math.floor(Date.now() / 1000)\n if (tolerance > 0 && Math.abs(now - timestamp) > tolerance)\n throw new BrisaWebhookSignatureError(`A assinatura tem ${Math.abs(now - timestamp)} s de diferença do relógio (máximo ${tolerance} s).`)\n const body = text(payload)\n for (const s of Array.isArray(secret) ? secret : [secret]) {\n const expected = await hmacSha256Hex(s, `${timestamp}.${body}`)\n if (signatures.some((v) => timingSafeEqual(v, expected))) {\n try {\n return JSON.parse(body) as WebhookEvent<D>\n } catch (e) {\n throw new BrisaWebhookSignatureError('A assinatura é válida mas o corpo não é JSON.', { cause: e })\n }\n }\n }\n throw new BrisaWebhookSignatureError('A assinatura não coincide com o segredo do webhook.')\n}\n\n/** Calcula o cabeçalho `Brisa-Signature` de um corpo: útil para testar o seu endpoint. */\nexport async function signWebhookPayload(payload: string, secret: string, timestamp = Math.floor(Date.now() / 1000)): Promise<string> {\n return `t=${timestamp},v1=${await hmacSha256Hex(secret, `${timestamp}.${payload}`)}`\n}\n","import { type ApiResponse, type BrisaOptions, HttpClient, type RateLimit, type Request, type RequestOptions } from './http.js'\nimport { Documents } from './resources/documents.js'\nimport { Catalog, Clients, Products, Saft } from './resources/others.js'\nimport type { BankDetails, Company, Me } from './types.js'\nimport { verifyWebhook } from './webhooks.js'\n\n/**\n * Cliente da API Brisa.\n *\n * ```ts\n * import { Brisa } from 'brisa-sdk'\n * const brisa = new Brisa({ apiKey: process.env.BRISA_API_KEY })\n * const doc = await brisa.documents.issue({ type: 'FT', clientId: 42, lines: [{ productCode: 'PAR-M8', quantity: 4 }] })\n * ```\n */\nexport class Brisa {\n readonly documents: Documents\n readonly clients: Clients\n readonly products: Products\n readonly catalog: Catalog\n readonly saft: Saft\n /** Verificação de webhooks (também exportada como `verifyWebhook`). */\n static readonly webhooks = { verify: verifyWebhook }\n private readonly http: HttpClient\n\n constructor(options: BrisaOptions = {}) {\n this.http = new HttpClient(options)\n this.documents = new Documents(this.http)\n this.clients = new Clients(this.http)\n this.products = new Products(this.http)\n this.catalog = new Catalog(this.http)\n this.saft = new Saft(this.http)\n }\n\n get baseUrl(): string {\n return this.http.baseUrl\n }\n\n /** Os limites de pedidos indicados na última resposta (`X-RateLimit-*`). */\n get rateLimit(): RateLimit | undefined {\n return this.http.lastRateLimit\n }\n\n /** Quem é a chave e que permissões tem (`GET /api/v1/me`). */\n async me(options?: RequestOptions): Promise<Me> {\n return (await this.http.request<Me>({ method: 'GET', path: '/api/v1/me' }, options)).data\n }\n\n /** Os dados da empresa da chave (`GET /api/v1/company`). */\n async company(options?: RequestOptions): Promise<Company> {\n return (await this.http.request<Company>({ method: 'GET', path: '/api/v1/company' }, options)).data\n }\n\n /** Os dados bancários da empresa (`GET /api/v1/company/bank`): o que as suas faturas por pagar dizem sobre como pagar. */\n async bank(options?: RequestOptions): Promise<BankDetails> {\n return (await this.http.request<BankDetails>({ method: 'GET', path: '/api/v1/company/bank' }, options)).data\n }\n\n /**\n * Substitui os dados bancários da empresa (o IBAN é verificado: um angolano tem 25 caracteres e dígitos de controlo certos; tudo vazio limpa-os).\n * Permissão `settings.manage`. Devolve o que ficou guardado.\n */\n async setBank(details: Partial<BankDetails>, options?: RequestOptions): Promise<BankDetails> {\n return (await this.http.request<BankDetails>({ method: 'PUT', path: '/api/v1/company/bank', body: details }, options)).data\n }\n\n /** Um pedido qualquer à API, com autenticação, repetições e erros do SDK; devolve também o estado e os cabeçalhos. */\n request<T = unknown>(req: Request, options?: RequestOptions): Promise<ApiResponse<T>> {\n return this.http.request<T>(req, options)\n }\n}\n"]}
@@ -0,0 +1,106 @@
1
+ # Primeiros passos
2
+
3
+ Em cinco minutos vai emitir um documento de teste e guardar o PDF. Tudo corre na **sandbox**: nada é enviado à AGT e pode repetir quantas vezes quiser.
4
+
5
+ ## 1. Obtenha uma chave de teste
6
+
7
+ Na aplicação Brisa, nas definições da empresa (precisa da permissão de gerir definições), crie a **sandbox** e, nela, uma **chave de API**. A chave começa por `brk_sbx_` e só é mostrada uma vez: guarde-a de imediato.
8
+
9
+ > **Atenção:** a chave é um segredo da empresa. Use-a no servidor; nunca a ponha numa aplicação web ou móvel, nem num repositório.
10
+
11
+ ```bash
12
+ export BRISA_API_KEY="brk_sbx_a_sua_chave"
13
+ ```
14
+
15
+ ## 2. Instale o SDK (opcional)
16
+
17
+ Pode usar a API só com HTTP, mas o SDK repete pedidos falhados, gera as chaves de idempotência e dá-lhe erros com tipo.
18
+
19
+ ```bash
20
+ # JavaScript / TypeScript (Node.js 18+, Deno, Bun)
21
+ npm install brisa-sdk
22
+
23
+ # PHP 8.1+
24
+ composer require codespace-ao/brisa-php
25
+ ```
26
+
27
+ ## 3. Confirme que a chave funciona
28
+
29
+ ```bash
30
+ curl https://api.brisa.ao/api/v1/me -H "Authorization: Bearer $BRISA_API_KEY"
31
+ ```
32
+
33
+ ```ts
34
+ import { Brisa } from 'brisa-sdk'
35
+
36
+ const brisa = new Brisa() // lê BRISA_API_KEY
37
+ console.log(await brisa.me())
38
+ ```
39
+
40
+ ```php
41
+ use Brisa\Brisa;
42
+
43
+ $brisa = new Brisa(['apiKey' => getenv('BRISA_API_KEY')]);
44
+ print_r($brisa->me());
45
+ ```
46
+
47
+ A resposta diz quem é a chave e que permissões tem.
48
+
49
+ ## 4. Emita a primeira fatura-recibo
50
+
51
+ ```bash
52
+ curl https://api.brisa.ao/api/v1/documents \
53
+ -H "Authorization: Bearer $BRISA_API_KEY" \
54
+ -H "Idempotency-Key: primeira-fr-001" \
55
+ -H "Content-Type: application/json" \
56
+ -d '{
57
+ "type": "FR",
58
+ "customer": { "name": "Consumidor final", "taxId": "999999999" },
59
+ "lines": [{ "description": "Parafuso M8", "quantity": 4, "unitPrice": 100,
60
+ "taxes": [{ "name": "IVA 14%", "percentage": 14, "taxType": "IVA", "taxCode": "NOR", "calculationOrder": 1 }] }],
61
+ "payment": { "method": "cash", "amountReceived": 500 }
62
+ }'
63
+ ```
64
+
65
+ ```ts
66
+ const fatura = await brisa.documents.issue({
67
+ type: 'FR',
68
+ customer: { name: 'Consumidor final', taxId: '999999999' },
69
+ lines: [{ description: 'Parafuso M8', quantity: 4, unitPrice: 100,
70
+ taxes: [{ name: 'IVA 14%', percentage: 14, taxType: 'IVA', taxCode: 'NOR', calculationOrder: 1 }] }],
71
+ payment: { method: 'cash', amountReceived: 500 },
72
+ })
73
+ console.log(fatura.number, fatura.grossTotal) // "FR FR2026/1" 456
74
+ ```
75
+
76
+ ```php
77
+ $fatura = $brisa->documents->issue([
78
+ 'type' => 'FR',
79
+ 'customer' => ['name' => 'Consumidor final', 'taxId' => '999999999'],
80
+ 'lines' => [['description' => 'Parafuso M8', 'quantity' => 4, 'unitPrice' => 100,
81
+ 'taxes' => [['name' => 'IVA 14%', 'percentage' => 14, 'taxType' => 'IVA', 'taxCode' => 'NOR', 'calculationOrder' => 1]]]],
82
+ 'payment' => ['method' => 'cash', 'amountReceived' => 500],
83
+ ]);
84
+ echo $fatura['number'], ' ', $fatura['grossTotal'];
85
+ ```
86
+
87
+ ## 5. Guarde o PDF
88
+
89
+ ```bash
90
+ curl https://api.brisa.ao/api/v1/documents/ID/pdf -H "Authorization: Bearer $BRISA_API_KEY" -o fatura.pdf
91
+ ```
92
+
93
+ ```ts
94
+ import { writeFile } from 'node:fs/promises'
95
+ await writeFile('fatura.pdf', await brisa.documents.pdf(fatura.id))
96
+ ```
97
+
98
+ ```php
99
+ file_put_contents('fatura.pdf', $brisa->documents->pdf($fatura['id']));
100
+ ```
101
+
102
+ ## Próximos passos
103
+
104
+ * Perceba as permissões da sua chave em [Autenticação](02-autenticacao.md).
105
+ * Conheça os [tipos de documento](03-documentos.md) e como [receber pagamentos](04-pagamentos.md).
106
+ * Quando tudo funcionar, siga [Sandbox e produção](13-sandbox-e-producao.md): troca-se só a chave.
@@ -0,0 +1,55 @@
1
+ # Autenticação
2
+
3
+ A API autentica cada pedido com uma **chave de API** enviada como *Bearer token*. Cada chave pertence a uma empresa, tem um ambiente (sandbox ou produção) e um conjunto de permissões.
4
+
5
+ ## Enviar a chave
6
+
7
+ ```bash
8
+ curl https://api.brisa.ao/api/v1/me -H "Authorization: Bearer brk_..."
9
+ ```
10
+
11
+ ```ts
12
+ const brisa = new Brisa({ apiKey: process.env.BRISA_API_KEY })
13
+ ```
14
+
15
+ ```php
16
+ $brisa = new Brisa(['apiKey' => getenv('BRISA_API_KEY')]);
17
+ ```
18
+
19
+ Sem a opção `apiKey`, o SDK lê a variável de ambiente `BRISA_API_KEY`.
20
+
21
+ ## O que a chave pode fazer
22
+
23
+ `GET /api/v1/me` devolve as permissões ("grants") da chave, como `invoices.view`, `invoices.issue` ou `reports.export`. Um pedido sem a permissão recebe `403`. Dê a cada chave só o que a integração precisa.
24
+
25
+ | Permissão | Para quê |
26
+ |---|---|
27
+ | `invoices.view` | ler documentos e os seus PDF |
28
+ | `invoices.issue` | emitir |
29
+ | `invoices.payments` | registar pagamentos e liquidar faturas |
30
+ | `invoices.cancel` | anular, retificar e notas de crédito |
31
+ | `invoices.send` | enviar por e-mail |
32
+ | `invoices.export` | exportar JSON/XML de um documento |
33
+ | `clients.view`, `clients.manage` | ler e gerir clientes |
34
+ | `reports.export` | PDF, CSV e Excel de relatórios e extratos |
35
+ | `settings.manage` | dados da empresa e dados bancários |
36
+
37
+ ## Ambientes
38
+
39
+ | Prefixo | Ambiente | Efeito |
40
+ |---|---|---|
41
+ | `brk_sbx_` | sandbox | nada vai à AGT; dados de teste |
42
+ | `brk_` | produção | documentos certificados, comunicados à AGT |
43
+
44
+ O endereço é o mesmo para os dois. Muda-se de ambiente trocando a chave.
45
+
46
+ ## Boas práticas
47
+
48
+ * **Uma chave por integração**, com o mínimo de permissões. Assim pode revogar uma sem parar as outras.
49
+ * **No servidor.** Se a chave for exposta, revogue-a na aplicação e crie outra.
50
+ * **Restrinja por IP** quando o seu servidor tiver um IP fixo.
51
+ * **Guarde-a como segredo** (variável de ambiente ou cofre), nunca no código.
52
+
53
+ ## Erros de autenticação
54
+
55
+ Uma chave inválida, revogada, expirada ou usada de um IP não permitido responde `401`. Uma chave sem a permissão necessária responde `403`. Ver [Erros](11-erros.md).
@@ -0,0 +1,80 @@
1
+ # Documentos
2
+
3
+ Um **documento** é o que a AGT certifica: uma fatura, um recibo, uma nota de crédito. Esta página mostra os tipos, como emitir, consultar, anular e corrigir.
4
+
5
+ ## Os tipos
6
+
7
+ | Tipo | Nome | Para quê |
8
+ |---|---|---|
9
+ | `FT` | Fatura | vender a crédito; fica por pagar até haver recibo |
10
+ | `FR` | Fatura-recibo | venda paga no ato |
11
+ | `TV` | Talão de venda | venda paga no ato, ao balcão |
12
+ | `PF` | Fatura pró-forma | orçamento sem validade fiscal |
13
+ | `NC` | Nota de crédito | devolver ou corrigir parte de um documento |
14
+ | `RC` / `RG` | Recibo / recibo global | liquidar uma ou várias faturas |
15
+
16
+ `NC`, `RC` e `RG` têm as suas próprias operações; `POST /api/v1/documents` emite `FT`, `FR`, `TV` e `PF`.
17
+
18
+ ## Emitir
19
+
20
+ ```bash
21
+ curl https://api.brisa.ao/api/v1/documents -H "Authorization: Bearer $BRISA_API_KEY" -H "Idempotency-Key: encomenda-77" \
22
+ -H "Content-Type: application/json" \
23
+ -d '{"type":"FT","clientId":42,"paymentTermsDays":30,"lines":[{"productCode":"PAR-M8","quantity":10}]}'
24
+ ```
25
+
26
+ ```ts
27
+ const ft = await brisa.documents.issue({
28
+ type: 'FT', clientId: 42, paymentTermsDays: 30,
29
+ lines: [{ productCode: 'PAR-M8', quantity: 10 }],
30
+ }, { idempotencyKey: 'encomenda-77' })
31
+ ```
32
+
33
+ ```php
34
+ $ft = $brisa->documents->issue([
35
+ 'type' => 'FT', 'clientId' => 42, 'paymentTermsDays' => 30,
36
+ 'lines' => [['productCode' => 'PAR-M8', 'quantity' => 10]],
37
+ ], ['idempotencyKey' => 'encomenda-77']);
38
+ ```
39
+
40
+ Cada linha pode usar um artigo do catálogo (`productCode`) ou ser escrita à mão (`description`, `unitPrice` e `taxes`). Um cliente pode ser um registado (`clientId`) ou escrito no próprio documento (`customer`).
41
+
42
+ > **Nota:** a numeração e a cadeia de assinaturas são da Brisa. Nunca tente numerar documentos do seu lado.
43
+
44
+ ## Consultar
45
+
46
+ ```bash
47
+ curl https://api.brisa.ao/api/v1/documents/ID -H "Authorization: Bearer $BRISA_API_KEY"
48
+ ```
49
+
50
+ ```ts
51
+ const d = await brisa.documents.get(ft.id)
52
+ for await (const x of brisa.documents.listAll({ type: 'FT', from: '2026-11-01' })) console.log(x.number, x.amountDue)
53
+ ```
54
+
55
+ ```php
56
+ $d = $brisa->documents->get($ft['id']);
57
+ foreach ($brisa->documents->listAll(['type' => 'FT', 'from' => '2026-11-01']) as $x) echo $x['number'], PHP_EOL;
58
+ ```
59
+
60
+ `amountDue` diz quanto falta pagar. `agtStatus` diz em que ponto está a comunicação à AGT.
61
+
62
+ ## Anular, retificar e creditar
63
+
64
+ * **Anular** uma fatura emitida só é possível com o fundamento do Art. 8.º n.º 8 do Decreto Presidencial 71/25.
65
+ * **Retificar** emite a nota de crédito que anula o documento e deixa-o corrigir os dados do cliente.
66
+ * **Nota de crédito** de linhas: devolve parte do documento.
67
+
68
+ ```ts
69
+ await brisa.documents.cancel(ft.id, { reason: 'Emitida por engano', basis: 'not_sent_to_acquirer' })
70
+ await brisa.documents.creditNote(ft.id, { reason: 'Devolução', lines: [{ line: 1, quantity: 2 }] })
71
+ ```
72
+
73
+ ```php
74
+ $brisa->documents->cancel($ft['id'], ['reason' => 'Emitida por engano', 'basis' => 'not_sent_to_acquirer']);
75
+ $brisa->documents->creditNote($ft['id'], ['reason' => 'Devolução', 'lines' => [['line' => 1, 'quantity' => 2]]]);
76
+ ```
77
+
78
+ ## Próximos passos
79
+
80
+ [Pagamentos](04-pagamentos.md) · [Impressão](05-impressao.md) · [Dados bancários](06-dados-bancarios.md)
@@ -0,0 +1,69 @@
1
+ # Pagamentos
2
+
3
+ Há dois momentos: pagar **no ato** (`FR`, `TV`) e pagar **depois** (`FT`). Esta página cobre os dois e o caso de pagar com vários meios ao mesmo tempo.
4
+
5
+ Meios aceites: `cash`, `credit_card`, `debit_card`, `transfer`, `check`, `multicaixa` e `other`.
6
+
7
+ ## Pagar no ato
8
+
9
+ ```bash
10
+ curl https://api.brisa.ao/api/v1/documents -H "Authorization: Bearer $BRISA_API_KEY" -H "Idempotency-Key: venda-1" -H "Content-Type: application/json" \
11
+ -d '{"type":"FR","lines":[{"description":"Cimento 50 kg","quantity":1,"unitPrice":100}],"payment":{"method":"cash","amountReceived":200}}'
12
+ ```
13
+
14
+ ```ts
15
+ await brisa.documents.issue({ type: 'FR', lines, payment: { method: 'cash', amountReceived: 200 } })
16
+ ```
17
+
18
+ ```php
19
+ $brisa->documents->issue(['type' => 'FR', 'lines' => $lines, 'payment' => ['method' => 'cash', 'amountReceived' => 200]]);
20
+ ```
21
+
22
+ O troco (o que foi dado a mais) só existe em numerário.
23
+
24
+ ## Pagar com vários meios
25
+
26
+ Num `FR` ou `TV` pode pagar-se parte em numerário, parte no TPA, parte por transferência (até 6 meios). O que se paga tem de cobrir o total; o **troco** sai do numerário, por isso os meios que não são numerário não podem somar mais do que o total.
27
+
28
+ ```ts
29
+ const fr = await brisa.documents.issue({
30
+ type: 'FR',
31
+ lines: [{ description: 'Cimento 50 kg', quantity: 1, unitPrice: 100 }], // 114 com IVA
32
+ payment: { payments: [{ method: 'debit_card', amount: 50 }, { method: 'cash', amount: 100 }] }, // 36 de troco
33
+ })
34
+ const d = await brisa.documents.get(fr.id) // d.paymentMethod === 'mixed', d.payments, d.amountReceived
35
+ ```
36
+
37
+ ```php
38
+ $fr = $brisa->documents->issue([
39
+ 'type' => 'FR',
40
+ 'lines' => [['description' => 'Cimento 50 kg', 'quantity' => 1, 'unitPrice' => 100]],
41
+ 'payment' => ['payments' => [['method' => 'debit_card', 'amount' => 50], ['method' => 'cash', 'amount' => 100]]],
42
+ ]);
43
+ ```
44
+
45
+ ```bash
46
+ curl https://api.brisa.ao/api/v1/documents -H "Authorization: Bearer $BRISA_API_KEY" -H "Idempotency-Key: venda-2" -H "Content-Type: application/json" \
47
+ -d '{"type":"FR","lines":[{"description":"Cimento 50 kg","quantity":1,"unitPrice":100}],"payment":{"payments":[{"method":"debit_card","amount":50},{"method":"cash","amount":100}]}}'
48
+ ```
49
+
50
+ > **Nota:** para a AGT e o SAF-T nada muda: o documento continua a ser um só. O talão e a fatura mostram cada meio, o total pago e o troco.
51
+
52
+ ## Pagar uma fatura depois
53
+
54
+ Registar um pagamento numa `FT` emite o recibo (`RC`). Pode ser parcial.
55
+
56
+ ```ts
57
+ const { receipt } = await brisa.documents.pay(ft.id, { method: 'transfer', amount: 500 })
58
+ await brisa.documents.payGlobal({ documentIds: [ft.id, outra.id], method: 'cash' }) // um recibo global
59
+ ```
60
+
61
+ ```php
62
+ $brisa->documents->pay($ft['id'], ['method' => 'transfer', 'amount' => 500]);
63
+ $brisa->documents->payGlobal(['documentIds' => [$ft['id'], $outra['id']], 'method' => 'cash']);
64
+ ```
65
+
66
+ ## Erros comuns
67
+
68
+ * `422` com `field: payment.payments`: a soma não cobre o total, ou os meios sem troco passam o total.
69
+ * `422` com `field: idempotency`: reutilizou um `Idempotency-Key` com outro corpo. Ver [Idempotência](12-idempotencia-e-limites.md).
@@ -0,0 +1,44 @@
1
+ # Impressão
2
+
3
+ O mesmo documento sai em quatro papéis. Escolhe-se no pedido do PDF.
4
+
5
+ | `format` | Papel | Para |
6
+ |---|---|---|
7
+ | `a4` (por omissão) | folha A4 | qualquer documento |
8
+ | `a5` | meia folha | o A4 reduzido, para papel mais pequeno |
9
+ | `thermal80` (ou `thermal`) | rolo de 80 mm | talões de `FR`, `TV`, `RC` e `RG` |
10
+ | `thermal58` | rolo de 58 mm | idem, em impressoras pequenas |
11
+
12
+ ```bash
13
+ curl "https://api.brisa.ao/api/v1/documents/ID/pdf?format=a5" -H "Authorization: Bearer $BRISA_API_KEY" -o fatura-a5.pdf
14
+ ```
15
+
16
+ ```ts
17
+ const a4 = await brisa.documents.pdf(id)
18
+ const a5 = await brisa.documents.pdf(id, { format: 'a5' })
19
+ const r80 = await brisa.documents.pdf(fr.id, { format: 'thermal80' })
20
+ const r58 = await brisa.documents.pdf(fr.id, { format: 'thermal58' })
21
+ ```
22
+
23
+ ```php
24
+ $a5 = $brisa->documents->pdf($id, ['format' => 'a5']);
25
+ $r80 = $brisa->documents->pdf($fr['id'], ['format' => 'thermal80']);
26
+ ```
27
+
28
+ ## Original e 2.ª via
29
+
30
+ `copy=second` imprime a 2.ª via, que diz que o é e quando foi impressa de novo.
31
+
32
+ ```ts
33
+ await brisa.documents.pdf(id, { copy: 'second' })
34
+ ```
35
+
36
+ > **Nota:** os rolos só existem para vendas e recibos. Pedir `thermal80` para uma `FT` devolve `422`.
37
+
38
+ ## Na aplicação Brisa
39
+
40
+ Em *Definições → Impressão* cada pessoa escolhe o papel predefinido (A4, A5 ou rolo), dá um nome à impressora do aparelho e pode pedir que o talão saia logo depois de uma venda no POS. O navegador não deixa uma página escolher a impressora por código: escolhe-se uma vez no diálogo do sistema, que se lembra.
41
+
42
+ ## Próximos passos
43
+
44
+ [Dados bancários nas faturas](06-dados-bancarios.md)
@@ -0,0 +1,42 @@
1
+ # Dados bancários
2
+
3
+ Uma fatura por pagar pode trazer impresso **como pagar**: banco, titular, IBAN, número de conta, chave Kwik e Multicaixa Express. Saem em «Dados Bancários», ao lado das notas.
4
+
5
+ ## Definir os da empresa
6
+
7
+ ```bash
8
+ curl -X PUT https://api.brisa.ao/api/v1/company/bank -H "Authorization: Bearer $BRISA_API_KEY" -H "Content-Type: application/json" \
9
+ -d '{"bankName":"BAI","holder":"Ngola Comercial, Lda","iban":"AO06 0000 0000 0000 0000 0000 0","kwikKey":"923000000"}'
10
+ ```
11
+
12
+ ```ts
13
+ await brisa.setBank({ bankName: 'BAI', holder: 'Ngola Comercial, Lda', iban: 'AO06 0000 0000 0000 0000 0000 0', kwikKey: '923000000' })
14
+ const bank = await brisa.bank()
15
+ ```
16
+
17
+ ```php
18
+ $brisa->setBank(['bankName' => 'BAI', 'holder' => 'Ngola Comercial, Lda', 'iban' => 'AO06 0000 0000 0000 0000 0000 0', 'kwikKey' => '923000000']);
19
+ ```
20
+
21
+ Todos os campos são opcionais e têm uma linha cada. O IBAN guarda-se **como foi escrito** (até 60 caracteres). Enviar tudo vazio limpa os dados. Precisa da permissão `settings.manage`.
22
+
23
+ ## Em cada fatura
24
+
25
+ * Sem mais nada, uma `FT` ou `PF` leva os dados da empresa.
26
+ * `bankDetails` dá outros só para essa fatura.
27
+ * `printBankDetails: false` não imprime nenhuns.
28
+
29
+ ```ts
30
+ await brisa.documents.issue({ type: 'FT', clientId: 42, lines }) // os da empresa
31
+ await brisa.documents.issue({ type: 'FT', clientId: 42, lines, bankDetails: { bankName: 'BFA' } }) // só nesta fatura
32
+ await brisa.documents.issue({ type: 'FT', clientId: 42, lines, printBankDetails: false }) // nenhuns
33
+ ```
34
+
35
+ ```php
36
+ $brisa->documents->issue(['type' => 'FT', 'clientId' => 42, 'lines' => $lines, 'printBankDetails' => false]);
37
+ ```
38
+
39
+ ## O que convém saber
40
+
41
+ * Os dados ficam **copiados** na fatura quando é emitida: mudar os da empresa depois não altera as já emitidas.
42
+ * Só aparecem enquanto há algo por pagar. Uma fatura paga, um `FR` ou um `TV` não os imprimem.
@@ -0,0 +1,61 @@
1
+ # Clientes e extrato
2
+
3
+ Os clientes registados evitam escrever os mesmos dados em cada fatura. Esta página mostra como gerir, ordenar por quanto cada um comprou e imprimir o extrato.
4
+
5
+ ## Criar e atualizar
6
+
7
+ ```bash
8
+ curl https://api.brisa.ao/api/v1/clients -H "Authorization: Bearer $BRISA_API_KEY" -H "Content-Type: application/json" \
9
+ -d '{"name":"Cliente Exemplo, Lda","taxId":"5000000001","clientType":"company","email":"geral@exemplo.ao"}'
10
+ ```
11
+
12
+ ```ts
13
+ const { id } = await brisa.clients.create({ name: 'Cliente Exemplo, Lda', taxId: '5000000001', clientType: 'company', email: 'geral@exemplo.ao' })
14
+ await brisa.clients.update(id, { name: 'Cliente Exemplo, Lda', taxId: '5000000001', city: 'Luanda' })
15
+ ```
16
+
17
+ ```php
18
+ $cliente = $brisa->clients->create(['name' => 'Cliente Exemplo, Lda', 'taxId' => '5000000001', 'email' => 'geral@exemplo.ao']);
19
+ ```
20
+
21
+ > **Nota:** `update` substitui tudo. Envie o corpo completo.
22
+
23
+ ## Ordenar por o que cada um faturou
24
+
25
+ `totals` acrescenta a cada cliente o total faturado (`invoiced`), o que deve (`amountDue`), a data da última fatura (`lastInvoiceDate`) e o número de documentos (`documents`).
26
+
27
+ ```bash
28
+ curl "https://api.brisa.ao/api/v1/clients?sort=invoiced:desc&totals=true&size=10" -H "Authorization: Bearer $BRISA_API_KEY"
29
+ ```
30
+
31
+ ```ts
32
+ const top = await brisa.clients.list({ sort: 'invoiced:desc', totals: true, size: 10 })
33
+ ```
34
+
35
+ ```php
36
+ $top = $brisa->clients->list(['sort' => 'invoiced:desc', 'totals' => true, 'size' => 10]);
37
+ ```
38
+
39
+ Ordens: `name` (por omissão), `taxId`, `city`, `createdAt` e, com os totais, `invoiced`, `due`, `lastInvoice` e `documents`. Junte `:desc` para a ordem inversa.
40
+
41
+ ## Extrato
42
+
43
+ O extrato é a conta corrente do cliente: faturas, notas de crédito e recibos, dia a dia, com o saldo a correr a partir de um saldo de abertura (positivo: o cliente deve).
44
+
45
+ ```bash
46
+ curl "https://api.brisa.ao/api/v1/clients/5/statement?from=2026-11-01&to=2026-11-30" -H "Authorization: Bearer $BRISA_API_KEY"
47
+ curl "https://api.brisa.ao/api/v1/clients/5/statement?format=pdf" -H "Authorization: Bearer $BRISA_API_KEY" -o extrato.pdf
48
+ ```
49
+
50
+ ```ts
51
+ const extrato = await brisa.clients.statement(5, { from: '2026-11-01', to: '2026-11-30' })
52
+ const pdf = await brisa.clients.statementPdf(5)
53
+ const csv = await brisa.clients.statementCsv(5)
54
+ ```
55
+
56
+ ```php
57
+ $extrato = $brisa->clients->statement(5, ['from' => '2026-11-01', 'to' => '2026-11-30']);
58
+ $pdf = $brisa->clients->statementPdf(5);
59
+ ```
60
+
61
+ Os ficheiros (PDF, CSV, Excel) exigem também a permissão `reports.export`.