Identifier movements
Read-only. Which serials and lots moved on which shipment or receipt. Written by the transaction that moved them, never directly - a movement with no transaction behind it would be a stock record nothing can explain.
The object#
| Field | Type | Description |
|---|---|---|
| idread-only | integer | NolaPro id. |
| itemidentifierdetailid | integer | Itemidentifierdetailid. Id only. |
| itemtransactionidread-only | integer | The inventory transaction that moved these units. The stock ledger is not exposed. Read-only. |
| quantityqty | string(6dp) | Quantity, 6 decimal places, as a string. Stored as decimal(6dp). |
| inventorylocationid | integer | Inventorylocationid. Id only. |
| trtype | integer | Movement type: 1 = committed to an order, 2 = purchase (PO receipt), 3 = sales/use (shipment), 4 = manual adjustment. |
| referencetable | string(100) | Table of the document that moved the identifier (invreceive, arordershipdetail, rma_arorder_detail_returned, ...). |
| referenceid | integer | Referenceid. Id only. |
| description | string(100) | User-visible note on the movement. |
| cancel | boolean | Cancelled. NolaPro cancels rather than deletes, so a cancelled row is still readable. |
| entrydate | string | When the record was created. |
Endpoints#
GET/itemidentifiertransactions
200403
List identifier movements.
Requires scope items:read.
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| inventorylocationid | query | string | Restrict to one inventorylocationid. |
| description | query | string | description. Partial match, case-insensitive. |
| cancel | query | string | Defaults to false. Pass true or any. |
| include | query | string | Comma-separated extras to embed. Only custom_fields is available: the extra fields this install has defined on the record. Off by default, and an unrecognised value is refused rather than ignored. See Conventions. |
When it fails
| Status | Code | Meaning |
|---|---|---|
| 403 | insufficient_scope | Token lacks read scope. |
curl \ 'https://acme.nolapro.com/!/api/v2/itemidentifiertransactions' \ -H 'Authorization: Bearer $NP_TOKEN'
$ch = curl_init('https://acme.nolapro.com/!/api/v2/itemidentifiertransactions'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NP_TOKEN')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true);
import os, requests r = requests.get( "https://acme.nolapro.com/!/api/v2/itemidentifiertransactions", headers={"Authorization": f"Bearer {os.environ['NP_TOKEN']}"}, ) r.raise_for_status()
const res = await fetch( 'https://acme.nolapro.com/!/api/v2/itemidentifiertransactions', { method: 'GET', headers: { Authorization: `Bearer ${process.env.NP_TOKEN}` }, } ); const data = await res.json();
using System.Net.Http.Json; var token = Environment.GetEnvironmentVariable("NP_TOKEN"); using var http = new HttpClient(); http.DefaultRequestHeaders.Add("Authorization", "Bearer " + token); var res = await http.GetAsync( "https://acme.nolapro.com/!/api/v2/itemidentifiertransactions"); res.EnsureSuccessStatusCode();
GET/itemidentifiertransactions/{id}
200404
Retrieve one record.
Requires scope items:read.
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| idrequired | path | integer | The record id. |
| include | query | string | Comma-separated extras to embed. Only custom_fields is available: the extra fields this install has defined on the record. Off by default, and an unrecognised value is refused rather than ignored. See Conventions. |
When it fails
| Status | Code | Meaning |
|---|---|---|
| 404 | not_found | No record with that id. |
curl \ 'https://acme.nolapro.com/!/api/v2/itemidentifiertransactions/104' \ -H 'Authorization: Bearer $NP_TOKEN'
$ch = curl_init('https://acme.nolapro.com/!/api/v2/itemidentifiertransactions/104'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NP_TOKEN')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true);
import os, requests r = requests.get( "https://acme.nolapro.com/!/api/v2/itemidentifiertransactions/104", headers={"Authorization": f"Bearer {os.environ['NP_TOKEN']}"}, ) r.raise_for_status()
const res = await fetch( 'https://acme.nolapro.com/!/api/v2/itemidentifiertransactions/104', { method: 'GET', headers: { Authorization: `Bearer ${process.env.NP_TOKEN}` }, } ); const data = await res.json();
using System.Net.Http.Json; var token = Environment.GetEnvironmentVariable("NP_TOKEN"); using var http = new HttpClient(); http.DefaultRequestHeaders.Add("Authorization", "Bearer " + token); var res = await http.GetAsync( "https://acme.nolapro.com/!/api/v2/itemidentifiertransactions/104"); res.EnsureSuccessStatusCode();
Response 200
{
"itemidentifierdetailid": 104,
"quantity": "1.000000",
"inventorylocationid": 104,
"trtype": 1,
"referencetable": "Example referencetable",
"referenceid": 104
}