Insert/Update Stock

Deprecated

POST

/api

Last modified:2024-08-14 15:23:42

It's possible to insert or update the starting stock.

To do so, the following JSON body must be passed to the insertStocks_v3 web service.

{
    "stocksRecords": [
        {
            "goods": {
                "entityCode": "",
                "year": "",
                "movementDate": "",
                "causal": ""
            },
            "rows": [
                {
                    "quantity": "",
                    "barcode": ""
                },
                {
                    "quantity": "",
                    "barcode": ""
                },
                {
                    "quantity": "",
                    "barcode": ""
                }
            ]
        }
    ]
}

goods section

Field	Type	Description	Mandatory
entityCode	string	Entity code	✓
causal	string	Causal code	✓
year	number	Document year	✓
movementDate	date	Movement date	✓

rows section - an array composed as follows

Field	Type	Description	Mandatory
barcode	string	Item barcode	✓
quantity	number	Item quantity	✓

Notes

There's a limit of 100 calls for this API.

Request

Query Params

Header Params

Body Params application/json

Example

{
    "stocksRecords": [
        {
            "goods": {
                "entityCode": 10,
                "year": 2021,
                "movementDate": "2021-01-20 04:36:01",
                "causal": "STOCK"
            },
            "rows": [
                {
                    "quantity": 0,
                    "barcode": "8000200618755"
                },
                {
                    "quantity": 0,
                    "barcode": "8009495453546"
                },
                {
                    "quantity": 0,
                    "barcode": "1000011698011"
                },
                {
                    "quantity": -8,
                    "barcode": "8000200559614"
                },
                {
                    "quantity": 0,
                    "barcode": "8000200559621"
                },
                {
                    "quantity": 0,
                    "barcode": "8000200619745"
                },
                {
                    "quantity": -5,
                    "barcode": "8000200621861"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api?cmd=insertStocks_v3&appId=KEEPIT&applicationId=KEEPIT' \
--header 'username: {{USERNAME}}' \
--header 'password: {{PASSWORD}}' \
--header 'companyId: {{COMPANY_ID}}' \
--header 'siteId: {{SITE_ID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "stocksRecords": [
        {
            "goods": {
                "entityCode": 10,
                "year": 2021,
                "movementDate": "2021-01-20 04:36:01",
                "causal": "STOCK"
            },
            "rows": [
                {
                    "quantity": 0,
                    "barcode": "8000200618755"
                },
                {
                    "quantity": 0,
                    "barcode": "8009495453546"
                },
                {
                    "quantity": 0,
                    "barcode": "1000011698011"
                },
                {
                    "quantity": -8,
                    "barcode": "8000200559614"
                },
                {
                    "quantity": 0,
                    "barcode": "8000200559621"
                },
                {
                    "quantity": 0,
                    "barcode": "8000200619745"
                },
                {
                    "quantity": -5,
                    "barcode": "8000200621861"
                }
            ]
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{}

🟠422Unique constraint error

Modified at 2024-08-14 15:23:42

Get Stock CSV

Insert/Update sales