Thay thế hóa đơn

Post /api/HDon/ReplaceInvoice

DataType: json

ContentType: application/json

Các tham số

Tham số Kiểu dữ liệu Ràng buộc Mô tả
TTChung (object) Bắt buộc Thông tin chung
--- TTChung.KHMSHDon (string) Bắt buộc Mẫu số hóa đơn
--- TTChung.KHHDon (string) Bắt buộc Ký hiệu hóa đơn
--- TTChung.SHDon (int) Không bắt buộc Số hóa đơn
--- TTChung.NLap (datetime) Bắt buộc Ngày lập: yyyy-MM-ddThh:mm:ss
Ví dụ: 2021-12-20T00:00:00
--- TTChung.DVTTe (string) Bắt buộc Đơn vị tiền tệ (VND,USD,EUR,JPY,CAD,AUD,SGD)
--- TTChung.TGia (string) Bắt buộc Tỉ giá
--- TTChung.MBMat (string) Bắt buộc Mã bí mật (GuideId)
--- TTChung.MNBo (string) Bắt buộc Mã nội bộ (GuideCode)
--- TTChung.MTCuu (string) Không bắt buộc Mã tra cứu
NMua (object) Bắt buộc Người mua
--- NMua.Ten (string) Bắt buộc Tên người mua
--- NMua.MST (string) Bắt buộc Mã số thuế người mua
--- NMua.DChi (string) Bắt buộc Địa chỉ
--- NMua.SDThoai (string) Không bắt buộc Số điện thoại
--- NMua.DCTDTu (string) Không bắt buộc Địa chỉ thư điện tử
--- NMua.HVTNMHang (string) Không bắt buộc Họ và tên người mua hàn
--- NMua.STKNHang (string) Không bắt buộc Số tài khoản ngân hàng
--- NMua.TNHang (string) Không bắt buộc Tên ngân hàng
TToan (object) Bắt buộc Thông tin thanh toán
--- TToan.TgTTTKCThue (decimal) bắt buộc Tổng tiền trước khi chịu thuế
--- TToan.TgTSKCThue (decimal) bắt buộc Tổng tiền sau khi chịu thuế
--- TToan.TgTTTThue0 (decimal) bắt buộc Tổng tiền trước thuế (thuế 0%)
--- TToan.TgTSTCThue0 (decimal) bắt buộc Tổng tiền sau thuế (thuế 0%)
--- TToan.TgTTTThue5 (decimal) bắt buộc Tổng tiền trước thuế (thuế 5%)
--- TToan.TgTThue5 (decimal) bắt buộc Tổng tiền thuế (thuế 5%)
--- TToan.TgTSTCThue5 (decimal) bắt buộc Tổng tiền sau thuế (thuế 5%)
--- TToan.TgTTTThue10 (decimal) bắt buộc Tổng tiền trước thuế (thuế 10%)
--- TToan.TgTThue10 (decimal) bắt buộc Tổng tiền thuế (thuế 10%)
--- TToan.TgTSTCThue10 (decimal) bắt buộc Tổng tiền sau thuế (thuế 10%)
--- TToan.TSuat (int) bắt buộc Thuế suất:
-2: KKKNT (không kê khai nộp thuế)
-1: KCT (Không chịu thuế)
0: Thuế 0%
5: Thuế 5%
8: Thuế 8%
10: Thuế 10%
--- TToan.TgTCThue (decimal) bắt buộc Tổng tiền chưa thuế
--- TToan.TgTThue (decimal) bắt buộc Tổng tiêng thuế
--- TToan.TTCKTMai (decimal) bắt buộc Tổng tiền chiết khấu thương mại
--- TToan.TgTTTBSo (decimal) bắt buộc Tổng tiền bằng số
--- TToan.TgTTTBChu (string) bắt buộc Số tiền bằng chữ
DSHHDVu (object) Bắt buộc Danh sách hàng hóa dịch vụ
TTHDLQuan (object) Bắt buộc Thông tin hoá đơn bị thay thế
--- TTHDLQuan.KHMSHDCLQuan (string) Bắt buộc Mẫu số hoá đơn bị thay thế
--- TTHDLQuan.KHHDCLQuan (string) Bắt buộc Ký hiệu hoá đơn bị thay thế
--- TTHDLQuan.SHDCLQuan (int) Bắt buộc Số hoá đơn bị thay thế
--- TTHDLQuan.Ky (bool) Bắt buộc Ký duyệt hoá đơn thay thế (true/false)
--- DSHHDVu.HHDVu (object) Bắt buộc Hàng hóa dịch vụ
--- --- DSHHDVu.HHDVu.TChat (int) Bắt buộc Tính chất:
1: Hàng hóa dịch vụ
2: Khuyến mãi
3: Chiết khấu
4: Ghi chú
--- --- DSHHDVu.HHDVu.THHDVu (string) Bắt buộc Tên hàng hóa dịch vụ
--- --- DSHHDVu.HHDVu.DVTinh (string) Không bắt buộc Đơn vị tính
--- --- DSHHDVu.HHDVu.SLuong (double) Không bắt buộc Số lượng
--- --- DSHHDVu.HHDVu.DGia (decimal) Không bắt buộc Đơn giá
--- --- DSHHDVu.HHDVu.TLCKhau (int) Không bắt buộc Tỉ lệ chiết khấu
--- --- DSHHDVu.HHDVu.STCKhau (int) Không bắt buộc Số tiền chiết khấu
--- --- DSHHDVu.HHDVu.ThTien (decimal) Bắt buộc Thành tiền
--- --- DSHHDVu.HHDVu.TSuat (int) Không bắt buộc Thuế suất:
-2: KKKNT (không kê khai nộp thuế)
-1: KCT (Không chịu thuế)
0: Thuế 0%
5: Thuế 5%
8: Thuế 8%
10: Thuế 10%

        var hdon = {
        "TTChung": {
            "KHMSHDon": "1",
            "KHHDon": "C21TMA",
            "SHDon": 0,
            "NLap": "2021-12-20T00:00:00",
            "DVTTe": "VND",
            "TGia": "1.0",
            "HTTToan": "TM/CK1",
            "MBMat": "SmartVasTest01",
            "MNBo": "SmartVasTest01",
            "MTCuu": null
        },
        "NMua": {
            "Ten": "Công ty cổ phần chữ ký số VINA",
            "MST": "0309612872",
            "DChi": "41A Nguyễn Phi Khanh, P.Tân Định, Q.1 TP.Hồ Chí Minh",
            "SDThoai": null,
            "DCTDTu": null,
            "HVTNMHang": null,
            "STKNHang": null,
            "TNHang": null
        },
        "TToan": {
            "TgTTTKCThue": "0.0",
            "TgTSKCThue": "0.0",
            "TgTTTThue0": "0.0",
            "TgTSTCThue0": "0.0",
            "TgTTTThue5": "0.0",
            "TgTThue5": "0.0",
            "TgTSTCThue5": "0.0",
            "TgTTTThue10": "0.0",
            "TgTThue10": "0.0",
            "TgTSTCThue10": "0.0",
            "TSuat": "-1",
            "TgTCThue": "10000",
            "TgTThue": "0.0",
            "TTCKTMai": "0.0",
            "TgTTTBSo": "10000",
            "TgTTTBChu": "Mười nghìn đồng"
        },
        "TTHDLQuan": {
            "KHMSHDCLQuan": "1",
            "KHHDCLQuan": "C21TMA",
            "SHDCLQuan": 2,
            "Ky": false
        },
        "DSHHDVu": {
            "HHDVu": [
                {
                    "TChat": 1,
                    "THHDVu": "Test sản phẩm 1",
                    "DVTinh": "cái",
                    "SLuong": "1",
                    "DGia": "10000",
                    "TLCKhau": 0,
                    "STCKhau": "0.0",
                    "ThTien": "10000",
                    "TSuat": -1
                }
            ]
        }
    };
    $.ajax({
        url: 'http://apis.smartsign.com.vn/api/HDon/CreateInvoiceSign',
        type: "POST",
        dataType: "json",
        contentType: 'application/json',
        data: JSON.stringify(hdon),
        success: function (data, status, xhr) {
            console.log(data);
        }
    });

                

Mô tả kết quả thành công (status = 200)

Status 200
Id Mã hóa đơn đã hủy

    {
        "Id": "1234567",
        "Message": "Thay thế thành công",
    };

Mô tả lỗi

Status Mã lỗi:
204: Không tìm thấy hóa đơn
403: Hóa đơn chưa ký
409: Hóa đơn đã hủy
500: Lỗi xử lý, xem mô tả để biết thêm chi tiết
Message Mô tả lỗi

    {
        Id:-1, 
        Message: "Thông điệp không đúng định dạng XML"
    }