> For the complete documentation index, see [llms.txt](https://ladipage-vietnam.gitbook.io/v5-ladiflow/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ladipage-vietnam.gitbook.io/v5-ladiflow/tich-hop/huong-dan-tich-hop/tich-hop-ladipage-ecommerce.md).

# Tích hợp LadiPage Ecommerce

### Tích hợp LadiPage Ecommerce

{% embed url="<https://www.youtube.com/watch?v=UarDC1FilXc>" %}

Kể từ sau thời điểm tích hợp Ecommerce trên Automation thành công:

* Tất cả khách hàng mới tạo đều được đồng bộ sang Automation&#x20;
* Tất cả đơn hàng mới tạo, cập nhật, huỷ sẽ cập nhật dữ liệu khách hàng đã có hoặc tạo mới khách hàng
* Tự động cập nhật các thông tin chỉ số liên quan đến đơn hàng của bạn và của từng khách hàng

1. **Tìm ứng dụng Ecommerce**

   <figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2F913ykvkJ7U4IadwUbYRV%2Fimage.png?alt=media&amp;token=a68ba858-abb6-45d8-bfd4-24bc2e7da0b8" alt=""><figcaption></figcaption></figure>
2. **Chọn Thêm liên kết.**
3. **Mở thêm 1 cửa sổ trình duyệt, truy cập ứng dụng Ecommece <https://builder.ladipage.com> và đăng nhập** với tài khoản của bạn.&#x20;
4. C**họn Cài đặt -> Webhooks & API,** sau đó chọn **API.** chọn **API** cho **Quản lý bán hàng**

<figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2FU9YCHCwZxpIU4d0MuWUC%2Fimage.png?alt=media&amp;token=067b7bde-941b-4f4a-bf10-05fda61b041e" alt=""><figcaption></figcaption></figure>

5. **Copy API key.**

   <figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2FJTyNAzmFDnrEzyq6w9wm%2Fimage.png?alt=media&amp;token=8842e0f1-26f1-4b97-8184-d3f5238042a2" alt=""><figcaption></figcaption></figure>
6. **Dán vào phần API key trên form của Automation**. **Điền tên tích hợp và chọn lưu liên kết.**

<figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2F1CNRpev5jS88RUhJPiCX%2Fimage.png?alt=media&amp;token=b6e1e1ae-9828-4dd5-95a2-02bf54273ba7" alt=""><figcaption></figcaption></figure>

5. &#x20;**Mở thêm 1 cửa sổ trình duyệt, truy cập tài khoản  <https://builder.ladipage.com> và đăng nhập** với tài khoản của bạn.Truy cập mục **Cài đặt -> Webhooks & API,** sau đó chọn **API.** chọn **API** cho **Automation**

   <figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2Fa019qpFUhC74j77GUHuv%2Fimage.png?alt=media&amp;token=6f12e337-a982-4fdc-89b1-61b6ad776ddc" alt=""><figcaption></figcaption></figure>
6. **Truy cập  <https://builder.ladipage.com> Chọn Cài đặt**, sau đó chọn **Webhook.**

<figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2FA2y5bQSLMl6sapFRjC7V%2Fimage.png?alt=media&amp;token=55eb82fd-83e7-40b9-9529-2920c1182574" alt=""><figcaption></figcaption></figure>

7. **Chọn Thêm Webhook,** điền các thông tin như mẫu form dưới đây, và chọn **Lưu**.\
   API Url: <https://api.service.ladiflow.com/1.0/webhook/ladisales>\
   **API Request Header** bạn điền như format sau :\
   {"Api-Key": "api key của Automation bạn vừa copy"} ở bước số 5 \
   \
   Lưu ý: Cần tích chọn hết các quyền cho phép trên Ecommerce.

<figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2FmsdDtFLp1I4COc0o1vsM%2Fimage.png?alt=media&amp;token=c49dba40-457a-4c12-8ba9-0b63edfc18c0" alt=""><figcaption></figcaption></figure>

**Hiện tại hệ thống không giới hạn số tích hợp Ecommerce**

### Các trạng thái đơn hàng của **Ecommerce**

<table><thead><tr><th width="193">Tên trường</th><th width="220">Mã trường</th><th>Giá trị</th></tr></thead><tbody><tr><td>Last Order Status</td><td>last_order_status</td><td><ul><li>Open: Đơn hàng mở</li><li>Cancel: Đơn bị hủy</li></ul></td></tr><tr><td>Last order shipping status</td><td>last_order_shipping_status</td><td><ul><li>Pending: Chưa giao</li><li>ReadyToPick: Đã đóng gói</li><li>Delivering: Đang giao</li><li>Delivered: Đã giao</li><li>DeliveredToPostMan: Đã giao cho bưu tá</li><li>Returning: Đang hoàn trả</li><li>Returned: Hoàn trả</li><li>Canceled: Đã hủy</li></ul></td></tr><tr><td>Last Order Payment Status</td><td>last_order_payment_status</td><td><ul><li>Pending: Chưa thanh toán</li><li>Success: Đã thanh toán</li></ul></td></tr><tr><td>Last Order Payment Method</td><td>last_order_payment_method</td><td><ul><li>COD: COD</li><li>ZALO_PAY: Zalo pay</li><li>MOMO: MoMo</li><li>VN_PAY: VnPay</li><li>ALE_PAY: AlePay</li><li>BANK: Chuyển khoản</li><li>VNPT_EPAY: Vnpt Epay</li><li>SHOPEE_PAY: ShoppePay</li><li>PAYPAL: Paypal</li><li>STRIPE: Stripe</li><li>APPOTA: Appotal pay</li><li>FINAN: Finan(Sổ bán hàng)</li></ul></td></tr></tbody></table>

### Lưu dữ liệu từ **Ecommerce** vào trường tùy chỉnh

**Danh sách mã QR check-in sự kiện từ đơn hàng Ecommerce**

* Tên hiển thị: Danh sách mã QR check-in sự kiện
* Tên trường: `lds_last_qr_code_urls`
* Kiểu dữ liệu: Danh sách

**Danh sách URL check-in sự kiện từ đơn hàng Ecommerce**

* Tên hiển thị: Danh sách URL check-in sự kiện
* Tên trường: `lds_last_checkin_urls`
* Kiểu dữ liệu: Danh sách

**Mã QR thanh toán chuyển khoản qua ngân hàng**

* Tên hiển thị: Mã QR thanh toán chuyển khoản qua ngân hàng
* Tên trường: `qr_url`
* Kiểu dữ liệu: Dòng văn bản

{% hint style="info" %}
Mã QR thanh toán chuyển khoản qua ngân hàng được thiết lập trên form checkout trong landing page của bạn.&#x20;

Hướng dẫn thiết lập vui lòng tham khảo tại đây:

* [Thêm Form Checkout](https://help.ladipage.vn/form-checkout/them-form-checkout#them-moi-form-checkout)
* [Kết nối API ngân hàng](https://ecommerce.help.ladipage.vn/thiet-lap/phuong-thuc-thanh-toan/chuyen-khoan-qua-ngan-hang/ket-noi-api-ngan-hang)
  {% endhint %}

**Tổng số lượng tất cả sản phẩm của đơn hàng gần nhất**&#x20;

* Tên hiển thị: Tổng số lượng tất cả sản phẩm của đơn hàng gần nhất&#x20;
* Tên trường: `last_order_total_quantity`
* Kiểu dữ liệu: Dạng số

**Danh sách tên và số lượng từng sản phẩm của đơn hàng gần nhất**

* Tên hiển thị: Danh sách tên và số lượng từng sản phẩm
* Tên trường: `last_order_quantity_of_products`
* Kiểu dữ liệu: Danh sách

**Danh sách ID biến thể sản phẩm trong đơn hàng gần đây nhất**

* Tên hiển thị: Last Order Product Variant IDs
* Tên trường: `last_order_product_variant_ids`
* Kiểu dữ liệu: Danh sách

**Các trường tùy chỉnh của đơn hàng Ecommerce**

Các dữ liệu trường tùy chỉnh đơn hàng **Ecommerce** sẽ được lưu vào thông tin khách hàng đặt đơn nếu bạn tạo tương ứng các trường tùy chỉnh đó trên **Automation**

{% hint style="info" %}
**Lưu ý:** Bạn cần tạo trường dữ liệu cùng mã trường và kiểu dữ liệu trên **Automation** và **Ecommerce** để lưu dữ liệu.

Ví dụ:&#x20;

* Trường tùy chỉnh trên **Automation**:

Mã trường: truong\_tuy\_chinh

Kiểu dữ liệu: Dạng số

* Trường tùy chỉnh đơn hàng trên **Ecommerce**:

Mã trường: truong\_tuy\_chinh

Kiểu dữ liệu: Dạng số
{% endhint %}