Overview of API Integration

Overview of API Integration

Overview
API
integration enables data communication between an online store and POS.

The following APIs are provided
  1. An item with rate and stock API (List all items)
  2. Sales order APIs (Create a sales order List all sales orders, retrieve a sales order)

API to get Items with rate and stock
  • To List all Items
Items Attributes
    

Attributes

Description

Data Type

Length

itemId

Item Code

Int


itemName

Item Name

string

100

locationId

Item Branch Id

Int


Stock

List of details about item

array



stock

Item Stock detail

Decimal

20

mrp

Item Mrp Price

Decimal

20

salePrice

Item Sell Price

Decimal

30

itemReferenceCode

Unique Id of each combination of a matrix items

String


taxPercentage

Item Tax Percentage

Decimal

20

discountpercentage

item discount percenatage

Decimal

53

itemTimeStamp

itemTimeStamp

Numeric



For more details on API for items, click the link below:

API for List all Items


API for Sales order
  • To Create a sales order
  • To Retrieve a sales order
  • To List all sales orders

Sales Order Attributes
    

totalTaxAmount

Total Tax Amount

decimal

15

totalDiscountAmount

Total Discount Amount

decimal

15

courierPartner

Courier Vendor Name

string

50

shippingId*

Shipping Id

string

40

shippingName*

Shipping Name

string

100

shippingAddress1*

Shipping Address 1

string

100

ShippingAddress2

Shipping Address 2

string

100

shippingPlace

Shipping Place

string

50

shippingState*

Shipping State

string

50

shippingCountry*

Shipping Country

string

50

shippingPincode*

Shipping Address Pincode

string

10

shippingPhone

Shipping Address Phone Number

string

50

shippingMobile*

Shipping Owner Mobile Number

string

40

shippingEmail*

Shipping Owner Email Id

string

50

shippingCharge

Shipping Charge

decimal

15

shippingMethod (String)

Shipping Method (EXP -Speed ,ECN -Economy)

string

50

ShipmentPointsUsed

Customer reward points[Total accumulated points till now]

decimal

15

shipmentItems

Total line items counts

Int


shipmentAbn

Airway bill number

string

50

shipmentWeight

shipment weight

decimal

50

discountCoupon

Discount coupon name

string

50

deliveryDate*

Order Delivery Time (YYYY-MM-DD HH:MM:SS)

datetime

100

locationId

Order Branch Id

numeric


userId

UserId of Ecommerce user

string

15

OrderItems
Order details of the items


rowNo

Serial Number Of Item

numeric


itemId*

Item Id

numeric


itemName

Item Name

string


itemReferenceCode*

Unique Id of each combination of a matrix items

string


salePrice

Item Sale Price inclusive of tax & exclusive of discount

decimal


quantity*

Item Sale Quantity

numeric


itemAmount

Item Amount inclusive of tax & exclusive of discount

decimal


taxPercentage

Particular Item Tax Id

numeric


discountPercentage

Particular Item discount Percentage

decimal


itemRemarks

Item remarks

string


itemMarketPrice

Item MRP/Market price

decimal


customerId*

Customer Code

numeric


customerName*

Customer Name

string

100

customerType

Customer Type

string

50

customerAddressLine1

Address Line1

string

250

customerAddressLine2

Address Line2

string

250

customerAddressLine3

Address Line3

string

250

customerArea

Customer Area

string

80

customerCity

Customer City

string

50

customerState

Customer State

string

50

customerCountry

Customer Country

string

50

customerPincode*

Customer Address Pincode

string

Int

customerPhone

Customer Phone number

string

30

customerMobile*

Customer Mobile Number

string

40

customerEmail*

customerEmail

string

100


Note:
The attributes marked as '*' are mandatory.

For more details on sales order API, click the links below:
API for Create a sales order
API for List all sales orders
API for Retrieve a sales order