vintrconnect (KSeF)
Connect a REST feed of supplier invoices, for example vintrconnect serving invoices collected from KSeF, so receiving scans can show expected quantities. During a scan you pick an invoice, and Vintrhall displays the expected quantity (matched by EAN) next to each scanned item — making it easy to verify a delivery against the invoice.
1. Build the feed (two endpoints)
The integration calls a REST API you provide. It must expose:
| Endpoint | Purpose |
|---|---|
| Invoice list | Returns invoices for a date range (accepts dateFrom, dateTo, optional supplier) |
| Single invoice | Returns one invoice with line items; the URL must contain an {id} placeholder |
The responses must match Vintrhall's expected JSON: each summary needs id,
invoiceNumber, supplier, date; each detail needs items with ean,
name, quantity.
Matching is done by EAN — invoice line items and your products must share the same EAN for expected quantities to line up.
2. Connect in Vintrhall
Go to Settings → Integrations → Supplier invoices and open the connect dialog. Enter a name, both endpoint URLs, and the authentication:
- Auth — None, HTTP Basic (
user:password), Bearer token, or Query token (with a custom parameter name). - Additional query token (optional) — a second query parameter, for setups that need both proxy-level and app-level auth.
3. Verify and use
On save, Vintrhall runs a connectivity test (fetches the last few days of invoices). Once connected, start a scan, choose the feed, adjust the date range, and select invoices to load expected quantities.
Notes
- Setting up the integration requires an admin; any member can use it while scanning.
- Credentials are stored encrypted and masked after setup.
- Each API call times out after 15 seconds.