Intro to Inventory

The Rackbeat Inventory Management API provides endpoints for managing your warehouse operations, including stock adjustments, internal movements, checking processes, and inventory transactions. This API focuses on practical inventory control operations rather than basic item management.


Core Inventory Operations


Checking Drafts

Manage inventory checking processes with draft entries before finalizing stock counts.

Key Endpoints:

  • GET /inventory/checking-drafts - List checking drafts with pagination
  • POST /inventory/checking-drafts - Create new checking draft entries
  • POST /inventory/checking-drafts/book-all - Process all open checking drafts
  • POST /inventory/checking-drafts/{id}/book - Process individual checking draft
  • DELETE /inventory/checking-drafts/delete-all - Remove all open checking drafts

What you get: Basic checking draft data including item numbers, locations, quantities, and booking status. Each draft contains user information, timestamps, and whether it's in booking state.


Transport Movements (internal)

Handle transfers of inventory between different warehouse locations.

Key Endpoints:

  • GET /inventory/internal-movements - List movements with filtering options
  • POST /inventory/internal-movements - Create new internal movement
  • POST /inventory/internal-movements/{id}/book - Finalize movement transaction
  • POST /inventory/internal-movements/{id}/create-receipt - Generate receipt for movement
  • GET /inventory/internal-movements/{id}/lines-missing-stock - Check stock availability

What you get: Detailed movement records including from/to locations with hierarchical structure, transport locations, movement state (booked/received status), expected arrival dates, reason descriptions, and creator information. Location data includes nested warehouse structure with parent/child relationships.

Filtering Available:

  • Date ranges (dateFrom, dateTo)
  • Item numbers (itemNumber)
  • Source and destination locations (fromLocation, toLocation)
  • Booking and receipt status (booked, received)
  • Archive status (is_archived)

Transport Movement Receipts

Manage the receiving process for internal movements.

Key Endpoints:

  • GET /inventory/internal-movement-receipts - List movement receipts
  • POST /inventory/internal-movement-receipts/{id}/receive - Mark receipt as received
  • GET /inventory/internal-movement-receipts/{id}/lines - List receipt line items

What you get: Receipt tracking with received status and associated internal movement references.


Inventory Adjustments Categories

Manage predefined categories for inventory adjustments.

Key Endpoints:

  • GET /regulation-types - List available regulation types
  • POST /regulation-types - Create new regulation type
  • PUT /regulation-types/{id} - Update regulation type
  • DELETE /regulation-types/{id} - Remove regulation type

What you get: Regulation type definitions for categorizing inventory adjustments.


Inventory Adjustments

Process inventory quantity and value adjustments for stock corrections.

Key Endpoints:

  • GET /inventory-adjustments - List adjustments with filtering
  • POST /inventory-adjustments - Create new adjustment
  • POST /inventory-adjustments/book-all - Process all pending adjustments
  • POST /inventory-adjustments/{id}/book - Process individual adjustment

What you get: Comprehensive adjustment records including detailed item information (product data, stock quantities, pricing, supplier details), location hierarchy, quantity changes, value adjustments, and regulation timestamps. Product data includes physical properties, batch/serial number settings, and group classifications.

Filtering Available:

  • Date ranges (dateFrom, dateTo)
  • Item numbers (itemNumber)

Inventory Movements

Track general inventory movements and transactions.

Key Endpoints:

  • GET /inventory-movements - List movements with extensive filtering
  • POST /inventory-movements - Create new movement record
  • POST /inventory-movements/book-all - Process multiple movements
  • GET /inventory-movements/{id} - Get detailed movement information

What you get: Movement transaction data with detailed tracking information.


Inventory Transactions

Access historical transaction records for audit and reporting.

Key Endpoints:

  • GET /inventory-transactions - List transaction history

What you get: Historical transaction data for inventory tracking and auditing.


Common Response Patterns


Pagination

List endpoints return paginated results:

{
  "data": [...],
  "total": 150,
  "pages": 8,
  "limit": 20,
  "page": 1
}

Location Structure

Location data includes hierarchical warehouse organization:

{
  "name": "Afsnit A",
  "number": 1030,
  "barcode": "",
  "parent_id": 1027,
  "nesting_level": 2,
  "nest_list": [
    {"number": 1004, "name": "Lager Sjælland"},
    {"number": 1027, "name": "Række 4"},
    {"number": 1030, "name": "Afsnit A"}
  ]
}

State Tracking

Movement and adjustment records include status information:

{
  "state": {
    "booked": true,
    "partly_received": false,
    "received": false,
    "has_pending_receipt": false
  }
}

Practical Workflows


Stock Checking Process

  1. Create checking drafts for items to be counted (ℹ️ Checking / stock counting is done via the Rackbeat mobile app)
  2. Review and verify draft entries
  3. Book individual drafts or process all at once
  4. Delete incorrect drafts if needed

Internal Transfer Process (Transport)

  1. Create internal transport movement between locations
  2. Check for missing stock before booking
  3. Book the movement to commit the transfer
  4. Create receipt for destination location
  5. Mark receipt as received when items arrive

Inventory Adjustment Process

  1. Create adjustment records for quantity/value corrections
  2. Review adjustment details and item information
  3. Book adjustments individually or in batches
  4. Track processed adjustments for audit purposes

Best Practices


  • Use appropriate filtering to reduce response sizes
  • Leverage pagination for large datasets
  • Check stock availability before creating movements
  • Process drafts and adjustments in logical batches
  • Include reason descriptions for internal movements