Ánh xạ thuộc tính sang sàn và ảnh bảng kích cỡ

  # Ánh xạ thuộc tính sang sàn và ảnh bảng kích cỡ     Bài **Hình ảnh và thông tin bán hàng** có nhắc tới việc "điền Thuộc tính đặc thù sàn nếu màn hình hiển thị các ô này". Bài này nói rõ những ô đó lấy từ đâu ra, và ai là người chuẩn bị chúng trước.     Bài dành cho người quản lý danh mục hàng hoá và người phụ trách kênh bán, cần phối hợp trước khi niêm yết một ngành hàng mới lên sàn.     ## Ánh xạ thuộc tính nằm ở đâu     Vào **Cài đặt hệ thống** → **Kênh bán hàng (Channels)**, mở kênh cần cấu hình (ví dụ TikTok Shop), chuyển sang tab ánh xạ thuộc tính bên cạnh tab ánh xạ danh mục đã nói ở bài **Danh mục sản phẩm và cách sắp xếp**.     Bảng có bốn cột và một nút thao tác:     | Cột | Nội dung |  |---|---|  | **Thuộc tính PIM (Core)** | Chọn một thuộc tính đã tạo ở bài Thuộc tính, nhóm thuộc tính và họ thuộc tính. |  | **Cột sàn yêu cầu (Excel/CSV ID)** | Mã thuộc tính phía sàn, ví dụ `ps_brand`. |  | **Tên hiển thị thuộc tính sàn** | Tên sẽ hiện làm nhãn ô nhập trên màn hình sản phẩm, ví dụ "Thương hiệu". |  | **Áp dụng cho danh mục sàn** | Để trống nghĩa là **Global**, áp dụng cho mọi sản phẩm của kênh này. Chọn một danh mục sàn cụ thể (lấy từ bảng ánh xạ danh mục) nếu thuộc tính chỉ dùng riêng cho ngành hàng đó. |     Bấm **Thêm Thuộc Tính** để thêm một dòng, điền đủ bốn cột rồi bấm **Lưu Ánh Xạ**. Màn hình không cho lưu nếu bỏ trống cột mã hoặc tên hiển thị.     ## Ánh xạ này dùng ở đâu     Sau khi lưu, mở một sản phẩm, bật niêm yết cho kênh tương ứng. Phần **Thuộc tính đặc thù sàn** trong cấu hình kênh của sản phẩm sẽ hiện một ô nhập cho từng dòng ánh xạ liên quan (dòng Global, hoặc dòng khớp đúng danh mục sàn của sản phẩm). Nhãn ô lấy đúng **Tên hiển thị thuộc tính sàn** đã cấu hình. Giá trị nhập vào đây là riêng cho từng kênh, không dùng chung với **Thuộc tính kỹ thuật** ở phần Thông tin cơ bản của sản phẩm dù có thể là cùng một thuộc tính PIM.     Nếu ngành hàng chưa có ánh xạ thuộc tính nào, phần này không hiện ra — sản phẩm vẫn niêm yết được, chỉ là không có thêm ô thuộc tính đặc thù sàn.     ## Thuộc tính bắt buộc theo sàn     Khi một dòng ánh xạ trỏ tới một thuộc tính PIM đã đánh dấu **Bắt buộc** (xem bài Thuộc tính, nhóm thuộc tính và họ thuộc tính), và ngành hàng sàn tương ứng nằm trong lượt đẩy hàng, sản phẩm thiếu giá trị cho thuộc tính đó sẽ bị loại khỏi lượt đẩy lên TikTok Shop kèm lý do thiếu thuộc tính bắt buộc. Nên ưu tiên đánh dấu Bắt buộc cho đúng những thuộc tính mà sàn thật sự yêu cầu, tránh chặn nhầm sản phẩm hợp lệ.     ## Ảnh bảng kích cỡ (size chart)     Hệ thống có xử lý riêng cho một thuộc tính có **đúng mã** `size_chart_image`: khi đẩy hàng lên TikTok Shop, hệ thống tìm thuộc tính này trong phần **Thuộc tính kỹ thuật** của sản phẩm (không phải trong Thuộc tính đặc thù sàn) và gửi giá trị đó đi làm ảnh bảng kích cỡ.     Cách chuẩn bị theo đúng quy ước mã nguồn hiện tại:     1. Tạo một thuộc tính mới với **Mã Code** chính xác là `size_chart_image` (kiểu Văn bản ngắn).  2. Gán thuộc tính này vào **Họ thuộc tính** của ngành hàng cần có bảng kích cỡ.  3. Khi tạo hoặc sửa sản phẩm, ô này sẽ hiện trong **Thuộc tính kỹ thuật**. Dán vào đó đường dẫn (URL) ảnh bảng kích cỡ đã tải lên.     Nếu vô tình cấu hình một dòng ánh xạ thuộc tính sàn với mã PIM cũng là `size_chart_image`, hệ thống sẽ bỏ qua dòng đó khi gửi danh sách "thuộc tính đặc thù sàn" thông thường — nghĩa là ô đó có thể vẫn hiện trên màn hình cấu hình kênh của sản phẩm nhưng giá trị gõ vào đó không phải là nguồn được dùng cho ảnh bảng kích cỡ. Nguồn thật luôn là thuộc tính `size_chart_image` ở phần Thuộc tính kỹ thuật chung của sản phẩm.     ## Điểm cần người nghiệp vụ xác nhận     - Quy ước mã `size_chart_image` suy ra từ đọc mã nguồn xử lý đẩy hàng, chưa thử trên môi trường thật để xác nhận ảnh có thật sự lên đúng vị trí bảng kích cỡ trên TikTok Shop hay không.  - Cần xác nhận với đội phát triển: nếu lỡ tạo dòng ánh xạ thuộc tính sàn trùng mã `size_chart_image`, màn hình cấu hình kênh của sản phẩm có nên ẩn hẳn ô đó đi để tránh người nhập tưởng nhầm đây là nơi nhập ảnh bảng kích cỡ.  - Chưa kiểm chứng việc đổi **Tên hiển thị thuộc tính sàn** sau khi sản phẩm đã có giá trị nhập cho ánh xạ đó có làm mất giá trị cũ hay không.  - Cần chốt ai chịu trách nhiệm cập nhật ánh xạ thuộc tính khi sàn đổi hoặc thêm yêu cầu ngành hàng mới, vì đây là cấu hình dùng chung cho mọi sản phẩm của ngành hàng đó trên kênh.