/
Service Overview

Service Overview

Owned by Mark Rachelski
Last updated: 18 Sept, 2018

The aCommerce platform offers a rich set of services allowing a partner or channel to interact with it. These services are broken up into logical section related to the different service groups. Those groups are, in turn, hosted at specific domain names. This section summarizes those services to simplify a reader's discovery and navigation.

Common APIs

Common APIs are normally hosted at https://api.acommerce.asia and represent services that are used across all aCommerce Products. For example, all services require that the application accessing the platform be authenticated and therefore the authentication services are located here.

  • Authentication - The authentication services support allowing an application to develop an access token from a set of keys and secrets
  • WebHooks - Webhooks significantly improve notification time and help applications reduce resource usage by supporting push notification to that application about long running Order processing updates

Fulfillment Customer APIs

Fulfillment APIs are used once a sale has been made to provide that product to the Consumer. This also includes resources allowing a partner to manage their inventory held at aCommerce and seamlessly manage the quantity of product offered to sales channels for sale. These services are hosted at https://fulfillment.api.acommerce.asia 

  • Sales Orders - Used by partners or channels to submit an order to fulfill a sale
  • Sales Order Status Updates and Sales Order Status Events - Used to understand the processing progress of a Sales order from submission to delivery to the end-customer
  • Inventory Allocation - Inventory allocations represent the quantity of product made available for sale to a channel. This is frequently known as Available to Promise (ATP)

Shipping Customer APIs

Shipping APIs are used by shipping partners to notify aCommerce that a shipping job is required or to understand the progress of delivery against that shipment order.

WebHook Event Streams

An application may subscribe to multiple webhook event streams. The following list of event stream tokens describes the event streams that are currently available

  • SALES_ORDER_STATUS_V3 - webhook events that communicate changes to the processing progress of a Sales Order
  • SALES_ORDER_STATUS - a soon-to-be obsolete version of webhook events that communicate changes to the processing progress of a Sales Order. Developers are encouraged to subscribe to the SALES_ORDER_STATUS_V3 event stream instead.
  • SHIPPING_ORDER_STATUS - webhook events that communicate changes to the processing progress of a Shipping Order

Related content