API, skupinska pisma in pošiljanje po e-pošti

Pošiljajte pisma neposredno iz svoje programske opreme – prek REST API, kot skupinsko pismo ali preprosto po e-pošti. Povezovalnik Claude uporablja iste funkcije.

Overjanje

Ključ ustvarite v Račun → API-ključi in ga pošljite kot žeton Bearer. Vsaka zahteva bremeni samo dobroimetje tega računa.

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

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

Končne točke

GET	/balance	Dobroimetje, cene, pošiljatelj, dnevna omejitev
POST	/letter/price	Preverjanje naslova, sestava pisma, strani in cena + predogled PDF (nič ne pošlje)
POST	/letter/send	Pošiljanje pisma (besedilo, PDF, DOCX, slika; priloge, dupleks, stroškovno mesto)
GET	/letter/{id}	Stanje in sledilna številka
POST	/letter/{id}/cancel	Preklic pred tiskom (povračilo)
POST	/letter/{id}/resend	Ponovno pošiljanje
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Seznam vaših pisem, s filtri
POST	/letters/batch/price	Preverjanje skupinskega pisma: vsi naslovi, nadomestne oznake, skupna cena
POST	/letters/batch/send	Pošiljanje skupinskega pisma (največ 200 prejemnikov)

Primer: priporočena pošiljka s prilogo

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-…"
}'

Primer: skupinsko pismo

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"
}'

Pisma po e-pošti

Brez programiranja: vsak račun ima oseben naslov za naročila. PDF-ji, ki jih na ta naslov pošljete z e-pošte svojega računa, se pošljejo kot pisma.

Vsaka priloga PDF = eno pismo, naslov v območju okenca (DIN 5008)
Zadeva določa možnosti: Priporočeno, Prednostno, Barvno, Dupleks, Ref: …, Država: …
„Priloga“ v zadevi: vse datoteke se združijo v eno pismo
„Test“ v zadevi: samo preverjanje in cena po e-pošti – nič ni poslano

Vrednosti stanja

Končna točka stanja, seznam in obvestilo po e-pošti prikazujejo trenutno stanje.

`pending`	v čakalni vrsti
`processing`	tisk in kuvertiranje
`mailed`	predano pošti
`failed`	ni poslano
`cancelled`	preklicano
`undeliverable`	nevročljivo
`rejected`	zavrnjeno