API, skupna pisma i slanje e-poštom

Šaljite pisma izravno iz svog softvera – putem REST API-ja, kao skupno pismo ili jednostavno e-poštom. Claude konektor koristi iste funkcije.

Autentifikacija

Izradite ključ pod Račun → API ključevi i šaljite ga kao bearer token. Svaki zahtjev tereti samo saldo tog računa.

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

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

Krajnje točke

GET	/balance	Saldo, cijene, pošiljatelj, dnevno ograničenje
POST	/letter/price	Provjera adrese, izrada pisma, stranice i cijena + PDF pregled (ništa ne šalje)
POST	/letter/send	Slanje pisma (tekst, PDF, DOCX, slika; prilozi, duplex, mjesto troška)
GET	/letter/{id}	Status i broj za praćenje
POST	/letter/{id}/cancel	Otkazivanje prije ispisa (povrat)
POST	/letter/{id}/resend	Ponovno slanje
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Popis Vaših pisama, s filtriranjem
POST	/letters/batch/price	Provjera skupnog pisma: sve adrese, rezervirana mjesta, ukupna cijena
POST	/letters/batch/send	Slanje skupnog pisma (najviše 200 primatelja)

Primjer: preporučeno pismo s prilogom

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

Primjer: skupno 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 putem e-pošte

Bez programiranja: svaki račun ima osobnu adresu za narudžbe. PDF-ovi koje s e-pošte svog računa pošaljete na tu adresu odlaze kao pisma.

Svaki PDF prilog = jedno pismo, adresa u području prozorčića (DIN 5008)
Predmet upravlja opcijama: Registered, Priority, Colour, Duplex, Ref: …, Country: …
„Enclosure” u predmetu: sve datoteke spajaju se u jedno pismo
„Test” u predmetu: samo provjera i cijena e-poštom – ništa se ne šalje

Vrijednosti statusa

Krajnja točka za status, popis i obavijest e-poštom prikazuju trenutačno stanje.

`pending`	u redu čekanja
`processing`	ispis i kuvertiranje
`mailed`	predano pošti
`failed`	nije poslano
`cancelled`	otkazano
`undeliverable`	neisporučivo
`rejected`	odbijeno