Die Partner-API
Wenn ein Brief gescannt oder eine spanische Zustellung abgeholt wird, senden wir innerhalb einer Minute einen Webhook an Ihr System. Jedes Ereignis enthält Mandant, Absender, gefundene Beträge und Fristen, den OCR-Text und einen signierten Link zum PDF.
Sie können außerdem alles über eine REST-API mit einem Schlüssel für Ihre Kanzlei abfragen – passend zu jeder Kanzleisoftware, die Sie bereits nutzen.
- Auth
- API-Schlüssel pro Kanzlei; Webhooks mit HMAC-SHA256 signiert
- Format
- JSON über HTTPS; PDFs über ablaufende signierte URLs
- Tarife
- Inklusive bei Asesoría und Firma, +39 €/Monat bei Despacho
POST https://your-firm.example/hooks/holapost { "event": "notification.received", "client": { "id": "cl_8Hq2", "name": "Sol y Mar S.L.", "tax_id": "B12345678" }, "item": { "id": "nt_51Xk9", "type": "notification", "sender": { "code": "AEAT", "name": "Agencia Tributaria" }, "subject": "Requerimiento de información — Modelo 303", "summary_en": "Hacienda is asking for invoices supporting the Q2 VAT return.", "amount": null, "made_available_at": "2026-10-01T09:12:00+02:00", "deemed_delivered_at": "2026-10-11T09:12:00+02:00", "response_due": "2026-10-15", "pdf_url": "https://api.holapost.com/v1/items/nt_51Xk9/pdf?sig=…" } }
# Everything new for one client since yesterday curl https://api.holapost.com/v1/items \ -H "Authorization: Bearer $HOLAPOST_KEY" \ -G -d client=cl_8Hq2 \ -d since=2026-09-30 \ -d type=notification,mail # → 200 OK { "data": [ { "id": "nt_51Xk9", "sender": { "code": "AEAT" }, … } ], "next_cursor": null }
# Fetch the original PDF
curl -L https://api.holapost.com/v1/items/nt_51Xk9/pdf \
-H "Authorization: Bearer $HOLAPOST_KEY" \
-o requerimiento-B12345678.pdf
Webhook-Ereignisse
Fehlgeschlagene Zustellungen werden 24 Stunden lang mit Backoff wiederholt.
| mail.received | Ein Brief oder Paket wurde für einen Mandanten erfasst und gescannt. |
|---|---|
| notification.received | Eine spanische digitale Zustellung wurde abgeholt und geöffnet. |
| notification.deadline_soon | Eine Antwort- oder Zahlungsfrist endet in drei Werktagen und das Schreiben ist nicht als erledigt markiert. |
| item.handled | Jemand in Ihrer Kanzlei hat ein Schreiben als erledigt markiert. |
| client.verified | Ein Mandant hat die Identitätsprüfung abgeschlossen, seine Vollmacht ist aktiv. |
Endpunkte
| GET | /v1/clients | Mandanten und ihren Status auflisten |
| POST | /v1/clients | Mandanten anlegen und Onboarding-E-Mail senden |
| GET | /v1/items | Post und Zustellungen auflisten, gefiltert nach Mandant, Typ, Absender oder Datum |
| GET | /v1/items/{id} | Ein Schreiben mit Zusammenfassung, OCR-Text und Fristen |
| GET | /v1/items/{id}/pdf | Der Originalscan oder die Zustellung als PDF |
| POST | /v1/items/{id}/handled | Schreiben aus Ihrem eigenen System als erledigt markieren |
| POST | /v1/items/{id}/forward | Original an eine Adresse schicken lassen |
Partner erhalten die vollständige API-Dokumentation und einen Sandbox-Schlüssel. Fragen Sie den Zugang an, wir schicken Ihnen beides.
API-Zugang anfragenPrüfen Sie, ob es zu Ihrer Kanzlei passt.
Meist reicht ein 20-minütiges Gespräch. Wir schauen uns an, wie Sie heute mit der Post und den Zustellungen Ihrer Mandanten umgehen, und richten ein Testkonto mit einigen Ihrer Mandanten ein.
Gespräch buchen