Invoice Webhooks

Invoice Lifecycle

Below is the schema of the Invoice lifecycle that A-Cube sends to the defined webhooks.

Perspective of Sender

These are messages that sender of the invoice will receive to the webhooks.

Invoice has been sent

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "e5f3389d-ce2c-4d9d-b1cc-dd668ecd0e34",
  "status": "sent",
  "message": null,
  "ksefReferenceNumber": null,
  "acquisitionTimestamp": null
}

Invoice has been delivered to KSeF

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "e5dc0cab-2a99-4e24-a958-f3d570db3ac6",
  "status": "delivered",
  "message": null,
  "ksefReferenceNumber": "8431324763-20221007-F95571-88922F-C2",
  "acquisitionTimestamp": "2022-10-07 11:51:46"
}

Invoice has been confirmed (UPO Received)

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "e5dc0cab-2a99-4e24-a958-f3d570db3ac6",
  "status": "confirmed",
  "message": null,
  "ksefReferenceNumber": "8431324763-20221007-F95571-88922F-C2",
  "acquisitionTimestamp": "2022-10-07 11:59:12"
}

Perspective of Recipient

These are messages that recipient of the invoice will receive to the webhooks.

Invoice has been received in KSeF

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "371591a0-8ac9-47c7-883f-349293baaf87",
  "status": "received",
  "message": null,
  "ksefReferenceNumber": "8431324763-20221007-F95571-88922F-C2",
  "acquisitionTimestamp": "2022-10-07 11:51:46"
}

Errors

Invoice has been rejected by KSeF

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "e5f3389d-ce2c-4d9d-b1cc-dd668ecd0e34",
  "status": "rejected",
  "message": "verify invoice semantics failed",
  "ksefReferenceNumber": "",
  "acquisitionTimestamp": null
}

Invoice Error

Copy

Copied

{
  "legalEntityUuid": "8b8b8755-5850-4ead-9c68-8243f4ac2748",
  "invoiceUuid": "",
  "status": "error",
  "message": "Invoice not found for 20221007-EE-FDD71858E2-CCD9AC9988-47.",
  "ksefReferenceNumber": "8431324763-20221007-222296-96E644-00",
  "acquisitionTimestamp": "2022-10-07 11:51:46"
}