iotoms Docs

Add items to a stock transfer

POST
/api/v1/inventory/transfers/{id}/items

Adds item lines to a transfer that is still in draft. Transfers in any other status are rejected.

How to use it

  1. Get the transfer ID from List stock transfers; it must still be DRAFT.
  2. Send the new lines with item codes from List items and requested quantities; existing lines are kept.
  3. The response shows all lines; stock still does not move until the transfer is confirmed.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

Request Body

application/json
  1. body
items*array<>

Item lines to append to the draft transfer. Existing lines are kept.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?

The stock transfer as it now stands, with its item lines and quantity totals.

Example Request
curl -X POST 'https://beta.iotoms.com/api/v1/inventory/transfers/497f6eca-6276-4993-bfeb-53cbbbba6f08/items' \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "itemId": "string",      "requestedQty": 0    }  ]}'
Example Response
{  "status": "string",  "message": "string",  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "transferNumber": "string",    "transferType": "VAN_LOADING",    "fromLocationId": "178bb398-90d2-4fc3-a4a0-37fc0eed2806",    "fromLocationName": "string",    "toLocationId": "e81ad314-9cb9-45ae-9ad9-f1b5ebcc7aae",    "toLocationName": "string",    "status": "DRAFT",    "referenceId": "8502eb05-558d-4480-8511-c1011710b340",    "referenceType": "string",    "transferDate": "2019-08-24",    "expectedReceiptDate": "2019-08-24",    "confirmedBy": "string",    "confirmedAt": "2019-08-24T14:15:22Z",    "receivedBy": "string",    "receivedAt": "2019-08-24T14:15:22Z",    "notes": "string",    "items": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "itemId": "string",        "itemName": "string",        "requestedQty": 0,        "dispatchedQty": 0,        "receivedQty": 0,        "varianceQty": 0,        "unitCost": 0,        "notes": "string"      }    ],    "totalItems": 0,    "totalRequestedQty": 0,    "totalDispatchedQty": 0,    "totalReceivedQty": 0,    "totalVarianceQty": 0,    "createdAt": "2019-08-24T14:15:22Z"  }}