Webhook event types
Documentation is released in preview, is not final, and may be subject to changes. Sandbox and Production environments will be available soon.
Webhook Types
The SK API currently uses these event types:
| Category | Webhook Type | What it does |
|---|---|---|
| Onboarding | legal_entity.onboarding | Receive information about legal-entity onboarding status |
| Invoice | invoice.outbound | Receive information about invoice processing stage |
| Invoice | invoice.inbound | Receive information when incoming invoice is received |
| Credit note | credit_note.outbound | Receive information about credit note processing stage |
| Credit note | credit_note.inbound | Receive information when incoming credit note is received |
| Tax Data Document (TDD) | tax_data_documents.outbound | Receive information about tax data document processing stage |
| Message Level Status (MLS) | message_level_status.outbound | Receive information about message level status processing stage |
| Message Level Status (MLS) | message_level_status.inbound | Receive information when incoming message level status is received |
The credit_note.* events carry the same payloads as their invoice.* counterparts and so on:
the event type is picked from the document type, so a credit note never triggers an invoice.* event and vice versa.
Subscribe to both families if you want to be notified about every document.
Subscribe only to the events your application handles. The API Reference remains the source of truth for the supported event catalogue and payload contract.
Onboarding Events
Use legal_entity.onboarding to continue an asynchronous onboarding synchronization flow.
The event tells you that something changed; the legal entity resource tells you the current state: to do that, use the GET /legal-entities/{legalEntityId} endpoint.
Invoice Lifecycle & Events
Document processing is asynchronous. A successful POST creates the resource first; validation, Peppol exchange, and tax reporting continue afterwards.
- For outgoing documents, use
invoice.outbound,credit_note.outbound,tdd.outbound,mls.outboundevents and check the document status to confirm delivery. - For incoming documents, use
invoice.inbound,credit_note.inbound,mls.inboundto retrieve and import the new resource. - If a webhook is delayed, use the collection and detail endpoints as a fallback.
Keep exchange and tax reporting as separate status concepts. A document may be delivered while tax reporting is still processing, or one of the two operations may fail independently.