Kliendid ja otsing ametlikust äriregistrist

tax_id järgi dubleerimata lisamine või uuendamine (upsert) ja äriregistri päring (Rumeenias ANAF), et e-arvet tagasi ei lükataks.

← Tagasi API dokumentatsiooni juurde

Esimene arve 6 sammuga

POST /v1/clients loob või uuendab kliendi, dubleerimist vältides tax_id ja selle puudumisel normaliseeritud nime järgi.
GET /v1/clients loetleb kliendid väljadega limit, offset ja vabateksti q.
GET /v1/lookup/company/{tax_id} valideerib CUI Rumeenia ANAF-i registris ja tagastab ametlikud andmed.
Täida buyer otsingu tulemusega, et e-Factura ei lükataks tagasi aegunud nime või aadressi tõttu.

Kõik lõpp-punktid

Meetod	Lõpp-punkt	Scope	Idempotency-Key	Päringuid / minut
GET	/clients Loetle kliendid	clients:read	—	120
POST	/clients Loo või uuenda klient	clients:write	—	30
GET	/lookup/company/{tax_id} Valideeri CUI Rumeenia ANAF-i registri vastu	clients:read	—	120

Mis on 4invoices API

bash
# Dubleerimine on vältitud tax_id järgi, varuvariandina normaliseeritud nime järgi:
# sama kliendi uuesti saatmine UUENDAB selle, dubleerimise asemel.
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"

# Ametlikud registriandmed (Rumeenias ANAF) — täida nendega „buyer”, et
# e-Factura ei lükataks tagasi aegunud nime või aadressi tõttu.

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

Levinud vead

Kliendi salvestamine enne väljastamist pole vajalik: buyer-objekti saab saata otse POST /invoices-sse.
Rumeenia ostjate puhul peab county olema õige maakond; Bukarestis pane sektor väljale city.
tax_id aktsepteeritakse riigiprefiksiga või ilma (RO12345678 või 12345678).
Sama kliendi uuesti saatmine uuendab kirjet, nii et korduv import ei tekita dubleerimisi.

Arendajate küsimused ja vastused

Millist scope'i äriregistri otsing vajab?

clients:read. Klientide kirjutamine nõuab clients:write.

Kas ma saan importida tuhandeid kliente pärandsüsteemist?

Jah, aga arvesta 30 kirjutamist minutis grupiga. Impordi partiidena ja kasuta 429 korral backoff'i.

Mis siis, kui CUI pole registris?

Otsing tagastab 404 not_found. Võid siiski oma andmetega väljastada, aga riskid esitamisel tagasilükkamisega (Rumeenias CIUS-RO kontroll).

Vaata ka