Base Endpoint
http://www.parkway.com.vn:9118
Authentication
Ngoại trừ API Login. Tất cả các request đến API đều yêu cầu token trong header (bao gồm tất cả các methods: GET, POST, PUT...)
Authorization: Token <access_key>
Content-Type: application/json
Login
HTTP Request
POST http://www.parkway.com.vn:9118/api/Authenticate/Signin
DataType: json
Data:
| UserName |
(string) |
Tên đăng nhập |
| Password |
(string) |
Mật khẩu |
Mô tả kết quả
| Customer |
(object) |
Thông tin khách hàng |
| Token |
(string) |
Mã xác thực cho những request sau |
Thông tin Hóa đơn
Danh sách hóa đơn
GET http://www.parkway.com.vn:9118/odata/Invoices
DataType: json
| Biến params |
Required |
Mô tả |
| status |
Không Bắt buộc |
Trạng thái hóa đơn là một chuỗi nhị phân gồm 6 ký tự tương ứng các trạng thái hóa đơn theo thứ tự:
Mới|Đã ký|Đã điều chỉnh|Đã chuyển đổi|Đã xóa|Đã thay thế
Với: 1 - Lấy ; 0 - Không lấy
Ví dụ: hiển thị hóa đơn mới và đã xóa: status = "1000010"
|
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền trước thuế |
| Tax |
(int) |
Mức thuế suất |
| MoneyTax |
(decimal) |
Tiền thuế |
| TotalMoney |
(decimal) |
Tổng tiền sau thuế |
| IsAdjusted |
(int) |
Hóa đơn đã xử lý:
1 - Hóa đơn điều chỉnh.
2 - Hóa đơn bị điều chỉnh.
|
| IvoiceAdjustedId |
(long) |
Mã hóa đơn điều chỉnh |
| AdjustedDate |
(long) |
Ngày điều chỉnh |
| Status |
(long) |
Trạng thái hóa đơn |
| CompanyName |
(string) |
Công ty người mua |
| CompanyTaxcode |
(string) |
MST công ty người mua |
| CompanyAdd |
(string) |
Địa chỉ công ty người mua |
| ContractName |
(string) |
Tên người mua |
Chi tiết hóa đơn
GET http://www.parkway.com.vn:9118/odata/Invoices([key])
[key] : Mã hóa đơn
DataType: json
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền trước thuế |
| Tax |
(int) |
Mức thuế suất |
| MoneyTax |
(decimal) |
Tiền thuế |
| TotalMoney |
(decimal) |
Tổng tiền sau thuế |
| IsAdjusted |
(int) |
Hóa đơn đã xử lý:
1 - Hóa đơn điều chỉnh.
2 - Hóa đơn bị điều chỉnh.
|
| IvoiceAdjustedId |
(long) |
Mã hóa đơn điều chỉnh |
| AdjustedDate |
(long) |
Ngày điều chỉnh |
| Status |
(long) |
Trạng thái hóa đơn |
| CompanyName |
(string) |
Công ty người mua |
| CompanyTaxcode |
(string) |
MST công ty người mua |
| CompanyAdd |
(string) |
Địa chỉ công ty người mua |
| ContractName |
(string) |
Tên người mua |
| DetailJson |
(string) |
Danh sách sản phẩm / dịch vụ |
Thêm hóa đơn
Post http://www.parkway.com.vn:9118/odata/Invoices
DataType: json
Data:
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn, mặc định là ngày hiện tại, không được chọn ngày ở tương lai, hóa đơn CHỪA có thể chọn ngày quá khứ |
| NoticeissuedId |
(int) |
Mã thông báo phát hành, không bắt buộc, nếu không truyền mã thông báo phát hành thì:
- NoticeissuedId = 0
- Bắt buộc truyền Mẫu Số và Ký Hiệu (để xác định thông báo phats hành nào) |
| Symbol |
(string) |
Ký hiệu (không bắt buộc nếu có mã thông báo phát hành) |
| TemptCode |
(string) |
Mẫu số (không bắt buộc nếu có mã thông báo phát hành) |
| MoneyCode |
(string) |
Loại tiền (VND,USD,EUR) |
| CompanyName |
(string) |
Công ty người mua |
| CompanyTaxcode |
(string) |
MST công ty người mua |
| CompanyAdd |
(string) |
Địa chỉ công ty người mua |
| ContractName |
(string) |
Tên người mua (không bắt buộc) |
| Email |
(string) |
Email người mua (không bắt buộc) |
| AccBank |
(string) |
Số tài khoản người mua (không bắt buộc) |
| Bank |
(string) |
Ngân hàng người mua (không bắt buộc) |
| PaymentTerm |
(string) |
Hình thức thanh toán: (TM/CK1|TM1|CK1|TD|BTCN) |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền trước thuế |
| Tax |
(int) |
Thuế suất |
| MoneyTax |
(decimal) |
Tiền thuế |
| TotalMoney |
(decimal) |
Tổng tiền sau thuế |
| TextTotalMoney |
(string) |
Số tiền bằng chữ |
| AmountNoTax |
(decimal) |
Tổng tiền trước thuế của sản phẩm không chịu thuế (hđ nhiều loại thuế) |
| AmountNoTax0 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 0% (hđ nhiều loại thuế) |
| AmountNoTax5 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountNoTax10 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| AmountTax5 |
(decimal) |
Tổng tiền thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountTax10 |
(decimal) |
Tổng tiền thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| AmountNo |
(decimal) |
Tổng tiền sau thuế của sản phẩm không chịu thuế(hđ nhiều loại thuế) |
| Amount0 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 0% (hđ nhiều loại thuế) |
| AmountTax5 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountTax10 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| OtherCharges |
(decimal) |
Phí khác |
| Details |
(List) |
Danh sách sản phẩm /dịch vụ |
Sửa hóa đơn
Chỉ sửa được hóa đơn mới tạo (Có status = 2).
PATCH http://www.parkway.com.vn:9118/odata/Invoices([key])
[key] : Mã hóa đơn cần sửa
DataType: json
Data:
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn, mặc định là ngày hiện tại, không được chọn ngày ở tương lai, hóa đơn CHỪA có thể chọn ngày quá khứ |
| Symbol |
(string) |
Ký hiệu |
| TemptCode |
(string) |
Mẫu số |
| MoneyCode |
(string) |
Loại tiền (VND,USD,EUR) |
| CompanyName |
(string) |
Công ty người mua |
| CompanyTaxcode |
(string) |
MST công ty người mua |
| CompanyAdd |
(string) |
Địa chỉ công ty người mua |
| ContractName |
(string) |
Tên người mua (không bắt buộc) |
| Email |
(string) |
Email người mua (không bắt buộc) |
| AccBank |
(string) |
Số tài khoản người mua (không bắt buộc) |
| Bank |
(string) |
Ngân hàng người mua (không bắt buộc) |
| PaymentTerm |
(string) |
Hình thức thanh toán: (TM/CK1|TM1|CK1|TD|BTCN) |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền trước thuế |
| Tax |
(int) |
Thuế suất |
| MoneyTax |
(decimal) |
Tiền thuế |
| TotalMoney |
(decimal) |
Tổng tiền sau thuế |
| TextTotalMoney |
(string) |
Số tiền bằng chữ |
| AmountNoTax |
(decimal) |
Tổng tiền trước thuế của sản phẩm không chịu thuế (hđ nhiều loại thuế) |
| AmountNoTax0 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 0% (hđ nhiều loại thuế) |
| AmountNoTax5 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountNoTax10 |
(decimal) |
Tổng tiền trước thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| AmountTax5 |
(decimal) |
Tổng tiền thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountTax10 |
(decimal) |
Tổng tiền thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| AmountNo |
(decimal) |
Tổng tiền sau thuế của sản phẩm không chịu thuế(hđ nhiều loại thuế) |
| Amount0 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 0% (hđ nhiều loại thuế) |
| AmountTax5 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 5% (hđ nhiều loại thuế) |
| AmountTax10 |
(decimal) |
Tổng tiền sau thuế của sản phẩm chịu thuế 10% (hđ nhiều loại thuế) |
| OtherCharges |
(decimal) |
Phí khác |
| Details |
(List) |
Danh sách sản phẩm /dịch vụ |
Xóa hóa đơn
Delete http://www.parkway.com.vn:9118/odata/Invoices([key])
[key] : Mã hóa đơn cần xóa
Hóa đơn mẫu
Danh sách hóa đơn mẫu
GET http://www.parkway.com.vn:9118/odata/SampleCustomers
DataType: json
Data:
| Id |
(int) |
Mã hóa đơn mẫu |
| CusivoiceTemptId |
(int) |
Mã mẫu cơ bản |
| Taxcode |
(string) |
Mã số thuế |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| Img |
(string) |
Hình logo |
| Img1 |
(string) |
Hình nền |
| Img2 |
(string) |
Hình QR Code |
| Status |
(int) |
1: Mới tạo 2: Đã duyệt |
| InvoiceType |
(int) |
1: Hóa đơn GTGT 2: Hóa đơn bán lẻ 3: Tem phiếu 4: Xuất nhập kho |
Chi tiết hóa đơn mẫu
GET http://www.parkway.com.vn:9118/odata/SampleCustomers([key])
[key] : Mã mẫu hóa đơn
DataType: json
Data:
| Id |
(int) |
Mã hóa đơn mẫu |
| CusivoiceTemptId |
(int) |
Mã mẫu cơ bản |
| Taxcode |
(string) |
Mã số thuế |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| Img |
(string) |
Hình logo |
| Img1 |
(string) |
Hình nền |
| Img2 |
(string) |
Hình QR Code |
| Status |
(int) |
1: Mới tạo 2: Đã duyệt |
| InvoiceType |
(int) |
1: Hóa đơn GTGT 2: Hóa đơn bán lẻ 3: Tem phiếu 4: Xuất nhập kho |
Thông báo phát hành
Danh sách thông báo phát hành
GET http://www.parkway.com.vn:9118/odata/Notices
DataType: json
| Biến params |
Required |
Mô tả |
| status |
Không Bắt buộc |
Trạng thái thông báo phát hành
1: Mới
2: Đã duyệt
3: Hết
|
Data:
| Id |
(int) |
Mã hóa TBPH |
| IvoiceTemptId |
(int) |
Mã mẫu |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| Number |
(int) |
Số lượng hóa đơn |
| FromNumber |
(int) |
Từ số |
| ToNumber |
(int) |
Đến số |
| NoticeissuedDate |
(DateTime) |
Ngàu hiệu lực |
| Status |
(int) |
1: Mới tạo 2: Đã duyệt 5: Đã hết |
| CurrentNumber |
(string) |
Hóa đơn xuất đến số |
Chi tiết TBPH
GET http://www.parkway.com.vn:9118/odata/Notices([key])
[key] : Mã TBPH
DataType: json
Data:
| Id |
(int) |
Mã hóa TBPH |
| IvoiceTemptId |
(int) |
Mã mẫu |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| Number |
(int) |
Số lượng hóa đơn |
| FromNumber |
(int) |
Từ số |
| ToNumber |
(int) |
Đến số |
| NoticeissuedDate |
(DateTime) |
Ngàu hiệu lực |
| Status |
(int) |
1: Mới tạo 2: Đã duyệt 5: Đã hết |
| CurrentNumber |
(string) |
Hóa đơn xuất đến số |
Phiếu xuất kho
Danh sách Phiếu xuất kho
GET http://www.parkway.com.vn:9118/odata/XKKVCBN
DataType: json
| Biến params |
Required |
Mô tả |
| status |
Không Bắt buộc |
Trạng thái phiếu xuất kho
1: Mới
2: Đã phát hành
5: Đã hủy
|
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền |
| Status |
(long) |
Trạng thái |
| ManeuverCommandNo |
(string) |
Lệnh điều động số |
| ManeuverCommandDate |
(DateTime) |
Ngày điều động |
| ManeuverCommandDepartment |
(string) |
Phòng ban điều động |
| ManeuverAbout |
(string) |
Điều động về việc |
| TransporterName |
(string) |
Họ tên người vận chuyển |
| ContractNo |
(string) |
Họp đồng số |
| ModesofTransport |
(string) |
Phương tiên vận chuyển |
| PlaceofExport |
(string) |
Xuất tại kho |
| Supplier |
(string) |
Nguồn |
| PlaceofImport |
(string) |
Nhập tại kho |
| DateofExport |
(DateTime) |
Ngày xuất kho |
| DateofImport |
(DateTime) |
Ngày nhập kho |
Chi tiết phiếu xuất kho
GET http://www.parkway.com.vn:9118/odata/XKKVCBN([key])
[key] : Mã phiếu xuất kho
DataType: json
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền |
| Status |
(long) |
Trạng thái |
| ManeuverCommandNo |
(string) |
Lệnh điều động số |
| ManeuverCommandDate |
(DateTime) |
Ngày điều động |
| ManeuverCommandDepartment |
(string) |
Phòng ban điều động |
| ManeuverAbout |
(string) |
Điều động về việc |
| TransporterName |
(string) |
Họ tên người vận chuyển |
| ContractNo |
(string) |
Họp đồng số |
| ModesofTransport |
(string) |
Phương tiên vận chuyển |
| PlaceofExport |
(string) |
Xuất tại kho |
| Supplier |
(string) |
Nguồn |
| PlaceofImport |
(string) |
Nhập tại kho |
| DateofExport |
(DateTime) |
Ngày xuất kho |
| DateofImport |
(DateTime) |
Ngày nhập kho |
Thêm phiếu xuất kho
Post http://www.parkway.com.vn:9118/odata/XKKVCBN
DataType: json
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền |
| Status |
(long) |
Trạng thái |
| ManeuverCommandNo |
(string) |
Lệnh điều động số |
| ManeuverCommandDate |
(DateTime) |
Ngày điều động |
| ManeuverCommandDepartment |
(string) |
Phòng ban điều động |
| ManeuverAbout |
(string) |
Điều động về việc |
| TransporterName |
(string) |
Họ tên người vận chuyển |
| ContractNo |
(string) |
Họp đồng số |
| ModesofTransport |
(string) |
Phương tiên vận chuyển |
| PlaceofExport |
(string) |
Xuất tại kho |
| Supplier |
(string) |
Nguồn |
| PlaceofImport |
(string) |
Nhập tại kho |
| DateofExport |
(DateTime) |
Ngày xuất kho |
| DateofImport |
(DateTime) |
Ngày nhập kho |
Sửa hóa đơn
PATCH http://www.parkway.com.vn:9118/odata/XKKVCBN([key])
[key] : Mã xuất nhập kho cần sửa
DataType: json
Data:
| InvoiceNumber |
(string) |
Số hóa đơn |
| IvoiceCode |
(string) |
Mã tra cứu |
| DateofInvoice |
(DateTime) |
Ngày xuất hóa đơn |
| DateofSign |
(DateTime) |
Ngày ký |
| TemptCode |
(string) |
Mẫu số |
| Symbol |
(string) |
Ký hiệu |
| TotalMoneyNoTax |
(decimal) |
Tổng tiền |
| Status |
(long) |
Trạng thái |
| ManeuverCommandNo |
(string) |
Lệnh điều động số |
| ManeuverCommandDate |
(DateTime) |
Ngày điều động |
| ManeuverCommandDepartment |
(string) |
Phòng ban điều động |
| ManeuverAbout |
(string) |
Điều động về việc |
| TransporterName |
(string) |
Họ tên người vận chuyển |
| ContractNo |
(string) |
Họp đồng số |
| ModesofTransport |
(string) |
Phương tiên vận chuyển |
| PlaceofExport |
(string) |
Xuất tại kho |
| Supplier |
(string) |
Nguồn |
| PlaceofImport |
(string) |
Nhập tại kho |
| DateofExport |
(DateTime) |
Ngày xuất kho |
| DateofImport |
(DateTime) |
Ngày nhập kho |
Xóa phiếu xuất kho
Delete http://www.parkway.com.vn:9118/odata/XKKVCBN([key])
[key] : Mã xuất nhập kho cần xóa
Ký hóa đơn
POST http://www.parkway.com.vn:9118/api/SignInvoice/Sign
DataType: json
Data:
| Id |
(int) |
Id hóa đơn |
| DateofSign |
(DateTime) |
Thời gian ký |
Cập nhật hóa đơn đã ký
Tạo hóa đơn - liên kết điều chỉnh/thay thế
POST http://www.parkway.com.vn:9118/api/ProcessInvoice/CreateProcessInvoice
DataType: json
| Cần một trong các nhóm params sau để tìm hóa đơn cần điều chỉnh thay thế |
| Biến params |
Mô tả |
| id |
Id hóa đơn |
temptcode symbol invoiceno |
Mẫu số Ký hiệu Số hóa đơn |
Data:
| Invoice |
(Object) |
Thông tin hóa đơn điều chỉnh/thay thế cho hóa đơn cũ
Miêu tả ở phía trên
|
| AdjustDetails |
(Object) |
| AdjustedContent |
(String) |
Nội dung điều chỉnh |
| Type |
(Int) |
Loại điều chỉnh
1: Điều chỉnh tăng
2: Điều chỉnh giảm
3: Điều chỉnh thông tin
|
| AdjustedContent |
(String) |
Nội dung điều chỉnh |
| DocumentNo |
(String) không dấu |
Biên bản số |
| BeforeAdjust |
(String) |
Tóm tắt nội dung trước điều chỉnh |
| AfterAdjust |
(String) |
Tóm tắt nội dung sau điều chỉnh |
|
| ReplaceDetails |
(Object) |
| ReplaceContent |
(String) |
Nội dung điều chỉnh |
| DocumentNo |
(String) không dấu |
Biên bản số |
|
Hủy hóa đơn
DELETE http://www.parkway.com.vn:9118/api/ProcessInvoice/CancelInvoice
DataType: json
| Cần một trong các nhóm params sau để tìm hóa đơn cần hủy |
| Biến params |
Mô tả |
| id |
Id hóa đơn |
temptcode symbol invoiceno |
Mẫu số Ký hiệu Số hóa đơn |
Header:
filename: Tên file đính kèm (Bắt buộc nếu có file)
|
Data:
File (Không bắt buộc)
|
Đính kèm biên bản/bản kê
DELETE http://www.parkway.com.vn:9118/api/ProcessInvoice/UploadDocument
DataType: json
| Cần một trong các nhóm params sau để tìm hóa đơn cần đính kèm |
| Biến params |
Mô tả |
| id |
Id hóa đơn |
temptcode symbol invoiceno |
Mẫu số Ký hiệu Số hóa đơn |
Header:
filename: Tên file đính kèm
|
Data:
File
|