API, stampa unione e invio via e-mail

Invii lettere direttamente dal Suo software – tramite API REST, come stampa unione o semplicemente via e-mail. Il connettore per Claude utilizza le stesse funzioni.

Autenticazione

Crei una chiave in Account → Chiavi API e la invii come bearer token. Ogni richiesta addebita esclusivamente il credito di questo account.

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

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

Endpoint

GET	/balance	Credito, prezzi, mittente, limite giornaliero
POST	/letter/price	Verifica indirizzo, impaginazione della lettera, pagine e prezzo + anteprima PDF (non invia nulla)
POST	/letter/send	Invia una lettera (testo, PDF, DOCX, immagine; allegati, fronte/retro, centro di costo)
GET	/letter/{id}	Stato e numero di spedizione
POST	/letter/{id}/cancel	Annulla finché non è stampata (rimborso)
POST	/letter/{id}/resend	Invia di nuovo
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Elenco delle Sue lettere, filtrabile
POST	/letters/batch/price	Verifica stampa unione: tutti gli indirizzi, segnaposto, prezzo totale
POST	/letters/batch/send	Invia stampa unione (max. 200 destinatari)

Esempio: raccomandata con allegato

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

Esempio: stampa unione

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

Lettere via e-mail

Senza programmazione: ogni account dispone di un indirizzo personale per gli ordini. I PDF che invia a questo indirizzo dall'e-mail del Suo account vengono spediti come lettere.

Ogni PDF allegato = una lettera, indirizzo nella finestra (DIN 5008)
L'oggetto controlla le opzioni: Raccomandata, Prioritaria, Colore, Duplex, Ref: …, Paese: …
«Enclosure» nell'oggetto: tutti i file vengono uniti in un'unica lettera
«Test» nell'oggetto: solo verifica e prezzo via e-mail – non viene inviato nulla

Valori di stato

Lo stato attuale è disponibile tramite l'endpoint di stato, l'elenco e la notifica via e-mail.

`pending`	in coda
`processing`	in stampa e imbustamento
`mailed`	consegnata alle poste
`failed`	non inviata
`cancelled`	annullata
`undeliverable`	non recapitabile
`rejected`	rifiutata