SFTP - Hướng dẫn về trường tuỳ chỉnh

MỤC LỤC

• SFTP - Hướng dẫn về trường tuỳ chỉnh
  • Nguyên tắc xử lý file phản hồi trường tuỳ chỉnh
  • Định dạng file và quy tắc đặt tên
  • Tần suất và lịch trình tải lên
  • Định dạng file trường tuỳ chỉnh

Chủ đề này cung cấp các thông tin hữu ích giúp bạn đảm bảo việc tải lên file được thực hiện thành công.

Để xem các hướng dẫn và thông tin chung về SFTP, vui lòng tham khảo SFTP - Hướng dẫn thiết lập.

Nguyên tắc xử lý file phản hồi trường tuỳ chỉnh

Mỗi lần tải file lên, Spotnana cho phép bạn gửi dữ liệu phản hồi trường tuỳ chỉnh đầy đủ hoặc chỉ một phần. Tên file sẽ thể hiện tên trường tuỳ chỉnh và danh sách phản hồi mà bạn đang cập nhật. Mỗi trường tuỳ chỉnh và các lựa chọn phản hồi của trường đó cần được gửi trong một file riêng biệt (xem chi tiết về quy tắc đặt tên file ở phần bên dưới). Việc xử lý nội dung file CSV của bạn sẽ tuân theo nguyên tắc sau:

• Nếu cột ACTION của dòng đó được đặt là CREATE, hệ thống sẽ tạo mới lựa chọn phản hồi cho danh sách phản hồi tương ứng.

• Nếu cột ACTION của dòng đó được đặt là UPDATE và lựa chọn phản hồi đó đã tồn tại, mô tả của lựa chọn phản hồi sẽ được cập nhật.

Nếu cột ACTION của dòng đó được đặt là DELETE , lựa chọn phản hồi đó sẽ bị xoá. Nếu không tìm thấy lựa chọn phản hồi tương ứng trong hệ thống Spotnana, dòng đó sẽ bị bỏ qua và không có hành động nào được thực hiện.

Định dạng file và quy tắc đặt tên

Mỗi file dữ liệu trường tuỳ chỉnh định dạng .CSV cần được đặt tên theo mẫu sau:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

trong đó:

• [customFieldID] là biến thay đổi tuỳ theo từng trường. ID này nằm trong tên file được hiển thị ở bước 2 trong phần hướng dẫn nhập SFTP hộp thoại thuộc hướng dẫn nhập dữ liệu từ thư mục SFTP. 

• [optionGroupID] là biến thay đổi tuỳ theo từng danh sách phản hồi. ID này nằm trong tên file được hiển thị ở bước 2 trong phần hướng dẫn nhập SFTP hộp thoại thuộc hướng dẫn nhập dữ liệu từ thư mục SFTP.  

• * (ký tự đại diện) có thể là bất kỳ ký tự nào bạn muốn thêm vào tên file. 

• Dấu “.” sau [optionGroupID] và dấu “.” trước “csv” đều bắt buộc phải có. 

Tên file không phân biệt chữ hoa hay chữ thường. Chúng tôi khuyến khích bạn nên thêm ngày và giờ vào tên file (giúp thuận tiện cho việc tra cứu sau này). Ví dụ:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

File dữ liệu .CSV cũng cần tuân theo định dạng nhất định. Tên các cột phải khớp chính xác với định dạng đã quy định (xem ở mục Định dạng trường tuỳ chỉnh dưới đây). 

Tần suất và lịch trình tải lên

Chúng tôi khuyến nghị bạn nên tải file lên hàng ngày để Spotnana luôn nhận được các thông tin thêm/sửa/xoá mới nhất (nếu các trường tuỳ chỉnh thay đổi thường xuyên, việc cập nhật hàng ngày sẽ phù hợp hơn). Khi thực hiện như vậy: 

• các lựa chọn phản hồi mới sẽ xuất hiện ngay lập tức để khách du lịch lựa chọn khi thanh toán. 

• các lựa chọn phản hồi đã ngưng sử dụng sẽ bị loại khỏi danh sách và không còn hiển thị cho khách du lịch. 

Các lựa chọn phản hồi đã ngưng sử dụng vẫn sẽ xuất hiện trong các báo cáo.

Định dạng file trường tuỳ chỉnh

Vui lòng tham khảo thông tin dưới đây để đảm bảo dữ liệu trong file trường tuỳ chỉnh của bạn được định dạng và chuẩn bị đúng cách.