Update Inventory

Action types

Type	Description
increment	You'll use this when you receive stock from a supplier, making products available for purchase
decrement	You'll use this when you want to remove stock from product inventory
allocate	You'll use this when you want to allocate stock, normally to a reseller who will sell on the stock
deallocate	You'll use this when you want to deallocate any previously allocated stock

Create a Stock Transaction for a Product

POST https://api.moltin.com/v2/inventories/:productId/transactions

Path Parameters

Name	Type	Description
productId	string	The ID for the product you're performing this action on

Headers

Name	Type	Description
Authorization	string	The Bearer token to grant access to the API

Request Body

Name	Type	Description
quantity	integer	The amount of stock affected by this transaction
action	string	increment, decrement, allocate, deallocate
type	string	Always stock-transaction

200 You will get the response below for any of the action types.

{
  "data": {
    "id": "da9a0008-d2c4-4a17-bbc6-5e0b2f9430aa",
    "type": "stock-transaction",
    "action": "increment",
    "product_id": "9eda5ba0-4f4a-4074-8547-ccb05d1b5981",
    "quantity": 10,
    "timestamps": {
      "created_at": "2018-05-01 10:10:57 +0000 UTC"
    }
  }
}

422 You will get an error if you try to perform an action with incorrect amounts

{
  "errors": [
    {
      "status": 422,
      "title": "Cannot complete request",
      "detail":
        "Your request could not be completed due to insufficient stock levels"
    }
  ]
}

cURL

curl -X POST https://api.moltin.com/v2/inventories/:productId/transactions \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
       "data": {
         "type": "stock-transaction",
         "action": "increment",
         "quantity": 10
       }
     }'

JavaScript SDK

const MoltinGateway = require('@moltin/sdk').gateway

const Moltin = MoltinGateway({
  client_id: 'X',
  client_secret: 'X'
})

const productId = 'XXXX'
const quantity = 10

Moltin.Inventories.IncrementStock(productId, quantity).then(transaction => {
  // Do something
})

Moltin.Inventories.DecrementStock(productId, quantity).then(transaction => {
  // Do something
})

Moltin.Inventories.AllocateStock(productId, quantity).then(transaction => {
  // Do something
})

Moltin.Inventories.DeallocateStock(productId, quantity).then(transaction => {
  // Do something
})

Moltin Request

const { MoltinClient } = require('@moltin/request')
​
const client = new MoltinClient({
  client_id: 'X',
  client_secret: 'X'
})

const productId = 'XXXX'​

client
  .post(`inventories/${productId}/transactions`, {
    type: "stock-transaction",
    action: "increment",
    quantity: 10
  })
  .then(inventory => {
    // Do something...
  })
  .catch(console.error)