API, corespondență în serie și trimitere prin e-mail

Trimiteți scrisori direct din software-ul dumneavoastră – prin REST API, ca corespondență în serie sau simplu, prin e-mail. Conectorul Claude folosește aceleași funcții.

Autentificare

Creați o cheie în Cont → Chei API și trimiteți-o ca bearer token. Fiecare cerere taxează doar soldul contului respectiv.

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

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

Endpointuri

GET	/balance	Sold, prețuri, expeditor, limită zilnică
POST	/letter/price	Verificare adresă, generare scrisoare, pagini și preț + previzualizare PDF (nu trimite nimic)
POST	/letter/send	Trimitere scrisoare (text, PDF, DOCX, imagine; anexe, duplex, centru de cost)
GET	/letter/{id}	Stare și număr de urmărire
POST	/letter/{id}/cancel	Anulare înainte de tipărire (rambursare)
POST	/letter/{id}/resend	Retrimitere
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Lista scrisorilor dumneavoastră, cu filtre
POST	/letters/batch/price	Verificare corespondență în serie: toate adresele, substituenții, prețul total
POST	/letters/batch/send	Trimitere corespondență în serie (max. 200 de destinatari)

Exemplu: scrisoare recomandată cu anexă

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

Exemplu: corespondență în serie

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

Scrisori prin e-mail

Fără programare: fiecare cont are o adresă de comandă personală. PDF-urile trimise de pe adresa de e-mail a contului la această adresă pleacă drept scrisori.

Fiecare atașament PDF = o scrisoare, adresa în zona ferestrei (DIN 5008)
Subiectul controlează opțiunile: Recomandată, Prioritar, Color, Duplex, Ref: …, Țară: …
„Anexă” în subiect: toate fișierele sunt combinate într-o singură scrisoare
„Test” în subiect: doar verificare și prețul prin e-mail – nu se trimite nimic

Valori de stare

Endpointul de stare, lista și notificarea prin e-mail arată starea curentă.

`pending`	în așteptare
`processing`	în tipărire și plicuire
`mailed`	predată la poștă
`failed`	netrimisă
`cancelled`	anulată
`undeliverable`	nelivrabilă
`rejected`	respinsă