Đề tài công trình nghiên cứu về máy thu tiền tự động là một đề tài trong lĩnh vực kỹ thuật điện tử và tự động hóa, nghiên cứu về việc phát triển một hệ thống máy thu tiền tự động hoàn toàn tự động, giúp cho các doanh nghiệp, cơ quan và tổ chức có thể quản lý và thu tiền một cách hiệu quả và tiết kiệm thời gian.
ĐỒN THANH NIÊN CỘNG SẢN HỒ CHÍ MINH BAN CHẤP HÀNH TP HỒ CHÍ MINH CƠNG TRÌNH DỰ THI GIẢI THƯỞNG SINH VIÊN NGHIÊN CỨU KHOA HỌC EURÉKA LẦN THỨ 23 NĂM 2021 TÊN CƠNG TRÌNH: MÁY THU TIỀN TỰ ĐỘNG LĨNH VỰC NGHIÊN CỨU: KỸ THUẬT ĐIỆN TỬ CHUN NGÀNH: ĐIỆN TỬ VIỄN THƠNG Mã số cơng trình: …………………………… (Phần BTC Giải thưởng ghi) i MỤC LỤC TÓM TẮT 1 ĐẶT VẤN ĐỀ 2 TỔNG QUAN CƠNG TRÌNH MỤC TIÊU - PHƯƠNG PHÁP KẾT QUẢ - THẢO LUẬN 4.1 Giới thiệu phần cứng 4.1.1 Máy tính nhúng Raspberry Pi 4.1.2 Màn hình cảm ứng 4.1.3 Nguồn xung 4.1.4 Khóa điện .7 4.1.5 Mạch giảm áp 4.1.6 Cảm biến tiệm cận 4.1.7 NV 200 10 4.1.8 Vỏ máy 12 4.1.9 Báo cáo linh kiện 13 4.1.10 Nguyên lý hoạt động 13 4.2 Phần mềm 14 4.2.1 Phần mềm 14 4.2.2 Ngơn Ngữ lập trình 15 4.2.3 Web App 17 4.2.4 Các thư viện Framework 18 4.2.5 Nguyên lý hoạt động phần mềm 19 4.2.6 Hình ảnh giao diện phần mềm máy thu tiền 24 4.3 Hệ thống server 25 4.3.1 WEB API 25 4.3.2 Những đặt điểm bật 26 4.3.3 Web API hoạt động 26 KẾT LUẬN - ĐỀ NGHỊ 28 TÀI LIỆU THAM KHẢO 29 PHỤ LỤC 30 ii DANH MỤC HÌNH ẢNH Hình Raspberry pi Hình Sơ Đồ Chân Của Raspberry pi Hình Mặt sau hình cảm ứng Hình Mặt sau hình cảm ứng Hình Nguồn Xung 12V - 3A Hình Khóa điện Hình Mạch Giảm áp Hình Module cảm biến hồng ngoại Hình NV-200 Smart Payout 10 Hình 10 Sơ đồ chân kết nối máy NV-200 11 Hình 11 Vỏ máy 12 Hình 12 Sơ đồ nguyên lý phần cứng 14 Hình 13 Sơ đồ tương tác người dùng với phần mềm 15 Hình 14 Sơ Các ngơn ngữ lập trình phổ biến 16 Hình 15 Quy trình thiết kế phát triển FrontEnd 17 Hình 16 Hình ảnh minh họa sở liệu 18 Hình 17 Các hàm sử dụng nộp rút tiền máy thu tiền 21 Hình 18 Kịch máy thu tiền 22 Hình 19 Quy trình phụ kịch (xử lý thơng tin hóa đơn) 23 Hình 20 Quy trình phụ kịch (Xử lý số tiền đưa vào máy) 23 Hình 21 Trang lựa chọn dịch vụ toán 24 Hình 22 Trang chờ khách hàng đưa tiền vào máy 24 Hình 23 Trang thơng báo số tiền cho khách hàng 25 Hình 24 Trang thơng báo giao dịch thành công 25 iii DANH MỤC BẢNG BIỂU Bảng Chi tiết cấu tạo thành phần vỏ máy 12 Bảng Báo cáo giá trị link mua linh kiện 33 Bảng Request body API lấy thông tin nợ 33 Bảng Response body API lấy thông tin nợ 34 Bảng Request body API truy vấn tiền điện HCM 34 Bảng Response body API truy vấn tiền điện HCM 35 Bảng Request body API cập nhật toán 36 Bảng Response body API cập nhật toán 36 iv DANH MỤC CÁC TỪ VIẾT TẮT ATM Automatic Teller Machine IoT Internet of things IDC Intangible Drilling Costs LCD Liquid-Crystal Display HDMI abbreviation for High-Definition Multimedia Interface USB Universal Serial Bus PiPS Pay in Pay out System MDB Database Files SD South Dakota GPIO General Purpose Input/Output PI3 Raspberry pi API Application Programming Interface ID Identification VCC Power GND Ground CO,COM Normally Open, common foot Role TĨM TẮT Hiện nay, giới hình thức, dịch vụ toán tiền tự động trở nên phổ biến trọng như: Máy bán nước tự động, Máy ATM rút tiền tự động… Mà không cần đến nhân viên hỗ trợ Những cỗ máy góp phần giúp tiến gần với Cơng Nghệ 4.0 Và điều Việt Nam áp dụng hình thức tự động để đơn giản hóa cơng việc Ngồi xã hội ngày có q nhiều khoản mà người dùng cần trả toán tháng cho dịch vụ sử dụng hàng ngày, trung bình theo tháng hộ gia đình Việt Nam trả tốn cho loại tiền tiền điện, tiền nước, tiền mạng, tiền card điện thoại nhiều dịch vụ bên ngồi khác dẫn đến khó khăn sau Tại Cửa Hàng, Công Ty…Trong việc giải tốn thiếu nguồn lao động hay việc cơng nhân viên phải làm nhiều công việc lúc dẫn đến rủi ro đặt biệt nơi đông dân cư phát triển thành phố lớn: Tp Hồ Chí Minh, Hà Nội…Về người dùng việc phải chờ lâu tới lượt để nhân viên tốn, phải tốn nơi có vị trí cố định phải di chuyển quản đường xa tới nơi cần tốn Đối diện khó khăn giúp người dùng có thỏa mái sử dụng dịch vụ Nhóm lên ý tưởng cơng trình máy thu tiền tự động không cần nhân viên kết hợp với nhiều loại hình thức tốn cho người dùng giúp người dùng tốn cách nhanh gọn nơi ĐẶT VẤN ĐỀ Ngày nay, tiến không ngừng khoa học kỹ thuật, ứng dụng điện tử - tin học sống làm thay đổi sâu sắc mặt lý thuyết thực tế lĩnh vực tự động hóa Ngồi đời tiến biến đổi điện tử công suất với kích thước nhỏ gọn tác động nhanh, nhạy, dễ dàng ghép nối với vi mạch điều khiển với máy tính Các phần mềm chương trình điều khiển ln nâng cao ngày hồn thiện nhằm đáp ứng tốt với nhu cầu thiết bị sản xuất đời sống Trong kinh tế phát triển theo hướng cơng nghiệp hóa, sản xuất tự động hóa đóng vai trị mũi nhọn khơng thể thiếu Việc tự động hóa cơng việc giúp giảm sức lực người khắc phục toán thiếu nguồn lao động, tải công việc, nâng cao hiệu suất cơng việc.Giao dịch tốn công việc diễn ngày, lúc nơi Việt Nam việc giao dịch tốn ln diễn theo hình thức truyền thống để thực công việc cách tự động hóa ln cịn mẻ Việt Nam.Cùng với phát triển khoa học công nghệ ngày áp dụng vào lĩnh vực xu thế giới nhóm chọn thực đề tài góp phần phục vụ nhu cầu đời sống cho cá nhân tổ chức đơn giản hóa cơng việc giúp người dân đặt biệt người dân vùng nông thôn tiếp cận tới công nghệ giới TỔNG QUAN CƠNG TRÌNH Cơng trình Máy thu tiền tự động cho người dùng toán tiền dịch vụ ngày tiền điện, tiền nước,tiền card điện thoại cách tự động mà không cần đến hỗ trợ nhân viên.Chỉ với bước: Đăng nhập, chọn loại dịch vụ cần toán, nộp số tiền cần toán vào máy Khi ta thực xong bước máy hoàn tất thành cơng việc thu tiền ta máy dễ sử dụng cho nhiều lứa tuổi.Cơng trình lắp ráp đơn giản, chi phí tầm trung, thiết kế gọn, nhẹ đặt sử dụng nhiều nơi vô thuận tiện mang lại hiệu cao cho thương mại kinh tế đáp ứng nhu cầu người dùng.Thêm vào Cơng trình tiếp nhận nhận dạng mặt tiền Việt Nam từ tờ 500 đồng đến tờ 500 ngàn đồng, đồng thời máy thối lại tiền cho người dùng Về phía Cơng Ty máy có chi phí vận hàng thấp đảm bảo tính bảo mật mang lại an toàn cho người dùng Trong công nghệ thu tiền tự động, nhiều nghiên cứu trước đưa thị trường cỗ máy cơng trình tự động mang lại hiệu đáp ứng nhu cầu người dùng đại hóa cơng nghệ 4.0 cịn Việt Nam hình thức tự động mà ta thường thấy ngồi thị trường là: Máy bán nước tự động, máy mua hàng tự động, máy rút tiền tự động(ATM) Ở cỗ máy thực tự động thị trường bn bán, ngân hàng cơng trình máy thu tiền tự động thu tiền tiền dịch vụ ngày người dùng giúp cho thị trường có thêm loại hình tốn góp phần đa dạng hóa hình thức tự động MỤC TIÊU - PHƯƠNG PHÁP MỤC TIÊU Gồm mục tiêu sau: Chế tạo hệ thống gồm máy tốn tiền mặt tự động Tự hóa q trình tốn tiền VND Ứng dụng vào thực tế cửa hàng giới di động Đánh giá kết thử nghiệm hiệu chỉnh Hướng tới giải pháp đưa nghiên cứu ứng dụng thực tiễn nhiều lĩnh vực toán khác đâu có tốn tiền sử dụng cơng trình này Tuy nhiên việc tích hợp thêm nhiều loại dịch vụ, đa dạng hình thức tốn, thực toán với máy với bước đơn giản thách thức lớn Trong nghiên cứu này, việc quan trọng phải tìm đưa thách thức đó, để người dùng có thỏa mái, tiện ích PHƯƠNG PHÁP Nhóm thực số phương pháp nghiên cứu để hình thành nên cơng trình máy thu tiền tự động sau: Tìm hiểu trình toán thực tế Nghiên cứu máy toán tự động thực tế sử dụng rộng rãi thị trường Biết số ưu điểm, nhược điểm số hạn chế mà máy tự động ngồi thị trường mang lại Từ tiêu đề cho việc hình thành nên hệ thống Cơng trình máy thu tiền hồn chỉnh đáp ứng nhu cầu cho người dùng Tìm hiểu nguyên lý nhận dạng tiền VND Một tốn mà nhóm cần phải nghiên cứu phần quan trọng khơng cơng trình máy thu tiền tự động “Làm để máy dạng tiền thối lại tiền” nhóm lựa chọn máy NV-200 để thực cho việc nghiên cứu đưa giải pháp Việc nghiên cứu máy NV-200 giúp ta biết cách sử dụng máy cho việc nhận dạng tiện, thối tiền, kết nối, điều khiển máy cách dễ dàng Thiết kế phần cứng Kết nối linh kiện lại với tạo nên sơ đồ nguyên lý phần cứng Viết phương trình phần mềm Viết phương trình phần mềm để điều khiển linh kiện hoạt động theo trình tự định, có logic Tạo nên đường dây liên kết thiết bị lại với hoạt động cách trơn chu thêm vào giúp người dùng sử dụng tốn thực thao tác cơng trình máy thu tiền tự động Thiết kế vỏ máy Hình thành nên khung chắn đảm bảo tính an tồn, bảo mật, đơn giảm không rườm rà.Thêm vào để máy di chuyển dễ dàng đặt nhiều nơi khác Việc thiết kế vỏ máy cho chứa hết tất linh kiện đặt bên vỏ lại với để máy hoạt động Chạy thử nghiệm Việc chạy thử nghiệm đánh giá cơng trình máy thu tiền hoạt động có đáp ứng nhu cầu người người dùng khơng,có bị lỗi hay khơng, có hoạt động theo trình tự đưa hay khơng, có đảm bảo tính an tồn hay khơng Xong việc chạy thử nghiệm giúp ta đưa hạn chế cơng trình máy thu tiền tự động từ chỉnh sửa lại, hoàn thiện máy KẾT QUẢ - THẢO LUẬN 4.1 Giới thiệu phần cứng Phần cứng thiết bị bên bên ngồi cơng trình máy thu tiền mà cầm được, nhìn thấy Phần cứng phận tạo thành cơng trình - Phần bên ngồi: Vỏ máy, hình - Phần bên trong: Raspberry pi 3, module rơle, Cảm biến tiệm cận hồng ngoại, khóa điện, nguồn xung, mạch giảm áp, NV 200 4.1.1 Máy tính nhúng Raspberry Pi Hình 1: Raspberry pi Hình 2: Sơ Đồ Chân Của Raspberry pi ● Khái miện Với Raspberry Pi, bạn cần cài hệ điều hành, gắn chuột, bàn phím hình sử dụng máy vi tính Raspberry Pi khơng hồn tồn thay máy tính để bàn laptop thiết bị đa sử dụng cho hệ thống điện tử, thiết lập hệ thống tính tốn, dự án DIY… với chi phí rẻ Mặc dù chậm so với dịng laptop, máy tính đại Raspberry Pi xem máy tính Linux hồn chỉnh cung cấp tất khả mà người dùng mong đợi, với mức tiêu thụ lượng thấp Hệ điều hành Raspberry Pi có nhiều OS linux chạy điểm danh số Distributions Linux (nhúng) chạy Raspberry Pi Raspbian, Pidora, openSUSE, OpenWRT, OpenELEC,… ● Thông số kỹ thuật: (Xem phần I mục phụ lục) 22 Dưới số sơ đồ khối thể bước thực toán: Hình 18: Kịch máy thu tiền 23 Hình 19:Quy trình phụ kịch (xử lý thơng tin hóa đơn) Hình 20: Quy trình phụ kịch (Xử lý số tiền đưa vào máy) 24 4.2.6 Hình ảnh giao diện phần mềm máy thu tiền Hình 21: Trang lựa chọn dịch vụ toán Hình 22: Trang chờ khách hàng đưa tiền vào máy 25 Hình 23: Trang thông báo số tiền cho khách hàng Hình 24: Trang thông báo giao dịch thành công 4.3 Hệ thống sever 4.3.1 WEB API API phương thức, giao thức kết nối với thư viện ứng dụng khác Nó viết tắt Application Programming Interface – giao diện lập trình ứng dụng API cung cấp khả cung cấp khả truy xuất đến tập hàm hay dùng Và từ trao đổi liệu ứng dụng 26 Web API: phương thức dùng phép ứng dụng khác giao tiếp, trao đổi liệu qua lại Dữ liệu Web API trả lại thưởng dạng JSON XML thông qua giao thức HTTP HTTPS 4.3.2 Những đặt điểm bật Web API hỗ trợ restful đầy đủ phương thức: Get/Post/Put/Delete liệu Nó giúp bạn xây dựng HTTP service cách đơn giản nhanh chóng Nó có khả hỗ trợ đầy đủ thành phần HTTP: URI, request/response headers, caching, versioning, content format Với web API, tự động hóa quản lý cơng việc, cập nhật luồng công việc, giúp tăng suất tạo hiệu công việc cao API cho phép lấy nội dung từ website ứng dụng cách dễ dàng cho phép, tăng trải nghiệm người dùng API hoạt động cổng, cho phép công ty chia sẻ thông tin chọn tránh yêu cầu không mong muốn API có chức thay đổi cập nhật thay đổi theo thời gian thực Với công nghệ này, liệu truyền tốt hơn, thông tin xác hơn, dịch vụ cung cấp linh hoạt 4.3.3 Web API hoạt động Đầu tiên xây dựng URL API để bên thứ ba gửi request liệu đến máy chủ cung cấp nội dung, dịch vụ thông qua giao thức HTTP HTTPS Tại web server cung cấp nội dung, ứng dụng nguồn thực kiểm tra xác thực có tìm đến tài ngun thích hợp để tạo nội dung trả kết Server trả kết theo định dạng JSON XML thông qua giao thức HTTP/HTTPS Tại nơi yêu cầu ban đầu ứng dụng web ứng dụng di động , liệu JSON/XML parse để lấy data Sau có data thực tiếp hoạt động lưu liệu xuống Cơ sở liệu, hiển thị liệu… 27 API máy thu tiền tự động: ● API lấy thông tin nợ Request body (json): (Xem phần III mục phụ lục) Response body (json): (Xem phần III mục phụ lục) ● API truy vấn tiền điện HCM Request body (json): (Xem phần III mục phụ lục) Response body (json): (Xem phần III mục phụ lục) ● API cập nhật toán Request body (json): (Xem phần III mục phụ lục) Response body (json): (Xem phần III mục phụ lục) 28 KẾT LUẬN - ĐỀ NGHỊ Kết thúc lại Máy thu tiền tự động thiết kế đơn giản tích hợp chức thu tiền dịch vụ, người dùng toán với vài thao tác đơn giản máy mà không cần đến nhân viên, đặt nơi hạn chế việc tiếp xúc nhiều người đảm bảo an tồn cho tình hình dịch bệnh tại.Thêm vào việc tạo máy tự động ứng dụng thực tế điều góp phần phát triển công ty kinh tế thị trường đại với nhiều cạnh tranh Tuy nhiên máy cịn hạn chế hình thức tốn dịch vụ với vài dịch vụ tốn mà việc thêm hình thức tốn dịch vụ phải cần đồng ý hợp tác loại hình dịch vụ Vì Máy tốn tiền tự động cốt lõi cho y tưởng, phát triển sáng kiến máy tự động thu tiền sau mà mang lại nhiều tiện ích đa đa dạng loại hình thức tốn 29 TÀI LIỆU THAM KHẢO Rob Zwetsloot 2021 The Official Raspberry Pi Handbook 2021 East Poultry Ave, London, Publishing Director: Russell Barnes russell@raspberrypi.com TS Phạm Thanh Huyền vs TS Đỗ Việt 2020 Sách linh kiện điện tử,nhà xuất Giao Thông Vận Tải Hà Nội Phil King 2020 Raspberry Pi Beginner's Guide 4th Edition John's Innovation Park, Cowley Road, Cambridge, CB4 0DS Originally published by Raspberry Pi Trading Ltd, Maurice Wilkes Building Innovative Technology 2011 Smart Payout Manual, Derker Street – Oldham – England - OL1 4EQ (https://innovative-technology.com) Python 3.9.5 Documentation 2021, Python Software Foundation (https://docs.python.org/3/tutorial/index.html) Document Web Technology,Portions of this content are ©1998–2021 by individual, Mozilla Spaces are our offices around the world,mozilla.org contributors (https://developer.mozilla.org/en-US/docs/Web) Svelte Framework, Svelte is free and open source software, made possible by the work of dozens of volunteers (https://svelte.dev/tutorial/basics) 8.Electron Documentation ,OpenJS Foundation, Revised November 21, 2019 San Francisco, California.Copyright OpenJS Foundation and Electron Contributors (https://www.electronjs.org/docs) 30 PHỤ LỤC I Thông số kỹ thuật linh kiện Máy tính nhúng Raspberry pi jack cắm 3.5mm cổng USB 40 chân pin GPIO Micro SD Micro USB 5V HDMI port CSI Camera connector Broadcom BCM 2835 vs GB Ram Màn hình cảm ứng 1024x600 inch Model: Waveshare inch Capacitive Touch Screen LCD (B), 1024x600, HDMI, Low Power Độ phân giải: 1024 x 600 pixels Cổng kết nối: HDMI, Touch Điện áp sử dụng: 5VDC từ cổng Micro USB Hỗ trợ cảm ứng điện dung cấp nguồn 5VDC qua cổng Micro USB Thiết kế Low Power tiết kiệm lượng inch HDMI LCD (B) x1 HDMI cable x1 HDMI to Micro HDMI Adapter x1 USB type A plug to micro B plug cable x1 RPi screws pack (4pcs) x1 Quick start sheet x1 Nguồn xung Điện áp đầu vào: 110V/220V – 50/60Hz Điện áp đầu ra: 12V – 3A Công suất: 36W Tuân thủ an toàn: CCC/FCC/CE 31 Nhiệt độ làm việc:0oC ~ 60 ℃ Chế độ quạt làm mát, giải nhiệt Kích thước (L * W * H) mm : 84 * 59 * 35 Trọng lượng (gam) : 120 Khóa điện Điện áp hoạt động :2V/24VDC Dịng kéo: 12V/60mA Lỗ an minh: Bị khóa tắt nguồn Chiều dài chốt mở rộng: 9.8mm Kích thước khóa: 53x39x25mm Mạch giảm áp Điện áp đầu vào: Từ 3V đến 30V Điện áp đầu ra: Điều chỉnh khoảng 1.5V đến 30V Dòng đáp ứng tối đa 3A Hiệu suất : 92% Công suất : 15W Kích thước: 45 (dài) * 20 (rộng) * 14 (cao) mm Cảm biến tiệm cận Sử dụng led phát hồng ngoại led thu hồng ngoại IC LM358 SMD Led nguồn báo sáng Biến trở điều chỉnh độ chỉnh VR vuông 10K Chân AO – DO- GND – VCC Điện áp hoạt động : 3.3 đến 5VDC VCC= 3-5VDC GND = 0V D0 = tín hiệu 1, NV 200 Nguồn: 12V Chế độ chờ: 400mA 32 Chạy: 3A Đạt đỉnh:5A Trọng lượng: 5.5kg Giao thức: SSP,ccTalk Công suất: 70 mixed Chiều rộng: 60-85mm Chiều dài: 115-170mm Chất liệu: Nhựa Kim loại MTBF : 100.000 Giao diện: USB với IF17 II Báo cáo linh kiện STT Tên Thiết Bị Raspberry Pi Model B+ Màn hình cảm ứng LCD inch Link https://shopee.vn/M%C3%A1y-t%C3%ADnhRaspberry-Pi-3-Model-B-NEW-2020i.60399497.1595148526 https://hshop.vn/products/man-honh-lcd-7-inchhdmi-camung-dien-dung NV200+ SMART Payout https://www.innovativetechnology.com/products/products-main/91smart-payout Thẻ nhớ 16GB https://www.thegioiic.com/products/the-nhomicro-sdhc-sandisk-16gb-class10-ultra Bộ dây đầu đọc tiền (USB with IF17) https://innovativetechnology.com/shop/accessories/if17-interfaceconverter-detail LY-03 Khóa điện 12V https://www.thegioiic.com/products/ly-03-khoadien-12v Cảm biến hồng ngoại https://www.thegioiic.com/products/cam-bienvat-can-hong-ngoai-khoang-cach-1-7cm-ngo-rattl Dây LAN nối dài https://shopee.vn/D%C3%A2y-c%C3%A1pn%E1%BB%91i-d%C3%A0i-Lan-1-5mi.105579192.1817200106 33 10 11 12 Nguồn xung tổ ong 12V/5A https://www.thegioiic.com/products/nguon-xungvao-220vac-ra-12v-5a-60w Quạt tản nhiệt https://linhkienfpt.vn/quat-tan-nhiet-12v-6x6cmloai-khoe-mong Mạch giảm áp XL4005 https://www.thegioiic.com/products/xl4005mach-giam-ap-5a https://www.thegioiic.com/products/module-2relay-5v-kich-muc-thap-v2 Module Relay Bảng 2: Báo cáo giá trị link mua linh kiện III API máy thu tiền API lấy thông tin nợ Request body (json): # Name Type Require d Description strAuthen Strin g ✔️ Chuỗi lấy từ Certificatekey hàm login strProviderName Strin g ✔️ DIENEVN strAgreementNo Strin g ✔️ mã khách hàng Bảng 3: Request body API lấy thông tin nợ Response body (json): # Name Type Required IsError bool ✔️ Status string ✔️ Message string ✔️ ResponseTime string.format("dd/MM/yyyy hh:mm:ss") ✔️ Data ?object ✔️ Data.AgreementNo string ✔️ Descriptio n 34 Data.CustomerName string ✔️ Data.CustomerAddress string ✔️ Data.CustomerPhone ?string ✔️ 10 Data.ChargeCycle ?string ✔️ 11 Data.Debt double ✔️ 12 Data.TotalPunishMoney double ✔️ 13 Data.IsLockPaidMoney bool ✔️ 14 Data.AirtimeTransactionTypeID int ✔️ Bảng 4: Response body API lấy thông tin nợ API truy vấn tiền điện HCM Request body (json): # Name Type Required Description strAuthen String ✔️ Chuỗi lấy từ Certificatekey hàm login strProviderName String ✔️ DIENEVN strAgreementNo String ✔️ mã khách hàng Bảng 5: Request body API truy vấn tiền điện HCM Response body (json): # Name Type Required Description IsError bool ✔️ Status string ✔️ Message string ✔️ ResponseTime string.format("dd/MM/yyyy hh:mm:ss") ✔️ Data ?object Data.AgreementNo string ✔️ Data.CustomerName string ✔️ 35 Data.CustomerAddress string ✔️ Data.CustomerPhone ?string ✔️ 10 Data.ChargeCycle ?string ✔️ 11 Data.Debt double ✔️ 12 Data.BilInfo string ✔️ 13 Data.PaymentRule int ✔️ 14 Data.TotalPunishMoney double ✔️ 15 Data.IsLockPaidMoney bool ✔️ 16 Data.AirtimeTransactionTypeID int ✔️ Bảng 6: Response body API truy vấn tiền điện HCM API cập nhật toán Request body (json): # Name Type Requires Description strAuthen string ✔️ Chuỗi lấy từ Certificatekey hàm login strProviderName string ✔️ DIENEVN strAgreementNo string ✔️ mã khách hàng decAmount doubl e ✔️ số tiền cần toán (được lấy từ Debt liệu trả hàm truy vấn) decTotalPunishM oney doubl e ✔️ tiền phạt (được lấy từ TotalPunishMoney liệu trả hàm truy vấn) strBills string ✔️ thơng tin bill cần phải tốn (được lấy từ BillInfo liệu trả hàm truy vấn) strCustomerNam e string ✔️ lấy từ CustomerName liệu trả hàm truy vấn strCustomerAddr ess string ✔️ lấy từ CustomerAddress liệu trả hàm truy vấn strCustomerPhon e string ✔️ lấy từ CustomerPhone liệu trả hàm truy vấn 36 10 strChargeCycle string ✔️ lấy từ ChargeCycle liệu trả hàm truy vấn 11 strCollectionID string ✔️ lấy từ CollectionID liệu trả hàm truy vấn 12 intAirtimeTransa ctionTypeID int ✔️ lấy từ AirtimeTransactionTypeID liệu trả hàm truy vấn Bảng 7: Request body API cập nhật toán Response body (json): # Name Type Required isError bool ✔️ Status string ✔️ Data ?object ✔️ Message string ✔️ ResponseTime string.format("dd/MM/yyyy hh:mm:ss") ✔️ Description Bảng 8: Response body API cập nhật toán