Πελάτες και αναζήτηση στο μητρώο επιχειρήσεων

1. Το POST /v1/clients δημιουργεί ή ενημερώνει έναν πελάτη, με αφαίρεση διπλοτύπων βάσει tax_id και, αν αυτό λείπει, βάσει του κανονικοποιημένου ονόματος.
2. Το GET /v1/clients απαριθμεί τους πελάτες με όριο, offset και ελεύθερο κείμενο q.
3. Το GET /v1/lookup/company/{tax_id} επαληθεύει ένα CUI στο μητρώο της ANAF (Ρουμανία) και επιστρέφει τα επίσημα στοιχεία.
4. Προσυμπληρώστε το αγοραστής από το αποτέλεσμα της αναζήτησης, ώστε το e-Factura να μην απορριφθεί λόγω παλιού ονόματος ή διεύθυνσης.

bash
# Αποδυναμοποίηση διπλοτύπων με βάση το tax_id, ή ελλείψει του κανονικοποιημένο όνομα:
# η εκ νέου αποστολή του ίδιου πελάτη τον ΕΝΗΜΕΡΩΝΕΙ αντί να δημιουργεί διπλότυπο.
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"

# Επίσημα στοιχεία από το μητρώο της ANAF (Ρουμανία) — χρησιμοποιήστε τα για να συμπληρώσετε εκ των προτέρων το "buyer", ώστε
# το e-Factura να μην απορριφθεί λόγω παλιού ονόματος ή διεύθυνσης.

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

• Δεν χρειάζεστε αποθηκευμένο πελάτη για να εκδώσετε: το αντικείμενο αγοραστής μπορεί να σταλεί απευθείας στο POST /invoices.
• Για Ρουμάνους αγοραστές, το county πρέπει να είναι ο πραγματικός νομός· για το Βουκουρέστι βάλτε τον τομέα στο πόλη.
• Το tax_id γίνεται δεκτό με ή χωρίς το πρόθεμα χώρας (RO12345678 ή 12345678).
• Η επαναποστολή του ίδιου πελάτη ενημερώνει την εγγραφή, οπότε μια επαναλαμβανόμενη εισαγωγή δεν δημιουργεί διπλότυπα.