Pentru partenerii care doresc să elimine descărcarea manuală a rapoartelor și să integreze datele direct în propriile sisteme (ERP, CRM, aplicații de contabilitate), NETOPIA pune la dispoziție acces prin API Key.

Această metodă permite automatizarea completă a procesului de reconciliere financiară.

⚙️ Cum funcționează procesul de automatizare

Pentru implementare, echipa tehnică trebuie să configureze următorul flux:

1️⃣ Monitorizare

Citirea automată a e-mailului de notificare transmis de NETOPIA (care anunță generarea unui raport).

2️⃣ Extragere

Identificarea URL-ului API din corpul e-mailului.
Acesta conține ID-ul unic al raportului (reportId).

3️⃣ Solicitare (API Request)

Transmiterea unei cereri către serverele NETOPIA folosind cheia de autorizare (API Key).

4️⃣ Stocare

Salvarea fișierului primit (CSV) într-un sistem intern pentru procesare automată.

🔑 Obținerea API Key

Cheia de acces se generează direct din contul NETOPIA:

1. Accesați:
   👉 https://admin.netopia-payments.com/login
2. Faceți clic pe iconița din colțul dreapta sus (Profilul meu)
3. Selectați secțiunea Securitate
4. Generați o nouă API Key

Puteți genera mai multe chei, dacă aveți nevoie de separare pe medii sau aplicații.

💻 Exemplu de implementare tehnică (cURL)

Echipa tehnică poate utiliza următoarea structură pentru apelul API:

curl -JO --location 'https://admin.netopia-payments.com/api/report/<reportId>/download' \

--header 'Authorization: <your API KEY>'

Parametri necesari:

• <reportId> – se înlocuiește cu identificatorul unic al raportului (extras din e-mail).
• <your API KEY> – se înlocuiește cu cheia generată din contul NETOPIA.

🛡 Recomandări de securitate

API Key oferă acces la date financiare sensibile.

Pentru protecția informațiilor:

• ❗ Nu partajați cheia API cu persoane neautorizate
• ❗ Nu o salvați direct în cod sursă public
• ❗ Nu o stocați în fișiere text necriptate
• ✅ Utilizați variabile de mediu sau sisteme securizate de gestionare a secretelor

✅ Beneficiile automatizării

• Elimină descărcarea manuală a rapoartelor
• Reduce erorile umane
• Permite integrarea directă în ERP / contabilitate
• Accelerează procesul de reconciliere financiară