Skip to content

FINTRAY EXTRACT · API FOR INVOICING SOFTWARE

Send a photo, get every detail of the invoice ready to use.

With Fintray Extract you can extend what you offer your clients by reading paper invoices automatically, as PDF or image. You get the supplier, the customer, the lines and the totals, with a confidence level for every field.

Request access API documentation ↗

A sample response, shortened, for the test invoice. In the real response, the confidence level of each field comes in a separate list.

WHAT YOU GET

Every detail on the invoice, structured.

The same format for every invoice: a PDF generated by software, a scanned document or a photo taken with a phone.

PARTIES

Supplier and customer

Name, address and VAT number for both, plus the supplier's contact details.

vendor · customer

DOCUMENT

Number, dates and currency

The invoice number, the issue date, the due date (only if printed on the invoice), the currency, the exchange rate, the order and the delivery note.

invoice_number · invoice_date · due_date · currency

LINES

Invoice lines

Description, quantity, unit, unit price, VAT rate and amount. The batch and country of origin, where printed.

line_items[]

TOTALS

Totals and payment

Net total, VAT, discounts, prepayments, amount due, payment terms and the supplier's IBAN.

subtotal · vat_amount · total_amount · bank_details

Accepted formats: PDF, JPEG, PNG, GIF and WebP, up to 14 MB and 50 pages per document.

CONFIDENCE LEVEL

Every field tells you whether it can be taken automatically.

The level comes from checks made separately from the reading: in public registers, through check digits and in the invoice's own arithmetic.

high

Checked. Can be taken automatically.

The VAT number exists at ANAF or in VIES, the IBAN is valid, the totals match the lines, and the number and date appear exactly so on the invoice.

medium

Consistent, but unconfirmed.

Nothing contradicts the value, but it could not be confirmed from a second source. You decide whether to take it directly.

low

To be confirmed by the user.

A check did not pass. It does not mean the value is wrong, only that it should be confirmed before booking.

MEASURED RESULTS

99,6%

of the fields marked high were correct in our tests: 249 fields, from 49 invoices.

WARNINGS

buyer_vat_mismatch
The invoice is made out to another customer: it was probably uploaded to the wrong account.
buyer_is_vendor
The invoice was issued by your client, not received by it.
totals_mismatch
The totals do not match the lines.
vendor_vat_unverified
The supplier's VAT number is invalid or not in the registers.
vendor_vat_missing
The invoice has no supplier VAT number.
invoice_date_in_future
The invoice date is in the future.

INTEGRATION

Four steps, from the test key to production.

  1. 01 You get a free test key. With it, every document you send returns the same test invoice, so you build your integration at no cost.
  2. 02 Send the invoice in one API call, together with your client's tax ID.
  3. 03 Get the result directly in the response, within 30 seconds, or through a signed webhook when the document is ready.
  4. 04 Switch to the live key. The response format stays the same. 
$ 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": [] }

The integration guide, the error codes and the full API reference are public, at api.fintray.ro/docs.

Stable versions
Every key stays on the response version from the day it was created, so our changes do not break your integration.
No duplicates
If the same request arrives twice, after a network error for example, you get the same document, not a new one.
Clear errors
Every error has a code and an explanation, so you know what is worth resending.
Your own references
Send your own identifier and up to 20 values of your own, and get them back unchanged in the response.

DATA RETENTION

Documents are deleted automatically.

Choose, for each document, how long we keep the file and the result.

retention=standard

Standard

THE FILE deleted 24 hours after processing THE RESULT deleted after 30 days
retention=zero

No retention

THE FILE deleted right after processing THE RESULT deleted once you have downloaded it, within 24 hours at most
  • You can delete a document at any time, together with its result.
  • Documents are not used to train any model.
  • The content of the invoices never appears in our logs.
  • Each account can access only its own documents.

ACCESS

Try Fintray Extract for free.

Fill in the form and get an answer within 24 hours, with everything you need for the integration.

  • You can test at no cost.
  • The API documentation is public and you can read it now, at api.fintray.ro/docs.

We use these details only to answer this request. Details in the Privacy notice.