Create a sales order

🚧

Beta — the Reseller API is in active development and endpoints, fields and behaviour may change. What beta means

Creates an order directly in Syntech's accounting system. API orders don't appear in your order history on syntech.co.za — keep the salesorder number from the response to link the order to your system and to check its status.

  • reference — your customer reference assigned to the order.
  • backorder — yes or no. If no and stock is insufficient at your location, the order is not created (RC9). If yes, the order is created and backordered items are listed in the response.
  • shipping.type — delivery or collection. Syntech shipping fees apply to orders below the free-shipping threshold.
  • shipping.location — for delivery: a full address object, validated against Google Geolocation (RC10 on mismatch). For collection: the string cpt or jhb.
  • lineitems — a SKU → quantity map. Prices come from your Syntech reseller account.

Error codes (RC)

CodeMeaning
RC1Your account is not allowed to post orders directly
RC2No Fincon account number attached to reseller account
RC3Account not found on Fincon
RC4Product not found
RC5Shipping data not set
RC6Shipping type not set
RC7Shipping address not set
RC8Shipping location not found
RC9Not enough stock at location
RC10Invalid delivery address
RC11Shipping item not found
RC12Google address verification offline
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Your customer reference number for the order.

string
enum
required

Whether to backorder items with insufficient stock at your location.

Allowed:
shipping
object
required
lineitems
object
required

SKU → quantity map. Prices come from your Syntech reseller account.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json