Klientai ir paieška oficialiame įmonių registre

Įrašymas arba atnaujinimas (upsert), deduplikuotas pagal tax_id, ir įmonių registro paieška (Rumunijoje – ANAF), kad e. sąskaita faktūra nebūtų atmesta.

← Atgal į API dokumentaciją

Pirmoji sąskaita per 6 žingsnius

POST /v1/clients sukuria arba atnaujina klientą, deduplikuodamas pagal tax_id, o jo nesant — pagal normalizuotą pavadinimą.
GET /v1/clients išvardija klientus su limit, offset ir laisvo teksto paieška q.
GET /v1/lookup/company/{tax_id} patikrina CUI Rumunijos ANAF registre ir grąžina oficialius duomenis.
Užpildykite buyer paieškos rezultatu, kad e-Factura nebūtų atmesta dėl pasenusio pavadinimo ar adreso.

Visi galiniai taškai

Metodas	Galinis taškas	Scope	Idempotency-Key	Užklausų / min.
GET	/clients Išvardyti klientus	clients:read	—	120
POST	/clients Sukurti arba atnaujinti klientą	clients:write	—	30
GET	/lookup/company/{tax_id} Patikrinti CUI pagal Rumunijos ANAF registrą	clients:read	—	120

Kas yra 4invoices API

bash
# Deduplikuota pagal tax_id, o jo nesant — pagal normalizuotą pavadinimą:
# pakartotinai siunčiant tą patį klientą, jis ATNAUJINAMAS, o ne kuriamas dublikatas.
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"

# Oficialūs registro duomenys (Rumunijoje – ANAF) — įrašykite juos į „buyer”, kad
# e-Factura nebūtų atmesta dėl pasenusio pavadinimo ar adreso.

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

Dažniausios klaidos

Klientą saugoti prieš išrašant nebūtina: buyer objektą galima siųsti tiesiai POST /invoices.
Rumunijos pirkėjams county turi būti tikra apskritis; Bukarešte sektorių įrašykite lauke city.
tax_id priimamas su šalies prefiksu arba be jo (RO12345678 arba 12345678).
Pakartotinai siunčiant tą patį klientą įrašas atnaujinamas, todėl pakartotinis importas nekuria dublikatų.

Kūrėjų klausimai ir atsakymai

Kokio scope reikia įmonių registro paieškai?

clients:read. Klientų rašymui reikia clients:write.

Ar galiu importuoti tūkstančius klientų iš senos sistemos?

Taip, bet laikykitės 30 rašymų per minutę grupės. Importuokite dalimis ir taikykite backoff prie 429.

Ką daryti, jei CUI nėra registre?

Paieška grąžina 404 not_found. Vis tiek galite išrašyti su savo duomenimis, bet pateikiant rizikuojate atmetimu (Rumunijoje – CIUS-RO patikra).

Taip pat žr.