Invoice Created Notification

Key benefits for you

The Invoice Created notification is triggered when an invoice has been successfully generated for an order by Accounting as a Service. It includes all relevant details of the invoice and provides a link to the generated invoice document. This notification is particularly useful for clients who want to track invoicing events or use the information for reporting purposes, such as e-invoicing.

This notification can be utilized for various business purposes:

• Tracking invoicing completion.
• Accessing invoice documents for compliance.
• Synchronizing invoicing data with CRM or ERP systems.
• Facilitating government reporting, including e-invoicing.

Important Note: The document URL provided in the notification expires after the time required for compliance reasons.

Setting up the notification

To register to this notification, please look in the general notifications-page using accounting/invoiceCreated

The follow-up processes depend on what you want to do with the data:

• Download the document to display it in MyAccounting, CRM-Tools, etc.
• Forward the data to an e-Invoicing provider or the authorities directly

The document is stored with a unique internal GUID, preventing unauthorized access through trial and error. The document remains stored in the optical archive on the Accounting side for as long as legally required, ensuring you can retrieve it at any time using the provided URL.

Technical details

Trigger Events:

This notification is triggered when Accounting as a Service is responsible for invoice generation. The notification provides details of the invoice, including line items, tax data, and the total amounts.

The notification also includes a URL to the invoice document, which can be accessed and downloaded. This is especially relevant for compliance and auditing purposes, as well as customer communication.

Example B2C:

{
  "type": "accounting/invoiceCreated",
  "parameters": {
    "dueDate": "2024-09-16",
    "invoiceDate": "2024-09-16",
    "billToAddress": {
      "email": "john.doe@example.com",
      "firstName": "John",
      "language": "de",
      "lastName": "Doe",
      "salutation": "MR",
      "countryCode": "AT",
      "postalCode": "1010",
      "postalPlace": "Vienna",
      "street": "Baseler Str.",
      "streetNumber": "20"
    },
    "businessCode": "1004",
    "creationDate": "2024-09-16T00:00:00Z",
    "currency": "EUR",
    "customerNumber": "9910099000001692",
    "invoiceDocumentUrl": "//z_knox_extern_srv/FileSet'4D364E4C33564739453638324F4B57393447'",
    "invoiceReference": "B-AT-2024-902119",
    "items": [
      {
        "orderItemReference": 1,
        "positionType": "SALES_ARTICLE",
        "description": "T-Shirt",
        "grossUnitPrice": 120.0,
        "quantity": 1.0,
        "vatAmount": 20.0,
        "vatPercent": 20.0
      }
    ],
    "orderReference": "CHAR100410000093",
    "totals": {
      "grossUnitPrice": 230.0,
      "vatAmount": 30.0
    }
  }
}

Example B2B

{
  "parameters": {
    "dueDate": "2024-10-01",
    "invoiceDate": "2024-08-31",
    "companyAddress": {
      "companyName": "J.Doe Consultancy",
      "language": "en",
      "email": "Doe_Consultancy@riverty.com",
      "taxIdentificationNumber": "PL0123456789",
      "countryCode": "PL",
      "postalCode": "04-856",
      "postalPlace": "Warszawa",
      "street": "ul. Traszka",
      "streetNumber": "68"
    },
    "businessCode": "1700",
    "currency": "PLN",
    "customerNumber": "COMP00080517183768",
    "invoiceDocumentUrl": "https://mytest.aqount.com/sap/opu/odata/sap/z_knox_extern_srv/FileSet('3444535030365A413656375A494A36413652')/$value",
    "invoiceReference": "B-PL-2024-000620",
    "items": [
      {
        "orderItemReference": 3,
        "positionType": "SUBSCRIPTION_ORDER",
        "description": "Subscription Type 1",
        "grossUnitPrice": 1201.32,
        "vatType": "REVERSE",
        "vatAmount": 0.0
      }
    ],
    "orderReference": "O000805174103943",
    "totals": {
      "grossUnitPrice": 2186.4,
      "vatAmount": 184.2
    }
  },
  "type": "accounting/invoiceCreated"
}

Field descriptions

Please look here for the details of the Invoice Created Notification.

• invoiceDocumentUrl: A URL where you can download the document. This URL remains valid as long as the document is legally required to be stored.