API, hromadná korešpondencia a odosielanie e-mailom

Posielajte listy priamo z Vášho softvéru – cez REST API, ako hromadnú korešpondenciu alebo jednoducho e-mailom. Konektor Claude používa rovnaké funkcie.

Overenie

Vytvorte si kľúč v časti Účet → API kľúče a posielajte ho ako bearer token. Každá požiadavka zaťaží len kredit daného účtu.

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

Popis OpenAPI: https://mcpbrief.de/openapi.json

Koncové body

GET	/balance	Kredit, ceny, odosielateľ, denný limit
POST	/letter/price	Kontrola adresy, zostavenie listu, strany a cena + náhľad v PDF (nič neodošle)
POST	/letter/send	Odoslanie listu (text, PDF, DOCX, obrázok; prílohy, duplex, nákladové stredisko)
GET	/letter/{id}	Stav a podacie číslo
POST	/letter/{id}/cancel	Zrušenie pred tlačou (refundácia)
POST	/letter/{id}/resend	Odoslať znova
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Zoznam Vašich listov s možnosťou filtrovania
POST	/letters/batch/price	Kontrola hromadnej korešpondencie: všetky adresy, zástupné symboly, celková cena
POST	/letters/batch/send	Odoslanie hromadnej korešpondencie (max. 200 príjemcov)

Príklad: doporučený list s prílohou

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

Príklad: hromadná korešpondencia

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

Listy e-mailom

Bez programovania: každý účet má osobnú adresu na objednávky. PDF, ktoré pošlete na túto adresu z e-mailu svojho účtu, odídu ako listy.

Každá PDF príloha = jeden list, adresa v okienku (DIN 5008)
Predmet určuje možnosti: Doporučene, Prioritne, Farebne, Duplex, Ref: …, Krajina: …
„Príloha“ v predmete: všetky súbory sa spoja do jedného listu
„Test“ v predmete: len kontrola a cena e-mailom – nič sa neodošle

Hodnoty stavu

Koncový bod stavu, zoznam a e-mailové oznámenie ukazujú aktuálny stav.

`pending`	v poradí
`processing`	tlač a vkladanie do obálky
`mailed`	odovzdané pošte
`failed`	neodoslané
`cancelled`	zrušené
`undeliverable`	nedoručiteľné
`rejected`	odmietnuté