Trợ giúp › Danh mục tích hợp

Danh mục tích hợp: HNR kết nối với những gì?

Trang này tập hợp ở một nơi cách HNR kết nối với ngân hàng, hãng vận chuyển, sàn thương mại điện tử, cơ quan thuế, tệp kế toán và các chương trình khác. Nhãn trước mỗi dòng cho biết thực tế hôm nay: cái gì tự chạy được, cái gì mở bằng tài khoản của bạn hoặc bằng hợp đồng, và cái gì chưa có. Nếu một kết nối chưa được thử với tài khoản thật, điều đó được ghi rõ.

1. Ý nghĩa các nhãn

• Đang dùng đượcHoạt động ngay hôm nay. Không cần tài khoản hay hợp đồng bên ngoài; nếu cần gì thì đó là máy chủ, tệp hoặc khóa của chính bạn.
• Sẵn sàng, cần thử bằng tài khoản của bạnMã kết nối được viết đầy đủ theo tài liệu chính thức của bên kia và đã qua các bài kiểm thử của HNR, nhưng chưa được thử với tài khoản thật. Hãy tạo kết nối đầu tiên trên môi trường thử nghiệm của bên kia và kiểm tra.
• Cần hợp đồngBên kia chỉ cung cấp tài liệu kỹ thuật khi có hợp đồng. Chỗ cho kết nối đã sẵn trong HNR; kết nối được hoàn tất khi có tài liệu và thông tin xác thực.
• Sắp cóĐang trong hàng đợi phát triển; hôm nay chưa có.
• Chưa cóHôm nay chưa có và cũng không nằm trong hàng đợi. Thường thì đường tệp (CSV, XLSX, XML) làm được việc tương tự.

2. Ngân hàng

• Đang dùng đượcNhập sao kê ngân hàng — Đọc được tệp MT940, CSV/Excel và DBS; có sẵn hồ sơ cột cho ngân hàng Thổ Nhĩ Kỳ và Indonesia, ngân hàng của bạn chỉ cần ánh xạ một lần. Giao dịch được đối chiếu với hóa đơn theo điểm và phiếu thu được ghi khi bạn duyệt.
• Đang dùng đượcDịch vụ ngân hàng (email và PDF) — Email thông báo giao dịch do ngân hàng gửi và sao kê PDF được dịch vụ ngân hàng chạy riêng đọc; đối soát POS cũng được theo dõi tại đây.
• Sẵn sàng, cần thử bằng tài khoản của bạnKết nối ngân hàng trực tiếp: ngân hàng mở — Ở Thổ Nhĩ Kỳ là chuẩn ÖHVPS (dịch vụ thông tin tài khoản BKM), ở Indonesia là chuẩn SNAP của Bank Indonesia (BCA, Mandiri, BNI, BRI và SNAP chung). Giao dịch được lấy về mà không cần tải sao kê; cần hợp đồng nhà cung cấp được cấp phép và khóa do ngân hàng cấp.
• Cần hợp đồngDịch vụ web doanh nghiệp của các ngân hàng Thổ Nhĩ Kỳ — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank và Kuveyt Türk có trong danh mục. Tài liệu dịch vụ đi kèm hợp đồng tích hợp ERP ký với chi nhánh; ngay hôm đó được đưa vào trình điều khiển.
• Đang dùng đượcTệp chi trả lương — Từ bảng lương, tệp văn bản cột cố định mà ngân hàng yêu cầu được tạo bằng mẫu. Ngân hàng không công bố định dạng này nên bạn xác nhận mẫu một lần với ngân hàng của mình.
• Sắp cóTệp lệnh chi hàng loạt cho nhà cung cấp — Lệnh chi hàng loạt gửi ngân hàng trong một tệp duy nhất, lập từ kế hoạch thanh toán.

3. Vận chuyển và hậu cần

• Đang dùng đượcLiên kết theo dõi và nhãn vận chuyển — Bạn nhập địa chỉ theo dõi của hãng vận chuyển một lần với ký hiệu giữ chỗ {takip}; mã vận đơn trên lô hàng trở thành liên kết bấm được. Nhãn vận chuyển, phiếu đóng gói, nhãn thùng và phiếu xuất kho được in thành một bộ tài liệu PDF.
• Cần hợp đồngAPI của hãng vận chuyển — Hôm nay chưa thể tạo vận đơn trong hệ thống của hãng vận chuyển hay tự động tra cứu trạng thái; trạng thái vận chuyển được nhập tay trên lô hàng. Khi bạn có thỏa thuận API với hãng vận chuyển, chỗ cho trình điều khiển đã sẵn.
• Sắp cóBiểu cước vận chuyển và nhãn pallet — Phân bổ chi phí giao hàng cho đơn hàng và khách hàng theo biểu cước vùng × kg/trọng lượng quy đổi, và nhãn pallet SSCC/GS1-128.

4. Sàn thương mại điện tử

• Sẵn sàng, cần thử bằng tài khoản của bạnTrendyol, Hepsiburada, Tokopedia, Shopee — Lấy đơn hàng, ánh xạ sản phẩm, đẩy tồn kho và giá, đóng gói và giao hàng, trả hàng và đối soát. Được viết theo tài liệu API chính thức của các sàn, chưa thử với tài khoản cửa hàng thật; hãy tạo kết nối đầu tiên trên môi trường thử nghiệm của sàn.
• Đang dùng đượcSàn mô phỏng — Diễn tập toàn bộ quy trình với thẻ kho của chính bạn và đơn hàng mẫu mà không chạm vào cửa hàng thật.
• Chưa cóCác sàn khác — Chưa có trình điều khiển cho Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop và các sàn tương tự; đơn hàng từ các sàn này hiện được nhập tay.

5. Chứng từ điện tử và tệp chính thức

• Đang dùng đượcXML hóa đơn điện tử (UBL-TR 1.2) — XML theo hồ sơ hóa đơn cơ bản và thương mại được tạo từ hóa đơn bán hàng và hóa đơn trả hàng, có thể tải về; kiểm tra được mà không cần tài khoản nhà tích hợp.
• Cần hợp đồngGửi chứng từ điện tử trực tiếp — Tại Thổ Nhĩ Kỳ, e-Fatura được gửi qua nhà tích hợp tư nhân: trình điều khiển Uyumsoft và İzibiz đã được viết, địa chỉ điểm cuối được xác minh khi mở tài khoản nhà tích hợp, con dấu tài chính do nhà tích hợp đóng; việc gửi e-Arşiv và e-İrsaliye cũng được bổ sung theo cùng hợp đồng. Tại Indonesia, HNR không phải là PJAP; bạn tự tải tệp lên Coretax.
• Đang dùng đượcTệp Coretax và e-Bupot (Indonesia) — Tạo được XML hàng loạt e-Faktur, XML trả hàng (retur), e-Bupot Unifikasi, PPh 21 (BPMP) và 1721-A1; mỗi tệp được kiểm tra theo XSD của DJP, hoặc khi chưa có XSD công bố thì theo lược đồ suy ra từ mẫu của DJP, tệp không hợp lệ sẽ không được xuất. Bạn là người tải lên cổng thông tin.
• Đang dùng đượcTệp tờ khai chính thức — Tại Thổ Nhĩ Kỳ là phần SGK của tờ khai khấu trừ và bảo hiểm gộp (XML); tại Indonesia là dữ liệu xuất BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP và IT Inventory. Lịch nghĩa vụ nhắc các hạn chót.
• Đang dùng đượcĐọc hóa đơn đầu vào — XML e-Fatura hoặc e-Faktur, PDF hay ảnh chụp của nhà cung cấp được chuyển thành bản nháp hóa đơn mua hàng; bạn kiểm tra rồi duyệt.

6. Kế toán và chuyển dữ liệu

• Đang dùng đượcXuất CSV và Excel — Mọi danh sách đều xuất được CSV; báo cáo công ty, bút toán, bảng cân đối thử và báo cáo tài chính còn tải được dạng Excel (XLSX).
• Đang dùng đượcKhông cần phần mềm kế toán riêng — Hóa đơn, thu tiền, séc và xác nhận sản xuất tự động ghi vào sổ nhật ký (Hệ thống tài khoản thống nhất của Thổ Nhĩ Kỳ, SAK EP của Indonesia); bảng cân đối thử, bảng cân đối kế toán và báo cáo kết quả kinh doanh lấy ngay từ HNR.
• Đang dùng đượcCầu nối Logo (chỉ đọc) — Sao kê Logo Wings hiện song song trên thẻ đối tác, và báo cáo tồn kho HNR↔Logo so sánh hai hệ thống. Cần máy chủ Logo MCP; HNR không ghi vào Logo.
• Đang dùng đượcChuyển từ cơ sở dữ liệu HNR cũ — Bằng Nhập cơ sở dữ liệu trong trình hướng dẫn cài đặt ban đầu, thẻ, chứng từ, dữ liệu sản xuất và tệp đính kèm của công ty HNR (Firebird) cũ được chuyển sang kèm báo cáo đối chiếu.
• Đang dùng đượcNhập từ tệp — Bảng giá và ánh xạ sản phẩm sàn (CSV/XLSX), báo cáo đo CMM (Q-DAS ASCII) và đơn hàng EDI của khách (CSV/JSON → đơn hàng nháp). Chưa có thông điệp EDIFACT/VDA và truyền tải OFTP2.
• Sắp cóTrình hướng dẫn nhập từ phần mềm khác — Đối tác, tồn kho, số dư mở và bảng giá từ Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir và Excel, theo định dạng xuất chính thức của từng phần mềm.
• Chưa cóTệp bút toán cho phần mềm kế toán bên ngoài và e-Defter — Chưa có tệp sẵn để chuyển sổ nhật ký sang Logo, Mikro, Luca hoặc Accurate, cũng chưa có nộp sổ điện tử e-Defter cho GİB. Bút toán có thể xuất dạng XLSX.

7. Liên lạc và dịch vụ bên ngoài

• Đang dùng đượcWhatsApp — Dịch vụ tin nhắn liên kết số điện thoại của bạn bằng mã QR (qua WhatsApp Web; không phải WhatsApp Business API chính thức). Gửi được PDF báo giá, đơn hàng, hóa đơn và các mẫu tin nhắn CRM.
• Đang dùng đượcEmail — Báo giá, đơn hàng và hóa đơn được gửi cho khách hàng qua máy chủ SMTP của chính bạn.
• Đang dùng đượcTỷ giá hối đoái — Ở Thổ Nhĩ Kỳ, tỷ giá của Ngân hàng Trung ương (TCMB) được đọc tự động. Ở Indonesia, tỷ giá Bank Indonesia (JISDOR) được nhập tay vào bảng tỷ giá; chưa có đọc tự động.
• Đang dùng đượcTrợ lý HNR (AI) — Trợ lý chỉ đọc chạy trên API Anthropic Claude; khóa API và phí sử dụng do bạn chịu.

8. API mở, cổng thông tin và cơ sở dữ liệu

• Đang dùng đượcHTTP API (REST/JSON) — Mọi điểm cuối mà giao diện dùng (hơn 2.150 theo số đếm ngày 2/10/2026) cũng mở cho chương trình khác. Mỗi yêu cầu mang khóa API của bản cài đặt (Authorization: Bearer) và mã phiên của một người dùng (/api/auth/login → X-Oturum-Token); thao tác chạy với quyền và công ty của người dùng đó. Yêu cầu ghi có thể lặp lại an toàn bằng Idempotency-Key.
• Chưa cóTài liệu API công khai và thông báo sự kiện (webhook) — Chưa có tài liệu OpenAPI/Swagger và chưa có thông báo gửi ra ngoài khi dữ liệu thay đổi. Danh sách điểm cuối được lấy từ đội cài đặt; để theo dõi thay đổi, hãy truy vấn định kỳ bộ đếm cập nhật.
• Đang dùng đượcCổng thông tin — Cổng khách hàng, cổng báo giá nhà cung cấp, cổng gia công ngoài, đặt hàng B2B, ứng dụng bán hàng hiện trường và cổng nhân viên; mỗi cổng có đăng nhập riêng và giới hạn quyền riêng.
• Đang dùng đượcHệ quản trị cơ sở dữ liệu — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server và Oracle; trên đám mây có PostgreSQL (Neon) và CockroachDB Cloud. Hệ quản trị được chọn khi tạo công ty.