🌐 Ngôn ngữ: 🇻🇳 Tiếng Việt (hiện tại) · 🇬🇧 English

InOut — Plugin Quản Lý Nhập Hàng, Trả Hàng & Thu Chi

Phiên bản: 1.0.0 | Nền tảng: GP247 / S-Cart

Giới thiệu

InOut là plugin quản lý nhập hàng, trả hàng và thu chi – công nợ cho nền tảng GP247 (S-Cart), dành cho chủ doanh nghiệp, quản lý cửa hàng và kế toán nội bộ.

Plugin này dành cho ai?

Nếu bạn cần: quản lý đơn nhập từ nhà cung cấp, theo dõi trả hàng & hoàn tiền, kiểm soát thu chi – công nợ, và tự động cập nhật tồn kho khi nhập/trả hàng — thì InOut là plugin bạn cần. Sau khi cài, các menu mới xuất hiện trong mục Đơn hàng trên thanh quản trị.

Tổng quan chức năng

Sơ đồ luồng nghiệp vụ tổng quan

flowchart TD
    NCC["NHÀ CUNG CẤP"] --> PO["ĐƠN NHẬP HÀNG<br/>(nhập kho)"]
    NCC --> RO["ĐƠN TRẢ HÀNG<br/>(xuất kho)"]
    KH["KHÁCH HÀNG"] --> SO["ĐƠN HÀNG BÁN<br/>(GP247 quản lý)"]
    PO -->|thanh toán NCC| CF["SỔ THU CHI"]
    RO -->|hoàn tiền| CF
    SO -->|doanh thu| CF
    CF --> PROF["Chênh lệch = Tổng thu − Tổng chi"]
    CF --> DEBT["CÔNG NỢ"]
    SO -.->|chưa TT đủ| DEBT
    PO -.->|chưa TT đủ| DEBT

Danh sách tài liệu

Yêu cầu hệ thống

• Nền tảng: GP247 / S-Cart (core 3.1 trở lên).

Hướng dẫn cài đặt

Có 4 cách cài đặt plugin InOut (kể cả dòng lệnh). Chi tiết xem Hướng dẫn cài đặt phần mở rộng GP247.

Sau khi cài, plugin tự tạo nhóm quyền "Inout Cash" với đầy đủ quyền nghiệp vụ kế toán. Gán nhóm quyền này cho nhân viên là họ dùng được plugin mà không cần quyền admin.

1. Qua thư viện Online (khuyến nghị): Quản trị → Phần mở rộng → Tiện ích → tab Tải từ thư viện → tìm InOut → cài đặt.
2. Import file zip: tab Nhập file → chọn file zip của InOut → hoàn tất.
3. Thủ công: copy mã nguồn vào app/GP247/Plugins/InOut, copy public vào public/GP247/Plugins/InOut, rồi cài qua tab Đã lưu trên máy.

Cài bằng dòng lệnh (CLI, gp247 3.x)

Từ gp247 3.x, bạn có thể tải InOut từ thư viện GP247 và cài ngay bằng dòng lệnh mà không cần mở admin. Plugin yêu cầu website đã có gói gp247/shop và gói barryvdh/laravel-dompdf (dùng để xuất PDF). Mở Terminal tại thư mục gốc website rồi chạy:

# 0) Cài gói bắt buộc (nếu website chưa có)
composer require barryvdh/laravel-dompdf

# 1) Chỉ làm 1 lần cho mỗi website: đăng ký API License (miễn phí) để kết nối thư viện GP247
php artisan gp247:ext-register-license

# 2) Tải plugin từ thư viện và cài
php artisan gp247:ext-install --type=plugin --key=InOut

• Trước bước 1, kiểm tra APP_URL trong .env là domain thật của website (không để http://localhost), vì license được gắn với domain này.
• Cài xong, plugin được bật sẵn và cache tự làm mới, bạn không cần thao tác gì thêm trong admin.
• Lệnh tự kiểm tra điều kiện khai báo trong gp247.json (phiên bản core, gói composer, plugin phụ thuộc). Nếu thiếu, lệnh dừng lại và báo rõ thiếu gì (ví dụ website chưa có gp247/shop hoặc barryvdh/laravel-dompdf).
• Nếu thư mục app/GP247/Plugins/InOut đã có sẵn trên máy (chép thủ công hoặc có sẵn theo bộ cài), lệnh sẽ cài tại chỗ, không tải lại.
• Nếu plugin đã được cài, lệnh sẽ từ chối. Để lên bản mới, chạy php artisan gp247:ext-update --type=plugin --key=InOut.
• Thêm --json vào cuối lệnh để nhận kết quả dạng máy đọc được (dùng cho script/CI).
• Chi tiết: Hướng dẫn cài đặt Plugin & Template · Tra cứu lệnh.

Hỗ trợ

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

Hỏi & Đáp (Q&A)

Câu 1: Tôi nên đọc tài liệu nào trước?

→ Bắt đầu với Quản Lý Đơn Nhập Hàng, rồi Thu Chi, Công Nợ & Khóa Sổ — đây là hai nghiệp vụ dùng nhiều nhất.

Câu 2: Plugin có tự quản lý tồn kho không?

→ Có, ở chiều nhập/trả hàng nhà cung cấp. Chiều bán ra do GP247 xử lý. Chi tiết ở Tồn Kho & Lịch Sử.

Câu 3: Nhân viên không phải admin có dùng được không?

→ Được. Gán nhóm quyền "Inout Cash" (tự tạo khi cài) cho tài khoản nhân viên.

Câu 4: Xuất chứng từ ra Excel/PDF ở đâu?

→ Mỗi trang chi tiết có nút Export Excel/PDF. Xem Xuất Dữ Liệu & In Ấn.

Câu 5: Khóa sổ để làm gì?

→ Chốt số liệu một kỳ đã qua, ngăn sửa chứng từ cũ. Xem Thu Chi, Công Nợ & Khóa Sổ.

_{📅 Cập nhật lần cuối: 2026-09-25 · ✍️ Tác giả (Author): GP247}