For certain events, the Nitrobox can send a notification (via webhooks) to another system. Notifications must be activated and set up. Notifications are sent asynchronously. Notifications are used, for example, to pick up an invoice document that has just been generated and make it available to the customer, or to trigger further follow-up processes in a third-party system (e.g. an e-commerce shop).

Retry policy

If an attempt to send a notification is met with a HTTP status code 5xx we will attempt to resend the notification up to three times until successful. If your system still rejects the request the attempts will be stored in our notification log.
4xx responses will, without retry attempts, be stored in the notification log.

Notification Log

In our Webportal under Configuration, -> Global -> Notification you will find a table at the bottom with all notifications attempted to send to your system. You will also find all failed notifications here and can retry them manually.
This can also be used to resend notifications that were previously already sent successfully, in case they got lost in your system for some reason.

Available Notifications

notificationstatustechnical identifierdescription
Customer createdcustomer.createdA new customer record has been created.
Customer updatedcustomer.updatedAn existing customer has been changed.
Address createdaddress.createdA new address record has been created for a customer.
Address updatedaddress.updatedAn existing address record for a customer has been changed.
Order createdorder.createdA new order has been created.
Order updatedorder.updatedAn existing order has been changed.
Order canceledorder.cancelledAn existing order has been canceled.
Contract createdcontract.createdA new contract (subscription) has been created.
Contract updatedcontract.updatedAn existing contract was updated.
Contract renewedcontract.renewedAn existing contract has been extended by the term defined in the plan.
Contract terminatedcontract.terminatedAn existing contract was terminated regularly.
Contract canceledcontract.cancelledAn existing contract was canceled.
Contract expiredcontract.expiredA Contract passes their endDate.
Document createdinvoice.createdA document has been created in the system. This notification is independent of the (PDF) file creation and archiving, which run as an asynchronous process.
Document updatedinvoice.updatedAn already existing document was updated. This essentially refers to meta-information or the document status. In terms of content, documents are unchangeable.
Document archivedinvoice.archivedA document has been stored in the file archive and can now be accessed via the file end point.
Payment Intent Resultpaymentintent.resultAn Payment Intent was processed in conjunction with the stored Payment Service Provider.
Payment assignedpaymentAssignment.processedA payment has been assigned to a transaction. Payments can be assigned to a document or an order.
Payment assignment reversedpaymentAssignment.reversedAn assigned payment has been reversed. Payments can be assigned to a document or an order.
Open item decision:
Open item decision: other revenueoposCaseDecision.otherRevenue
Open item decision: uncollectable receivableoposCaseDecision.uncollectableReceivable
Open item decision: doubtful receivableoposCaseDecision.doubtfulReceivable
Open item decision: reversion
Settlement createdsettlement.created