Muutokset päivitetään API-dokumentaatioon
Lista versiopäivityksistä:
Versiopäivitys 18.6.2024 Päivitetty 25.5% alv:n muutokset
Haluatko saada versiotiedotteet jatkossa sähköpostilla? Tilaa versiotiedotteet alta:
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.
Verkkolaskuoperaattori -listaan lisätty Posti Messaging Oy:n uusi tunnus, FI28768767
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.