Skip to main content
POST
/
v1
/
stocks
/
transfer
Create a stock transfer
curl --request POST \
  --url https://dev.flextell.ai/api/v1/stocks/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant: <x-tenant>' \
  --data '
{
  "product_id": 2,
  "source_warehouse_id": 2,
  "destination_warehouse_id": 2,
  "quantity": 1.0001,
  "notes": "<string>"
}
'
{
  "success": "<string>",
  "data": {
    "id": 123,
    "product": {
      "id": 123,
      "name": "<string>"
    },
    "source_warehouse": {
      "id": 123,
      "name": "<string>"
    },
    "destination_warehouse": {
      "id": 123,
      "name": "<string>"
    },
    "quantity": 123,
    "unit_label": "<string>",
    "user": {
      "id": 123,
      "name": "<string>"
    },
    "notes": "<string>",
    "transferred_at": "2023-11-07T05:31:56Z",
    "source_movement": {
      "id": 123,
      "product": {
        "id": 123,
        "name": "<string>"
      },
      "warehouse": {
        "id": 123,
        "name": "<string>"
      },
      "type": "<string>",
      "direction": "<string>",
      "quantity": 123,
      "unit_label": "<string>",
      "reference": "<string>",
      "user": {
        "id": 123,
        "name": "<string>"
      },
      "notes": "<string>",
      "effective_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "destination_movement": {
      "id": 123,
      "product": {
        "id": 123,
        "name": "<string>"
      },
      "warehouse": {
        "id": 123,
        "name": "<string>"
      },
      "type": "<string>",
      "direction": "<string>",
      "quantity": 123,
      "unit_label": "<string>",
      "reference": "<string>",
      "user": {
        "id": 123,
        "name": "<string>"
      },
      "notes": "<string>",
      "effective_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "movements": [
      {
        "id": 123,
        "product": {
          "id": 123,
          "name": "<string>"
        },
        "warehouse": {
          "id": 123,
          "name": "<string>"
        },
        "type": "<string>",
        "direction": "<string>",
        "quantity": 123,
        "unit_label": "<string>",
        "reference": "<string>",
        "user": {
          "id": 123,
          "name": "<string>"
        },
        "notes": "<string>",
        "effective_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
X-Tenant
number
required

Tenant identifier. Send the Tenant ID in the X-Tenant header to scope API requests to a specific tenant.

Body

application/json
​
product_id
integer
required

Filter by product ID.

Required range: x >= 1
​
source_warehouse_id
integer
required

Source warehouse ID.

Required range: x >= 1
​
destination_warehouse_id
integer
required

Destination warehouse ID.

Required range: x >= 1
​
quantity
number
required

The quantity value.

Required range: x >= 0.0001
​
notes
string | null

Internal notes.

Maximum string length: 65535

Response

​
success
string
required
​
data
StockTransferResource · object
required