Playbook

Partnertörzs egyeztetése

Külső rendszer partnereinek összevetése a QUiCK-kel — új partnerek felderítése, adószám-egyezés ellenőrzése.

Haladó~20 perc4 lépés

Ez a playbook azt mutatja meg, hogyan egyeztesd a külső rendszered partnereit (customers/vendors) a QUiCK-ben tárolt partnertörzzsel. Az egyeztetés alapja az adószám (tax_number).

Előfeltételek

Public API token
Külső partnerlista adószámmal

1. Első lap lekérése

bash

curl -H "Authorization: Token $QUICK_TOKEN" \
  "https://api.quick.riport.co.hu/1/partners/?page_size=100"

A válasz szabványos lapozott alak:

json

{
  "count": 837,
  "next": "https://api.quick.riport.co.hu/1/partners/?page=2&page_size=100",
  "previous": null,
  "results": [ /* ... */ ]
}

2. Teljes lista behúzása lapozva

javascript

let url = `${BASE}/1/partners/?page_size=100`;
const partners = [];
while (url) {
  const res = await fetch(url, { headers: { Authorization: `Token ${TOKEN}` }});
  const page = await res.json();
  partners.push(...page.results);
  url = page.next;
}

3. Egyeztetés tax_number alapján

Építs egy Map-et a QUiCK-partnerekből adószám kulcsokkal, majd iterálj a külső listán:

javascript

const byTax = new Map(partners.map(p => [normalizeTax(p.tax_number), p]));
for (const external of myList) {
  const match = byTax.get(normalizeTax(external.tax_number));
  if (!match) console.log('missing in QUiCK:', external);
}

4. is_customer / is_vendor kezelése

Egy partner egyszerre lehet vevő és szállító is. A QUiCK partner rekord is_customer és is_vendor boolean mezőkkel jelzi a szerepet — a saját rendszeredben ehhez igazítsd az egyeztetést.

Kapcsolódó endpointok

GET/1/partners/

Kapcsolódó fogalmak

partner tax_number

Gyakori hibák

Adószám-formátum eltérés

A magyar adószám lehet `12345678-1-42` vagy `12345678142` formátumban. Normalizálj mindkét oldalon (pl. csak a számjegyeket tartsd meg) az egyeztetés előtt.

Lapozás figyelmen kívül hagyása

Ha csak az első lapot (`results`) használod, több száz partner kimaradhat. Mindig kövesd a `next` URL-t, amíg `null`-t nem kapsz.