Invoice Webhooks

Each invoice webhook type uses the same schema. Depending on the webhook type and its status, some fields may be null.

Example schema

Copy

Copied

{
  "legalEntityUuid": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "invoiceUuid": "fa87d11a-22c6-11ed-861d-0242ac120002",
  "subjectType": "Subject1",
  "status": "invalid",
  "processingCode": 415,
  "ksefReferenceNumber": null,
  "acquisitionTimestamp": null,
  "hash": null,
  "invoicingMode": "Online",
  "webhookType": "invoice-sender"
}

Invoice has been accepted by KSeF

Copy

Copied

{
  "legalEntityUuid": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "invoiceUuid": "fa87d11a-22c6-11ed-861d-0242ac120002",
  "subjectType": "Subject1",
  "status": "valid",
  "processingCode": 200,
  "ksefReferenceNumber": "5555555555-20250828-010080615740-E4",
  "acquisitionTimestamp": "2025-08-28T09:22:56.388+00:00",
  "hash": "mkht+3m5trnfxlTYhq3QFn74LkEO69MFNlsMAkCDSPA=",
  "invoicingMode": "Online",
  "webhookType": "invoice-sender"
}

Invoice has been rejected by KSeF

Copy

Copied

{
  "legalEntityUuid": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "invoiceUuid": "fa87d11a-22c6-11ed-861d-0242ac120002",
  "subjectType": "Subject1",
  "status": "invalid",
  "processingCode": 440,
  "ksefReferenceNumber": "5555555555-20250828-010080615740-E4",
  "acquisitionTimestamp": "2025-08-28T09:22:56.388+00:00",
  "hash": "mkht+3m5trnfxlTYhq3QFn74LkEO69MFNlsMAkCDSPA=",
  "invoicingMode": "Online",
  "webhookType": "invoice-sender"
}

Incoming invoice has been received from KSeF

Copy

Copied

{
  "legalEntityUuid": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "invoiceUuid": "fa87d11a-22c6-11ed-861d-0242ac120002",
  "subjectType": "Subject2",
  "status": "valid",
  "processingCode": 200,
  "ksefReferenceNumber": "5555555555-20250828-010080615740-E4",
  "acquisitionTimestamp": "2025-08-28T09:22:56.388+00:00",
  "hash": "mkht+3m5trnfxlTYhq3QFn74LkEO69MFNlsMAkCDSPA=",
  "invoicingMode": "Online",
  "webhookType": "invoice-receiver"
}

Outgoing invoice has been received from KSeF

Copy

Copied

{
  "legalEntityUuid": "e8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "invoiceUuid": "fa87d11a-22c6-11ed-861d-0242ac120002",
  "subjectType": "Subject1",
  "status": "valid",
  "processingCode": 200,
  "ksefReferenceNumber": "5555555555-20250828-010080615740-E4",
  "acquisitionTimestamp": "2025-08-28T09:22:56.388+00:00",
  "hash": "mkht+3m5trnfxlTYhq3QFn74LkEO69MFNlsMAkCDSPA=",
  "invoicingMode": "Online",
  "webhookType": "invoice-sync"
}