Merge pull request #151 from diepxuan/fix/phieubaono-undefined-cact3

fix: undefined variable $caCt3 in Phieubaono loadPhieu

Author: caothu159

src/StoredProcedures/AsCAGetPH2.php

@@ -8,7 +8,7 @@
  * @author     Tran Ngoc Duc <ductn@diepxuan.com>
  * @author     Tran Ngoc Duc <caothu91@gmail.com>
  *
- * @lastupdate 2026-04-06 18:47:51
+ * @lastupdate 2026-04-12 17:19:23
  */
 
 namespace Diepxuan\Simba\StoredProcedures;
@@ -20,54 +20,127 @@
 /**
  * Class AsCAGetPH2.
  *
- * Stored procedure: asCAGetPH2
- * Mục đích: Lấy danh sách phiếu hàng 2 (PH2) từ hệ thống Simba.
- * Procedure trả về danh sách các phiếu hàng loại 2 được sử dụng trong quản lý kho.
+ * Stored procedure: `asCAGetPH2`
  *
- * Tham số:
- * - Không có tham số đầu vào.
+ * ## Mục đích
  *
- * Giá trị trả về:
- * - Collection chứa danh sách phiếu hàng 2 với các trường thông tin liên quan.
+ * Lấy thông tin phiếu hàng 2 (PH2) từ hệ thống Simba.
+ * Procedure trả về danh sách các phiếu thuộc bảng CA_PH2 (Cash Phiếu 2).
+ *
+ * ## Parameters (theo SQL Server)
+ *
+ * | Name | Type | Required | Description |
+ * |------|------|----------|-------------|
+ * | `@pMa_cty` | nvarchar(3) | ❌ | Mã công ty |
+ * | `@pStt_rec` | nvarchar(20) | ❌ | Số tham chiếu (stt_rec) cần lấy |
+ *
+ * ## Fields trả về
+ *
+ * Procedure trả về Collection với các fields từ bảng `CA_PH2`:
+ *
+ * | Field | Kiểu | Diễn giải |
+ * |-------|------|-----------|
+ * | `ma_cty` | string(3) | Mã công ty |
+ * | `stt_rec` | string(20) | Số thứ tự bản ghi (PK) |
+ * | `ma_ct` | string(3) | Mã chứng từ (CA1, CA2, CA3, CA4, CA5, CA6) |
+ * | `so_ct` | string(20) | Số chứng từ |
+ * | `ngay_ct` | datetime | Ngày chứng từ |
+ * | `ngay_lct` | datetime | Ngày lập chứng từ |
+ * | `kht_tain` | boolean | Kế hoạch tài chính |
+ * | `ma_kh` | string(20) | Mã khách hàng |
+ * | `dia_chi` | string(255) | Địa chỉ |
+ * | `nguoi_gd` | string(30) | Người giao dịch |
+ * | `dien_giai` | string(255) | Diễn giải |
+ * | `tk_co` | string(20) | Tài khoản Có |
+ * | `ma_nt` | string(3) | Mã ngoại tệ |
+ * | `ty_gia` | float | Tỷ giá |
+ * | `t_tien` | float | Tổng tiền VNĐ |
+ * | `t_tien_nt` | float | Tổng tiền ngoại tệ |
+ * | `t_thue_nt` | float | Thuế ngoại tệ |
+ * | `t_thue` | float | Thuế VNĐ |
+ * | `t_tt` | float | Tổng thanh toán VNĐ |
+ * | `t_tt_nt` | float | Tổng thanh toán ngoại tệ |
+ * | `stt_rec_hd` | string(20) | STT rec hóa đơn |
+ * | `trang_thai` | string | Trạng thái |
+ * | `post2gl` | string | Đã post GL chưa |
+ * | `cdate` | datetime | Ngày tạo |
+ * | `cuser` | string | Người tạo |
+ * | `ldate` | datetime | Ngày sửa |
+ * | `luser` | string | Người sửa |
+ *
+ * ## Ví dụ sử dụng
  *
- * Ví dụ gọi:
  * ```php
- * // Sử dụng method call()
- * $result = AsCAGetPH2::call([]);
+ * use Diepxuan\Simba\StoredProcedures\AsCAGetPH2;
+ *
+ * // 1. Lấy 1 phiếu theo stt_rec
+ * $phieu = AsCAGetPH2::call([
+ *     'pStt_rec' => '001wCA40000000676570',
+ * ])->first();
  *
- * // Sử dụng method callWithParams()
- * $result = AsCAGetPH2::callWithParams();
+ * // 2. Lấy tất cả phiếu của công ty
+ * $allPhieu = AsCAGetPH2::call([
+ *     'pMa_cty' => '001',
+ * ]);
+ *
+ * // 3. Lấy tất cả phiếu (không filter)
+ * $allPhieu = AsCAGetPH2::call([]);
+ *
+ * // 4. Gọi với callWithParams()
+ * $phieu = AsCAGetPH2::callWithParams(
+ *     Ma_cty: '001',
+ *     Stt_rec: '001wCA40000000676570'
+ * )->first();
  * ```
  *
- * Lưu ý:
- * - Procedure thuộc nhóm Get (asCAGet*), không có output parameter.
- * - Sử dụng method callWithParams() để gọi với các tham số đặt tên (nếu có trong tương lai).
+ * ## Lưu ý
+ *
+ * - Procedure thuộc nhóm Get (`asCAGet*`), không có output parameter
+ * - Kết quả trả về là Laravel Collection
+ * - Nếu không truyền params → trả về tất cả phiếu
+ * - Dùng `pStt_rec` để filter theo 1 phiếu cụ thể
+ * - Dùng `pMa_cty` để filter theo công ty
+ *
+ * ## Tham chiếu
+ *
+ * - Bảng: `CA_PH2`
+ * - Procedure liên quan: `asCAGetCT2` (lấy chi tiết phiếu)
  */
 class AsCAGetPH2
 {
     /**
      * Gọi stored procedure asCAGetPH2.
      *
-     * @param array $params mảng tham số (hiện tại không sử dụng)
+     * @param array $params Mảng tham số với các khóa: pMa_cty, pStt_rec
      *
-     * @return Collection kết quả trả về từ procedure
+     * @return Collection kết quả từ procedure
      */
     public static function call(array $params): Collection
     {
         $paramObj   = ParamHelper::fromArray($params);
         $connection = (new SModel())->getConnectionName();
 
         return ProcedureCaller::call('asCAGetPH2', [
+            'pMa_cty'  => $paramObj->pMa_cty ?? null,
+            'pStt_rec' => $paramObj->pStt_rec ?? null,
         ], $connection);
     }
 
     /**
      * Call stored procedure asCAGetPH2 with named parameters.
      *
-     * @return Collection kết quả trả về từ procedure
+     * @param null|string $Ma_cty  Mã công ty
+     * @param null|string $Stt_rec Số tham chiếu
+     *
+     * @return Collection Kết quả từ procedure
      */
-    public static function callWithParams(): Collection
-    {
-        return self::call([]);
+    public static function callWithParams(
+        ?string $Ma_cty = null,
+        ?string $Stt_rec = null,
+    ): Collection {
+        return self::call([
+            'pMa_cty'  => $Ma_cty,
+            'pStt_rec' => $Stt_rec,
+        ]);
     }
 }

src/StoredProcedures/ProcedureCaller.php

@@ -8,7 +8,7 @@
  * @author     Tran Ngoc Duc <ductn@diepxuan.com>
  * @author     Tran Ngoc Duc <caothu91@gmail.com>
  *
- * @lastupdate 2026-04-07 13:49:23
+ * @lastupdate 2026-04-12 16:59:27
  */
 
 namespace Diepxuan\Simba\StoredProcedures;
@@ -105,7 +105,7 @@ public static function call(string $name, array $params = [], ?string $connectio
             }
         }
 
-        \Debugbar::info('ProcedureCaller result:', $rows);
+        \Debugbar::info("ProcedureCaller {$name} result: ", $rows);
 
         return collect($rows);
     }