🌐 Language: 🇻🇳 Tiếng Việt · 🇬🇧 English (current)

InOut — Purchase, Return & Cash Flow Management Plugin

Version: 1.0.0 | Platform: GP247 / S-Cart

Introduction

InOut is a purchasing, returns and cash flow – debt management plugin for the GP247 (S-Cart) platform, aimed at business owners, store managers and internal accountants.

Who is this plugin for?

If you need to: manage purchase orders from suppliers, track returns & refunds, control income/expense and debts, and automatically update stock on purchase/return — then InOut is the plugin for you. After installation, new menu items appear under the Orders section of the admin sidebar.

Feature overview

End-to-end business workflow

flowchart TD
    SUP["SUPPLIER"] --> PO["PURCHASE ORDER<br/>(into stock)"]
    SUP --> RO["RETURN ORDER<br/>(out of stock)"]
    CUS["CUSTOMER"] --> SO["SALES ORDER<br/>(managed by GP247)"]
    PO -->|supplier payment| CF["CASH BOOK"]
    RO -->|refund| CF
    SO -->|revenue| CF
    CF --> PROF["Gap = Total income − Total expense"]
    CF --> DEBT["DEBTS"]
    SO -.->|unpaid| DEBT
    PO -.->|unpaid| DEBT

Document list

System requirements

• Platform: GP247 / S-Cart (core 3.1 or later).

Installation

There are 4 ways to install the InOut plugin (including the command line). See the GP247 extension installation guide.

After installation, the plugin auto-creates the "Inout Cash" permission group with all accounting operation rights. Assign this group to a staff account and they can use the plugin without admin rights.

1. From the Online library (recommended): Admin → Extensions → Add-ons → Load from library tab → find InOut → install.
2. Import zip file: Import file tab → choose the InOut zip → finish.
3. Manual: copy the source into app/GP247/Plugins/InOut, copy public into public/GP247/Plugins/InOut, then install via the Stored locally tab.

Install from the command line (CLI, gp247 3.x)

Since gp247 3.x you can download InOut from the GP247 library and install it straight from the command line, without opening the admin. The plugin requires the gp247/shop package and the barryvdh/laravel-dompdf package (used for PDF export) on the website. Open a terminal in the website's root folder and run:

# 0) Install the required package (if not already present)
composer require barryvdh/laravel-dompdf

# 1) Once per website: register the (free) API License that connects the site to the GP247 library
php artisan gp247:ext-register-license

# 2) Download the plugin from the library and install it
php artisan gp247:ext-install --type=plugin --key=InOut

• Before step 1, make sure APP_URL in .env is the website's real domain (not http://localhost) — the license is bound to that domain.
• Once installed, the plugin is enabled and caches are refreshed automatically; nothing else is needed in the admin.
• The command checks the requirements declared in gp247.json (core version, composer packages, required plugins) and stops with a clear message if something is missing (e.g. gp247/shop or barryvdh/laravel-dompdf is not installed).
• If the folder app/GP247/Plugins/InOut is already on the server (copied manually or shipped with the installer), the command installs it in place instead of downloading it again.
• The command refuses a plugin that is already installed. To move to a newer version, run php artisan gp247:ext-update --type=plugin --key=InOut.
• Append --json to get machine-readable output (for scripts/CI).
• More: Installing Plugins & Templates · Command reference.

Support

• Website: gp247.net
• Facebook Group: S-Cart Opensource

Q&A

Q1: Which document should I read first?

→ Start with Purchase Order Management, then Cash Flow, Debts & Period Closing — these are the two most-used features.

Q2: Does the plugin manage stock automatically?

→ Yes, on the supplier purchase/return sides. The selling side is handled by GP247. Details in Inventory & History.

Q3: Can non-admin staff use it?

→ Yes. Assign the "Inout Cash" permission group (auto-created on install) to the staff account.

Q4: Where do I export documents to Excel/PDF?

→ Each detail page has an Export Excel/PDF button. See Export & Printing.

Q5: What is period closing for?

→ To finalize a past period's figures and prevent editing old documents. See Cash Flow, Debts & Period Closing.

_{📅 Last updated: 2026-09-25 · ✍️ Author: GP247}