Migrate Haravan sang WooCommerce: hướng dẫn end-to-end + pitfall

Haravan là platform VN bản địa với payment VNPay/MoMo/ZaloPay sẵn và shipping GHN/GHTK tích hợp — nhưng giới hạn customize và không có B2B/multi-warehouse. Shop scale qua 500 đơn/tháng thường migrate sang WooCommerce để mở khoá hệ sinh thái plugin.

Bài này hướng dẫn export qua Haravan API, mapping schema VN-specific, giữ GHN/GHTK + payment đã có khi chuyển sang WooCommerce.

Vì sao shop VN rời Haravan sang WooCommerce

Haravan tốt cho shop nhỏ-vừa cần lên live nhanh — payment VN sẵn, GHN/GHTK integrate sẵn, không cần đụng code. Nhưng khi shop scale, 4 limitation hiện rõ.

Khác Shopify (lock-in code và Liquid theme), pain point Haravan chủ yếu là feature gap: không có B2B, không có subscription billing, theme limited customize chỉ qua setting có sẵn. Subscription monthly 700k-2 triệu cộng dồn theo năm cũng tốn kém so với WooCommerce self-hosted.

Giai đoạn 1 — Export data qua Haravan API

Haravan có 2 cách export: CSV qua admin UI (basic, đủ cho shop nhỏ) và Haravan API qua developer portal (advanced, export đầy đủ metafield + customer history). Khác Shopify CSV structured chuẩn, Haravan CSV nhiều field VN-specific (vd “Tên sản phẩm”, “Giá”, “Phân loại”) cần converter chuyên dụng.

4 dataset cần export

1. Products: Admin → Sản phẩm → Export → CSV (tối đa 1000 SKU/file, shop lớn chia nhiều batch).
2. Orders: Admin → Đơn hàng → Export → CSV — filter theo date range tránh file quá lớn.
3. Customers: Admin → Khách hàng → Export → CSV kèm history mua hàng và loyalty point hiện tại.
4. Pages + Blogs: Admin → Online Store → Pages/Blogs → Export — content HTML cần convert format Haravan sang WordPress block.

Export qua Haravan API cho dataset đầy đủ

# Get API access token
# Admin → Cài đặt → Tài khoản API → Tạo token mới
# Note token, giữ secure không commit Git

# Export products với pagination
curl -X GET "https://api.haravan.com/com/products.json?limit=250&page=1" 
  -H "Authorization: Bearer YOUR_HARAVAN_TOKEN" 
  -o products_page_1.json

# Loop pagination cho shop trên 250 SKU
for page in $(seq 1 20); do
  curl -X GET "https://api.haravan.com/com/products.json?limit=250&page=$page" 
    -H "Authorization: Bearer YOUR_HARAVAN_TOKEN" 
    -o "products_page_$page.json"
  sleep 1  # Tránh rate limit
done

# Orders (status any để lấy cả pending + completed)
curl -X GET "https://api.haravan.com/com/orders.json?status=any&limit=250" 
  -H "Authorization: Bearer YOUR_HARAVAN_TOKEN" 
  -o orders.json

# Customers với history
curl -X GET "https://api.haravan.com/com/customers.json?limit=250" 
  -H "Authorization: Bearer YOUR_HARAVAN_TOKEN" 
  -o customers.json

Giai đoạn 2 — Mapping schema Haravan sang WooCommerce

Đây là giai đoạn unique của migration Haravan — column CSV Haravan tiếng Việt cần map sang field WooCommerce tiếng Anh. Plugin Cart2Cart có support Haravan nhưng yếu hơn Shopify connector, manual mapping thường chính xác hơn cho shop dưới 1000 SKU.

Map column CSV Haravan sang WooCommerce

• “Tên sản phẩm” → “Name”: Field bắt buộc, giữ nguyên text tiếng Việt với dấu — utf8mb4 trong WordPress hỗ trợ đầy đủ.
• “Giá” → “Regular price”: Format Haravan VND không có decimal, WooCommerce default 2 decimal — strip “.00” hoặc set decimal places = 0 trong WC Settings.
• “Mô tả” → “Description”: HTML content, kiểm tra image src trỏ về Haravan CDN — cần download và re-upload (xem giai đoạn 4).
• “SKU” → “SKU”: Giữ nguyên cho consistency, đặc biệt nếu shop có barcode scanner đang dùng SKU làm key.
• “Hình ảnh” → “Images”: URL separated by comma, cần bulk download qua wget loop và re-upload qua plugin WP All Import.
• “Phân loại” → “Categories”: Separator “>” (vd “Quần áo > Áo thun”), WooCommerce import auto-tạo parent-child category.
• “Thẻ” → “Tags”: Tags comma-separated, import trực tiếp vào WooCommerce product_tag taxonomy.

Import qua WP All Import (recommend cho mapping VN)

WP All Import (free + Pro 99 USD) cho UI drag-drop map column CSV sang field WooCommerce — visual interface dễ hơn Cart2Cart cho người không quen English admin. Pro version có addon WooCommerce dedicated cho product/variation/customer.

Giai đoạn 3 — Giữ GHN/GHTK + payment VN trên WooCommerce

Đây là phần dễ nhất khi migrate từ Haravan — vì plugin VN cho WooCommerce đã có sẵn và miễn phí. Shop không phải đăng ký lại merchant với VNPay/MoMo, chỉ đổi gateway integration từ Haravan sang WooCommerce.

Plugin shipping VN cho WooCommerce

• GHN cho WooCommerce (free): Plugin official từ GHN, integrate API tính phí ship theo trọng lượng + khoảng cách. Setup qua API token từ GHN dashboard.
• GHTK cho WooCommerce (free): Plugin official từ Giao Hàng Tiết Kiệm, support cả Express và Standard service. Tracking number tự động sync.
• Viettel Post for WooCommerce (free): Integration cho shop muốn ship qua Viettel Post — quote phí và tracking native trong order admin.
• BEST Express cho WooCommerce (paid 1.5 triệu/năm): Cho shop high-volume cần SLA cao, đặc biệt cho COD shop F&B/mỹ phẩm.

Plugin payment VN giữ merchant account hiện tại

• VNPay official plugin (free): Plugin official VNPay, dùng merchant ID + secret key từ VNPay dashboard hiện tại — không cần register merchant mới.
• MoMo Business plugin (free): Integration với MoMo merchant account, support cả QR và link payment.
• ZaloPay plugin (free): Tích hợp ZaloPay app payment + QR — phù hợp shop có customer base trẻ dùng Zalo nhiều.
• Bao Kim plugin (free): Aggregator nhiều gateway — phù hợp shop muốn 1 dashboard quản tất cả payment method.

Giai đoạn 4 — Recreate loyalty point và affiliate

Haravan có module loyalty và affiliate built-in mà WooCommerce không có native. Đây là phần khó migrate vì data structure khác hẳn — cần plugin third-party + manual data migration.

Recreate loyalty point

• Plugin WooCommerce Points and Rewards (129 USD): Plugin official Automattic, cho phép earn point theo order + redeem checkout. Feature parity với Haravan loyalty.
• Migrate point balance hiện tại: Export customer + point từ Haravan (Admin → Khách hàng → kèm cột “Điểm tích luỹ”) → import qua plugin với CSV custom field.
• Communication với khách: Email batch thông báo point được preserve và cách dùng trên platform mới — tránh khách complain mất point.

Recreate affiliate program

• AffiliateWP (149 USD/năm): Plugin affiliate mạnh nhất cho WooCommerce, support multi-tier commission và tracking đa kênh.
• YITH WooCommerce Affiliates (99 USD/năm): Affordable alternative với feature đủ cho shop SME — UI Vietnamese-friendly hơn.
• Migrate affiliate code: Export list affiliate từ Haravan, recreate code trong AffiliateWP với cùng URL parameter pattern — affiliate link cũ vẫn track được.

Giai đoạn 5 — Redirect 301 cho URL Haravan

URL pattern Haravan khá giống Shopify (vì Haravan trước đây fork concept từ Shopify), nhưng có vài khác biệt trong category và blog pattern. Setup redirect đầy đủ giữ xếp hạng SEO và backlink.

# URL pattern Haravan sang WooCommerce

Haravan                             → WooCommerce
/products/{slug}                    → /{slug}/
/collections/{slug}                 → /product-category/{slug}/
/collections/all                    → /shop/
/blogs/{blog}/{slug}                → /{slug}/
/pages/{slug}                       → /{slug}/

# .htaccess implementation
RewriteEngine On
RewriteRule ^products/(.*)$ /$1/ [R=301,L]
RewriteRule ^collections/all$ /shop/ [R=301,L]
RewriteRule ^collections/(.*)$ /product-category/$1/ [R=301,L]
RewriteRule ^blogs/[^/]+/(.*)$ /$1/ [R=301,L]
RewriteRule ^pages/(.*)$ /$1/ [R=301,L]

# Verify với curl
curl -I https://yoursite.vn/products/iphone-15
# Phải thấy "HTTP/1.1 301 Moved Permanently"
# Location: https://yoursite.vn/iphone-15/

Mapping VN-specific field — phần đặc thù Haravan

Khác Shopify chuẩn international, Haravan có nhiều field VN-specific cần xử lý riêng khi migrate. Đây là phần unique của migration Haravan — không có ở Shopify hay Sapo.

Customer field tiếng Việt phức tạp

• Tên khách có dấu: Haravan lưu UTF-8, WordPress utf8mb4 — verify không bị mất dấu khi import. Test 5-10 customer có tên đặc thù (“Nguyễn”, “Trần”, “Phương”) trước khi bulk import.
• SĐT format đa dạng: Haravan accept cả “0901234567”, “+84901234567”, “84901234567” — WooCommerce cần normalize về 1 format chuẩn (recommend “0901234567” cho VN).
• Địa chỉ 4 cấp Tỉnh/Huyện/Xã/Số nhà: Haravan có dropdown 4 cấp built-in, WooCommerce default chỉ State/City. Cần plugin “WooCommerce Vietnam Checkout” hoặc tương đương để recreate dropdown 4 cấp.

Order field VN-specific

• Note giao hàng tiếng Việt dài: Khách thường ghi note dài “Giao trước 5h chiều, gọi trước 30 phút” — Haravan có field `note` riêng, WooCommerce dùng `customer_note` map qua.
• Số hoá đơn VAT: Shop B2B yêu cầu xuất hoá đơn VAT — Haravan có field tax_invoice_required, recreate qua custom field WooCommerce trong checkout.
• Mã giảm giá theo code: Haravan và WooCommerce đều có coupon system — export coupon từ Haravan và recreate trong WC, KHÔNG migrate usage history (start fresh tracking).

Theme rebuild — recreate UI Haravan trên WooCommerce

Theme Haravan dùng template engine custom (Liquid-like), không export code được. Workflow rebuild khác Shopify ở chỗ Haravan theme thường đơn giản hơn — designer recreate trong 1-2 tuần thay vì 3-4 tuần như Shopify theme phức tạp.

Workflow rebuild 4 bước

1. Screenshot toàn site Haravan: Homepage, product page, category, cart, checkout, blog — full HD desktop + mobile. Cần screenshot trước khi cancel subscription Haravan.
2. Document theme tokens: Color, font, spacing, border radius — extract từ DevTools computed style của Haravan theme hiện tại.
3. Pick WooCommerce theme phù hợp: Flatsome (59 USD lifetime), Astra Pro (59 USD/năm), hoặc custom theme — match design Haravan hiện tại.
4. Designer rebuild 1-2 tuần: Recreate UI giống Haravan trên theme đã chọn — focus brand identity và UX flow chính, không cần pixel-perfect.

5 lỗi phổ biến khi migrate Haravan

• Variant “phân loại con” import sai: Haravan có khái niệm “phân loại con” 2-3 level (vd Áo > Màu > Size) phức tạp hơn WooCommerce variable product — Cart2Cart handle tốt hơn manual CSV, hoặc dùng plugin WPC Variations Radio Buttons để recreate UX tương tự.
• Image Haravan CDN break sau cancel: Image URL Haravan CDN (cdn.haravan.com) không accessible sau cancel subscription — bulk download trước go-live qua wget loop, re-upload qua plugin WP All Import.
• Loyalty point lost translation: Haravan loyalty không export trực tiếp qua API — request Haravan support export CSV manual, import qua WooCommerce Points and Rewards với custom field mapping.
• Customer password không transfer: Haravan hash password proprietary, không export — force customer reset password lần đầu login, gửi email batch nhắc qua Mailchimp hoặc Brevo.
• SEO drop do miss redirect pattern: URL Haravan có `/collections/` prefix khác WC `/product-category/` — miss redirect → 404 hàng loạt. Verify top 100 URL trả 301 đúng, monitor Search Console 404 weekly 3 tháng.

Câu hỏi thường gặp

Tài nguyên và bước tiếp theo

Migrate Haravan là quyết định scale dài hạn — phù hợp shop muốn unlimited customize và giảm subscription cost. Sau go-live, mở rộng sang topic operation WooCommerce.

Bài liên quan cùng cụm migration:

• Migrate Shopify sang WooCommerce — quy trình end-to-end — so sánh với migration từ platform quốc tế.
• Migrate Sapo Web sang WooCommerce — chiến lược hybrid POS — khi shop có cửa hàng offline kết hợp.
• Cài WooCommerce từ A-Z — setup VN-ready — setup payment, shipping, tax VN sau migrate.
• Dịch vụ thiết kế website WooCommerce — gói migration turnkey kèm 6 tháng support.

Cần Web22 migrate Haravan sang WooCommerce trọn gói + giữ GHN/GHTK + VNPay/MoMo merchant hiện tại + redirect 301? Đội Web22 dev WooCommerce full feature — báo giá cố định 25-40 triệu shop trung bình, SLA 30 ngày, đào tạo admin 2-3 buổi.