NAV adatcsere a számlán — végpontok és háttérfeladat

NAV-letöltés (navdownload)

1. A kijelölt számlákra NAV queryInvoiceData hívás (navosa->sendQueryInvoiceData) a tulajdonos NAV-hitelesítő adataival (company::getCompanyTaxHUById2).
2. A válasz (invoiceData, invoiceJson) az invoice_ctrl táblába kerül (saveInvoiceCtrlRaw).
3. A számla- és tétel-kiegészítő adatok az analitika modellbe (saveLineAdditionalData), majd összesítő-újraépítés (rebuildAdditionalAggregate) és számlafajta-frissítés (applyKind).
4. Számlánkénti eredménylista.

Számlafajta és hivatkozás (navref)

A Dlbtinvoice::refreshKindFromNav frissíti a fajtát (normál, sztornó, módosító) és a hivatkozást. Kijelölés nélkül a szűrt listára fut: legfeljebb 20 számla azonnal, felette aszinkron job a cron-sorban (cron_queue, job_type = nav_invoice_ref, insertRunOnce, payload {"invoice_ids": [...]}, legfeljebb 20 000 azonosító, a szűrő clientjével). Ha már van függő job, nem tesz újat. A futtató a catalog oldali cron; hibakulcs: error_navref_queue.

Tétel-kiegészítő adatok (lineadditional, lineadditionalsave)

A NAV additionalLineData és productCodes adatok kézi megtekintése és mentése számlára vagy tételre a masterdata/analytic::saveLineAdditionalData metóduson át; a NAV-tételt nem érinti.

Kézi címkézés (labelsearch, addLabel, removeLabel)

Hozzárendelés: dlbtlabel->addLink, forrás manual. Eltávolításkor a címkéhez tartozó továbbszámlázási sorok törlődnek; a cél-számla csak akkor, ha még tervezet (contract/passthrough::invoiceIsDraft, deleteInvoice).

Adatmodell

A táblanevek a telepítés saját előtagjával állnak az adatbázisban: invoice_ctrl, invoice, invoice_item, analitika-táblák (masterdata/analytic), label_link, továbbszámlázási táblák (contract/passthrough), cron_queue.

Jogosultság és előfeltétel

• 2. réteg: canAction(navdata) minden végponton; a kulcs SUBSCRIPTION besorolású.
• 3. réteg: invoiceInScope számlánként.
• Előfeltétel: NAV technikai felhasználó a tulajdonos cégnél, navosa library. Hibakulcsok: error_nav_*, error_navref_queue.