Ilman aktiivista verotuksellista sarjaa (fiscale) laskutus palauttaa 409 no_series_configured.
← Takaisin API-dokumentaatioon
Ensimmäinen lasku 6 vaiheessa
- GET /v1/series listaa tenantille määritetyt numerosarjat.
- Laskutus vaatii vähintään yhden AKTIIVISEN sarjan, jonka tyyppi on fiscale.
- Ilman sitä POST /v1/invoices palauttaa 409 no_series_configured.
- Sarjat luodaan ja aktivoidaan paneelissa, ei API:n kautta.
Kaikki päätepisteet
| Metodi | Päätepiste | Scope | Idempotency-Key | Pyyntöjä / minuutti |
|---|---|---|---|---|
| GET | /series Listaa numerosarjat | invoices:read | — | 120 |
Mitä 4invoices-API on
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Vähintään yhden AKTIIVISEN sarjan tyypiltä ”fiscale” on oltava olemassa, muuten
# POST /invoices palauttaa 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Virheet
| Tila | Tyyppi | Koodi |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Yleiset virheet
- POST /v1/invoices -vastaus sisältää series- ja number-kentät — kirjaa molemmat täsmäytystä varten.
- Hyvitys kuluttaa uuden numeron sarjasta; alkuperäisen laskun numeroa ei koskaan käytetä uudelleen.
- Proformat käyttävät verotuksellisesta sarjasta erillistä numerointia, joten ne eivät kuluta verotuksellisia numeroita.
- Älä oleta numeron muotoa: käsittele number läpinäkymättömänä merkkijonona, et kokonaislukuna.
Kehittäjien kysymykset ja vastaukset
Voinko luoda sarjan API:n kautta?
Ei. API lukee vain sarjat. Niiden luonti ja aktivointi tapahtuu paneelissa, koska verotuksellinen numerointi on vaatimustenmukaisuuspäätös.
Mitä jos minulla on useita aktiivisia sarjoja?
Käytetään paneelissa määritettyä oletussarjaa. Laskutus ei valitse itse epäselvien sarjojen välillä.
Miksi no_series_configured on 409 eikä 422?
Kyse on tilan ristiriidasta tililläsi, ei lähettämäsi datan virheestä. Pyyntösi on kelvollinen; konfiguraatio puuttuu.