taohopdong

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 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.