Kết nối với website bán hàng
Lấy mã kết nối đưa cho bên làm website để đồng bộ hàng hóa, tồn kho và đơn hàng.
Nếu cửa hàng có website bán hàng, bạn có thể nối website đó với Bán Nhàn: website tự lấy danh sách hàng, giá bán và số tồn từ Bán Nhàn, còn đơn khách đặt trên website tự chảy về màn Đơn hàng. Việc của chủ cửa hàng chỉ là lấy một mã kết nối và gửi cho bên làm website — phần còn lại họ làm.
Một cửa hàng — một mã
Mỗi cửa hàng chỉ có đúng một mã kết nối. Mã này giống chìa khóa: ai cầm mã là đọc được (và nếu bạn cho phép, ghi được) dữ liệu cửa hàng. Chỉ đưa cho bên làm website bạn tin tưởng.
Mở mục Kết nối API
- Bấm hình bánh răng › Thiết lập.
- Ở cột trái, bấm Kết nối API 1.
- Bấm dòng Mã kết nối 2. Chữ bên phải cho biết cửa hàng đã kết nối chưa.
Lấy mã kết nối
Lần đầu vào, bạn chọn những việc website được phép làm, rồi tạo mã:
- Ở khung Cho phép truy xuất 2, tick những việc website cần. Một website bán hàng thông thường cần: Đọc hàng hóa & giá bán, Đọc tồn kho, Đọc khách hàng, Tạo / sửa khách hàng, Đọc đơn hàng, Tạo đơn & cập nhật trạng thái. Không chắc thì hỏi bên làm website cần những ô nào.
- Ô Website nguồn 3: gõ tên website, ví dụ
taphoaminhan.vn. Phần mềm dùng tên này để nhớ đơn nào trên website là hóa đơn nào ở đây, nhờ vậy website gửi lại một đơn nhiều lần cũng không sinh ra hóa đơn trùng. - Ô Chỉ cho phép từ IP để trống, trừ khi bên làm website yêu cầu điền.
- Bấm Tạo mã 1.
Hộp thoại hiện ra mã kết nối 1 — một dãy chữ số dài:
- Bấm Chép khóa 2, rồi dán gửi cho bên làm website qua tin nhắn riêng (không gửi vào nhóm chat đông người).
- Bấm Tôi đã lưu khóa 3 để đóng.
Mã chỉ hiện một lần
Đóng hộp thoại là không xem lại được mã nữa — kể cả chủ cửa hàng. Chưa kịp chép thì chỉ còn cách bấm Tạo lại mã (xem phần dưới) để có mã mới.
Theo dõi kết nối
Sau khi có mã, đầu màn Mã kết nối cho biết:
- 1 Trạng thái: Đang hoạt động hoặc Đang tạm ngừng.
- 2 Vài ký tự cuối của mã — đọc cho bên website để đối chiếu họ đang dùng đúng mã.
- Chạy dưới tài khoản: website chỉ làm được những việc mà tài khoản này được phép. Tài khoản của bạn không có quyền xem giá vốn thì website cũng không thấy giá vốn.
- Dùng gần nhất: lần cuối website gọi sang. Ghi "chưa lần nào" nghĩa là bên kia chưa nhập mã.
Muốn thêm, bớt việc website được làm: tick lại các ô ở khung Cho phép truy xuất bên dưới rồi bấm Lưu thay đổi. Mã không đổi, không phải gửi lại.
Tạm ngừng, tạo lại mã hay ngắt hẳn?
Ba nút 3 ở đầu màn làm ba việc khác nhau. Bấm nút nào phần mềm cũng hỏi lại trước khi làm:
| Nút | Chuyện gì xảy ra | Khi nào dùng |
|---|---|---|
| Tạm ngừng | Website tạm thời không lấy được dữ liệu, không gửi được đơn. Mã giữ nguyên; bấm Bật lại là chạy tiếp, bên website không phải làm gì. | Website đang sửa chữa, đang kiểm kho, muốn tạm dừng bán online vài hôm. |
| Tạo lại mã | Mã cũ hết hiệu lực ngay, phần mềm hiện mã mới (một lần). Các lựa chọn khác giữ nguyên. | Nghi mã bị lộ, đổi bên làm website, hoặc lỡ đóng hộp thoại mà chưa chép mã. |
| Ngắt | Cắt kết nối vĩnh viễn. Muốn nối lại phải tạo mã mới và nhờ bên website khai lại từ đầu. | Thôi không dùng website đó nữa. |
Tạo lại mã xong nhớ gửi mã mới
Từ lúc bấm Tạo lại, website dùng mã cũ sẽ ngừng cập nhật hàng hóa và ngừng gửi đơn về. Gửi mã mới cho bên làm website càng sớm càng tốt.
Website tự nhận thông báo khi có thay đổi
Khi bạn sửa giá, nhập thêm hàng, bán hết một món hay có đơn mới, Bán Nhàn tự báo sang website để website cập nhật theo. Chỗ nhận thông báo do bên làm website tự đăng ký — bạn không cần khai gì. Kéo xuống phần Đường đẩy dữ liệu để xem đang có những địa chỉ nào nhận:
Mỗi dòng là một địa chỉ đang nhận, kèm lần gửi được gần nhất. Bấm nút gửi thử để kiểm tra đường truyền, hoặc nút gỡ để ngừng gửi tới địa chỉ đó. Địa chỉ nào gửi hỏng liên tiếp nhiều lần sẽ tự tắt và bạn nhận được thông báo.
Ngay dưới là Nhật ký lời gọi vào (nút Xem nhật ký). Khi bên làm website báo "đã gửi sang mà không thấy gì", mở nhật ký này để xem yêu cầu đó có tới không và kết quả ra sao.
Câu hỏi thường gặp
Tôi có cần biết lập trình không?
Không. Bạn chỉ cần tạo mã, tick đúng các ô và gửi mã cho bên làm website. Họ sẽ dán mã vào phần cài đặt trên website của họ.
Đơn đặt trên website vào Bán Nhàn ở đâu?
Ở màn Đơn hàng › Đặt hàng, dưới dạng đơn chờ xử lý, kênh bán là website. Cửa hàng vẫn tự xác nhận và giao đơn như đơn bình thường — xem Quản lý đơn đặt hàng và hóa đơn.
Ai được vào mục Kết nối API?
Chủ cửa hàng và chức vụ được bật quyền "Quản lý API key kết nối" ở màn Phân quyền. Nên để riêng chủ cửa hàng giữ quyền này.