Nếu dự án chọn VTEX làm Nền tảng đích, công tác chuẩn bị cần biến mô hình thương mại cấp doanh nghiệp hiện tại thành một bộ thông tin được phân quyền sở hữu rõ ràng trước khi bất kỳ lần di chuyển dữ liệu nào bắt đầu. Catalog, hệ thống giá, Promotions, Trade Policies, Inventory, Logistics, Checkout, Payments, OMS, Master Data, sellers, quan hệ marketplace và nội dung storefront có liên hệ chặt chẽ nhưng vẫn là những khu vực do các bên khác nhau quản lý.
Với mỗi nhóm dữ liệu hoặc quan hệ quan trọng, hãy ghi lại hành động cần thực hiện, bên chịu trách nhiệm, tài liệu hoặc kết quả cần giữ và điều kiện để coi là sẵn sàng. Cách chuẩn bị này giúp tránh nhầm một bản export Products với một VTEX Catalog hoàn chỉnh, hoặc nhầm lịch sử đơn hàng với cấu hình logistics và checkout đang hoạt động.
Xác định mô hình vận hành VTEX và bên chịu trách nhiệm cho từng miền
Chuẩn bị một sơ đồ ngắn gọn cho biết miền VTEX hoặc hệ thống bên ngoài nào sở hữu từng quan hệ thương mại.
| Hạng mục cần chuẩn bị | Quyết định cần ghi nhận | Bên chịu trách nhiệm | Thông tin xác nhận trạng thái sẵn sàng |
|---|---|---|---|
| Catalog | Categories, Brands, Products, SKUs, specifications, attachments, kits và assembly options | Người phụ trách Catalog | Sơ đồ quan hệ Catalog |
| Ngữ cảnh thương mại | Giá, Promotions, Trade Policies, sellers, offers và nhóm Products theo kênh | Người phụ trách thương mại | Ma trận SKU/kênh/giá và quyền sở hữu |
| Customers và B2B | Profiles, addresses, organizations, roles, cost centers và Master Data | Người phụ trách Customers/B2B | Sơ đồ danh tính và các đối tượng liên quan |
| Orders và vận hành | Checkout, Payments, OMS, Logistics, inventory, warehouses, docks, carriers và sellers | Người phụ trách vận hành | Sơ đồ miền Orders và logistics |
| Storefront | CMS, search, navigation, routes, nội dung và trách nhiệm frontend Headless | Người phụ trách trải nghiệm số | Sơ đồ quyền sở hữu storefront |
| Hệ thống bên ngoài | ERP, PIM, WMS, CRM, marketplace, Tax, accounting và middleware | Người phụ trách kỹ thuật | Bảng theo dõi dependency và hệ thống chịu trách nhiệm chính |
Sơ đồ cần chỉ rõ nơi mỗi giá trị được quản lý chính thức và identifier nào kết nối giá trị đó với những miền khác.
Chuẩn bị quyền truy cập, dữ liệu export, bản sao lưu và thông tin từ Cửa hàng nguồn
Thu thập:
- quyền quản trị Cửa hàng nguồn và quyền quản trị VTEX cần thiết;
- các bản export có ngày ghi nhận cho Products, SKUs, Categories, Brands, giá, promotions, Customers, Orders và nội dung;
- bản sao database, media hoặc application archives nếu có;
- specification groups, specifications ở cấp Products, SKU specifications và các tập giá trị được kiểm soát;
- báo cáo Trade Policy, seller, channel, warehouse, dock, carrier và inventory;
- ví dụ Customers, B2B và các đối tượng Master Data;
- identifiers Catalog và seller trong marketplace;
- danh sách CMS, search, navigation, URLs, metadata và redirects;
- danh sách apps, APIs, middleware, các tích hợp và hệ thống bên ngoài;
- screenshots hoặc reports giải thích những cách hoạt động quan trọng ở Cửa hàng nguồn.
| Tài liệu cần giữ | Vì sao cần | Điều kiện sẵn sàng |
|---|---|---|
| Từ điển Catalog | Giải thích ý nghĩa Products/SKU/specifications | Mỗi trường ưu tiên có bên chịu trách nhiệm và giá trị đại diện |
| Ma trận kênh và seller | Bảo đảm phạm vi Trade Policy và marketplace được hiểu đúng | Mỗi quan hệ seller/kênh được ghi nhận |
| Danh sách Master Data | Xác định đối tượng tùy chỉnh ngoài bản ghi Customers thông thường | Mỗi đối tượng quan trọng có schema, key và bên chịu trách nhiệm |
| Bảng theo dõi tích hợp | Giữ các quan hệ với hệ thống bên ngoài | Mỗi identifier cần duy trì được nối với đúng đối tượng VTEX hoặc hệ thống bên ngoài |
| Danh sách routes/nội dung | Tách phần triển khai storefront khỏi dữ liệu Catalog | Routes và nội dung ưu tiên đều có chủ thể đích |
API export còn thiếu hoặc middleware transformation chưa được mô tả phải tiếp tục được ghi là hạng mục chuẩn bị chưa giải quyết, không được giả định là có thể xử lý sau.
Chuẩn bị Categories, Products, SKUs và specifications
Chọn các bản ghi đại diện làm lộ rõ hệ phân cấp VTEX: Categories, Brands, Products, SKUs, specification groups, specifications ở cấp Products và SKU specifications.
Bao gồm:
- Products đơn giản có một SKU;
- Products có nhiều SKUs;
- Products có SKU values phân biệt size, color, model, voltage, region hoặc package;
- specification groups riêng theo Categories và các trường kế thừa;
- Products có Brands, media, nội dung liên quan hoặc external PIM identifiers;
- attachments, services, kits, bundles hoặc assembly-option behavior;
- Products được nhiều sellers hoặc channels cung cấp.
| Cách hoạt động ở nguồn | Quyết định chuẩn bị trong VTEX | Thông tin cần giữ |
|---|---|---|
| Giá trị phân biệt đơn vị có thể bán | Xác định SKU specification và quan hệ SKU | IDs Products/SKU, values, images, stock và external keys |
| Giá trị mô tả Products nói chung | Xác định specification ở cấp Products | Categories, specification group, kiểu trường và tập giá trị |
| Khách hàng cung cấp thông tin | Xác định attachment hoặc chủ thể ứng dụng khác | Định nghĩa dữ liệu nhập và một đơn hàng trước đây làm ví dụ |
| Products gồm nhiều thành phần hoặc items tùy chọn | Xác định kit, assembly option, service hoặc chủ thể bên ngoài | Danh sách thành phần, số lượng, giá, inventory và cách Orders ghi nhận |
| Catalog do PIM cung cấp | Giữ identifiers PIM và VTEX | Hệ thống chịu trách nhiệm chính và synchronization key |
Chuẩn hóa tên specifications trùng nhau, values thiếu nhất quán, SKUs mồ côi, Products thiếu Categories và Products đã lỗi thời trước khi mapping cuối cùng. Catalog được coi là sẵn sàng khi mọi dòng sản phẩm chính đều có kế hoạch cho Categories, Brands, Products, SKUs, specifications và external IDs.
Chuẩn bị Trade Policies, giá, sellers và ngữ cảnh thương mại
Trade Policies có thể kết nối Catalog, giá, Promotions, inventory, logistics, payment settings và sales channels. Sellers và marketplace offers tạo thêm một lớp quyền sở hữu.
| Bản ghi thương mại | Hành động chuẩn bị | Thông tin xác nhận sẵn sàng |
|---|---|---|
| Trade Policy | Xác định sales channel, khả năng bán Catalog, quy tắc thương mại và hoạt động liên quan | Ma trận Trade Policy |
| Giá | Xác định SKU, currency, price table, ngữ cảnh Customers/kênh và hệ thống chịu trách nhiệm chính | Các trường hợp giá SKU đại diện |
| Promotion | Ghi nhận conditions, scope, dates và Products/Customers chịu ảnh hưởng | Danh sách promotions ưu tiên |
| Seller | Xác định seller identity, Products, offers, trách nhiệm hoàn tất đơn hàng và external IDs | Ma trận quyền sở hữu seller |
| Marketplace offer | Tách danh tính Catalog chuẩn khỏi giá, stock và trách nhiệm hoàn tất đơn hàng riêng của seller | Ví dụ mapping Products/SKU/seller |
| Nhóm Products B2B | Xác định organization, Trade Policy, Catalog, giá và quan hệ truy cập | Kịch bản người mua B2B đại diện |
Không coi giá theo kênh hoặc seller records ở nguồn là trường Products thông thường. Hạng mục này chỉ sẵn sàng khi mỗi SKU ưu tiên có bên chịu trách nhiệm giá, phạm vi Trade Policy, quan hệ seller và chủ thể inventory rõ ràng.
Chuẩn bị Customers, B2B và Master Data
Dữ liệu liên quan đến Customers có thể bao gồm profiles, addresses, organizations, buyer roles, cost centers, approval context, forms tùy chỉnh, consent, loyalty, CRM IDs và Master Data documents.
Chuẩn bị:
- Customers đã đăng ký, guests, nhiều addresses, danh tính trùng và external IDs;
- B2B organizations, users, roles, cost centers và ngữ cảnh thương mại;
- đối tượng Customers hoặc workflow tùy chỉnh được lưu ngoài profiles tiêu chuẩn;
- schemas, trường dữ liệu, keys, references và ứng dụng sử dụng Master Data;
- quyết định về consent, privacy và retention;
- identifiers trong CRM, ERP, loyalty, marketplace và hệ thống hỗ trợ.
| Bản ghi ở nguồn | Bên chịu trách nhiệm | Thông tin cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Danh tính Customers | Đội vận hành Customers | Ví dụ duplicate và guest | Quy tắc định danh và merge được ghi nhận |
| B2B organization | Người phụ trách B2B | Ma trận organization/user/role/cost-center | Quan hệ company có chủ thể đích xác định |
| Master Data document | Chủ quy trình nghiệp vụ | schema của đối tượng và ví dụ tham chiếu | Key, parent relationship và hệ thống tiếp tục sử dụng đã rõ |
| Consent hoặc trường nhạy cảm | Pháp lý/người phụ trách dữ liệu | Danh sách trường được phê duyệt | Mục đích cần thiết và cơ sở retention được ghi nhận |
| External key | Người phụ trách tích hợp | Ví dụ lookup CRM/ERP/marketplace | Key được gắn ở đúng cấp đối tượng |
Master Data không nên trở thành nơi chứa mọi trường ở nguồn chưa biết xử lý thế nào. Mỗi document tùy chỉnh cần có đối tượng nghiệp vụ, key, quan hệ và bên chịu trách nhiệm trong tương lai được đặt tên rõ.
Chuẩn bị dữ liệu lịch sử đơn hàng và các tham chiếu vận hành
Chọn Orders làm rõ danh tính Customers, seller, Trade Policy, SKU lines, giá, Promotions, Tax, payment references, shipping data, quy trình hoàn tất đơn hàng, status và external IDs.
Bao gồm:
- Orders thông thường, cancelled, refunded và partially fulfilled;
- Orders từ từng seller, Trade Policy, currency và sales channel quan trọng;
- Orders marketplace;
- Orders có nhiều shipments hoặc carriers;
- Orders chứa kits, attachments, services hoặc custom data;
- Orders kết nối với ERP, accounting, WMS, marketplace hoặc hệ thống hỗ trợ.
| Khu vực lịch sử | Thông tin cần giữ | Điều kiện sẵn sàng |
|---|---|---|
| Chi tiết Products/SKU | Bộ hồ sơ Orders đại diện | SKU đã mua, seller, số lượng, giá và custom data đều có thể giải thích |
| Ngữ cảnh payment | Ví dụ method, transaction và status | Tham chiếu lịch sử và ranh giới dữ liệu nhạy cảm được ghi nhận |
| Ngữ cảnh logistics | Ví dụ shipping method, SLA, carrier, warehouse, dock, tracking và trạng thái hoàn tất đơn hàng | Quan hệ lịch sử hiểu được mà không cần cấu hình logistics đang hoạt động |
| Điều chỉnh | Promotions, Tax, refunds, cancellations và thay đổi thủ công | Tổng giá trị lịch sử có thể được giải thích |
| Liên kết hệ thống bên ngoài | IDs ERP, marketplace hoặc accounting | Reconciliation keys được giữ ở đúng cấp Orders |
Lịch sử đơn hàng ghi lại hoạt động thương mại đã diễn ra. Cấu hình Checkout, Payments, OMS, Logistics, carrier và warehouse hiện tại vẫn là lớp riêng với bản ghi Orders được di chuyển.
Chuẩn bị inventory, logistics, nội dung storefront và URLs
Với inventory, cần xác định hệ thống nào sở hữu số lượng và khả năng bán, warehouses/sellers nào cung cấp từng SKU, và Trade Policy/logistics context liên quan được biểu diễn ra sao.
Với storefront, thu thập:
- nội dung Products và Categories;
- Trang Hệ thống quản lý nội dung, landing pages, Blog Posts, hướng dẫn và nội dung chiến dịch;
- ví dụ search, facets, navigation và filters;
- URLs ưu tiên cho Products, Categories, Brands, campaigns và nội dung;
- metadata, canonical relationships và redirects;
- bên sở hữu frontend Headless hoặc CMS;
- danh sách media và internal links.
| Hạng mục | Câu hỏi chuẩn bị | Thông tin xác nhận sẵn sàng |
|---|---|---|
| Inventory | Hệ thống, warehouse, seller hoặc feed nào sở hữu số lượng của từng SKU? | Ma trận SKU/hệ thống chịu trách nhiệm chính |
| Logistics | Quan hệ warehouse, dock, carrier, SLA, pickup hoặc hoàn tất đơn hàng nào quan trọng? | Sơ đồ logistics đại diện |
| Search và facets | Specifications và Categories nào hỗ trợ khả năng tìm kiếm Products? | Ví dụ trường/filter đã được kiểm soát |
| Nội dung | VTEX CMS, CMS bên ngoài hay frontend repository nào sở hữu bản ghi? | Danh sách quyền sở hữu nội dung |
| URLs | Route/redirect nào duy trì đúng từng đường dẫn ưu tiên ở nguồn? | Sổ đối chiếu URL nguồn/đích |
Hạng mục này chỉ sẵn sàng khi Catalog, inventory, logistics, nội dung và routes có chủ thể riêng, thay vì bị gom thành một bản export storefront.
Kiểm kê apps, APIs và các hệ thống bên ngoài
Tạo bảng theo dõi dependency cho mọi app, API, middleware flow, tích hợp tùy chỉnh, webhook và nền tảng bên ngoài có khả năng tạo hoặc thay đổi Catalog, Customers, Orders, giá, seller, inventory, logistics hoặc nội dung.
Với mỗi dependency, ghi:
- mục đích kinh doanh;
- miền VTEX và bản ghi chịu ảnh hưởng;
- hệ thống bên ngoài chịu trách nhiệm chính;
- IDs và reference keys;
- khả năng truy cập qua API hoặc export;
- người phụ trách nghiệp vụ và kỹ thuật;
- quyết định tiếp tục, thay thế hoặc loại bỏ;
- dữ liệu cần có trước khi workflow đích được cấu hình.
Các dependency ưu tiên gồm ERP, PIM, WMS, OMS, CRM, accounting, Tax, fraud, search, marketplace, loyalty, subscription, personalization, analytics và các hệ thống nội dung.
Bảng theo dõi chỉ sẵn sàng khi mỗi giá trị quan trọng có một chủ thể chịu trách nhiệm chính và một key bền vững. Một trường của middleware mà chưa xác định đối tượng nguồn/đích vẫn là thông tin chưa hoàn chỉnh.
Chọn các mẫu đại diện cho lần kiểm thử di chuyển dữ liệu
| Mẫu kiểm thử | Mục đích chuẩn bị |
|---|---|
| Products có nhiều SKUs | Làm rõ quan hệ Products/SKU/specifications/media |
| Categories có specifications kế thừa | Làm rõ hệ phân cấp Catalog và quyền sở hữu trường |
| SKU xuất hiện trong nhiều Trade Policies | Làm rõ ngữ cảnh giá, kênh, inventory và logistics |
| Products marketplace và seller offer | Làm rõ Catalog chuẩn so với quyền sở hữu seller |
| Customers hoặc organization B2B | Làm rõ danh tính, role, cost center và ngữ cảnh thương mại |
| Master Data document | Làm rõ đối tượng tùy chỉnh, key, reference và chủ thể |
| Một đơn hàng trước đây có cấu trúc phức tạp | Làm rõ seller, SKU, promotion, payment, quy trình hoàn tất đơn hàng và external IDs |
| Nội dung hoặc route Headless | Làm rõ quyền sở hữu frontend, CMS, SEO và redirect |
Với mỗi mẫu, ghi source ID, source URL khi có liên quan, lý do kinh doanh, miền VTEX dự kiến, external identifiers, phần đã biết không nằm trong phạm vi và người chịu trách nhiệm rà soát.
Hoàn tất điều kiện sẵn sàng trước khi chuyển sang VTEX
| Câu hỏi về mức độ sẵn sàng | Thông tin cần có | Điều kiện đạt |
|---|---|---|
| Quyền truy cập và bản sao nguồn có khôi phục được không? | Hồ sơ quyền truy cập và bản export/backup có ngày ghi nhận | Bản ghi cần thiết có thể được kiểm tra độc lập với Cửa hàng nguồn đang hoạt động |
| Quyền sở hữu theo miền đã được ghi nhận chưa? | Sơ đồ miền VTEX và hệ thống bên ngoài | Mỗi nhóm bản ghi chính có chủ thể chịu trách nhiệm |
| Cấu trúc Catalog/SKU đã sẵn sàng chưa? | Ma trận Products/SKU/specifications | Mọi mô hình Products chính có cách biểu diễn trong VTEX |
| Trade Policies, sellers và giá đã được chỉ định chưa? | Ma trận quyền sở hữu thương mại | Các trường hợp kênh/seller đại diện đã đầy đủ |
| Customers và các đối tượng Master Data đã được định nghĩa chưa? | Sơ đồ danh tính và đối tượng | Keys, relationships và ứng dụng sử dụng được ghi nhận |
| Orders và tham chiếu vận hành đã được giải thích chưa? | Bộ hồ sơ lịch sử đơn hàng | Giao dịch trước đây vẫn có thể hiểu được |
| Apps và hệ thống bên ngoài đã được kiểm kê chưa? | Bảng theo dõi dependency | Mỗi dependency quan trọng có chủ thể tiếp tục chịu trách nhiệm |
| Đã chọn mẫu kiểm thử di chuyển dữ liệu đại diện chưa? | Danh sách mẫu | Độ phức tạp của Catalog, thương mại, Customers, Orders và storefront được bao phủ |
| Hạng mục chưa giải quyết có được kiểm soát không? | Decision log | Mỗi vấn đề mở có người chịu trách nhiệm và thời hạn |
Công tác chuẩn bị hoàn tất khi không còn quyết định quan trọng về Catalog, SKU, Trade Policy, seller, Customers, Master Data, Orders, inventory, routes hoặc tích hợp phụ thuộc vào giả định chưa được ghi nhận.
Kết luận
Chuẩn bị chuyển đổi sang VTEX cần tạo ra một bộ thông tin cấp doanh nghiệp với quyền sở hữu theo từng miền. Categories, Products, SKUs, specifications, Trade Policies, sellers, giá, Customers, Master Data, Orders, logistics, nội dung và các tích hợp đều cần bên chịu trách nhiệm và các bản ghi đại diện.
Khi những quyết định này được chuẩn bị trước lần kiểm thử di chuyển dữ liệu đại diện, bộ mẫu có thể phản ánh đúng kiến trúc VTEX dự kiến thay vì khiến một tập bản ghi đã import bị hiểu nhầm là một hoạt động thương mại hoàn chỉnh.
Câu hỏi thường gặp
Tài liệu chuẩn bị nào nên được tạo đầu tiên cho VTEX?
Nên bắt đầu bằng sơ đồ quyền sở hữu theo miền cho Catalog, ngữ cảnh thương mại, Customers, Orders, vận hành, storefront và các hệ thống bên ngoài. Sơ đồ này xác định những tài liệu nào cần thu thập và ai phải chịu trách nhiệm.
Vì sao Products và SKUs phải được chuẩn bị riêng?
Products thể hiện định nghĩa thương mại chung, còn mỗi SKU thể hiện một biến thể có thể bán. Specifications, images, inventory, giá, seller offers và chi tiết mặt hàng trong Orders có thể phụ thuộc vào quan hệ SKU.
Cần chuẩn bị gì cho Trade Policies?
Ghi nhận sales channel, khả năng bán SKU, ngữ cảnh giá, Promotions, inventory, logistics, quan hệ payment, sellers và hệ thống bên ngoài gắn với từng Trade Policy ưu tiên.
Master Data nên được chuẩn bị như thế nào?
Xác định từng đối tượng, schema, key bền vững, quan hệ cha-con, ứng dụng sử dụng, yêu cầu privacy và chủ thể đích. Master Data không nên được coi là nơi chứa chung các trường ở nguồn chưa xác định mục đích.
Cần chuẩn bị dữ liệu lịch sử đơn hàng cho VTEX như thế nào?
Cung cấp các bản ghi đơn hàng đại diện có thông tin SKU, sellers, giá, Promotions, Tax, tham chiếu thanh toán, bối cảnh giao hàng, trạng thái hoàn tất đơn hàng, trạng thái đơn hàng và external IDs. Tách những thông tin lịch sử này khỏi cấu hình vận hành hiện tại.
Khi nào có thể coi công tác chuẩn bị cho VTEX đã hoàn tất?
Công tác chuẩn bị chỉ hoàn tất khi quyền sở hữu theo miền, cấu trúc Catalog, quan hệ thương mại, Customers và Master Data, Orders, nội dung, routes, các tích hợp, mẫu kiểm thử và mọi quyết định còn mở đều được ghi nhận cùng người chịu trách nhiệm.