Creează feed-uri de facturi
Un feed de facturi este o adresă de la care un sistem extern poate prelua repetat datele emise prin instanța Facturier selectată, adică prin configurația aplicației folosită pentru firma emitentă. Poți exporta câte un rând pentru fiecare factură sau câte un rând pentru fiecare produs facturat.
Fiecare feed aparține unei singure instanțe Facturier și nu combină documente emise prin firme diferite.
Folosește un feed când contabilul sau o integrare trebuie să preia periodic documentele. Pentru o descărcare punctuală, folosește acțiunile de export din lista Facturi, fără să păstrezi o adresă externă activă.
Pentru primul test, selectează o singură instanță, o perioadă scurtă și numai câmpurile necesare. Protejează accesul, descarcă toate paginile dintr-un mediu autorizat și extinde selecția numai după confirmarea contabilului sau a persoanei care administrează sistemul extern.
Alege structura potrivită
| Ce trebuie să preia sistemul | Alege |
|---|---|
| Totaluri, client, adresă, dată și serie la nivel de document | Feed de facturi |
| Câte un rând pentru fiecare produs facturat | Feed de produse facturate |
Alege structura la creare. Ea nu se schimbă ulterior; dacă sistemul extern are nevoie de cealaltă structură, duplică feedul sau creează unul nou cu tipul potrivit.
Creează feedul
- Accesează Comenzi, apoi deschide Facturi sau Facturi (numele instanței) pentru firma corectă.
- Apasă Feed-uri de facturi.
- Apasă Adauga feed și alege Feed de facturi sau Feed de produse facturate.
- Completează Referinta interna și alege formatul: CSV, TXT, Excel sau Twig.
- Pentru CSV, TXT sau Excel, selectează câmpurile și ordinea coloanelor; ajustează anteturile și separatorii dacă sistemul destinatar cere alt format.
- Filtrează opțional după seria facturii, status și perioada emiterii.
- Alege numărul de înregistrări pe pagină, sortarea, statusul și regulile de acces.
- Apasă Salveaza.
Formatul Twig este destinat exporturilor care trebuie să respecte o structură foarte specifică. Folosește-l numai dacă ai cunoștințe avansate despre Twig și despre formatul cerut de sistemul care preia datele.
Protejează datele din feed
Feedul poate conține date de identificare și facturare ale clienților. Nu lăsa adresa publică neprotejată dacă sistemul destinatar poate folosi autentificare sau o adresă IP stabilă.
Poți configura:
- HTTP Basic Auth, adică acces cu utilizator și parolă la descărcare;
- una sau mai multe Adrese IP permise;
- statusul Activ sau Inactiv al feedului.
Tratează adresa feedului și datele de autentificare ca informații sensibile. Transmite-le doar persoanei sau sistemului care trebuie să preia datele și dezactivează feedul când nu mai este folosit.
Descarcă paginile feedului
Feedurile de facturi sunt paginate, adică împărțite în mai multe pagini, și se
generează la accesarea adresei. URL-ul principal returnează prima pagină;
sistemul extern poate cere paginile
următoare adăugând ?page=2, ?page=3 și așa mai departe.
De exemplu, pentru 250 de rânduri și o dimensiune de 100 de înregistrări,
sistemul preia 100 de rânduri de la adresa inițială, 100 cu ?page=2 și 50 cu
?page=3. Preluarea continuă până când o pagină nu mai returnează rezultate.
Din listă poți folosi Descarca feedul, poți schimba rapid statusul, edita configurația, duplica sau șterge feedul. Deschide Loguri feed-uri de facturi pentru a verifica generările și descărcările recente, numărul de rânduri și dimensiunea rezultatului.
Dacă sistemul preia numai prima pagină
- Confirmă că integrarea mărește parametrul
pagela fiecare cerere. - Păstrează aceeași dimensiune și sortare pe durata preluării complete.
- Verifică statusul feedului, autentificarea și adresa IP permisă.
- Deschide logurile și caută accesările paginilor următoare.
Dacă lipsesc în continuare rânduri, contactează echipa de suport MerchantPro și indică referința internă a feedului, instanța, numărul de înregistrări configurat pe pagină, precum și data și ora testului.
Verifică integrarea
- Feedul conține numai instanța, perioada și statusurile dorite.
- Coloanele și separatorii corespund cerințelor sistemului destinatar.
- Autentificarea sau lista IP limitează accesul așa cum ai stabilit.
- Sistemul extern poate citi și paginile următoare, nu doar prima pagină.