Skip to end of banner
Go to start of banner

Outward Sales Posting APIs to POS (For Stores)

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Outbound | POST  | {Client’s URL}

Summary

This API will notify the POS system with Sales order details after the order completion in Increff system.

Description

This API will call the POS system with the details of sales orders which are completed in Increff system. This will be triggered at a certain frequency from Increff system to the POS system.

Postings can be sent on below triggers

  • SUBORDER_CREATE

  • SUBORDER_CANCEL

  • SUBORDER_COMPLETE

  • SUBORDER_PARTIAL_CANCEL

Request

{
  "billingAddress": {
    "city": "Bangalore",
    "country": "IN",
    "email": "ad******@gmail.com",
    "line1": "Shanti Nagar Kent",
    "line2": "South vihar colony",
    "line3": "string",
    "name": "Abhinav Singh",
    "phone": "98******78",
    "state": "KARNATAKA",
    "zip": "560102"
  },
  "channelName": "NYKAA",
  "channelType": "ERP",
  "createdAt": "23-08-2023T12:07:18",
  "credentials": {},
  "eventTime": "23-08-2023T12:09:18",
  "eventType": "SUBORDER_CANCEL",
  "isPriority": true,
  "locationCode": "1120004561",
  "messageId": 786651,
  "omsSubOrderId": 128876,
  "orderCode": "NYK-128839-1992",
  "orderTime": "23-08-2023T12:06:18",
  "orderType": "SALES",
  "parentOrderCode": "NYK-128839-1992",
  "paymentMethod": "COD",
  "shippingAddress": {
    "city": "Bangalore",
    "country": "IN",
    "email": "ad******@gmail.com",
    "line1": "Shanti Nagar Kent",
    "line2": "South vihar colony",
    "line3": "string",
    "name": "Abhinav Singh",
    "phone": "98******78",
    "state": "KARNATAKA",
    "zip": "560102"
  },
  "shippingCharges": 0,
  "subOrderItems": [
    {
      "barcode": "BAR00091",
      "cancelledQuantity": 0,
      "channelDiscount": 23.0,
      "channelSkuCode": "BAR00091",
      "fulfilledQuantity": 1,
      "giftChargePerUnit": 0,
      "hoppedQuantity": 0,
      "omsSubOrderItemId": 16624,
      "orderItemCodes": [
        "ITEM001"
      ],
      "orderedQuantity": 1,
      "sellerDiscount": 0,
      "sellingPricePerUnit": 1200,
      "shippingCharge": 0,
      "externalItemCodes": [
        "BAR00091"
      ]
      
    }
  ],
  "turnAroundTime": "23-10-2023T12:09:08",
  "virtualSkuDefinitions": [
    {
      "childSkus": [
        {
          "barcode": "BAR00091",
          "channelSkuCode": "BAR00091",
          "qty": 1
        }
      ],
      "virtualParentBarcode": "BAR00091",
      "virtualParentChannelSkuId": "BAR00091"
    }
  ]
}

 

 

Parameter

Data Type

Description

Mandatory

billingAddress

Object of type address

Billing Address

yes

billingAddress.city

String

City name

yes

billingAddress.country

String

Country Name

yes

billingAddress.email

String

email

yes

billingAddress.line1

String

address line 1

yes

billingAddress.line2

String

address line 2

no

billingAddress.lone3

String

address line 3

no

billingAddress.name

String

Name

yes

billingAddress.state

String

state name

yes

billingAddress.zip

String

zip code

yes

billingAddress.phone

String

phone number

yes

channelName

String

channel name

yes

channelType

“ERP”

channel type

yes

createdAt

String

created at time

yes

credentials

list of credentials

credentials

no

eventTime

String

time of the event

yes

eventType

String

Postings can be sent on below triggers

  • SUBORDER_CREATE (creation of sub order)

  • SUBORDER_CANCEL (cancellation of sub order)

  • SUBORDER_COMPLETE (completion of suborder)

  • SUBORDER_PARTIAL_CANCEL (partial cancellation of suborder)

yes

orderType

String

Can be - SO(Sales Order)/STO(Stock Transfer Order)/RTV(Return To Vendor), RPO(Replacement)

yes

isPriority

Boolean

Flag to identify wether an order is of priority or not

yes

locationCode

String

Warehouse location from which order was fulfilled

yes

messageId

Long

Unique Identifier of a notification (for De-duplication)

yes

omsSubOrderId

Long

Internal sub order id of OMS

yes

orderCode

String

order code from channel

yes

parentOrderCode

String

parent order code from channel

no

paymentMethod

String

possible values- COD/NCOD

yes

shippingAddress

Object of type Address

Address

yes

shippingAddress.city

String

City name

yes

shippingAddress.country

String

Country name

yes

shippingAddress.line1

String

address line 1

yes

shippingAddress.line2

String

address line 2

no

shippingAddress.line3

String

address line 3

no

shippingAddress.name

String

name

yes

shippingAddress.state

String

state name

yes

shippingAddress.zip

String

pin code

yes

shippingAddress.email

String

email address

yes

shippingAddress.phone

String

phone nymber

yes

shippingCharges

Double

Shipping charge

no

subOrderItems

yes

subOrderItems.barcode

String

barcode

yes

subOrderItems.cancelledQuantity

Integer

cancelled quantity

yes

subOrderItems.channelDiscount

Double

discount from the channel

no

subOrderItems.channelSkuCode

String

Sku Code on channel side

yes

subOrderItems.fulfilledQuantity

Long

fulfilled quantity

yes

subOrderItems.giftChargePerUnit

Double

giftChargePerUnit

no

subOrderItems.hoppedQuantity

Long

hoppedQuantity

yes

subOrderItems.omsSubOrderItemId

Long

sub order item id in oms

yes

subOrderItems.orderItemCodes

List<String>

list of order item codes

yes

subOrderItems.orderedQuantity

Long

ordered quantity

yes

subOrderItems.sellerDiscount

Double

seller discount

no

subOrderItems.sellingPricePerUnit

Double

selling price per item

no

subOrderItems.shippingCharge

Double

shipping charde

no

subOrderItems.externalItemCodes

List of String

list of item codes

no

turnAroundTime

String

turn around time

no

virtualSkuDefinitions

no

virtualSkuDefinitions.childSkus

List

List of child skus

no

virtualSkuDefinitions.virtualParentBarcode

String

Virtual Parent barcode

no

virtualSkuDefinitions.virtualParentChannelSkuId

String

Virtual Parent channel SKU id

yes

virtualSkuDefinitions.childSkus.barcode

String

barcode

no

virtualSkuDefinitions.childSkus.qty

Integer

quantity

no

virtualSkuDefinitions.childSkus.channelSkuCode

String

channel SKU code

no

Response

{
    "hasError": false,
    "errorMessage":"message"
}

 

HttpStatus : 200

  • No labels