back
loading skill details...
Tạo hợp đồng: tra cứu thông tin doanh nghiệp từ masothue.com và ghi vào Google Sheet (sheet Hợp đồng). Use when user asks to: tra cứu mã số thuế, ghi thông t...
---
name: taohopdong
description: |
Tạo hợp đồng: tra cứu thông tin doanh nghiệp từ masothue.com và ghi vào Google Sheet (sheet Hợp đồng).
Use when user asks to: tra cứu mã số thuế, ghi thông tin công ty vào sheet, tạo hợp đồng,
thêm dữ liệu doanh nghiệp từ masothue, hoặc yêu cầu format: "MST + Số tiền + Dịch vụ" để điền sheet.
---
# Tạo Hợp Đồng (taohopdong)
Tra cứu thông tin doanh nghiệp từ [masothue.com](https://masothue.com) và ghi vào Google Sheet **Hợp đồng**.
> **Yêu cầu:** `gog` CLI đã authenticated, env `GOG_ACCOUNT` được set, và Odoo connector sẵn sàng (`~/clawd/skills/odoo-connector`).
## Sheet Structure
- **Spreadsheet ID**: ``
- **Sheet name**: `` (gid: ``)
- **Header row**: dòng 4
- **Dữ liệu bắt đầu**: dòng 5 trở đi
### Column layout
| Cột | Nội dung | Ví dụ |
|:---:|:---------|:------|
| **A** | Mã (MST) | `0316863281` |
| **C** | Mã hợp đồng | `W231224/SEO` |
| **D** | Tên doanh nghiệp | CÔNG TY CP CN WIFIM |
| **E** | Địa chỉ | ... |
| **F** | Mã số thuế | `00316863281` |
| **G** | Người đại diện | Nguyễn Lê Minh Dương |
| **H** | SĐT | *(trống nếu không có)* |
| **I** | Số tiền | `14.000.000` |
| **J** | Dịch vụ | `SEO` |
### Google Sheets via gog CLI
Dùng `gog` để đọc/ghi sheet. Set env `GOG_ACCOUNT` trước:
```bash
export GOG_ACCOUNT=""
```
**Đọc dữ liệu hiện có:**
```bash
gog sheets get "Hợp đồng!A4:J" --json --no-input
```
**Ghi (cập nhật specific range):**
```bash
gog sheets update \
"Hợp đồng!A5:J5" \
--values-json '[["0312712411","","W231224/SEO","TÊN CÔNG TY","Địa chỉ","0312712411","NGƯỜI ĐD","","14.000.000","SEO"]]' \
--input USER_ENTERED \
--no-input
```
> **Lưu ý:** `gog` tự xử lý encoding tên sheet tiếng Việt, không cần URL-encode thủ công.
## Input Format
User có thể cung cấp thông tin theo các format sau:
1. **Link masothue.com đầy đủ**:
`
2. **Chỉ MST** (tự động ghép URL):
`0314927902` → `https://masothue.com/{mst}`
3. **Cú pháp đầy đủ 1 dòng**:
`{Mã HĐ} {URL/MST} {Số tiền} {Dịch vụ}`
Ví dụ: `W231224/SEO https://masothue.com/0314927902... 14.000.000 SEO`
## Workflow
### Bước 1: Xác định MST và URL masothue
- Nếu user gửi full URL (slug) → dùng luôn
- Nếu user gửi MST số → dùng search URL:
`https://masothue.com/Search/?q={mst}&type=masothue`
→ web_fetch sẽ tự redirect sang slug đúng
- Nếu user gửi cả mã HĐ + URL + số tiền + dịch vụ → parse từng phần
> **Lưu ý:** URL trần `https://masothue.com/{mst}` (chỉ số) **không redirect** — sẽ 404. Luôn dùng search URL hoặc slug đầy đủ.
### Bước 2: Scrape masothue.com
Dùng `web_fetch` với URL masothue (search URL hoặc full slug). Parse kết quả để lấy:
| Field | Pattern trong web_fetch output |
|-------|-------------------------------|
| **Tên công ty** | Dòng đầu tiên sau title (thường là tên in hoa) |
| **Mã số thuế** | Dòng có `Mã số thuế` → value bên dưới |
| **Địa chỉ** | Dòng `Địa chỉ` (không phải `Địa chỉ Thuế`) → value |
| **Người đại diện** | Dòng có `Người đại diện` → tên trong `[]` |
Ưu tiên **Địa chỉ** (address thật) hơn **Địa chỉ Thuế** (tax address).
### Bước 3: Tìm dòng trống tiếp theo trong sheet
Dùng `gog` để đọc dữ liệu hiện tại:
```bash
gog sheets get "Hợp đồng!A4:J" --json --no-input
```
Tìm dòng cuối có dữ liệu trong cột A (MST). Dòng tiếp theo là `rowNum = lastRow + 1`.
### Bước 4: Ghi vào Google Sheet
Ghi range `Hợp đồng!A{rowNum}:J{rowNum}` với:
```python
values = [[
mst, # A - Mã (MST)
"", # B - (nếu có)
ma_hop_dong, # C - Mã hợp đồng
ten_cong_ty, # D - Tên doanh nghiệp
dia_chi, # E - Địa chỉ
mst, # F - Mã số thuế (lặp lại)
nguoi_dai_dien,# G - Người đại diện
"", # H - SĐT
so_tien, # I - Số tiền
dich_vu # J - Dịch vụ
]]
```
Lệnh gog:
```bash
gog sheets update \
"Hợp đồng!A${rowNum}:J${rowNum}" \
--values-json '[[mst,"",ma_hop_dong,ten_cong_ty,dia_chi,mst,nguoi_dai_dien,"",so_tien,dich_vu]]' \
--input USER_ENTERED \
--no-input
```
**Cảnh báo:** Luôn ghi đủ A:J để giữ nguyên các cột D-G (tên, địa chỉ, MST, người đại diện) đã có. Không ghi range C:J riêng lẻ.
### Bước 5: Verify
Đọc lại dòng vừa ghi để xác nhận:
```bash
gog sheets get \
"Hợp đồng!A${rowNum}:J${rowNum}" --json --no-input
```
Thông báo ngắn gọn: **Dòng {rowNum} Đã thêm thành công**
### Bước 6 (Tự động): Tạo khách hàng trên Odoo CRM
Sau khi ghi sheet, tự động tạo (hoặc cập nhật) khách hàng (`res.partner`) trên Odoo với thông tin doanh nghiệp vừa tra cứu.
**Kiểm tra trùng:** Tra cứu `res.partner` theo `vat` (MST) trước. Nếu đã tồn tại thì bỏ qua, không tạo trùng.
```python
import sys
sys.path.insert(0, '~/clawd/skills/odoo-connector')
from odoo_skill.client import OdooClient
client = OdooClient()
# Kiểm tra đã có partner với MST này chưa
existing = client.search_read('res.partner', [['vat', '=', mst]], fields=['id', 'name'])
if not existing:
partner_id = client.create('res.partner', {
'name': ten_cong_ty,
'vat': mst,
'street': dia_chi,
'phone': sdt or '', # nếu có SĐT từ masothue
'is_company': True,
'company_type': 'company',
})
print(f'✅ Odoo Partner #{partner_id}: {ten_cong_ty}')
else:
print(f'ℹ️ Đã tồn tại partner #{existing[0]["id"]}: {existing[0]["name"]} — bỏ qua')
```
> **Lưu ý:** Nếu user có cung cấp SĐT riêng (trong input), ưu tiên dùng SĐT đó thay vì SĐT từ masothue.
### Bước 7 (Tự động): Tạo cơ hội trên Odoo CRM
Sau khi tạo (hoặc tìm thấy) partner, tự động tạo một `crm.lead` (opportunity) ở stage **Hợp Đồng Mẫu** (ID: 5) để theo dõi hợp đồng này.
```python
import sys
sys.path.insert(0, '~/clawd/skills/odoo-connector')
from odoo_skill.client import OdooClient
client = OdooClient()
opp_id = client.create('crm.lead', {
'name': f'{ma_hop_dong} - {dich_vu} - {ten_cong_ty_ngan}', # VD: "W21/256565/SEO - SEO - Bao Bì Rồng Việt"
'partner_id': partner_id, # ID từ Bước 6
'contact_name': nguoi_dai_dien or '',
'type': 'opportunity',
'stage_id': 5, # Hợp Đồng Mẫu
'expected_revenue': so_tien_so, # số tiền dạng số, VD: 14000000
'probability': 50,
})
print(f'✅ Odoo Opp #{opp_id}: {ma_hop_dong} - {dich_vu} - {ten_cong_ty_ngan}')
```
> **Lưu ý:** `so_tien_so` là số tiền dạng integer (VD: `14000000`), parse từ `so_tien` string (VD: `"14.000.000"`). `ten_cong_ty_ngan` là tên công ty rút gọn (bỏ "CÔNG TY TNHH"... để tên opportunity gọn hơn) — có thể lấy nguyên tên đầy đủ nếu muốn đơn giản. Tên opportunity theo format `{Mã HĐ} - {Dịch vụ} - {Tên}`.
## Edge Cases
- **MST bắt đầu bằng số 0** (VD: `0312712411`): Google Sheets có thể ăn mất số 0 nếu ghi dạng số. Luôn dùng `--input USER_ENTERED` và truyền dạng string `"0312712411"` để giữ nguyên số 0.
- **Dữ liệu đã tồn tại**: Kiểm tra MST trong sheet trước khi ghi để tránh trùng.
- **Không tìm thấy masothue**: Thử search Google với format `"mã số thuế {mst}"` hoặc báo user.
don't have the plugin yet? install it then click "run inline in claude" again.