API - Order Notifications

Overview

The Neto Order Notifications API is an optional call to an external webhook in response to order status change events occurring in the Neto E-Commerce Suite. The Notifications API uses your Neto API key to ensure the call is coming from a trusted source.

Practical Uses

You can use the notification API to notify your application of new orders or changes to an existing orders status. On receipt of a notification you can then use other API calls such as GetOrder or UpdateOrder to perform a desired action. Using the notification API can help to reduce the number of unnecessary calls you make to the application looking for new order or order status changes.

Notification Structure

Notifications are sent as XML via POST to your specified URL.

Webhook URL Set your URL in your Neto control panel. (Go to: admin > system setup > api)
Method POST
Headers
NETO_NOTIFICATION Order
NETOAPI_KEY Your Neto API Secure Key (generate this in your Neto control panel)
XSD Schema EventSchema XSD

Example Post

Notification of order status changing to pick.

Element Name Type Description Example
<Event> Contains the child elements below
<EventID> integer The unique ID of the event call. This is logged. 12
<CurrentTime> datetime The date and time the notification was sent. 2014-01-03 01:11:12
<EventType> string The type of event. Order
<Order> Contains the child elements below
<OrderID> orderidtype The order ID related to the event. N1000001
<OrderStatus> orderstatustype The status that the order was changed to. Quote
New
On Hold
New Backorder
Backorder Approved
Pick
Pack
Pending Dispatch
Dispatched
Cancelled
Uncommitted

Valid Response

If the call to your webhook is successful, your application should respond “200 OK”. If your application makes no response or provides a standard error response, Neto will treat the notification as undelivered, and delivery will be optionally reattempted at a later time (set in Scheduled Tasks).