Stock

curl -X PUT https://api-commerce.nucleoplatform.com/api/fulfillment/v1/stock \
  -H "Authorization: Bearer $NUCLEO_ACCESS_TOKEN" \
  -H 'Idempotency-Key: 2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f' \
  -H 'Content-Type: application/json' \
  -d '{
  "items": [
    {
      "sku": "TEE-BLK-M",
      "quantity": 42,
      "counted_at": "2026-10-13T06:00:00Z"
    },
    {
      "barcode": "2000000000022",
      "location_code": "VR1",
      "quantity": 3,
      "classification": "damaged"
    },
    {
      "sku": "SOCK-WHT-S",
      "quantity": 0
    }
  ]
}'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/fulfillment/v1/stock", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.NUCLEO_ACCESS_TOKEN}`,
    "Idempotency-Key": "2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "items": [
      {
        "sku": "TEE-BLK-M",
        "quantity": 42,
        "counted_at": "2026-10-13T06:00:00Z"
      },
      {
        "barcode": "2000000000022",
        "location_code": "VR1",
        "quantity": 3,
        "classification": "damaged"
      },
      {
        "sku": "SOCK-WHT-S",
        "quantity": 0
      }
    ]
  }),
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('PUT', 'https://api-commerce.nucleoplatform.com/api/fulfillment/v1/stock', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('NUCLEO_ACCESS_TOKEN'),
        'Idempotency-Key' => '2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f',
    ],
    'json' => [
        'items' => [
            [
                'sku' => 'TEE-BLK-M',
                'quantity' => 42,
                'counted_at' => '2026-10-13T06:00:00Z',
            ],
            [
                'barcode' => '2000000000022',
                'location_code' => 'VR1',
                'quantity' => 3,
                'classification' => 'damaged',
            ],
            [
                'sku' => 'SOCK-WHT-S',
                'quantity' => 0,
            ],
        ],
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "accepted": 2,
  "ignored": [
    {
      "index": 2,
      "sku": "SOCK-WHT-S",
      "barcode": null,
      "reason": "unknown_item"
    }
  ],
  "warnings": []
}

{
  "error": {
    "code": "validation_failed",
    "message": "The request is not valid.",
    "request_id": "1f7e3c2a-9b8d-4e6f-a5c4-3b2a1d0e9f8c",
    "details": {
      "lines.0.quantity": [
        "The lines.0.quantity field must be at least 0."
      ],
      "reason_code": [
        "The reason code field is required."
      ]
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key.",
    "request_id": "0b6c3e4f-1a2d-4c5b-8e7f-9a0b1c2d3e4f"
  }
}

{
  "error": {
    "code": "connection_paused",
    "message": "This connection is paused: nothing was changed.",
    "request_id": "3c2b1a0f-9e8d-4c7b-a6f5-4e3d2c1b0a9f"
  }
}

{
  "error": {
    "code": "order_not_accepted",
    "message": "Accept order",
    "request_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
  }
}

{
  "error": {
    "code": "validation_failed",
    "message": "string",
    "request_id": "9b2f4c1e-5d7a-4e8b-9c3d-2a1f0e6b7c8d",
    "details": {}
  }
}

{
  "error": {
    "code": "unknown_item",
    "message": "Some lines do not match an item of this order assigned to your warehouse. Nothing was changed.",
    "request_id": "2e1d0c9b-8a7f-4e6d-9c5b-4a3f2e1d0c9b",
    "details": {
      "lines.1": [
        "Not an item of this order assigned to your warehouse."
      ]
    }
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: retry after the number of seconds in Retry-After.",
    "request_id": "4f3e2d1c-0b9a-4f8e-8d7c-6b5a4f3e2d1c"
  }
}