Sari la conținut

FINTRAY EXTRACT · API PENTRU SOFTWARE DE FACTURARE

Trimiteți o poză, primiți toate datele facturii gata de folosit.

Cu Fintray Extract puteți extinde funcționalitățile oferite clienților voștri, citind automat facturile fizice în format PDF sau imagine. Primiți furnizorul, clientul, liniile și totalurile, cu un nivel de încredere pentru fiecare câmp.

Cereți acces Documentația API ↗

Exemplu de răspuns, prescurtat, pentru factura de test. În răspunsul real, nivelul de încredere al fiecărui câmp vine într-o listă separată.

CE PRIMIȚI

Toate datele de pe factură, structurate.

Același format pentru orice factură: PDF generat de un program, document scanat sau poză făcută cu telefonul.

PĂRȚI

Furnizorul și clientul

Nume, adresă și cod de TVA pentru amândoi, plus datele de contact ale furnizorului.

vendor · customer

DOCUMENT

Număr, date și monedă

Numărul facturii, data emiterii, scadența (doar dacă e trecută pe factură), moneda, cursul, comanda și avizul.

invoice_number · invoice_date · due_date · currency

LINII

Liniile facturii

Denumire, cantitate, unitate de măsură, preț unitar, cota de TVA și valoare. Lotul și țara de origine, unde apar.

line_items[]

TOTALURI

Totaluri și plată

Total fără TVA, TVA, reduceri, avansuri, total de plată, termen de plată și IBAN-ul furnizorului.

subtotal · vat_amount · total_amount · bank_details

Formate acceptate: PDF, JPEG, PNG, GIF și WebP, până la 14 MB și 50 de pagini pe document.

NIVEL DE ÎNCREDERE

Fiecare câmp vă spune dacă poate fi preluat automat.

Nivelul vine din verificări făcute separat de citire: în registrele publice, prin cifrele de control și în calculele de pe factură.

high

Verificat. Poate fi preluat automat.

Codul de TVA există la ANAF sau în VIES, IBAN-ul e valid, totalurile se potrivesc cu liniile, iar numărul și data apar exact așa pe factură.

medium

Coerent, dar neconfirmat.

Nimic nu contrazice valoarea, dar nu a putut fi confirmată dintr-o a doua sursă. Decideți voi dacă o preluați direct.

low

De confirmat de utilizator.

O verificare nu a trecut. Nu înseamnă că valoarea e greșită, ci că trebuie confirmată înainte de înregistrare.

REZULTATE MĂSURATE

99,6%

dintre câmpurile marcate high au fost corecte în testele noastre: 249 de câmpuri, din 49 de facturi.

AVERTISMENTE

buyer_vat_mismatch
Factura e pe numele altui client: probabil a fost încărcată în contul greșit.
buyer_is_vendor
Factura e emisă de clientul vostru, nu primită de el.
totals_mismatch
Totalurile nu se potrivesc cu liniile.
vendor_vat_unverified
Codul de TVA al furnizorului e invalid sau nu există în registre.
vendor_vat_missing
Factura nu are codul de TVA al furnizorului.
invoice_date_in_future
Data facturii e în viitor.

INTEGRARE

Patru pași, de la cheia de test la producție.

  1. 01 Primiți o cheie de test gratuită. Cu ea, orice document trimis întoarce aceeași factură de test, ca să vă construiți integrarea fără costuri.
  2. 02 Trimiteți factura printr-un apel API, împreună cu CUI-ul clientului vostru.
  3. 03 Primiți rezultatul direct în răspuns, în cel mult 30 de secunde, sau printr-un webhook semnat, când documentul e gata.
  4. 04 Treceți pe cheia de producție. Formatul răspunsului rămâne același. 
$ curl https://api.fintray.ro/v1/documents \
    -H "Authorization: Bearer ftk_test_…" \
    -F [email protected] \
    -F buyer_vat=RO90000022 \
    -F external_id=factura-8841 \
    -F mode=sync

{ "id": "doc_…", "status": "succeeded", "document": { … },
  "fields": { … }, "warnings": [] }

Ghidul de integrare, codurile de eroare și referința completă a API-ului sunt publice, la api.fintray.ro/docs.

Versiuni stabile
Fiecare cheie rămâne pe versiunea de răspuns din ziua în care a fost creată, așa că schimbările noastre nu vă strică integrarea.
Fără duplicate
Dacă aceeași cerere ajunge de două ori, de exemplu după o eroare de rețea, primiți același document, nu unul nou.
Erori clare
Fiecare eroare are un cod și o explicație, ca să știți ce merită retrimis.
Referințele voastre
Trimiteți propriul identificator și până la 20 de valori proprii, iar le primiți înapoi neschimbate, în răspuns.

PĂSTRAREA DATELOR

Documentele se șterg automat.

Alegeți, pentru fiecare document, cât timp păstrăm fișierul și rezultatul.

retention=standard

Standard

FIȘIERUL se șterge la 24 de ore după procesare REZULTATUL se șterge după 30 de zile
retention=zero

Fără păstrare

FIȘIERUL se șterge imediat după procesare REZULTATUL se șterge după ce l-ați descărcat, cel târziu în 24 de ore
  • Puteți șterge oricând un document, împreună cu rezultatul lui.
  • Documentele nu sunt folosite pentru antrenarea niciunui model.
  • Conținutul facturilor nu apare în jurnalele noastre.
  • Fiecare cont are acces doar la propriile documente.

ACCES

Testați gratuit Fintray Extract.

Completați formularul și primiți răspuns în cel mult 24 de ore, cu toate informațiile necesare pentru integrare.

  • Puteți testa fără niciun cost.
  • Documentația API e publică și o puteți citi de acum, la api.fintray.ro/docs.

Folosim datele doar ca să vă răspundem la această cerere. Detalii în Nota de informare.