Számlaanalitika API végpont bővítés: új external_id mező


Frissült a számlaanalitika API válasza.

Érintett végpont:

POST /api/invoiceanalytics/{apikey}

A válasz sorai mostantól tartalmazhatnak egy új mezőt:

{"external_id": 123}

Az external_id mező a számla fejlécéhez kapcsolt külső / kiegészítő azonosító jellegű értéket adja vissza.

Forrása:

  • értékesítési számláknál: SalesHeader.SH_BillCity_ID
  • beszerzési számláknál: PurchaseHeader.PH_BillCity_ID



A mező típusa:

integer | null

Ha az adott számlához nincs ilyen érték rögzítve, akkor az API null értéket adhat vissza.

Fontos kompatibilitási információ

A változás visszafelé kompatibilis.
A meglévő request paraméterek és a korábbi válaszmezők nem változtak, csak egy új opcionális mező került be a response sorokba.

Példa válaszrészlet:

[
{
"InvoiceDocNo":
"INV-2026-0001",
"Partner": "Minta Partner Kft.",
"PartnerID": 100,
"external_id": 42,
"InvoiceLineNetAmount": 100000,
"InvoiceLineVatAmount": 27000,
"InvoiceLineGrossAmount": 127000
}
]

A módosítás célja, hogy az integrációk a számlaanalitika lekérdezésből közvetlenül elérjék ezt a külső kapcsolati azonosítót, külön kiegészítő lekérdezés nélkül.