Para partners Habla con nosotros

La API para partners

Cuando se escanea una carta o se recoge una notificación española, enviamos un webhook a tu sistema en menos de un minuto. Cada evento incluye el cliente, el remitente, el importe y el plazo que hayamos encontrado, el texto OCR y un enlace firmado al PDF.

También puedes consultarlo todo mediante una API REST con una clave para tu despacho, así que encaja con el software de gestión que ya uses.

Autenticación: Una clave de API por despacho; webhooks firmados con HMAC-SHA256
Formato: JSON sobre HTTPS; PDF mediante URL firmadas con caducidad
Planes: Incluido en Asesoría y Firma, +39 €/mes en 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

Eventos de webhook

Si una entrega falla, se reintenta con espera progresiva durante 24 horas.

mail.received	Se ha registrado y escaneado una carta o paquete de un cliente.
notification.received	Se ha recogido y abierto una notificación electrónica española.
notification.deadline_soon	Faltan tres días hábiles para un plazo de respuesta o de pago y el envío no está marcado como gestionado.
item.handled	Alguien de tu despacho ha marcado un envío como gestionado.
client.verified	Un cliente ha completado la verificación de identidad y su autorización ya está activa.

Endpoints

GET	/v1/clients	Lista tus clientes y su estado
POST	/v1/clients	Crea un cliente y envíale el correo de alta
GET	/v1/items	Lista el correo y las notificaciones, filtrados por cliente, tipo, remitente o fecha
GET	/v1/items/{id}	Un envío con su resumen, el texto OCR y los plazos
GET	/v1/items/{id}/pdf	El escaneo o la notificación original en PDF
POST	/v1/items/{id}/handled	Marca un envío como gestionado desde tu propio sistema
POST	/v1/items/{id}/forward	Pídenos que enviemos el original a una dirección

Los partners tienen a su disposición la documentación completa de la API y una clave de pruebas (sandbox). Pídenos acceso y te la enviamos.

Solicitar acceso a la API

Comprueba si encaja con tu despacho.

Normalmente basta con una llamada de 20 minutos. Vemos cómo gestionáis hoy el correo y las notificaciones de vuestros clientes y abrimos una cuenta de prueba con algunos de ellos.

Reserva una llamada

Equipo de partners

[email protected]
UK
ES

De lunes a viernes, 9:00–17:30 (Reino Unido) / 9:00–18:00 (España)