Klienti un meklēšana oficiālajā uzņēmumu reģistrā

Dedublēta izveide vai atjaunināšana (upsert) pēc tax_id un uzņēmumu reģistra meklēšana (Rumānijā – ANAF), lai e-rēķins netiktu noraidīts.

← Atpakaļ uz API dokumentāciju

Pirmais rēķins 6 soļos

POST /v1/clients izveido vai atjaunina klientu, dedublējot pēc tax_id, bet, ja tā nav — pēc normalizēta nosaukuma.
GET /v1/clients uzskaita klientus ar limit, offset un brīvā teksta meklēšanu q.
GET /v1/lookup/company/{tax_id} pārbauda CUI Rumānijas ANAF reģistrā un atgriež oficiālos datus.
Aizpildiet buyer ar meklēšanas rezultātu, lai e-Factura netiktu noraidīta novecojuša nosaukuma vai adreses dēļ.

Visi galapunkti

Metode	Galapunkts	Scope	Idempotency-Key	Pieprasījumi / minūtē
GET	/clients Uzskaitīt klientus	clients:read	—	120
POST	/clients Izveidot vai atjaunināt klientu	clients:write	—	30
GET	/lookup/company/{tax_id} Pārbaudīt CUI pret Rumānijas ANAF reģistru	clients:read	—	120

Kas ir 4invoices API

bash
# Dedublēts pēc tax_id, bet, ja tā nav, pēc normalizēta nosaukuma:
# atkārtoti nosūtot to pašu klientu, tas tiek ATJAUNINĀTS, nevis izveidots dublikāts.
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"

# Oficiālie reģistra dati (Rumānijā – ANAF) — izmantojiet tos, lai aizpildītu „buyer”, lai
# e-Factura netiktu noraidīta novecojuša nosaukuma vai adreses dēļ.

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

Biežākās kļūdas

Klients nav jāsaglabā pirms izrakstīšanas: buyer objektu var nosūtīt tieši POST /invoices.
Rumānijas pircējiem county jābūt pareizam apgabalam; Bukarestei sektoru ierakstiet laukā city.
tax_id tiek pieņemts ar valsts prefiksu vai bez tā (RO12345678 vai 12345678).
Atkārtoti nosūtot to pašu klientu, ieraksts tiek atjaunināts, tātad atkārtots imports nerada dublikātus.

Izstrādātāju jautājumi un atbildes

Kāds scope nepieciešams uzņēmumu reģistra meklēšanai?

clients:read. Klientu rakstīšanai nepieciešams clients:write.

Vai varu importēt tūkstošiem klientu no vecas sistēmas?

Jā, bet ievērojiet 30 rakstīšanas minūtē grupu. Importējiet partijās un pie 429 izmantojiet backoff.

Ko darīt, ja CUI nav reģistrā?

Meklēšana atgriež 404 not_found. Varat izrakstīt ar saviem datiem, bet iesniegšanas brīdī riskējat ar noraidījumu (Rumānijā – CIUS-RO pārbaude).

Skatīt arī