Webhook

EinvoiceRegistrationRecipientNotFound Webhook

​

Webhook endpoint for receiving E-invoice registration recipient not found events.

Markets: Finland

This event is triggered when a registration event (add, change or delete) has occurred, but our system could not understand which recipient to match it towards. This probably means that the recipient entered an incorrect customer number in their bank. The registration event is discarded.

Body·
required
application/json
  • callback_id
    Type: string
    required

    Unique identifier generated for each callback.

  • callback_timestamp
    Type: stringFormat: date-time
    required

    An ISO 8601 compliant timestamp for the callback.

  • callback_type
    const:  
    EinvoiceRegistrationRecipientNotFound
    required

    The type of callback. Value is "EinvoiceRegistrationRecipientNotFound" for an e-invoice registration recipient not found callback.

  • recipient_information
    Type: object ·
    required
Responses
  • application/json
Request Example for postEinvoiceRegistrationRecipientNotFound
{
  "callback_id": "9ec1c43a-0272-46f0-b4c2-9fe53acdb861",
  "callback_timestamp": "2021-11-03T13:28:51.706784Z",
  "callback_type": "EinvoiceRegistrationRecipientNotFound",
  "recipient_information": {
    "customer_number": "1234",
    "operation": "ADD",
    "personal_identification_number": "DDMMYYCZZZQ",
    "electronic_invoicing_address": "123"
  }
}

{
  "status": "OK"
}

Webhook received successfully.

Required: Your endpoint must return HTTP 200 OK for the webhook to be considered successfully delivered. Any other status code will cause the webhook to be marked as failed and retried.