Documentation Index

Fetch the complete documentation index at: https://docs.abakion.com/llms.txt

Use this file to discover all available pages before exploring further.

Setup and Core Flow

Prev Next

Feature Overview

The Rental Setup and Core Rental Flow is the foundation of the Rental Management app. It enables companies to rent out physical inventory items to customers using standard Business Central sales orders — without having to leave the familiar sales order interface. The key concept is a "swap": when a sales order line contains an item marked for rental, the system automatically swaps the item line into a resource line at the time of posting. The resource line represents the rental fee, while the item itself is tracked logistically via a transfer order that moves the item from your stock location to the rental location and back again when the customer returns it.

Each rental line carries full rental metadata: which rental category (resource) governs the pricing, the rental duration (quantity × unit of measure), the calculated rental return date, and the locations involved for outbound and inbound transfers. When the sales order is shipped, the system records the exact start date and time of the rental on a Rental Relation Line — a behind-the-scenes tracking record that links the sales line to the transfer orders and carries the full financial and logistical history of the rental.

The Rental Setup allows you to configure default behaviour globally and optionally override it per customer. Settings control which locations are used for the rental stock, transit, and return; whether direct transfers are used; how dimensions are handled during the swap; and whether the standard sales posting route is allowed or if only the rental posting route is permitted. This layered setup approach means most companies configure one global default and only create customer-specific setups where deviations are needed.

Key Facts

Topic Details
Primary setup page Rental Setup
Rental line configuration Sales Order (subform), Sales Quote (subform)
Transfer order management Automatic — created, updated, and deleted by the system
Rental relation tracking Rental Relation Lines (accessible from the sales order)
Supported document types Sales Orders, Sales Quotes (converted to orders)
Rental categories Defined on the Rental Categories page (each category = a Resource)
Location flow Home location → Transit location → Rental location (outbound) / Rental location → Transit → Return location (inbound)
In-transit location support If rental location is flagged as in-transit, a single transfer order handles both directions
Direct transfer option Outbound only, Inbound only, or Both
Swap timing At shipment posting (item line → resource line)
Customer-specific setup Supported — one setup per customer, fallback to global default

Getting Started

Follow these steps to get from zero to a working rental order:

  1. Create a Resource for each rental category. Go to Resources and create one resource per type of rental (e.g. "SCAFFOLD-DAY", "CRANE-WEEK"). Set a Base Unit of Measure on the resource — this is mandatory.

  2. Configure Rental Categories. Go to Rental Setup → navigate to Rental Categories. For each resource, create a Rental Category entry, link it to the resource, and set the Duration (in milliseconds) that matches the base unit of measure (e.g. 86,400,000 ms = 1 day).

  3. Set up locations. Ensure you have at minimum: a home stock location (where rental items live), a rental/customer-facing location, and optionally a transit location and a return location. If your rental location is flagged as "Use As In-Transit", you only need two locations.

  4. Create a global Rental Setup record. Go to Rental Setup and create a record with a blank Customer field. Fill in: Default Rental Location Code, Default Transit Location Code, Default Return Location Code, Default Rental Category, and Default Unit of Measure Code. Choose the Employ Direct Transfer? setting.

  5. (Optional) Create customer-specific Rental Setup records. For customers that need different defaults, create additional Rental Setup records with the customer number filled in.

  6. Mark items as rental items. Open the Item Card for each item you rent out. On the Rental tab, enable the Rental Item toggle. Optionally set a Return Location Code at the item level.

  7. Create a Sales Order. Add a line with Type = Item and select a rental item. The Rental Line checkbox will be available in the subform. Fill in the Rental No. (rental category), Rental Unit of Measure Code, and Rental Quantity.

  8. Verify the Rental Return Date. The system calculates this automatically from the shipment date and the rental duration. Review it on the sales line.

  9. Post the shipment. The system performs the swap: the item line is replaced with a resource line, and transfer orders are created to handle the physical movement of the item.

  10. Post the invoice. Post the sales invoice to bill the customer for the rental period.


Related Features

Rental Prices are closely tied to the core rental flow — the rental unit price on a sales line is looked up automatically from the Rental Prices setup whenever the rental category, unit of measure, or quantity changes. Price Scales extend pricing further by defining tiered price factors over the duration of a rental, and are applied on top of the base rental price. The Rental Calendar feature adjusts how elapsed time is counted during a rental — calendar entries with a time factor of 0 create pauses in the chargeable period, which directly affects how the Rental Invoicing Plan generates invoice lines. The Rental Invoicing Plan is the structured invoicing mechanism that uses price scales and calendars together to calculate and pre-plan how rental invoices will be split over time. Finally, the Item Return, Replacement, and Suspension features depend entirely on an active rental relation line being present — which is created by the core rental flow at the time of shipment.


User Stories

US-01: Configure a global rental default setup

As a Business Manager
I want to create a default Rental Setup record that applies to all customers
So that rental lines on sales orders are pre-populated with the correct locations and rental category without manual input

Setup:

  1. Go to Rental Setup.
  2. Create a new record and leave the Customer field blank — this makes it the global default.
  3. Fill in Default Rental Location Code — the location items are transferred to when rented out.
  4. Fill in Default Transit Location Code — used when two separate transfer orders are needed.
  5. Fill in Default Return Location Code — the location items come back to after rental.
  6. Fill in Default Rental Category — the resource used to invoice when no specific rental price is found.
  7. Fill in Default Unit of Measure Code — the default rental time unit.
  8. Set Employ Direct Transfer? to control whether outbound, inbound, or both transfer orders should be posted as direct transfers.
  9. Save the record.

Note: If the rental location is set up as an in-transit location in BC, only one transfer order will be created (handling both shipment and return). In this case, Default Transit Location Code is not needed.

US-02: Create a customer-specific rental setup

As a Business Manager
I want to override the global rental defaults for a specific customer
So that rental orders for that customer automatically use different locations or a different rental category

Setup:

  1. Go to Rental Setup.
  2. Create a new record and fill in the Customer field with the customer number.
  3. Fill in any fields that should deviate from the global default — only the fields you fill in will be used; any blank fields will fall back to the global setup.
  4. Save the record.

Note: The system always looks for a customer-specific setup first. If none is found, it uses the global (blank customer) setup. At least one global setup record must exist.

US-03: Define a rental category linked to a resource

As a Business Manager
I want to set up rental categories that define how rental time is measured
So that the system can calculate rental return dates and look up rental prices correctly

Setup:

  1. Go to Rental Setup → action Rental Calendar Setup (or navigate directly to Rental Categories).
  2. Create a new Rental Category. The Resource field links the category to a BC resource — this resource will appear on the swapped sales line.
  3. Set the Duration to the length of the base unit of measure in milliseconds. Examples: 1 day = 86,400,000 ms; 1 hour = 3,600,000 ms; 1 week = 604,800,000 ms.
  4. The Base Unit of Measure is read-only and comes from the resource's base UOM.
  5. Save the record.

Note: The Duration must be at least the minimum rental period (1 millisecond). The duration is what the system uses when calculating how many rental periods fit between the shipment date and the rental return date.

US-04: Mark an item as a rental item

As a Business Manager
I want to flag items as rental items and optionally set a default return location on the item
So that the rental functionality is automatically applied when those items are added to a sales order

Setup:

  1. Open the Item Card for the relevant item.
  2. Locate the Rental Item field and enable it.
  3. Optionally fill in Return Location Code if this item should always be returned to a specific location, overriding the setup default.
  4. Save the item card.

Note: Enabling Rental Item on the item card does not automatically add rental information to new sales lines — it controls visibility and default behaviour in the rental flow.

US-05: Create a rental line on a sales order

As a Sales Order Processor
I want to add a rental line to a sales order
So that the customer is billed for the rental and the item is transferred logistically

Setup:

  1. Create or open a Sales Order.
  2. Add a line with Type = Item and enter the rental item in No..
  3. In the sales line, locate Rental No. and select the appropriate rental category (resource).
  4. Fill in Rental Unit of Measure Code (e.g. DAY, WEEK).
  5. Fill in Rental Quantity (the number of rental periods).
  6. Review Rental Return Date — the system calculates this automatically. Adjust manually if needed.
  7. Verify Rental Location Code, Transit Location Code, and Return Location Code — pre-filled from setup but can be changed per line.
  8. Post the shipment to activate the rental (start date/time is captured at this point).
US-06: Set a header-level rental return date for all lines

As a Sales Order Processor
I want to set a single rental return date at the sales order header level
So that all rental lines on the order share the same return date without having to update each line individually

Setup:

  1. Open a Sales Order that has (or will have) multiple rental lines.
  2. On the sales order header, fill in Rental Return Date.
  3. The system propagates this date to all rental lines on the order.
  4. Individual lines can still be overridden after the header-level date is set.

Note: If a line already has a return date that differs from the header, the system will ask whether to update the lines when you change the header date.

US-07: Allow the swap to happen automatically on manual release

As a Sales Order Processor
I want to have the system automatically attempt to swap item lines to resource lines when I manually release the sales order
So that transfer orders are created earlier in the process and the order is ready to ship immediately

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Enable Swap on Manual Release.
  3. When you now manually release a sales order with rental lines, the system will attempt to swap all applicable item lines.

Note: Lines where the shipment has already been posted cannot be swapped. The system will report how many lines were successfully swapped.

US-08: Prevent deletion of the transfer order while the sales order is open

As a Business Manager
I want to keep the transfer order alive until the sales order is fully posted and deleted
So that the logistical transfer is not accidentally deleted while the rental is still active

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Enable Keep Transfer Order while Sales Order exists.
  3. With this setting active, the standard BC behaviour of deleting a transfer order when it is fully received will be suppressed — the transfer order remains until the associated sales order no longer exists.
US-09: Use sales order ship-to address on the transfer order

As a Sales Order Processor
I want to have the ship-to address from the sales order copied onto the transfer order
So that the physical delivery address appears correctly on the transfer document without manual duplication

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Enable Use Sales Order Ship-to Information on Transfer Order.
  3. When transfer orders are now created from rental lines, the ship-to address fields from the sales header are copied to the transfer-from/transfer-to address on the transfer order.
US-10: Restrict posting to the rental posting procedure only

As a Business Manager
I want to prevent users from posting rental sales orders through the standard posting button
So that all rental orders go through the dedicated rental posting procedure which ensures correct swap and transfer handling

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Leave Allow Standard Sales Posting disabled (the default).
  3. Users will now receive an error if they try to post a rental order using the standard posting action. They must use the rental posting action instead.

Note: If you need to allow both, enable this field. This is typically only relevant in transition or testing scenarios.

US-11: Control how dimensions are handled during the swap

As a Business Manager
I want to choose whether dimensions from the item or the resource take precedence when a rental line is swapped
So that financial postings have the correct dimension values

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Set Dimension Handling:
    • Standard: The standard BC dimension logic applies — dimensions from the resource are used.
    • Replace: Dimensions from the item and any manually entered dimensions are used instead of the resource dimensions.
  3. Save the record.
US-12: Configure rental location on a specific sales line

As a Sales Order Processor
I want to change the rental location, transit location, or return location on an individual rental line
So that specific items on an order can be handled from a different location than the default

Setup:

  1. Open the Sales Order and navigate to the relevant rental line.
  2. Adjust Rental Location Code, Transit Location Code, and/or Return Location Code directly on the line.
  3. These values override the defaults from the Rental Setup for this specific line only.

Note: Location fields cannot be changed after the transfer order has been created. Make adjustments before the order is released or shipped.

US-13: Convert a rental quote to a rental order

As a Sales Order Processor
I want to create a rental quote and later convert it to a sales order
So that I can present rental pricing to a customer before committing to an order

Setup:

  1. Create a Sales Quote and add rental lines (same as a sales order — fill in Rental No., Unit of Measure, Quantity, Return Date).
  2. If an Invoicing Plan or Price Scale has been set up on the quote, it is carried over automatically when the quote is converted.
  3. Use the standard Make Order action on the quote. The rental relation lines and any invoicing plan/price scale data are moved to the new sales order.
US-14: View the rental relation line for a sales line

As a Sales Order Processor
I want to inspect the rental relation line behind a sales line
So that I can see the exact transfer orders, shipping/receipt dates, and invoicing status for a specific rental

Setup:

  1. Open the Sales Order and select the rental line of interest.
  2. Navigate to Rental Relation Lines (available from the sales order or subform via the navigate/drilldown actions).
  3. The record shows: outbound and inbound transfer document numbers, starting and closing date-times, qty shipped and received, rental invoiced to date-time, and whether the line is fully posted.
US-15: Use shipping and handling time in transfer date calculation

As a Business Manager
I want to include the shipping time and handling time from locations and transfer routes when calculating transfer dates
So that transfer orders reflect realistic shipment and receipt dates that account for transit time

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Ensure Use Shipping and Handling Time in Transfer Date Calculation is enabled (it defaults to true).
  3. Make sure your Locations and Transfer Routes are configured with the relevant shipping and handling times in standard BC.
  4. When rental transfer orders are now created, the shipment and receipt dates will be calculated using those time offsets.

Note: This setting is not applicable when the rental location itself is configured as an in-transit location.

US-16: Prevent adding rental lines to already-shipped transfer orders

As a Business Manager
I want to prevent new rental lines from being added to a transfer order that has already had shipment posted on at least one line
So that partially shipped transfer orders are not changed in ways that would cause logistical inconsistencies

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Enable Only Add to Non-Shipped Transfer Orders.
  3. When this is active, the system will not add new rental transfer lines to an existing transfer order if any of its lines have already been shipped.
US-17: Enable bidirectional swapping from the sales order header

As a Sales Order Processor
I want to be able to swap rental lines both from item to resource and from resource back to item at the header level
So that I can reverse a swap if needed without having to work line by line

Setup:

  1. Go to Rental Setup and open the relevant setup record.
  2. Enable Sales Header Swap Both Ways.
  3. When you now use the swap action from the sales order header, lines can be swapped in either direction — item to resource or resource to item.

Note: Lines where shipment has already been posted cannot be swapped back.


Field Reference

Field Where to find it What it does Default
Customer Rental Setup Identifies which customer this setup applies to. Blank = global default. Blank
Default Rental Location Code Rental Setup Location where items are transferred when rented out. Blank
Default Transit Location Code Rental Setup Transit location used in two-transfer-order scenarios. Blank
Default Return Location Code Rental Setup Location where items return after rental. Blank
Default Rental Category Rental Setup Rental category (resource) pre-filled on new rental lines. Blank
Default Unit of Measure Code Rental Setup Unit of measure pre-filled on new rental lines. Blank
Employ Direct Transfer? Rental Setup Controls whether outbound, inbound, or both transfer orders are direct transfers. Options: blank, Outbound, Inbound, Both. Blank
Swap on Manual Release Rental Setup If enabled, the swap is triggered when the sales order is manually released. Disabled
Keep Transfer Order while Sales Order exists Rental Setup Prevents the transfer order from being deleted until the sales order is gone. Disabled
Allow Standard Sales Posting Rental Setup Allows posting via the standard posting button (not just the rental posting button). Disabled
Use Sales Order Ship-to Information on Transfer Order Rental Setup Copies ship-to address from the sales header to the transfer order. Disabled
Dimension Handling Rental Setup Controls whether resource or item dimensions win during swap. Options: Standard, Replace. Standard
Lock Rental Return Date Rental Setup Prevents automatic extension of the rental period during period posting. Disabled
Rental Price Customer Type Rental Setup Controls whether rental prices are looked up by Sell-to or Bill-to customer. Sell-to Customer
Only Add to Non-Shipped Transfer Orders Rental Setup Stops new lines from being added to transfer orders that have been partially shipped. Disabled
Sales Header Swap Both Ways Rental Setup Allows swapping in both directions from the sales header. Disabled
Use Shipping and Handling Time in Transfer Date Calculation Rental Setup Includes location/route shipping and handling times in transfer date calculation. Enabled
Allow Partial Termination Without Return Rental Setup Allows partial termination without posting the inbound transfer. Disabled
No Transfer Posting in Return/Replacement Rental Setup Suppresses automatic transfer posting during return and replacement. Disabled
Scale Base Price Source Rental Setup The price source (Rental Price or Sales Price) used as the base for Price Scale calculations. Global default only. Blank
Rental Item Item Card Marks an item as a rental item. Disabled
Return Location Code Item Card Item-level default return location, overrides setup default. Blank
Rental No. Sales Line The rental category (resource) governing this rental line. From setup default
Rental Unit of Measure Code Sales Line The unit of measure for the rental period (e.g. DAY, WEEK). From setup default
Rental Quantity Sales Line The number of rental periods. Blank
Rental Return Date Sales Line The calculated or manually set end of the rental period. Calculated
Rental Location Code Sales Line Where items are transferred to. Overrides setup default for this line. From setup
Transit Location Code Sales Line Transit location for this line. Overrides setup default. From setup
Return Location Code Sales Line Return location for this line. Overrides setup default. From setup
Lock Rental Return Date Sales Line Prevents automatic extension of the return date for this specific line. From setup
Rental Line Discount % Sales Line Discount percentage applied to the rental line amount. Blank
Rental Special Base Unit Price Sales Line Override base price used in Invoicing Plan calculations for this line. Blank
Rental Invoicing Start Date Sales Line The start date for invoicing this line within an Invoicing Plan. From sales header