KIBO OMS DOCUMENTATION
Add Order Note
The Order Note API allows any user to add notes to orders and shipments, and mark them as publicly or privately visible.
| Version | 2.0 |
| Call | https://integration.shopatron.com/api/v2/orderNote/{orderID} |
| Supported Formats | JSON |
| HTTP Method | POST |
| Schema | https://integration.shopatron.com/api/v2/schema/orderNote.json |
The .json address above can be used to access the schema within Postman. An example use of the Add Order Note API follows below, or view the schema or the sample Postman Collection.
Example
The example case will add a note with the following properties to an order:
- Public note on Order 44444
- Written by user 012210
Required Parameters
Assigning an order requires:
| Parameter | Type | Description |
| userID | integer | A unique identifier for the user. The minimum value is "1". |
| note | string | The body of the order note. The maximum length is 1000. |
| public | boolean | Whether the note is publicly viewable. The default is "true". |
Optional Parameters
There are several optional parameters that can add more details and ID associations to the note:
| Parameter | Type | Description |
| noteID | integer | A unique identifier for the order note. |
| noteTime | string | The date-time at which the note was created. |
| orderID | integer | A unique identifier for the order. The minimum value is "1". |
| externalOrderID | string | A client-generated unique identifier for the order. The minimum length is 1 and the maximum length is 100. |
| shipmentID | integer | A unique identifier for the shipment. The minimum value is "1". |
| userName | string | The user’s name. |
The Full Request
The order that this note is being applied to should be specified in the URL endpoint.
https://integration.shopatron.com/api/v2/orderNote/?orderID=44444
The body contains all the information about the note itself.
{
"note":"Here is another note.",
"public":true,
"userID":012210
}The returned response provides information about the note that was created, including the note text, user ID, order ID, and a new Order Note ID when applicable.
Release Notes
We strive to provide our users with steady updates and improvements. Check here to see the latest updates to your Kibo software.
Ideas
Let yourself be heard! Submit, vote, and debate on new features and improvements for the Kibo platform.
Contact Us
Still need help? Contact our Support Team.