SmartStock

The module must be able to:

- keep track of sales, payments, returns, and shipments,

- work with multiple warehouses (receiving, transferring, inventory),

- account for currencies (with switching in the interface),

- support roles and access levels (RBAC),

- reserve goods until payment (with a time deadline),

- generate invoices and documents (order, return, transfer, etc.),

- maintain balances for clients and employees.

My deadlines are quite tight — I would like it to be completed in about 1–1.5 months.

Here is the detailed technical assignment:

Technical Assignment: Sales and Warehouse Accounting Module

1. Module Goals

 • Accounting for sales, payments, shipments, and returns.

 • Sales statistics: daily / weekly / monthly.

 • Balances for clients/contractors and for employees (received/returned).

 • Multi-warehouse accounting, receiving/transferring/inventory.

 • Multi-currency calculations with a currency switcher in the interface.

 • Generation of invoices, reserving goods until payment with a deadline.

 • Support for returns and exchanges of goods.

 • RBAC: multi-level access by blocks.

 • Generation of a unique link for the client, where they can create an order themselves (goes to the picker).

⸻

2. Key Objects / Directories

• Client / Contractor: card, contacts, default currency, unique link for personal order.

• Employee: role, access (by blocks), balance (received/returned).

• Warehouses: name, address, status (active/archive).

• Product item (SKU):

 • No weight/volume/barcode (as requested).

 • Ability to add multiple modifications in one item (variations).

 • Attributes: article, purchase price (for FIFO), retail price(s) by currencies, packaging units.

• Packaging units: pcs, blocks, boxes (fixed — only these three).

• Currencies: base currency of the system + others; selection via a dropdown list in the interface; support for manual input of exchange rates and connecting sources of rates.

• Cash registers/wallets: employee cash register, company cash register, current account, etc.

• Documents: Invoice (order/shipment), Payment (income/expenditure), Transfer, Inventory, Return, Replacement Act, Cancellation/Deletion Act.

⸻

3. Processes and Business Logic

3.1 Invoice / Order

 • Fields: client, shipping warehouse, date, document currency, items (modification, quantity, price), unit (pcs/block/box), delivery cost, payment method, comment, responsible employee, reserve deadline.

 • Statuses: Draft → Confirmed → Awaiting Shipment → Shipped → Delivered → Closed (paid).

 • Separate statuses: Canceled / Return / Exchange / Deleted.

 • Reservation:

• When the status is Confirmed — a reserve is created in the warehouse (the reserve holds the quantity).

• The reserve is valid until payment. The default reserve deadline is 14 calendar days from the confirmation date. (configurable)

 • If full payment is not received within 14 days — the reserve is automatically released, the goods return to free stock, and the invoice is moved to the status "Canceled (refunded/reserve released)" or marked for manual resolution.

 • Partial payment does not release the reserve (the reserve is released only after full payment), but the interface shows "paid / amount to be paid". (we can change this rule if needed)

• When the status is Shipped — the invoice records the shipment (courier/transport company, tracking number).

3.2 Write-off/Reserve/Transfer

 • The reserve reduces the available balance but does not physically write off until the status is "Shipped".

 • When "Shipped" — write-off from the warehouse (FIFO is used for cost calculation and write-off of purchase batches).

 • In case of return — a return document is created, the quantity is returned to the warehouse, and a receipt record is formed in FIFO indicating the return price / adjustment.

3.3 Transfers and Inventory

 • Transfers between warehouses by document (a transfer request is created → confirmation upon receipt at the target warehouse).

 • Inventory: ability to create an act, reconcile with accounting, adjust quantities (adjustments are recorded as separate entries).

3.4 Payments / Cash Registers

 • Payments are linked to the invoice (full/partial) or as an advance.

 • Supported methods: cash, bank transfer, card (integrations of payment solutions are noted in the technical assignment, but you requested to exclude payment solutions from integrations — ultimately, payment integrations are NOT connected).

 • Each cash register has a journal of income/expenditure; employees may have "cash on hand".

 • Employee balance: accounting for how much has been received from the contractor and how much has been returned to the corporate cash register/bank; ability to link returns to the cash register.

3.5 Returns and Exchanges

 • Return of goods: documented by a return document (arrival at the warehouse); upon return, the client's debt/balance is automatically adjusted.