Przetwarzanie przychodzących faktur przez API: przesyłasz fakturę — otrzymujesz pola i plik dla księgowości. Model salda, bez abonamentu.Przetwarzaj przychodzące faktury przez REST: prześlij dokument, otrzymaj uporządkowane pola i eksport gotowy dla księgowości. Saldo przedpłacone, bez abonamentu.
Przyjmuje przychodzącą fakturę od dostawcy i zwraca uporządkowane dane oraz plik gotowy dla księgowości. Nie wystawiamy faktur i nie przyjmujemy płatności — tylko przetwarzamy dokumenty.Przyjmuje przychodzącą fakturę od dostawcy i zwraca uporządkowane pola oraz plik gotowy dla księgowości. Nie wystawiamy faktur i nie przyjmujemy płatności — tylko przetwarzamy dokumenty.
Faktury elektroniczne odczytujemy za pomocą kodu — dokładnie i bez opłat. Płacisz tylko za skany i zdjęcia.Faktury elektroniczne są przetwarzane za pomocą kodu — dokładnie i bez opłat. Płacisz tylko za skany i zdjęcia.
X-Api-Key.Przekazuj klucz w nagłówku X-Api-Key.X-Api-Key: your_api_key_here| MetodaMetoda | Ścieżka | DziałanieDziałanie |
|---|---|---|
| POST | /v1/parse | Prześlij fakturę (multipart: file, country)Prześlij fakturę (multipart: file, country) |
| GET | /v1/parse/{job_id} | Status zadania i przetworzone polaStatus zadania i przetworzone pola |
| GET | /v1/usage | Zużycie i pozostałe saldoZużycie i pozostałe saldo |
| GET | /v1/price | Cena (publiczne, bez klucza)Cena (publiczne, bez klucza) |
| GET | /v1/countries | Kraje i formaty (publiczne)Kraje i formaty (publiczne) |
Interaktywna dokumentacja: /docs · /redoc · openapi.jsonInteraktywna dokumentacja: /docs · /redoc · openapi.json
curl -X POST https://duebuddy.work/v1/parse \
-H "X-Api-Key: your_api_key_here" \
-F "country=de" \
-F "[email protected]"
# {"ok":true,"job_id":41,"status":"queued","charged":true}
curl https://duebuddy.work/v1/parse/41 \
-H "X-Api-Key: your_api_key_here"import requests, time
BASE = "https://duebuddy.work/v1"
HEAD = {"X-Api-Key": "your_api_key_here"}
def parse(path, country="de"):
with open(path, "rb") as f:
r = requests.post(f"{BASE}/parse", headers=HEAD,
files={"file": f}, data={"country": country}, timeout=60)
r.raise_for_status()
job = r.json()
for _ in range(30): # ждём результат
time.sleep(2)
out = requests.get(f"{BASE}/parse/{job['job_id']}", headers=HEAD, timeout=30).json()
if out.get("status") in ("done", "failed"):
return out
raise TimeoutError("parse timeout")
res = parse("invoice.pdf", "de")
print(res["fields"]) # поля счёта
const fd = new FormData();
fd.append("country", "us");
fd.append("file", fileInput.files[0]);
const r = await fetch("https://duebuddy.work/v1/parse", {
method: "POST",
headers: { "X-Api-Key": API_KEY },
body: fd
});
const { job_id } = await r.json();
const out = await fetch(`https://duebuddy.work/v1/parse/${job_id}`,
{ headers: { "X-Api-Key": API_KEY } }).then(r => r.json());
console.log(out.fields);Zapisz jako parse.html i otwórz w przeglądarce — przeciągnij plik i otrzymaj wynik. Klucz jest przechowywany wyłącznie w Twojej przeglądarce.Zapisz jako parse.html, otwórz w przeglądarce i upuść plik. Klucz pozostaje wyłącznie w Twojej przeglądarce.
<!doctype html>
<meta charset="utf-8">
<title>DueBuddy parse</title>
<style>body{font:15px system-ui;margin:40px;max-width:640px}
#d{border:2px dashed #999;border-radius:12px;padding:40px;text-align:center}
pre{background:#f4f4f5;padding:14px;border-radius:8px;overflow:auto}</style>
<input id="k" placeholder="API key" style="width:100%;padding:8px">
<div id="d">Drop an invoice here (PDF / JPG / PNG / XML)</div>
<pre id="o">—</pre>
<script>
const d = document.getElementById("d"), o = document.getElementById("o");
d.ondragover = e => e.preventDefault();
d.ondrop = async e => {
e.preventDefault();
const f = e.dataTransfer.files[0];
const fd = new FormData();
fd.append("country", "de");
fd.append("file", f);
const head = { "X-Api-Key": document.getElementById("k").value };
const j = await fetch("https://duebuddy.work/v1/parse",
{ method: "POST", headers: head, body: fd }).then(r => r.json());
o.textContent = JSON.stringify(j, null, 2);
for (let i = 0; i < 30; i++) {
await new Promise(r => setTimeout(r, 2000));
const out = await fetch("https://duebuddy.work/v1/parse/" + j.job_id,
{ headers: head }).then(r => r.json());
o.textContent = JSON.stringify(out, null, 2);
if (out.status === "done" || out.status === "failed") break;
}
};
</script>{
"ok": true,
"job_id": 41,
"status": "done",
"fields": {
"invoice_number": "RE-2026-04871",
"invoice_date": "2026-09-14",
"due_date": "2026-10-14",
"vendor_name": "Hartmann GmbH",
"net_amount": "1048.74",
"vat_amount": "199.26",
"gross_amount": "1248.00",
"currency": "EUR"
},
"fields_detailed": [{"key": "gross_amount", "value": "1248.00", "edited": false}]
}Zestaw pól zależy od kraju (country). Dostępny jest również eksport w formacie właściwym dla danego kraju: XRechnung, ZUGFeRD, DATEV, 1С, UBL, FatturaPA i inne.Zestaw pól zależy od country. Dostępne są również eksporty właściwe dla danego kraju: XRechnung, ZUGFeRD, DATEV, 1C, UBL, FatturaPA i inne.
| KodKod | detail | PrzyczynaPrzyczyna |
|---|---|---|
| 400 | unsupported_country | Kraj nie jest obsługiwanyKraj nie jest obsługiwany |
| 400 | unsupported_file_type | Nie jest to PDF/JPG/PNG/XMLNie jest to PDF/JPG/PNG/XML |
| 400 | empty_file | Pusty plikPusty plik |
| 413 | file_too_large | Plik przekracza limitPlik przekracza limit |
| 429 | rate_limited | Ponad 120 żądań na minutęPonad 120 żądań na minutę |
Przetwarzamy przychodzące faktury. Nie wystawiamy faktur w Twoim imieniu i nie przyjmujemy za Ciebie płatności.Przetwarzamy przychodzące faktury. Nie wystawiamy faktur w Twoim imieniu i nie przyjmujemy za Ciebie płatności.