Asiakkaat ja haku virallisesta yritysrekisteristä

tax_id:llä deduplikoitu lisäys tai päivitys (upsert) sekä yritysrekisterihaku (Romaniassa ANAF), jotta sähkölaskua ei hylätä.

← Takaisin API-dokumentaatioon

Ensimmäinen lasku 6 vaiheessa

POST /v1/clients luo tai päivittää asiakkaan; deduplikointi tehdään tax_id:n ja sen puuttuessa normalisoidun nimen perusteella.
GET /v1/clients listaa asiakkaat kentillä limit, offset ja vapaatekstihaku q.
GET /v1/lookup/company/{tax_id} validoi CUI-tunnuksen Romanian ANAF-rekisteristä ja palauttaa viralliset tiedot.
Täytä buyer lookup-tuloksella, jotta e-Factura ei hylätä vanhentuneen nimen tai osoitteen vuoksi.

Kaikki päätepisteet

Metodi	Päätepiste	Scope	Idempotency-Key	Pyyntöjä / minuutti
GET	/clients Listaa asiakkaat	clients:read	—	120
POST	/clients Luo tai päivitä asiakas	clients:write	—	30
GET	/lookup/company/{tax_id} Validoi CUI Romanian ANAF-rekisteriä vasten	clients:read	—	120

Mitä 4invoices-API on

bash
# Deduplikoitu tax_id:n mukaan, varalla normalisoidun nimen mukaan:
# saman asiakkaan uudelleenlähetys PÄIVITTÄÄ sen kaksoiskappaleen luomisen sijaan.
curl -sS -X POST https://api.4invoices.net/v1/clients \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Exemplu Comert SRL",
    "tax_id": "RO12345678",
    "email": "[email protected]",
    "country": "RO",
    "county": "Cluj",
    "city": "Cluj-Napoca",
    "address": "Str. Fabricii 12",
    "iban": "RO49AAAA1B31007593840000"
  }'

bash
curl -sS https://api.4invoices.net/v1/lookup/company/RO12345678 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Viralliset rekisteritiedot (Romaniassa ANAF) — täytä niillä ”buyer”, jotta
# e-Factura ei hylätä vanhentuneen nimen tai osoitteen vuoksi.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Yleiset virheet

Asiakasta ei tarvitse tallentaa ennen laskutusta: buyer-objekti voidaan lähettää suoraan POST /invoices -kutsussa.
Romanialaisille ostajille county on oltava oikea lääni; Bukarestille sektori laitetaan kenttään city.
tax_id hyväksytään maakoodin kanssa tai ilman (RO12345678 tai 12345678).
Saman asiakkaan uudelleenlähetys päivittää tietueen, joten toistuva tuonti ei luo kaksoiskappaleita.

Kehittäjien kysymykset ja vastaukset

Mitä scopea yritysrekisterihaku vaatii?

clients:read. Asiakkaiden kirjoittaminen vaatii clients:write.

Voinko tuoda tuhansia asiakkaita vanhasta järjestelmästä?

Kyllä, mutta noudata 30 kirjoitusta minuutissa -ryhmää. Tuo erissä ja käytä backoffia 429-vastauksissa.

Mitä jos CUI ei ole rekisterissä?

Haku palauttaa 404 not_found. Voit silti laskuttaa omilla tiedoillasi, mutta silloin riskinä on hylkäys lähetyksessä (Romaniassa CIUS-RO-tarkistus).

Katso myös