Stranke in preverjanje v registru podjetij

1. POST /v1/clients ustvari ali posodobi stranko, pri čemer odpravlja dvojnike po tax_id oziroma, če tega ni, po normaliziranem imenu.
2. GET /v1/clients izpiše stranke z limit, offset in prostim iskanjem q.
3. GET /v1/lookup/company/{tax_id} preveri CUI v registru ANAF (Romunija) in vrne uradne podatke.
4. Polje buyer izpolnite iz rezultata poizvedbe, da e-Factura ne bo zavrnjena zaradi zastarelega imena ali naslova.

bash
# Deduplicirano po tax_id, sicer po normaliziranem imenu:
# ponovno pošiljanje iste stranke jo POSODOBI, namesto da ustvari podvojeno.
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"

# Uradni podatki iz registra ANAF (Romunija) — uporabite jih za vnaprejšnje izpolnjevanje "buyer", da
# e-Factura ne bo zavrnjena zaradi zastarelega imena ali naslova.

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

• Za izdajo ne potrebujete shranjene stranke: objekt buyer lahko pošljete neposredno v POST /invoices.
• Za romunske kupce mora biti county dejansko okrožje; za Bukarešto vpišite sektor v city.
• tax_id je sprejet z državno predpono ali brez nje (RO12345678 ali 12345678).
• Ponovno pošiljanje iste stranke posodobi zapis, zato ponovljen uvoz ne ustvari dvojnikov.