API, cartas en serie y envío por e-mail

Envíe cartas directamente desde su software: mediante API REST, como cartas en serie o simplemente por e-mail. El conector de Claude utiliza las mismas funciones.

Autenticación

Cree una clave en Cuenta → Claves API y envíela como token Bearer. Cada solicitud solo se carga al saldo de esa cuenta.

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

Descripción OpenAPI: https://mcpbrief.de/openapi.json

Endpoints

GET	/balance	Saldo, precios, remitente, límite diario
POST	/letter/price	Comprobar la dirección, componer la carta, páginas y precio + vista previa en PDF (no envía nada)
POST	/letter/send	Enviar una carta (texto, PDF, DOCX, imagen; anexos, dúplex, centro de coste)
GET	/letter/{id}	Estado y número de seguimiento
POST	/letter/{id}/cancel	Cancelar mientras no se haya impreso (reembolso)
POST	/letter/{id}/resend	Volver a enviar
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Lista de sus cartas, filtrable
POST	/letters/batch/price	Comprobar cartas en serie: todas las direcciones, marcadores, precio total
POST	/letters/batch/send	Enviar cartas en serie (máx. 200 destinatarios)

Ejemplo: carta certificada con anexo

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

Ejemplo: cartas en 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"
}'

Cartas por e-mail

Sin programación: cada cuenta tiene una dirección de pedidos personal. Los PDF que envíe desde el e-mail de su cuenta a esta dirección salen como cartas.

Cada PDF adjunto = una carta, dirección en la ventanilla (DIN 5008)
El asunto controla las opciones: Certificada, Urgente, Color, Dúplex, Ref: …, País: …
«Anexo» en el asunto: todos los archivos se combinan en una sola carta
«Test» en el asunto: solo comprobar y recibir el precio por e-mail; no se envía nada

Valores de estado

El endpoint de estado, la lista y la notificación por e-mail muestran el estado actual.

`pending`	en cola
`processing`	en impresión y ensobrado
`mailed`	entregada a Correos
`failed`	no enviada
`cancelled`	cancelada
`undeliverable`	no entregable
`rejected`	rechazada