API, brevfletning og afsendelse pr. e-mail

Send breve direkte fra din software – via REST API, som brevfletning eller ganske enkelt pr. e-mail. Claude-connectoren bruger de samme funktioner.

Godkendelse

Opret en nøgle under Konto → API-nøgler, og send den som bearer token. Hver forespørgsel trækker kun fra den pågældende kontos saldo.

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

OpenAPI-beskrivelse: https://mcpbrief.de/openapi.json

Endpoints

GET	/balance	Saldo, priser, afsender, daglig grænse
POST	/letter/price	Kontrollér adresse, opbyg brev, sider og pris + PDF-forhåndsvisning (sender intet)
POST	/letter/send	Send et brev (tekst, PDF, DOCX, billede; bilag, duplex, omkostningssted)
GET	/letter/{id}	Status og sporingsnummer
POST	/letter/{id}/cancel	Annuller før print (refusion)
POST	/letter/{id}/resend	Send igen
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Liste over dine breve, kan filtreres
POST	/letters/batch/price	Kontrollér en brevfletning: alle adresser, pladsholdere, samlet pris
POST	/letters/batch/send	Send en brevfletning (maks. 200 modtagere)

Eksempel: anbefalet brev med bilag

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

Eksempel: brevfletning

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

Breve pr. e-mail

Ingen programmering nødvendig: hver konto har en personlig ordreadresse. PDF’er, du sender fra din kontos e-mail til denne adresse, sendes som breve.

Hver PDF-vedhæftning = ét brev, adresse i rudefeltet (DIN 5008)
Emnefeltet styrer valgmulighederne: Registered, Priority, Colour, Duplex, Ref: …, Country: …
»Enclosure« i emnefeltet: alle filer samles i ét brev
»Test« i emnefeltet: kun kontrol, og du får prisen pr. e-mail – intet sendes

Statusværdier

Status-endpointet, listen og e-mailnotifikationen viser den aktuelle tilstand.

`pending`	i kø
`processing`	printes og kuverteres
`mailed`	afleveret til posten
`failed`	ikke sendt
`cancelled`	annulleret
`undeliverable`	kan ikke leveres
`rejected`	afvist