1. Trang chủ
3. Tin tức
5. Dùng Postman gọi API webservice hóa đơn Viettel SInvoice

Dùng Postman gọi API webservice hóa đơn Viettel SInvoice

Mục lục

1. Postman gọi API webservice hóa đơn Viettel SInvoice là gì?

- Để nâng cao hiệu quả hoạt động và trải nghiệm cho khách hàng, việc kết nối hóa đơn S-Invoice Viettel cho các hệ thống API tích hợp phần mềm kế toán, hệ thống quản trị lớn phải cần đồng bộ dữ liệu tránh sai sót, S-Invoice đã hỗ trợ xuyên suốt và thuận lợi cho các doanh nghiệp lớn thông qua đẩy dữ liệu API test demo trên Postman

- API (Application Programming Interface - Giao diện lập trình ứng dụng) là tập hợp các quy tắc và định dạng cho phép các ứng dụng phần mềm không chung hệ thống giao tiếp, tương tác và trao đổi dữ liệu với nhau.

- Để giao tiếp với hệ thống Viettel thì bên Phần mềm kế toán, hệ thống quản trị phải kết xuất dữ liệu theo đúng chuẩn của Viettel sẽ nhận dữ liệu show lên thành 1 HD đồng thời sẽ gửi HD này sang Thuế quy định, để kiểm tra dữ liệu đẩy sang Viettel có hợp lệ hay không thì chúng ta phải dùng Postman

2. Hướng dẫn cài đặt và dùng Postman gọi API webservice

Bước 1: Truy cập getpostman.com/apps, chọn Download

Bước 2: Sau khi cài đặt giao diện sẽ show ra như ảnh dưới click chọn Continue without an account

Bước 3: Chọn HTTP vì đẩy dữ liệu API sang web hóa đơn Viettel

Bước 4: Chọn loại trang thái đẩy API là POST (4.1), sau đó bấm vào Authorization (4.2), chọn loại xác nhận là Basic Auth (4.3) và nhập tài khoản (4.4)

Bước 5: Qua tab Headers thêm trường Content-Type và Accept giá trị của 2 trường này là application/json

Bước 6: Điền link để test API
https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/createInvoice/{Mã số thuế}
=> Link trên là phát hành hóa đơn
https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/createOrUpdateInvoiceDraft/{Mã số thuế}
=> Link trên là lập nháp hóa đơn
https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/createExchangeInvoiceFile
=> Link trên là phát hành HD chuyển đổi
https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/searchInvoiceByTransactionUuid
=> Link trên là respone về thông tin HD đã phát (khi phát hành HD có truyền vào transactionUuid thì mới respone)
https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceUtilsWS/getInvoices/{Mã số thuế}
=> Link trên là respone danh sách thông tin HD đã phát hành

Bước 7: Chọn tab Body chọn Raw và truyền chuỗi json dữ liệu HD vào sau đó bấm Send

Sau khi đẩy API phát hành HD hệ thống trả về thông báo Status: 200 OK là đã thành công
{
  "errorCode": null,
  "description": null,
  "result": {
     "supplierTaxCode": "0100109106-505",
     "invoiceNo": "K25TIH8",
     "transactionID": "176550406868631980",
     "reservationCode": "8MOMLFNPJ6PNHPN",
     "codeOfTax": null
   }
}
Đăng nhập vào kiểm tra HD đã thành công

Với các bước test trên Postman đơn giản và thuận tiện, trong quá trình test API doanh nghiệp có khó khăn vướng mắc có thể liên hệ trực tiếp S-Invoice bên dưới để hỗ trợ nhanh chóng và kịp thời
Hotline: 0387.825.725

Bài Viết Nổi Bật