Muutokset päivitetään API-dokumentaatioon

Lista versiopäivityksistä:

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:


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.