Recept

Bejövő számlák listázása

A cégedhez érkezett szállítói számlákat szeretnéd lapozva, szűrve visszakérdezni az API-tól.

Kezdő~25 perc4 lépés

Előfeltételek

Működő autentikált integráció (lásd: API kérések autentikálása)
Legalább egy bejövő számla a tenantban

1. Alap listázás

A direction=inbound szűrő adja vissza a bejövő számlákat. Alapból az utolsó 20 elem jön, updated_at szerint csökkenő sorrendben.

bash

curl -sS "https://api.quick.es/v1/invoices?direction=inbound" \
  -H "Authorization: Bearer $QUICK_API_KEY"

2. Lapozás cursor alapon

A válasz next_cursor mezőt ad vissza, amíg van további oldal.

json

{
  "data": [ /* ... */ ],
  "next_cursor": "eyJpZCI6IjEyM30="
}

A következő oldalt így kéred:

bash

curl -sS "https://api.quick.es/v1/invoices?direction=inbound&cursor=eyJpZCI6IjEyM30=" \
  -H "Authorization: Bearer $QUICK_API_KEY"

3. Szűrés dátumra és státuszra

Több szűrő is kombinálható. Egy hónapnyi, még nem könyvelt tétel:

bash

curl -sS "https://api.quick.es/v1/invoices?direction=inbound&issue_date_from=2026-06-01&issue_date_to=2026-06-30&status=received" \
  -H "Authorization: Bearer $QUICK_API_KEY"

4. Node.js lapozó helper

export async function* listInboundInvoices(params: Record<string, string> = {}) {
  let cursor: string | undefined;
  do {
    const qs = new URLSearchParams({ direction: "inbound", ...params });
    if (cursor) qs.set("cursor", cursor);
    const page = await quickFetch(`/invoices?${qs}`);
    for (const item of page.data) yield item;
    cursor = page.next_cursor;
  } while (cursor);
}

Kapcsolódó endpointok

GET/v1/invoices

Kapcsolódó fogalmak

inbound_invoice cursor status

Gyakori hibák

Az offset paraméterrel próbál lapozni

A QUiCK API cursor-alapú, nem offset-alapú. A ?page=2 néma módon nem is fog szűrni — mindig a next_cursor értékét add tovább.

Az összes oldalt egyszerre húzza le szinkron

Nagy tenantoknál ez időtúllépéshez vezet. Iterálj async generatorral vagy batch-elve dolgozz.