Địa chỉ giao hàng sau sáp nhập: đổi địa chỉ cũ, lấy tọa độ, chọn kho gần nhất

Trả lời nhanh: từ 01/07/2025, địa chỉ Việt Nam bỏ cấp quận, huyện và nhiều phường, xã đổi tên. Sổ địa chỉ khách hàng, đơn cũ và nhãn giao hàng của bạn vẫn ghi kiểu cũ. map.vapp.vn giúp ba việc: đổi địa chỉ cũ sang địa chỉ mới (miễn phí), lấy tọa độ cho từng địa chỉ để giao hàng (tính lượt theo gói), và chọn cửa hàng hoặc kho gần khách nhất. Bạn tự chạy trên dữ liệu của mình bằng API: chúng tôi không nhận tệp khách hàng của bạn.

Tạo khóa miễn phí (gói Developer, 20.000 lượt mỗi tháng) và chạy hai lệnh đầu tiên ngay trên trang nhà phát triển.

Dành cho: shop bán hàng online, sàn và website thương mại điện tử, đơn vị giao vận, phần mềm bán hàng và CRM có lưu địa chỉ khách.

Bài toán sau sáp nhập

Bảng của chúng tôi lấy từ toàn văn 34 nghị quyết của Ủy ban Thường vụ Quốc hội: 3.321 đơn vị cấp xã mới, hình thành từ 10.570 đơn vị cũ được nghị quyết nêu tên. 414 đơn vị mới chỉ nhận một phần của một đơn vị cũ bị chia: với những địa chỉ đó, tên phường cũ không đủ để biết phường mới, cần số nhà và tên đường. Một phần mềm đổi tên tự động mà không báo các trường hợp này sẽ đổi sai mà không ai biết.

Ba bước

1. Đổi địa chỉ cũ sang địa chỉ mới — miễn phí

POST /api/v1/address/convert nhận tối đa 1.000 địa chỉ mỗi lần, không cần khóa, không tính lượt, và nội dung địa chỉ không được ghi vào nhật ký truy vấn. Mỗi dòng trả status: ok kèm địa chỉ mới (giữ số nhà, tên đường), split khi đơn vị cũ bị chia (trả mọi đơn vị mới có thể), ambiguous khi trùng tên (cần thêm quận, huyện cũ). Không bao giờ đoán. Dán danh sách hoặc tải tệp CSV lên công cụ đổi hàng loạt (tối đa 10.000 dòng mỗi lần, chạy trên trình duyệt), hoặc tra từng tỉnh ở Tra địa chỉ mới.

2. Lấy tọa độ để giao hàng — một lượt mỗi địa chỉ

GET /api/v1/geocode?q=… với khóa API trả lat, lng, tỉnh (province), phường hoặc xã mới chứa tọa độ (trường district) và mức tin cậy confidence. Nhận cả địa chỉ cũ lẫn mới: không cần đổi trước khi geocode. Hãy so province của kết quả với tỉnh trên đơn và đưa kết quả tin cậy thấp sang kiểm tra tay. Cách đọc từng trường: hướng dẫn geocode địa chỉ Việt Nam.

3. Chọn điểm giao gần nhất — tuỳ chọn, một lượt mỗi đơn

Một lần gọi /api/v1/matrix trả thời gian đi từ các cửa hàng hoặc kho tới khách, tính một lượt cho cả lần gọi. /api/v1/isochrone vẽ vùng giao được trong 10, 20, 30 phút để định vùng phí ship: hướng dẫn vùng phục vụ.

Ví dụ

Một tháng có 30 ngày; danh sách cũ chạy đều trong tháng đầu. Gói được chọn khi cả hạn mức tháng và hạn mức ngày đều đủ.

Gói tính theo tháng, không tự động tính thêm tiền khi hết hạn mức (API trả mã 429). Sau tháng đầu, bạn có thể chuyển về gói nhỏ hơn. Hạn mức từng gói và cách nâng cấp: Bảng giá.

Dữ liệu khách hàng của bạn

• Chỉ gửi địa chỉ. Đừng gửi tên người nhận hay số điện thoại: API không cần chúng.
• Lệnh đổi địa chỉ (bước 1) không được ghi nhật ký. Lệnh geocode, ma trận (bước 2, 3) được ghi vào nhật ký truy vấn để cải thiện kết quả và tự xoá sau 30 ngày (Chính sách bảo mật, mục 3).
• Không muốn dữ liệu rời hạ tầng của bạn: gói Dedicated chạy trên máy chủ riêng hoặc tại hạ tầng của bạn.

Bắt đầu

1. Đổi thử danh sách của bạn bằng công cụ đổi hàng loạt: không cần đăng ký.
2. Tạo khóa miễn phí trên trang nhà phát triển (gói Developer, 20.000 lượt mỗi tháng) và geocode thử vài trăm địa chỉ.
3. Khi cần gói trả phí: gửi yêu cầu báo giá ở trên, hoặc viết tới support@erpfit.com. ERPFit gửi báo giá, hai bên ký hợp đồng, bạn chuyển khoản theo hoá đơn. Không có giỏ hàng hay thanh toán trực tuyến.

Mục đích dùng thông tin: ERPFit chỉ dùng thông tin trong email của bạn để báo giá và liên hệ về báo giá đó, không dùng để gửi quảng cáo và không chia sẻ cho bên thứ ba. Khi gửi email, bạn đồng ý cho ERPFit xử lý thông tin đó cho mục đích trên. Bạn có thể yêu cầu xoá bất kỳ lúc nào qua cùng địa chỉ.