Viðskiptavinir og uppflettingar í opinberri fyrirtækjaskrá

Innsetning eða uppfærsla afritahreinsuð eftir tax_id, ásamt uppflettingu í opinberri skrá (í Rúmeníu: ANAF) svo rafrænum reikningi sé ekki hafnað.

← Til baka í API-skjölin

Fyrsti reikningurinn þinn í 6 skrefum

POST /v1/clients býr til eða uppfærir viðskiptavin, afritahreinsað eftir tax_id og, ef það dugar ekki, eftir normaliseruðu nafni.
GET /v1/clients listar viðskiptavini með limit, offset og frjálsum leitartexta q.
GET /v1/lookup/company/{tax_id} staðfestir skattnúmer gegn opinberri fyrirtækjaskrá (í Rúmeníu: CUI hjá ANAF) og skilar opinberu gögnunum.
Forfylltu buyer út frá uppflettingunni svo e-Factura sé ekki hafnað vegna úrelts nafns eða heimilisfangs.

Allir endapunktar

Aðferð	Endapunktur	Scope	Idempotency-Key	Beiðnir / mínútu
GET	/clients Lista viðskiptavini	clients:read	—	120
POST	/clients Búa til eða uppfæra viðskiptavin	clients:write	—	30
GET	/lookup/company/{tax_id} Staðfesta skattnúmer gegn opinberri skrá (í Rúmeníu: ANAF)	clients:read	—	120

Hvað eru forritaskil 4invoices

bash
# Afritahreinsað eftir tax_id, og ef það dugar ekki eftir normaliseruðu nafni:
# að senda sama viðskiptavin aftur UPPFÆRIR hann í stað þess að búa til afrit.
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"

# Opinber gögn úr fyrirtækjaskrá (í Rúmeníu: ANAF) — notaðu þau til að forfylla "buyer" svo
# e-Factura sé ekki hafnað vegna úrelts nafns eða heimilisfangs.

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

Algeng mistök

Þú þarft ekki vistaðan viðskiptavin til að gefa út: buyer-hlutinn má senda beint með POST /invoices.
Fyrir rúmenska kaupendur þarf county að vera rétt sýsla; fyrir Búkarest settu hverfið í city.
tax_id er tekið með eða án landsforskeytis (RO12345678 eða 12345678).
Ef sami viðskiptavinur er sendur aftur uppfærist færslan, þannig að endurtekinn innflutningur býr ekki til afrit.

Spurningar og svör fyrir þróendur

Hvaða heimild þarf uppflettingin í skránni?

clients:read. Að skrifa viðskiptavini krefst clients:write.

Get ég flutt inn þúsundir viðskiptavina úr eldra kerfi?

Já, en virtu skrifafötuna sem er 30 á mínútu. Fluttu inn í lotum með bið (backoff) við 429.

Hvað ef skattnúmerið er ekki í skránni?

Uppflettingin skilar 404 not_found. Þú getur samt gefið út með þínum eigin gögnum, en þá áttu á hættu höfnun við sendingu.

Sjá einnig