PMIS Federation Exchange

Skupne pogodbe poslovnih dokumentov in izvorni komercialni izračuni za Odoo 18 Community. Exchange temelji na Core in Transport brez zahteve po uvajanju računov, skupni prijavi, sporočanju ali Matrix.

Funkcionalnosti

Različicno preverjanje strukturiranih povpraševanj, ponudb in naročil.
Pogodbe knjiženih računov/dobropisov s predznačenimi popravnimi vrsticami, izvornimi povezavami, zamrznjenimi podatki PDF in preverjanjem izvornih vsot.
Pogodbe potrjenih dobav/vračil kupcev z dejanskimi količinami, naročilnimi vrsticami, prvotnimi dobavami/premiki in dokazili naknadnih naročil.
Izrecna obvestila preklica/nadomestila z ločenimi identitetami dokumentov.
Potrditev prejemnika za izbirni preklic z dokazili pregleda brez preklica izvornih dokumentov.
Varne sheme potrdil received, pending-review, applied in rejected.
Izvorna obravnava neobdavčenih zneskov in lokalnih cen z davkom z ohranjenimi ponujenimi neto zneski in popusti.
Odobrene pretvorbe enot, ki skupaj prilagodijo količino/ceno.
Lokalne odobritve poti za točen par namestitev, operativno podjetje, partnerja in zmogljivost s preverjenimi članstvi pošiljatelja.
Preslikave različic, enot in embalaže, odobrene po poti.
Pregledani nabavni dnevniki in privzeti konti vrstic za ločene poti računov/ dobropisov z izvornimi omejitvami ter valutnimi preverjanji.
Trajna dokazila odobritev in arhivirani izvirniki pregledanih nadomestil.
Nespremenljivi vhodni posnetki z zaščito ponovitev/revizij.
Zamrznjene preverjene stranke, pošiljatelji, partnerji in naslovi.
Potrdila prejetja, pregledov in končnih izidov samo za dodajanje z omejenimi povratnimi ovojnicami.
Izrecne lokalne odobritve preverjanja s trajno pripisano zgodovino.
Overjeni kanali, vezani na točne poti in storitvene uporabnike.
Trajni posnetki pošiljatelja, omejene ponovitve in uskladitev potrdil samo za branje.
Zamrznjene priloge s preverjanjem podjetja, MIME, velikosti in povzetka.
Samodejno zamrznjeni PDF-ji računov in izrecno izbrane priloge.
Izvorne cene in priprava komercialnih vhodov prejemnika z lokalnimi davki.
Trajne reference naročil, vrstic, izdelkov, enot, kategorij in embalaže po operativnem podjetju z omejeno serializacijo izvornega naročila.

Dostop in odvisnosti

Namestite pmis_federation_exchange z pmis_federation_transport, account in uom. Dodatni paketi Python ali zunanji dodatki OCA niso potrebni. Izračuni zahtevajo izrecno dostopno operativno podjetje in lokalne zapise. Cenovna storitev izpostavi zasebne metode prilagodilnikov, ne splošnih RPC dejanj. Skrbniki vzdržujejo Federation > Document Routes in Document Mappings. Vhodni/odhodni meniji so samo skrbniški; namestitev ne dodeli dostopa do izvornih dokumentov.

Uporaba prilagodilnikov

Pregled preverjanja prejemnika

V Federation > Incoming Documents preglejte nespremenljiv posnetek in prvotno preverjanje. Review Verification zahteva dokazilo; odobritev ločeno od izvirnega dnevnika shrani skrbnika, čas in trenutna dokazila.

Pooblasti samo prvotna pregledana pot; nadomestna ne prevzame zgodovine. Revizija zahteva točnega uporabljenega predhodnika, vse deklarirane odvisnosti in prenesene datoteke. Sprememba preverjanja zahteva nov pregled; uporabljene/ zavrnjene operacije se ne odobrijo znova. Ohranijo se ID-ji komercialnih odobritev in izvorni cilji, zato zamenjava partnerja, izdelka, enote ali embalaže razveljavi prejšnji pregled.

Samo odobritev ne ustvari, potrdi ali knjiži izvornega dokumenta. Prilagodilnik pred uporabo kliče _check_application_review, ki preveri trenutna dokazila in odvisnosti; izvorno ustvarjanje ostane njegova odgovornost.

Pogodbene storitve

document_protocol.validate_document_envelope preveri omejene od računov neodvisne posnetke, zasebna pmis.federation.exchange.pricing pa računa lokalne vrednosti. Natančne strukture in obveznosti so v pogodbi življenjskega cikla in pogodbi naročil.

Usmerjanje prejemnika

Odobritev pmis.federation.exchange.route določi operativno podjetje, lokalno/oddaljeno namestitev Core, preverjeno lokalno preslikavo Operating Company, pregledano povezavo oddaljene organizacije, preverjeni UUID preslikave oddaljenega podjetja in zmogljivost dokumenta. Lastništvo imenika je ločeno od operativnega cilja. Izbirna preverjena preslikava poslovnega stika izbere lokalnega partnerja; brez nje ostane pregled partnerja nerešen.

Zasebni _resolve prejme preverjeno ovojnico in par namestitev/zmogljivost, ugotovljene iz overjenega kanala. Vrne točno pot in povzetek, preveri živo verifikacijo in odobreno članstvo pošiljatelja v Core. Zatrjevani UUID, imena, skupni partnerji ali trenutno podjetje niso nadomestno usmerjanje. Metoda sama kanala ne overja.

pmis.federation.exchange.mapping odobri pot, izvorni UUID in en cilj partnerja, različice, enote ali embalaže. _resolve vrne odobren cilj ali prazen nabor. Arhivirani in izdelki drugega podjetja zahtevajo pregled. Embalaža ne pooblasti pretvorbe enot; davki so lokalni. _convert_units pred cenovnim pomočnikom razreši odobreno lokalno ekvivalenco izvorne enote. Nerešena vrne None, da prilagodilnik ohrani prvotne ovrednotene vrstice brez izdelka za pregled.

Računovodski cilji

Federation > Accounting Mappings odobri nabavni dnevnik in privzeti konto vrstice za eno pot računa ali dobropisa. Podeduje točno podjetje, partnerja, par namestitev in zmogljivost. Operativno podjetje in Directory Owner morata biti dostopna. Odobritev računa ne odobri dobropisa.

Izberite aktivni nabavni dnevnik in neopuščen komercialni konto podjetja; terjatve, obveznosti in zunajbilančni konti niso dovoljeni. Omejitve dnevnika/ konta ter vsiljene valute morajo biti skladne. Skupni konti so upravičeni samo za izrecno dodeljena podjetja. Ne izbere kontnega načrta, lokalizacije ali preslikav pošiljateljevih davkov.

pmis.federation.exchange.accounting.mapping._resolve(route, currency=None) vrne točno aktivno odobritev ali prazen nabor. Prilagodilnik poda valuto ponudbe za preverjanje omejitev brez pretvarjanja ali aktivacije. Odobritev zamrzne nastavitve in skrbniški pripis; poznejše izvorne spremembe zahtevajo pregledano nadomestilo. Preverjanje računa/dobropisa ohrani ta dokazila, zamenjava pa razveljavi prejšnji pregled. Ustvarjanje računa in ročno knjiženje sta ločena.

Cilji in pripis so trajni. Za popravek arhivirajte izvirnik in ustvarite pregledano nadomestilo. Arhiv ohrani prvotne cilje, nova uporaba preveri trenutna pooblastila. Prilagodilniki hranijo prvotne odobritve v nespremenljivih dostavnih posnetkih.

Dnevnik vhodnih operacij

Overjeni prilagodilnik kliče pmis.federation.exchange.snapshot._receive_envelope z neodvisno ugotovljenim parom/zmogljivostjo. V eni transakciji shrani kanonične bajte, celotni povzetek, lastništvo podjetja/poti in potrdila prejetja/pregleda. Potrditev transakcije upravlja klicatelj; samo zapis ne overja ali izvaja poslovnih sprememb.

Ponovitev uporabi prvotno operacijo/posnetek. Isti UUID z drugo vsebino, druga operacija iste revizije ali sprememba lastništva med revizijami so zavrnjeni. Manjkajoči predhodniki, neskladne verige, nerešene odvisnosti in spremembe preverjanja ostanejo v pregledu. Točni uporabljeni posnetki in stabilni UUID-ji vrstic določijo odvisnosti, izvorne povezave pa prilagodilnik.

Dnevnik ohrani stranke, naslove in povezave ob dokumentu tudi po lokalnih spremembah. Zamenjava poti ne prevzame zgodovine. Manjkajoča naslovna povezava ostane v pregledu; poznejše preverjanje prvotne dostave ne odobri tiho. Bajti datotek se prenesejo ločeno po prvotnem kanalu; dokler vsi ne prestanejo preverjanja, posnetek ostane v pregledu odvisnosti.

pmis.federation.exchange.receipt ohrani vsako opažanje nespremenljivo. Ponovitve uporabijo isto, spremembe dodajo dokazilo, končnega izida ni mogoče zamenjati. _acknowledgment vrne točno stanje v1 brez lokalnih ID-jev in poslovnih podrobnosti. Uporaba dokumenta zahteva nameščen prilagodilnik. Exchange sam omogoča potrditev obravnave preklica brez poslovne spremembe. Dostava in iskanje potrdila vrneta zadnje točno opažanje; ustrezni prvi prilagodilnik lahko dokument uporabi med dostavo ali po prihodu prilog. Iskanje potrdila samo bere in nikoli ne uporabi dokumenta.

Komercialna varovala

Izračuni uporabljajo izrecno dostopno podjetje, aktivno valuto ponudbe in lokalne davke. Davki pošiljatelja so dokazila, ne preslikave ID-jev. Storitev ne aktivira ali pretvarja valut. Če ponujenega neto zneska ni mogoče ohraniti, je potreben pregled.

Pretvorba zahteva izrecno odobritev prilagodilnika za različni enoti iste kategorije in hkrati spremeni količino/ceno brez količinskega zaokroževanja. Ne ustvarja odobritev in pretvorb ne ugiba iz imen, embalaže ali UUID-jev.

Odobreni lokalni cilji

V Document Mappings izberite ali izrecno ustvarite partnerja s preverjenim UUID nasprotne stranke; tako razrešite prvotno pot, zadržani dokument pa potrebuje nov pregled. Enako velja za različice izdelkov. Imena in šifre pomagajo pri izbiri, nikoli niso dovoljenje ali samodejni ujemalni ključ.

Overjeni kanali in pošiljanje

V Federation > Delivery > Service Connections izberite zmogljivost dokumenta in pregledano pot ter delegirajte natanko njeni lokalno/nasprotno organizacijo. Directory Owner povezave ni Operating Company poti. Vhodna povezava zahteva namenskega uporabnika Transport z obema podjetjema. Omejeni ključi API in izvajalna vezava pooblastijo HTTPS; namestitev ne nastavi poverilnic/zaupanja.

Operations zabeleži dokument in vrne omejeno povratno stanje; receipts zadnje opažanje brez ponovne uporabe. Odkrivanje objavi samo pregledano zmogljivost uporabnika; nepodprta izvorna uporaba ostane v pregledu.

pmis.federation.exchange.outgoing._enqueue_envelope sprejme izvorni dokument in izbrane priloge. Preveri bralni dostop, podjetje, model/stanje, preverjeno identiteto delujočega uporabnika Core, odobreno članstvo in točne stranke. PDF računa/dobropisa se samodejno izdela in zamrzne v isti transakciji; priloge izrecno izberite med berljivimi binarnimi prilogami tega izvora. Naročilo lahko vsebuje izbirne metapodatke prilog.

Federation > Outgoing Documents kaže revizije in oddaljena potrdila. Federation: dispatch document snapshots je privzeto aktiven, teče vsako minuto in odpremlja samo izrecno pripravljene dokumente po preverjanju povezave, poti, pošiljatelja in zunanjega okolja. Je ločen od privzeto neaktivnega razporeda računov/sporočil Transport. Negotova dostava se ponavlja z istimi bajti/UUID, po osmih poskusih zahteva pregled. Retry Delivery zahteva aktualno preverjanje; Reconcile Receipt samo pridobi stanje. Potrdila ne vsebujejo lokalnih ID-jev ali zasebne diagnostike.

Obvestila preklica

Vsaka stran upravlja naročila, prenose in računovodstvo neodvisno. Lokalni preklic/zamenjava ne zahteva obvestila, soglasja ali istega dejanja druge strani. Obvestila so izbirna, nikoli samodejna ali privzeto omogočena.

Po lokalnem preklicu že poslanega dokumenta lahko na zadnji reviziji v Federation > Outgoing Documents izberete Send Cancellation Notice, ločeno odobreno odhodno povezavo Cancellation Notices istega podjetja/para in Queue Cancellation Notice. Pošiljanje potrebuje lasten kanal; izvorni preklic ne potrebuje niti kanala niti obvestila.

Obvestilo ima lastno identiteto/operacijo ter ohrani prvotno izmenjavo, točno revizijo in povzetek. Starejša revizija, drug izvor ali spremenjene stranke ne morejo nadomestiti izvirnika. Ponovitev uporabi isto obvestilo in zgodovino. Izvor mora še obstajati in že biti preklican; pošiljanje ga ne prekliče.

Vhodno obvestilo ostane v pregledu tudi pri že uporabljenem izvirniku. Acknowledge Cancellation Notice zabeleži applied obravnavo brez izvornih sprememb. Manjkajoče odvisnosti ohranijo sklice do razrešitve. Prejemnik odloči lokalno; stanje/odobritev ne prekličeta dokumenta. Nadomestila, vračila in dobropisi so ločeni postopki. V Review Verification preverite izvirnik in izbirno nadomestilo ter potrdite obravnavo. Odhodno okno izbirno ponudi Exchanged Replacement; lokalna nadomestila ne potrebujejo federacijske identitete ali obvestila.

Prenos binarnih prilog

Končna točka sprejme samo deklarirane datoteke prvotne dnevniške operacije kanala. Ena največ 5 MiB, skupaj največ deset in 10 MiB na posnetek. Podpisi PDF/PNG/JPEG, velikosti in SHA-256 se morajo ujemati. Zamrznjeni bajti so ločeni od klepeta in nezamenljivi; preverjanje zahteva vse deklarirane datoteke.

Komercialni vhodi prilagodilnikov

pmis.federation.exchange.adapter._source_pricing izlušči cene izvornih naročil/računov in davčna dokazila. _receiver_lines pripravi vhode z odobrenimi preslikavami, nespremenjeno aktivno valuto, lokalnim fiskalnim položajem in davki. Pretvorbe skupaj prilagodijo ceno/količino. Manjkajoči izdelek/enota, nezdružljiva embalaža ali nepredstavljivi zneski ohranijo prvotno ovrednoteno vrstico brez izdelka in izrecne razloge pregleda. Kupčeva neponujena zahteva zneskov kupca ne povzdigne v merodajno ceno prodajalca.

Vmesnik pripravlja vhode; Orders upravlja osnutke, stalne nasprotne dokumente/ vrstice, pošiljanje, revizijske razlike in atomarni sprejem. Zaloga in računovodstvo dodata lastne omejene ciljne preslikave.

_source_order pripravi upravičena povpraševanja, ponudbe in potrjena naročila s stalnimi UUID-ji dokumenta/vrstic pošiljatelja. Različice, enote, kategorije enot in embalaža imajo trajne reference po operativnem podjetju. Urejanje jih ponovno uporabi, nove vrstice dobijo nove; pred dodelitvijo se preverita dostop in podjetje. Reference ostanejo nespremenljive tudi po odstranitvi izvora.

Vrstice ohranijo zaporedje; razdelki/opombe niso v začetni pogodbi. Potrebni so pozitivne količine, omejeni opisi, aktivne enote in embalaža v enoti vrstice. Prodajalec uporablja izvorni neto izračun, kupčevi zneski ostanejo dokazilo do dokazane točne ponudbe. Priprava naročila ne uvrsti ali pošlje.

Trenutne meje

Exchange zagotavlja overjeni dnevnik in trajne odhodne posnetke. Izvorni prilagodilniki upravljajo izrecno pošiljanje, ustvarjanje nasprotnih dokumentov in pregledano uporabo. Namestitev ne vzpostavi zaupanja, aktivira pošiljanja, potrdi naročil/zaloge, knjiži računovodstva ali kopira klepeta. Za izvorna naročila, povezane osnutke, ponudbene povezave in revizijski pregled namestite pmis_federation_order; zalogovni in računovodski prilagodilniki so ločeni.

Prijava napak

Napake spremljamo v sistemu prijav repozitorija PMISuite.

Zasluge

Avtorji

Sodelujoči

Matjaž Mozetič

Vzdrževalci

Trenutni vzdrževalec:

Luxim je neodvisno podjetje za raziskave, razvoj in uvajanje rešitev, usmerjeno v reševanje zahtevnih problemov v ekosistemu Odoo.

Luxim je aktiven član OCA (Odoo Community Association).