Por defecto, la PSB envía una notificación webhook por cada documento recibido. Cuando los volúmenes son grandes, puede resultar más eficiente procesar los documentos periódicamente en masa. Con un batch hook, la PSB recopila todos los eventos durante un periodo configurable y crea un archivo ZIP.

Un batch hook escucha un topic (por ejemplo InvoiceReceived) y recopila todos los eventos que llegan durante un periodo determinado. Al final del periodo, la PSB crea un archivo ZIP con todos los documentos asociados a esos eventos. La PSB publica entonces un nuevo topic ({Topic}Batched) para que usted pueda descargar el archivo.

El flujo es el siguiente:

1. La PSB recibe documentos y registra los eventos
2. El batch hook recopila eventos hasta que el periodo ha transcurrido o se ha alcanzado el número máximo
3. La PSB crea un archivo ZIP de todos los documentos recopilados
4. Se publica un evento {Topic}Batched (por ejemplo InvoiceReceivedBatched)
5. Su webhook recibe el evento batched y descarga el archivo ZIP

Registre un hook a través de la API con una acción batch://zip:

{
  "action": "batch://zip?period=00:15:00&maxBatchSize=100",
  "topics": ["InvoiceReceived"]
}

Consejo: Elija los valores de period y maxBatchSize en función de su volumen de documentos. Para volúmenes bajos, puede configurar un periodo más largo (por ejemplo, una hora). Para volúmenes altos, un periodo más corto con un maxBatchSize más alto resulta más práctico.

Después del cierre de un lote, la PSB publica un nuevo evento en el topic {Topic}Batched. La nomenclatura sigue un patrón fijo:

Configure un webhook estándar en el topic batched para recuperar el archivo ZIP:

{
  "action": "https://jouw-endpoint.nl/batches",
  "topics": ["InvoiceReceivedBatched"],
  "secret": "jouw-geheime-sleutel"
}

El archivo ZIP contiene todos los documentos recopilados en el lote, cada uno como archivo XML separado. Los nombres de archivo se basan en el documentId. El archivo se puede descargar a través de la URL proporcionada en el evento batched.

Puede combinar batch hooks con webhooks estándar. Utilice, por ejemplo, un webhook estándar para el procesamiento inmediato de documentos urgentes y un batch hook para la importación periódica en masa en su sistema ERP. Asegúrese de no procesar documentos por duplicado si tiene ambos tipos de hooks en el mismo topic.

Atención: Los batch hooks utilizan la misma lógica de retry que los webhooks estándar. Si el evento batched no se entrega con éxito, la PSB lo reintenta durante un máximo de 5 días.

Consulte la especificación API completa en psb.econnect.eu para todas las opciones de configuración.