Партнери

Партнерите се едни и исти за двете насоки. Не постои список за излезни и друг за влезни: една компанија е еден запис, и тој го користат обете патеки.

Тоа не е внатрешна уредност — тоа е редот во стварноста. Влезна фактура пристигнува без да имаш шифра за таа компанија, зашто испраќачот те одбрал него, не ти. Значи партнерот постои во eArhiva.mk пред да постои во твојот софтвер.

Заведувањето се случува само

Примач или испраќач што не е заведен се заведува од самиот документ — од името, ЕДБ-то и адресата што документот ги носи — и обработката продолжува.

Насока	Кој се заведува	Кога
излезна фактура	примачот	при разрешување на примачот, пред поднесувањето кон УЈП
влезна фактура	испраќачот	при приемот на документот

⛔ Не мораш да заведуваш ништо однапред за да пратиш прва фактура. Дотогаш документ за незаведен примач завршуваше на 250 со EARH-4005 — вообичаениот исход на прв обид кај секој нов интегратор.

⚠️ Заведувањето не ги препишува постоечките податоци. Пополнува само она што е празно: партнер заведен рачно со е-пошта и точно име го задржува своето, а од документот се дополнува тоа што го немал.

Повлекување во твојот софтвер — `GET /partners`

GET /api/integration/v1/partners?changedSince=2026-09-01&page=1&pageSize=200

Одговорот носи items, totalCount и nextFrom:

{
  "items": [
    {
      "edb": "4002002113498",
      "name": "Алкалоид АД Скопје",
      "address": "бул. Александар Македонски 12",
      "city": "Скопје",
      "postalCode": "1000",
      "country": "MK",
      "email": "info@alkaloid.com.mk",
      "origin": "Unknown",
      "changedAt": "2026-07-06T23:50:11.001807"
    }
  ],
  "totalCount": 13,
  "nextFrom": "2026-07-06T23:50:11.001807"
}

Поле	Што е
`edb`	ЕДБ-то како што е запишано — со или без префикс `MK`. При споредување нормализирај: `MK4030995155258` и `4030995155258` се ист обврзник
`origin`	од каде е записот — `OutboundInvoice`, `InboundInvoice`, `Manual`, `Erp`, или `Unknown` за запис постар од воведувањето на полето
`changedAt`	последната промена на записот; по неа е и подредувањето

Инкрементално, не цел список

changedSince враќа само она што се сменило, а nextFrom во одговорот е почетната точка за следниот повик — истиот образец како кај листите на документи.

GET /api/integration/v1/partners?changedSince=2026-07-06T23:50:11.001807

changedSince прима календарски датум (yyyy-MM-dd) или цел временски печат. ⛔ Читањето е строго по ISO: 10.09.2026 се одбива со EARH-2020, не се толкува како 10 септември.

Страничењето е page и pageSize. Најголемата дозволена страница е 500; поголема се одбива со EARH-3005, а одговорот ја носи дозволената вредност.