Muutokset päivitetään API-dokumentaatioon

Lista versiopäivityksistä:

Versiopäivitys 4.12.2024

Versiopäivitys 6.11.2024

Muutos 2.10 versiopäivityksen myyntilaskun luonti (sales_api/add) shipping_elementtien tarkistukseen

Versiopäivitys 2.10.2024

Versiopäivitys 4.9.2024

Versiopäivitys 8.8.2024

Versiopäivitys 18.6.2024 Päivitetty 25.5% alv:n muutokset

Versiopäivitys 5.6.2024

Versiopäivitys 7.5.2024

Versiopäivitys 3.4.2024

Versiopäivitys 6.3.2024

Versiopäivitys 7.2.2024

Versiopäivitys 10.1.2024


Haluatko saada versiotiedotteet jatkossa sähköpostilla? Tilaa versiotiedotteet alta:

Joulukuu 2024 -versiopäivitys 4.12.2024
  • POST /sales_api/do/approve kutsuun on tehty tarkistus että tuoteriveillä oleva liikevaihdon tili pitää olla aktiivinen
Marraskuu 2024 -versiopäivitys 6.11.2024
  • GET /purchases_api/get/approval_queue Parametri modifiedAfter on korjattu toimimaan oikein. Mikäli modifiedAfter -parametria käytetään, se lisätään muihin hakuehtoihin eikä se korvaa niitä. 
  • Parametri modifiedAfter on muutettu tyypiksi datetime. Jatkossa voi päivämäärän lisäksi laittaa myös tarkan kellonajan. 
  • GET/sales_api/get/pdf/<id> Noudetaan myyntilaskun kuva ID:n perusteella. Myyntilaskun kuvaksi noudetaan myyntilaskun ensimmäinen lähetetty pdf. Jos lähetyksiä ei ole, niin noudetaan sama kuva kuin käyttöliittymän esikatselussa. 
  • POST /sales_api/add Tuotteen nimi päivittyy/perustuu laskun kielen (locale) mukaan. Mikäli tietoa ei tule postauksessa, locale:n oletuksena on fi. 
  • POST /sales_api/add Elementin notes_fixed_width voi tuoda taulukkona tai yksittäisenä kenttänä. Taulukon elementin toistuvuudelle ei ole rajoitetta. Yhteenlaskettu merkkimäärä voi olla 8000 merkkiä. Yli 8000 merkin ylittänyttä osaa ei huomioida, ylimenevä osaa ei kirjoiteta. 

Muutos 2.10 versiopäivityksen myyntilaskun luonti (sales_api/add) shipping_elementtien tarkistukseen

Versiopäivityksessä estettiin puutteellisten toimitusosoitetietojen tuominen laskun luonnissa (sales_api/add)
Toiminto estettiin, koska käyttöliittymässä toimitusosoitteen nimi, osoite, postinumero ja postitoimipaikka tulee olla annettuna laskua luodessa.
Mikäli näitä ei ole annettu, herjaa laskun muokkaaminen /hyväksyminen puuttuvista toimitusosoitetiedoista käyttöliittymässä sekä rajapinnassa sales_api/do/approve .

shipping_elementtien tarkistus on nyt vedetty pois, mutta tarkistus tullaan asettamaan uudelleen päälle ensikuun versiojulkaisussa (6.11.)

Mikäli tuotte laskun luonnissa (sales_api/add) toimitusosoitteita, teettehän tarkistuksen että kaikki vaadittavat tiedot tuodaan:

*shipping_name
*shipping_address
*shipping_postalcode
*shipping_city

shipping_country ei tule olemaan pakollinen, mutta se ei saa olla tyhjä.

Mikäli shipping_country tuodaan, tulee käyttää ISO 3166-1 maakoodeja.

Toimitusosoitetiedot eivät tallennu asiakaskortille laskun luonnissa (sales_api/add) vaan ovat laskukohtaisia tietoja.

Lokakuu 2024 -versiopäivitys 2.10.2024
  • Myyntilaskujen tuonnissa (POST sales_api/add) ei sallita laskujen lisäämistä poistetulle asiakkaalle. Aiemmin järjestelmä on luonut uuden asiakkaan poistetun rinnalle, mutta nyt tästä annetaan virheilmoitus.
  • Myyntilaskujen tuonnissa (POST sales_api/add) lisätty vaatimus kaikkien toimitusosoitetietojen täyttämiseksi mikäli yksikin niistä on annettu. Sama vaatimus on ollut käyttöliittymässä ja lisättiin nyt myös rajapintaan. 
  • Myyntilaskujen hakuun (GET sales_api) lisätty tieto laskuriveillä olevien tuotteiden mahdollisista tuoteryhmistä.

Korjattu uuden laskun tuonnissa (POST sales_api/add) asiakkaan maa ei tallentunut asiakaskortille


Syyskuu 2024 -versiopäivitys 4.9.2024
  • Asiakkaiden tuonti (POST customers_api/add) -toiminnossa verkkolaskuoperaattorin tiedon voi tuoda verkkolaskuosoitteen avulla. Aiemmin tieto tuotiin Fennoan sisäisellä tunnisteella.
  • Myyntilaskujen tuontiin (POST sales_api/add) on lisätty tarkistuksia alv-kannan muutokseen liittyen. Virheellisiä alv-kantoja (vatpercent) tai -käsittelyjä (sales_invoice_taxclass_id) ei hyväksytä, ja rajapinta antaa näistä virheilmoituksen. 
  • Myyntilaskun tuonnissa (POST sales_api/add) sallitaan alv-kannan (vatpercent) desimaalierottimena myös pilkku, joka muunnetaan automaattisesti pisteeksi.
  • Tositteen tuonnissa (POST accounting_api/ add) alv-koodin tunnisteena (vatcode) hyväksytään vain Fennoassa tuetut tunnisteet. Rajapinta antaa virheilmoituksen virheellisistä tunnisteista.
Elokuu 2024 -versiopäivitys 8.8.2024
  • Myyntilaskun lähettämisen (POST /sales_api/do/send) yhteydessä on mahdollista antaa lähetystapa- ja osoite
    • delivery_method
    • address
    • postalcode
    • city
    • country
    • einvoice_address
    • einvoice_operator_address
  • Lisätty uusi API-kutsu myyntilaskujen lähetysvirheiden tarkastamiseksi ja noutamiseksi (GET /sales_api/get/delivery_errors).

Vastaus:

”SalesInvoiceDelivery”:

”sales_invoice_id”: ”1081”,

”invoice_no”: ”10677”,

”queued”: ”2024-08-07 13:45:00”,

”sent_message”: ”Receiver not found” 

  • Kirjanpidon tositteiden luonnissa (POST /accounting_api/add) estetty negatiivisten lukujen syöttäminen. Käyttöliittymässä negatiivinen arvo esim. debit-kentässä siirtyy automaatisesti kredit:n puolelle,  API:ssa arvot tulee antaa aina oikealle puolelle positiivisina arvoina.
  • Asiakkaan muokkaaminen (PUT /customer_api/) on mahdollista tehdä nyt vain muuttuvien kenttien osalta, aiemmin kaikki asiakkaan tiedot tuli antaa. Jos poistat kentän arvon, palautuu vastauksessa tyhjä merkkijono ”” eikä ”null” arvoa.

Kesäkuu 2024 /2. -versiopäivitys 18.6.2024

Versiopäivityksessä julkaistiin tuki 1.9.2024 voimaan astuvan alv-muutoksen käsittelyyn API – rajapinnassa

Myyntilaskut

Käytettävä veroprosentti annetaan laskurivikohtaisesti elementissä row[x][vatpercent]

Sallitut veroprosentit ovat 0, 10, 14, 24, 25.5 (desimaalierottimena piste)

Myyntilaskun verokäsittelyn koodit pysyvät ennallaan

1= Domestic sales (S) Default
2=EU-sales services (K)
3=EU-sales goods (K)
4=Construction services (AE)
5=Scrap metal sales (AE)
6=Foreign sales, outside of EU (G)
7=Domestic sales VAT-free (Z)
8=Triangulation (K)

Kirjanpito ja ostolaskut

Voit tarkistaa käytössä olevat alv-koodit API-kutsulla GET /accounting_api/get/vatcodes

  • Tositteen lisääminen (POST /accounting_api/add) tuki 25,5% alv-koodeille
  • Pääkirjan sekä tilikartan hakuun (GET /accounting_api/get/ledger) tuki 25,5% alv-koodeille
  • Ostolaskujen merkintöjen asettaminen (POST /purchases_api/do/set_tags) tuki 25,5% -alv-koodeille
Kesäkuu 2024 – versiopäivitys 5.6.2024
  • Myyntilaskujen suorituksen luontiin (POST /sales_api/add/payment) on lisätty tarkistus ja esto ylisuorituksille. 

Toukokuu 2024 – versiopäivitys 7.5.2024
  • Asiakkaan tietojen lisäämiseen ja muokkaamiseen (POST/PUT customer_api) asiakkaan oletusarvoinen laskulomakkeen kieli tukemaan id:n lisäksi ISO 639-1 mukaisia kielikoodeja 
  • Tiliöimättömien ostolaskujen hakuun (GET purchases_api/get/unbooked) lisätty mahdollisuus rajata hakutuloksia muutospäivän perusteella 

Huhtikuu 2024 – versiopäivitys 3.4.2024
  • Myyntilaskun maksusuorituksen lisäämiseen (POST /sales_api/add/payment) on asetettu raja kahdelle (2) desimaalille. Mikäli API-rajapinnalle lähetettävä maksu sisältää enemmän kuin kaksi desimaalia, rajapinta vastaa virheellä eikä suoritusta tallenneta. 

Maaliskuu 2024 – versiopäivitys 6.3.2024
  • Merkinnät-API: purchases/do/set_tags/<purchase_invoice_<id> Virheenkäsittelyä on parannettu. 
  • Suorituksen lisäys myyntilaskulle-API: POST /sales_api/add/payment Virheenkäsittelyä parannettu tilanteissa joissa kaudet ei ole avoinna tai ei ole perustettu tilikautta. 
  • Myyntilaskun lisäys API POST /sales_api/add-kutsun asetuksia on parannettu. API-kutsun asetuksiin on lisätty mahdollisuus estää tuotteennimen päivittyminen tuoterekisteriin tuotavien laskujen perusteella. Integraatioasetukset on vain Fennoan tuen käytössä ja niillä voidaan ohjata rajapintojen käyttäytymistä asiakaskohtaisesti. 

Helmikuu 2024 – versiopäivitys 7.2.2024
  • Toimittajien haku (GET /purchases_api/get/suppliers) palauttaa maakoodin, pankin maakoodin sekä valuutan standardien mukaisilla koodeilla. Aiemmin ko. tiedot ovat palautettu vain Fennoan sisäisillä tunnisteilla.

Tammikuu 2024 – versiopäivitys 10.1.2024
  • Ostojen API:n vastauksiin on lisätty aikaleima (modified) viimeisimmästä muokkauksen ajankohdasta seuraaviin kutsuihin:
    • GET /purchases_api/<id>
    • GET Purchases_api/ unbooked
  • Ostojen API:n vastaukseen on lisätty hyväksynnän tiedot GET /purchases_api/{id} -kutsuun.
  • Myyntien API:n vastaukseen on lisätty valuuttakurssi- sekä asiakasnumero-tiedot GET sales_api/{id} -kutsuun.