Add New Stock Transaction

Production

https://{{subdomain}}.daftra.com/api2

POST

/stock_transactions{format}

Creates a manual stock adjustment (a stock-in or stock-out transaction) for a product in a warehouse.

The request body is wrapped under a StockTransaction object. The target product must be active and quantity-tracked (products tracked by serial/lot use Requisitions instead).

Server-controlled fields are set automatically and ignored if supplied: the source is fixed to Manual, the status to Processed, and order_id, staff_id, and branch_id are assigned by the server.

On success the endpoint responds with 202 Accepted and the new transaction id.

Requires the Adjust Product Inventory permission.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The stock transaction was created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/stock_transactions.json' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "StockTransaction": {
    "product_id": 55,
    "store_id": 3,
    "transaction_type": 1,
    "quantity": 10,
    "price": 25.5,
    "currency_code": "USD",
    "received_date": "15/06/2026",
    "transaction_category_id": ["Adjustment"],
    "notes": "Initial count"
  }
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 1024
}

GET Single Stock Transaction

Edit Stock Transactions