enetlvfiplru

Tietomuodot ja määritykset

Palautustyypit

Kaikki arvot palautetaan merkkijonoina. Katso kaikki avain–arvo-parit dokumentaatiostamme. Vieritä sivun alaosaan ja valitse DocumentResponse:

https://digi.costpocket.com/docs/

Esimerkki-JSON

Huomioithan, että seuraava data on keksittyä eikä sitä ole käyty läpi robon suorittaman varsinaisen validoinnin kautta.

Kenttien selitykset

Kenttiä voidaan muokata itsepalveluportaalissa osoitteessa https://digi.costpocket.com/portal/#/login

Useimmissa tapauksissa robotti validoi kaikki kentät useilla tarkistuksilla ja eri alijärjestelmillä (tekoäly, koneoppiminen, tietokannat, kielikokoelmat). Yleensä jälkikäsittelyä ei tarvita.

Alla on vinkkejä siihen, miten arvojen jäsentäminen on mahdollisimman tehokasta.

Toimittaja (Supplier)

  • Toimittaja palautetaan listana kaikista asiakirjasta löydetyistä yrityksistä
  • Lista voi sisältää myös vastaanottajan, pankkeja, tuomioistuimia jne.
  • Varsinainen toimittaja on listan ensimmäinen yritys
  • Varsinainen vastaanottaja on yleensä listan toinen yritys
  • Virheiden vähentämiseksi suosittelemme suodattamaan oman yrityksenne pois listasta ja ottamaan sen jälkeen ensimmäisen yrityksen
  • Yritystiedot validoidaan maan omista yritysrekistereistä tai EU-tietokannoista

Loppusumma (Grand total)

  • Poimitaan suoraan asiakirjasta (ei laskennallisesti)

ALV-rivit (VAT rows)

  • Mikäli mahdollista, arvot otetaan suoraan asiakirjasta
  • Puuttuvat arvot lasketaan robotin toimesta ja validoidaan asiakirjalla olevien lukujen sekä loppusumman perusteella

Rivit (Item lines)

  • Rivien summa vastaa aina asiakirjan loppusummaa
  • Tarvittaessa robotti voi lisätä alennuksen tai luoda rivin ilman kuvausta
    • Tämä lisätään viimeiseksi riviksi ja merkitään isDiscount = "true"
  • Robotin tuottamia arvoja ei yleensä ole tarpeen laskea uudelleen, sillä robotti on laskennassaan erittäin tarkka
  • Robotin itse laskemat kentät pyöristetään neljään desimaaliin
    • Saatat joutua pyöristämään arvot itse käyttötarkoituksesi mukaan
  • Kuten ALV-riveissä, puuttuvat arvot lasketaan ja validoidaan loppusumman ja ALV-rivien avulla
  • "SumNoDiscount" palautetaan vain, jos se on suurempi kuin "Sum"

Rivien pyöristys (Lines Rounding)

  • Yritykset voivat laskea laskurivit eri tavoin
    • Jotkut summaavat ensin rivit ja lisäävät ALV:n nettoyhteissummaan
    • Toiset lisäävät ALV:n jokaiselle riville ja summaavat sen jälkeen
  • Tämän huomioimiseksi robotti palauttaa myös linesRounding-kentän
  • linesRounding on erotus loppusumman ja rivien summan välillä

Käteisen pyöristys (Cash Rounding)

  • Suomessa käteismaksut pyöristetään lähimpään viiteen senttiin lain perusteella
  • cashRounding kuvaa tätä pyöristystä (−0,01, −0,02, 0,01 tai 0,02)

Yksinkertainen kaava: cashRounding = pyöristetty (todellinen) summa − loppusumma

Tunnisteet (ID:t: asiakirjan numero, tilausnumero jne.)

  • Puhdistettu tarpeettomista merkeistä
  • Trimmattu
  • Etuliitteet lisätty numeroihin

Pankkitilit

  • Robotti noudattaa virallisia pankkitilimuotoja
  • Kaikki asiakirjalta tunnistetut pankkitilit palautetaan listana

Asiakirjan tyyppi (Document type)

  • Joko "RECEIPT" tai "INVOICE"

Asiakirjan suunta (Document direction)

  • Joko "DEBIT" tai "CREDIT"

Maakoodi (Country code)

  • Kaksikirjaiminen ISO-koodi