# 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="/files/cTTykRyWKKbvIXQALXfL" 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="/files/Cve60yaWbGu3ZgRZ45DO" alt=""><figcaption></figcaption></figure>

5. **Copy API key.**

   <figure><img src="/files/AincjJksoGMGgC5GDk2c" 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="/files/bWUCLE4bBpq9Oioevx8W" 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="/files/X5S7hjf2I7iHdDCR61pS" alt=""><figcaption></figcaption></figure>
6. **Truy cập  <https://builder.ladipage.com> Chọn Cài đặt**, sau đó chọn **Webhook.**

<figure><img src="/files/0sVgXhzrsSilqMMXUTJs" 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="/files/EvxtRcSxv5Zo7TDefNxf" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ladipage-vietnam.gitbook.io/v5-ladiflow/tich-hop/huong-dan-tich-hop/tich-hop-ladipage-ecommerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.