Virheet

Tässä oppaassa käsittelemme, mitä tapahtuu, kun jotain menee pieleen API:n käytön yhteydessä. Katsotaan joitakin tilakoodi- ja virhetyyppejä, joita saatat kohdata.

Voit selvittää, oliko pyyntösi onnistunut tarkistamalla tilakoodin, kun saat API-vastauksen. Jos vastaus on epäonnistunut, voit käyttää virhetyyppiä ja virheviestiä selvittääksesi, mikä on mennyt vikaan ja tehdäksesi jonkinlaista perustavaa vianetsintää (ennen kuin otat yhteyttä tukeen).

Ennen kuin otat yhteyttä tukeemme mahdollisen ongelman kanssa, muistathan, että useimmat ilmoitetuista virheistä johtuvat käyttäjän puolelta tapahtuvista virheistä. Olisi hyvä tarkistaa koodisi huolellisesti ennen yhteydenottoa PalkkaOnline-tukeen. Kiitos ymmärryksestäsi!

Tilakoodit

Tässä on luettelo eri tilakoodien luokista, jotka PalkkaOnline API palauttaa. Käytä näitä ymmärtääksesi, onko pyyntö onnistunut.

  • Name
    2xx
    Description

    2xx tilakoodi osoittaa vastauksen onnistuneen.

  • Name
    4xx
    Description

    4xx tilakoodi osoittaa käyttäjävirhettä – tämä tarkoittaa, että kyseessä on sinä ongelma

  • Name
    5xx
    Description

    5xx tilakoodi osoittaa palvelinvirhettä – näitä toivottavasti et tule näkemään.

Virheet

Aina kun pyyntö epäonnistuu, PalkkaOnline API palauttaa vastauksessa viestin. Voit käyttää tätä tietoa ymmärtääksesi paremmin, mikä on mennyt pieleen ja miten se korjataan. Useimmat virhesanomat ovat melko itsestäänselviä ja hyödyllyisiä.

Tässä on luettelo mahdollisista virheviesteistä, joita PalkkaOnline API tukee — käytä näitä ymmärtääksesi, mitä olet tehnyt väärin.

Yleiset virheet

Tapahtuu tunnistautumisvaiheessa

  • Name
    Tunnisteet väärin
    Description

    Tarkista, että Api-Key ja/tai Api-Secret on syötetty oikein.

  • Name
    Tunnisteet puuttuu
    Description

    Tarkista, että Api-Key, Api-Secret ja Api-Identifier on annettu.

  • Name
    Tunniste väärin
    Description

    Api-Identifier ei täsmää tietoihin

Laskut virheet

  • Name
    Tietojen tarkastus epäonnistui
    Description

    Tuodut tiedot eivät läpäisseet tarkastusta. Katso Errors-kohdasta lisätietoja.

  • Name
    Laskun luonti epäonnistui
    Description

    Jokin meni pieleen laskun luontivaiheessa. Ongelma voi olla meidän palvelimessa. Kokeile uudestaan

  • Name
    Laskurivin luonti epäonnistui
    Description

    Jokin meni pieleen laskurivien luonnissa/laskennassa. Ongelma voi olla meidän palvelimessa. Tarkasta laskurivit ja kokeile uudestaan

Kevytyrittäjä virheet

  • Name
    Sähköposti on jo käytössä
    Description

    Tällä sähköpostiosoitteella on jo kevytyrittäjä

  • Name
    Puhelinnumero on jo käytössä
    Description

    Tällä puhelinnumerolla on jo kevytyrittäjä

  • Name
    Käyttäjän luonti epäonnistui
    Description

    Jokin meni pieleen kevytyrittäjän luonnissa. Ongelma voi olla meidän palvelimessa. Tarkasta tiedot ja yritä uudelleen.

Epäonnistunut vastaus

{
  "status": "failed",
  "message": "Sähköposti on jo käytössä.",
}