Invoice Created - Notification

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.

Key benefits for you

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.

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.