Một script Python chuyển các file xuất danh bạ của bạn thành một CSV sạch, sẵn sàng nhập vào dịch vụ gửi email

Ví dụ kết quả

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Thư mục: sales/2026-10, tìm thấy 9 file
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 dòng
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 dòng
2026-11-02 09:14:04 WARN  shop-07.csv: bỏ qua 3 dòng không có giá (dòng 88, 412, 913)
2026-11-02 09:14:05 INFO  Xong: 10.412 dòng -> report-2026-10.xlsx (sheet “Doanh số” và “Tổng cộng”)

[columns]
date = Ngày, Ngày bán, Ngày giao dịch
product = Sản phẩm, Mặt hàng, Tên hàng
quantity = SL, Số lượng, Cái
price = Giá, Đơn giá

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Đọc file của một cửa hàng và đặt cho các cột tên theo báo cáo."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: không có cột cho “{name}” (đã tìm: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Về dịch vụ này

Danh bạ xuất từ cửa hàng, CRM hay danh sách đăng ký sự kiện hiếm khi khớp với những gì dịch vụ gửi email muốn nhập: tên cột khác, họ và tên chung một ô, thẻ nằm ở chỗ lạ, người đã hủy đăng ký vẫn còn trong danh sách. Script Python này đọc các file xuất của bạn và ghi ra một CSV sạch theo định dạng nhập của dịch vụ: tách họ tên khi cần, ánh xạ trường và thẻ, loại bỏ email sai dạng và bản trùng, và từ gói Tiêu chuẩn, chỉ giữ người có đánh dấu đồng ý và bỏ người đã hủy đăng ký, kèm một file các dòng bị loại để bạn kiểm tra. Script dành cho danh bạ của chính bạn gồm những người đã đồng ý nhận tin từ bạn, không bao giờ cho danh sách mua hoặc thu thập trái phép. Script chạy trên máy tính của bạn và không kết nối với dịch vụ; bạn tự nhập file.

Bao gồm những gì

• Bạn nhận được gìFile ZIP gồm script Python, README hướng dẫn từng bước và, từ gói Tiêu chuẩn, file cài đặt chứa ánh xạ trường và thẻ; code cũng được hiển thị trên trang đơn hàng.
• Định dạng của dịch vụ bạn dùngTheo mẫu nhập hoặc file ví dụ của dịch vụ
• Tôn trọng sự đồng ýTừ gói Tiêu chuẩn, chỉ người đã đồng ý, không có người đã hủy đăng ký
• Loại bỏ bản trùng và lỗi gõLoại bỏ địa chỉ sai dạng và địa chỉ lặp lại
• Giữ lại các dòng bị loạiMột file riêng cho biết những gì bị loại và vì sao
• Code dễ đọcCó chú thích, dễ thêm trường về sau

Cách hoạt động

1. 1
   File mẫuBạn gửi các dòng giả từ mỗi file xuất và định dạng nhập của dịch vụ
2. 2
   CodeChúng tôi viết script và hướng dẫn chạy
3. 3
   Chạy thửBạn chạy script, xem qua các dòng bị loại và nhập thử một danh sách nhỏ
4. 4
   Chỉnh sửaBạn yêu cầu chỉnh sửa trong phạm vi gói và gửi thông báo lỗi nếu có

Chúng tôi cần gì từ bạn

Dòng tiêu đề và 10-20 dòng của mỗi file xuất với tên và email giả nhưng cùng cách trình bày, cột nào thể hiện sự đồng ý và cột nào thể hiện việc hủy đăng ký, dịch vụ gửi email bạn dùng và mẫu nhập của nó hoặc liên kết tới trang trợ giúp về nhập dữ liệu, và cách đặt thẻ hoặc phân khúc. Danh bạ được thu thập thế nào (cửa hàng của bạn, biểu mẫu đăng ký, sự kiện). Đừng bao giờ gửi danh sách thật.

Chúng tôi sẽ hỏi bạn:

• Danh bạ lấy từ đâu?
• Bạn sẽ nhập vào dịch vụ gửi email nào?
• Sự đồng ý được ghi nhận thế nào?
• Bạn có cần thẻ hoặc phân khúc không?

So sánh các gói

Hỏi đáp

Chưa tìm thấy câu trả lời? Hỏi chúng tôi