Pour les partenaires Nous contacter

L’API partenaires

Quand un courrier est numérisé ou qu’une notification espagnole est récupérée, nous envoyons un webhook à votre système en moins d’une minute. Chaque événement contient le client, l’expéditeur, le montant et l’échéance éventuellement relevés, le texte OCR et un lien signé vers le PDF.

Vous pouvez aussi tout interroger via une API REST avec une clé propre à votre cabinet, quel que soit le logiciel métier que vous utilisez déjà.

Authentification: Une clé d’API par cabinet ; webhooks signés en HMAC-SHA256
Format: JSON sur HTTPS ; PDF via des URL signées à durée limitée
Formules: Inclus avec Asesoría et Firma, +39 €/mois avec 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

Événements webhook

Les envois échoués sont relancés avec un délai croissant pendant 24 heures.

mail.received	Une lettre ou un colis a été enregistré et numérisé pour un client.
notification.received	Une notification électronique espagnole a été récupérée et ouverte.
notification.deadline_soon	Une échéance de réponse ou de paiement tombe dans trois jours ouvrés et l’élément n’est pas marqué comme traité.
item.handled	Quelqu’un de votre cabinet a marqué un élément comme traité.
client.verified	Un client a terminé la vérification d’identité et son autorisation est active.

Points d’accès

GET	/v1/clients	Lister vos clients et leur statut
POST	/v1/clients	Créer un client et lui envoyer son e-mail d’accueil
GET	/v1/items	Lister le courrier et les notifications, filtrés par client, type, expéditeur ou date
GET	/v1/items/{id}	Un élément avec son résumé, son texte OCR et ses échéances
GET	/v1/items/{id}/pdf	La numérisation ou la notification d’origine, en PDF
POST	/v1/items/{id}/handled	Marquer un élément comme traité depuis votre propre système
POST	/v1/items/{id}/forward	Demandez-nous d’envoyer l’original à une adresse

La documentation complète de l’API et une clé de test sont à la disposition des partenaires. Demandez un accès et nous vous les enverrons.

Demander l’accès à l’API

Voyez si cela convient à votre cabinet.

Un appel de 20 minutes suffit en général. Nous regardons comment vous gérez aujourd’hui le courrier et les notifications de vos clients, puis nous ouvrons un compte d’essai avec quelques-uns d’entre eux.

Prendre rendez-vous

Équipe partenariats

[email protected]
UK
ES

Du lundi au vendredi, 9 h – 17 h 30 (Royaume-Uni) / 9 h – 18 h (Espagne)