event_type | Fires when |
|---|---|
tender.completed | A tender offer is released to the partner API — the seller clicks Finalize (Export → API) in the matching view. Carries tender_id (= the request id) and completed_at; fetch the full record from GET /tenders/{tender_id}. Fires again (with a newer completed_at) on every re-release. (Other export paths — PDF, offer email/download, the ERP callback — do NOT fire this.) |
order.completed | An order is finalised (marked exported) for handoff. Carries order_id (= the request id) and completed_at; fetch the full record from GET /orders/{order_id}. |
project.exported | A Mercura user hands a project (Objekt) over to your system — the Send to ERP button on the project page. Carries project_id and the current object_number; fetch the full record from GET /projects/{project_id}, create it on your side, then report the outcome with POST /projects/{project_id}/acknowledgements. Unlike the *.completed events this is an explicit handoff, not a lifecycle transition: the project's status is untouched and re-clicking emits again. The button only appears for organisations subscribed to this event. |
job.finished | A bulk-write job from this API (POST /articles / /customers / /suppliers) reaches a terminal status (COMPLETED or FAILED). Replaces the need to poll GET /jobs/{job_id}. |
request.processing_completed | A request finishes its intake processing — file parsing, position extraction — whatever the intake channel (email forwarding, web app, or POST /tenders / POST /orders). Fires on success and on parsing failure; branch on data.status. This is the intake signal; tender.completed / order.completed are the export/finish signal. |
webhook.test | A human clicks Send test event in the admin UI. Carries a fixed synthetic payload — useful for end-to-end smoke tests of your verification code. |
Every event type uses the same wire format, headers, and signature scheme (below), so a webhook.test delivery validates your verification code against the exact production contract before you rely on any real event.