Tiedon elinkaari ja taloushallintokäyttö¶
MCP palauttaa kaluston kirjattuja tietoja. Vastaanottavan integraation vastuulla on päättää, mitkä tietueet ja määrät voidaan siirtää toiseen liiketoimintajärjestelmään.
Erota kolme kilometrimäärää¶
- Kirjattu ajomatka: ajopäiväkirjaan tallennettu arvo.
- Korvattava matka: työntekijälle maksettavaksi hyväksytty kilometrimäärä.
- Laskutettava matka: asiakkaan työmääräykselle tai laskulle hyväksytty kilometrimäärä.
Määrät voivat poiketa toisistaan. API ei johda kahta jälkimmäistä ensimmäisestä, valitse palkkalajeja, päätä auton omistukseen perustuvia korvaussääntöjä tai luo laskutusrivejä.
Valmius ja hyväksyntä¶
Tallennettu rivi tai päättymisaika ei osoita esihenkilön tarkastusta. Tässä versiossa ei ole API:n hyväksyntätilaa tai hyväksyntätapahtumaa. Järjestä ennen palkka- tai laskutussiirtoa erillinen, jälkikäteen todennettava hyväksyntä.
work_id on vapaa tekstiviite. Varmista, että se osoittaa oikeaan kohdejärjestelmän työmääräykseen. Usean työkohteen päivä voi edellyttää erikseen tarkastettuja kohdistuksia; niitä ei voi päätellä pelkästä päiväsummasta.
Lähdetunniste ja kaksoissiirron esto¶
Käytä lähdetietueen tunnisteena yhdistelmää (ympäristö, fleet_id, resurssityyppi, id). Tallenna kohdejärjestelmän riviviite, hyväksytyt lähdearvot, siirron käyttötarkoitus ja tulos.
Osoite, ajankohta, kuljettajan nimi tai ajomatka ei ole yksilöllinen siirtoavain. JSON-RPC-pyynnön id yhdistää vain pyynnön vastaukseen; se ei ole liiketoimintatapahtuman tunniste.
Jos kirjoitus kohdejärjestelmään aikakatkeaa, selvitä ennen uusintaa, tallentuiko se jo. Käytä kohteen idempotenssiavainta tai hakumekanismia, jos sellainen on saatavilla. Saman lähdeajon uudelleenlukeminen ei saa automaattisesti luoda toista palkka- tai laskutusriviä.
Korjaukset ja poistot¶
Tämä versio ei tarjoa muokkausaikaleimaan perustuvaa hakua, kasvavaa muutosversiota, poistomerkintöjä, muutossyötettä tai webhookeja. Tietueen id säilyy tavallisessa muokkauksessa eikä ole versionumero.
Sovitun avoimen kauden toistuva haku voi auttaa täsmäytyksessä, mutta se ei takaa jokaisen vanhan muutoksen tai poiston havaitsemista. Rivi voi siirtyä haetun aikavälin ulkopuolelle tai jäädä pois oikeus-/yksityisyysmuutoksen vuoksi. Älä poista taloushallinnon kirjauksia automaattisesti vain siksi, ettei riviä enää näy haussa.
Ensimmäiseen integraatioon sopii erikseen hyväksytty vientikausi tai aineistoerä ja dokumentoitu jälkikorjausten käsittely. Jos tarvitaan jatkuva ja aukoton muutossynkronointi, sovi ominaisuudesta Ewooksin kanssa ennen tuotantokäyttöä.
Kohdejärjestelmän liitäntä¶
API on riippumaton vastaanottavasta järjestelmästä. Integraation toteuttaja järjestää kohteen kirjoitusrajapinnan, tunnistekohdistukset, palkka-/laskutuslajit ja korjaussäännöt. Nämä ohjeet eivät tarkoita valmista Ultima-, Ecom- tai muuta taloushallintoliitäntää.