Article Batches

POST

/master/article_batches/

master

Captures article current stock in store as batches, One article in a store can end up having current stock from different batches i.e supply at different times and possible different cost conditions and expiry.

Request

Header Params

X-SYNC-TOKEN

string

required

<sync_token>

Accept-Encoding

string

required

gzip (mandatory)

Body Params application/json

array of:

article_id

string

required

store_id

string

required

supplier_id

string

optional

item_row_id

string

optional

batch_id

string

required

mrc_no

string

optional

expiry_date

string <date>

optional

received_quantity

number <double>

optional

stock

number <double>

required

uom

number <double>

optional

cp_without_tax_per_unit

number <double>

optional

sp_without_tax_per_unit

number <double>

optional

tax_perc

number <double>

optional

discount_perc

number <double> | null

optional

received_date

string <date> | null

optional

purchase_date

string <date>

optional

Example

[
  {
    "article_id": "string",
    "store_id": "string",
    "supplier_id": "string",
    "item_row_id": "string",
    "batch_id": "string",
    "mrc_no": "string",
    "expiry_date": "2019-08-24",
    "received_quantity": 0,
    "stock": 0,
    "uom": 0,
    "cp_without_tax_per_unit": 0,
    "sp_without_tax_per_unit": 0,
    "tax_perc": 0,
    "discount_perc": 0,
    "received_date": "2019-08-24",
    "purchase_date": "2019-08-24"
  }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.your-api-server.com/master/article_batches/' \
--header 'X-SYNC-TOKEN;' \
--header 'Accept-Encoding;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "article_id": "string",
        "store_id": "string",
        "supplier_id": "string",
        "item_row_id": "string",
        "batch_id": "string",
        "mrc_no": "string",
        "expiry_date": "2019-08-24",
        "received_quantity": 0,
        "stock": 0,
        "uom": 0,
        "cp_without_tax_per_unit": 0,
        "sp_without_tax_per_unit": 0,
        "tax_perc": 0,
        "discount_perc": 0,
        "received_date": "2019-08-24",
        "purchase_date": "2019-08-24"
    }
]'

Responses

🟢200OK

application/json

Successful Sync

Body

status

string

optional

message

string

optional

Example

{
  "status": "string",
  "message": "string"
}

🟠403Forbidden

🟠405405

Modified at 2025-02-10 12:39:04

Stores**

Article Eans