Tạo ký và gửi hóa đơn

Post /api/HDon/CreateInvoiceSign

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.MSTCNhanh	(string)	Không bắt buộc	Mã số thuế chi nhánh
--- 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.HTTToan	(string)	Không bắt buộc	Hình thức thanh toán
--- TTChung.PTTToan	(string)	Không bắt buộc	Phương thức thanh toán
--- 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
--- TTChung.GChu	(string)	Không bắt buộc	Ghi chú
Phần nội dung dành cho Phiếu xuất kho
--- TTChung.LDDSo	(string)	Bắt buộc (Khi là PXKKVCNB)	Lệnh điều động số
--- TTChung.NDDong	(datetime)	Bắt buộc (Khi là PXKKVCNB)	Ngày điều động: yyyy-MM-ddThh:mm:ss Ví dụ: 2021-12-20T00:00:00
--- TTChung.BPDDong	(string)	Không bắt buộc	Bộ phận điều động
--- TTChung.DDVViec	(string)	Không bắt buộc	Về việc
--- TTChung.KNhap	(string)	Bắt buộc (Khi là PXKKVCNB)	Nơi nhập kho
--- TTChung.KXuat	(string)	Bắt buộc (Khi là PXKKVCNB)	Nơi xuất kho
--- TTChung.NNhap	(datetime)	Không bắt buộc	Ngày nhập kho: yyyy-MM-ddThh:mm:ss Ví dụ: 2021-12-20T00:00:00
--- TTChung.NXuat	(datetime)	Không bắt buộc	Ngày xuất kho: yyyy-MM-ddThh:mm:ss Ví dụ: 2021-12-20T00:00:00
--- TTChung.TNVChuyen	(string)	Bắt buộc (Khi là PXKKVCNB)	Tên người vận chuyển
--- TTChung.PTVChuyen	(string)	Bắt buộc (Khi là PXKKVCNB)	Tên người phương tiện vận chuyển
--- TTChung.HDSo	(string)	Không bắt buộc	Hợp đồng số
--- TTChung.HDGiua	(string)	Không bắt buộc	Hợp đồng của phòng ban
--- TTChung.HDVa	(string)	Không bắt buộc	Hợp đồng với phòng ban
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
--- NMua.CMND	(string)	Không bắt buộc	CMND/CCCD của người mua 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.TgTTTThue8	(decimal)	bắt buộc	Tổng tiền trước thuế (thuế 8%)
--- TToan.TgTThue8	(decimal)	bắt buộc	Tổng tiền thuế (thuế 8%)
--- TToan.TgTSTCThue8	(decimal)	bắt buộc	Tổng tiền sau thuế (thuế 8%)
--- 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ụ
--- 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.MHHDVu	(string)	Không bắt buộc	Mã hàng hóa dịch vụ
--- --- 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%
--- --- DSHHDVu.HHDVu.SLo	(string)	Không bắt buộc	Số lô
--- --- DSHHDVu.HHDVu.HDung	(datetime)	Không bắt buộc	Hạn dùng: yyyy-MM-ddThh:mm:ss Ví dụ: 2021-12-20T00:00:00
--- --- DSHHDVu.HHDVu.TThue	(decimal)	Không bắt buộc	Tiền thuế
--- --- DSHHDVu.HHDVu.ThTSThue	(decimal)	Không bắt buộc	Thành tiền sau thuế


        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
        },
        "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
                }
            ]
        },
        "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"
        }
    };

    $.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
Data	Object như thông tin gửi lên có thêm field XML chứa thông tin ký số


            {
        "TTChung":{
        "MSTCNhanh":null,
        "KHMSHDon":"1",
        "KHHDon":"C22TVU",
        "SHDon":1,
        "NLap":"2022-03-04T14:25:33.34",
        "DVTTe":"VND",
        "TGia":1.0,
        "HTTToan":"TM/CK1",
        "MBMat":"SmartVasTest01",
        "MNBo":"SmartVasTest01",
        "MTCuu":"22F4185100HB",
        "GChu":null,
        "XML":"<HDon><DLHDon Id=\"DLHDon\"><TTChung><THDon>Hóa đơn điện tử giá trị gia tăng</THDon><KHMSHDon>1</KHMSHDon><KHHDon>C22TVU</KHHDon><SHDon>1</SHDon><NLap>2022-03-04</NLap><HTTToan>Tiền mặt/Chuyển khoản</HTTToan><DVTTe>VND</DVTTe><TGia>1</TGia></TTChung><NDHDon><NBan><Ten>TEST HỘI ANH VĂN VIỆT MỸ</Ten><MST>0309612872-999</MST><DChi>189 Nguyễn Thị Minh Khai, Phường Phạm Ngũ Lão, Quận 1, Thành phố Hồ Chí Minh</DChi></NBan><NMua><Ten>Công ty cổ phần chữ ký số VINA</Ten><MST>0309612872</MST><DChi>41A Nguyễn Phi Khanh, P.Tân Định, Q.1 TP.Hồ Chí Minh</DChi></NMua><DSHHDVu><HHDVu><TChat>1</TChat><STT>1</STT><THHDVu>Test sản phẩm 1</THHDVu><DVTinh>cái</DVTinh><SLuong>1</SLuong><DGia>10000</DGia><TLCKhau>0</TLCKhau><STCKhau>0</STCKhau><ThTien>10000</ThTien><TSuat>KCT</TSuat></HHDVu></DSHHDVu><TToan><TgTCThue>10000</TgTCThue><TgTThue>0</TgTThue><THTTLTSuat><LTSuat><TSuat>KCT</TSuat><ThTien>10000</ThTien><TThue>0</TThue></LTSuat></THTTLTSuat><TTCKTMai>0</TTCKTMai><TgTTTBSo>10000</TgTTTBSo><TgTTTBChu>Mười nghìn đồng</TgTTTBChu></TToan></NDHDon></DLHDon><DSCKS><NBan><Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\" Id=\"NBan\"><SignedInfo><CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\"></CanonicalizationMethod><SignatureMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"></SignatureMethod><Reference URI=\"#DLHDon\"><DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"></DigestMethod><DigestValue>hGZsUKbHngZ718TnehhdOUNrXtk=</DigestValue></Reference><Reference URI=\"#NBanObject\"><DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"></DigestMethod><DigestValue>gDpJ/tIAw4d4M+DnPj1Kd71c/5k=</DigestValue></Reference></SignedInfo><SignatureValue>BCdy6K5tpbjH0+cxaCo4AsiFW3V1XEsazwESzxt1/kJJKwRUfdyHlr/2OTqPvfAlmOC8qIEIRWMFKWlbFdhYVh3RhFxLYc9FwRUgjT9vc9hTdATK+Q31PukhPr+adz3NzkxMbcn/kXO37lfA803QpK0jtpzwG7tBUVoQ8OnWVR0=</SignatureValue><KeyInfo><X509Data><X509SubjectName>OID.0.9.2342.19200300.100.1.1=MST:0309612872-999, CN=TEST HDDT CTY CP CHỮ KÝ SỐ VI NA – TP Hà Nội, L=Hà Nội, C=VN</X509SubjectName><X509Certificate>MIIE9DCCA9ygAwIBAgIQVAEBBxV19rD+p/zl9olyfzANBgkqhkiG9w0BAQsFADB1MQswCQYDVQQGEwJWTjEoMCYGA1UECgwfQ29uZyB0eSBjbyBwaGFuIGNodSBreSBzbyBWSSBOQTEoMCYGA1UECwwfQ29uZyB0eSBjbyBwaGFuIGNodSBreSBzbyBWSSBOQTESMBAGA1UEAwwJU21hcnRTaWduMB4XDTIxMTExNjA2NTAyOVoXDTIyMTExNjA2NTAyOVowgYYxIjAgBgoJkiaJk/IsZAEBDBJNU1Q6MDMwOTYxMjg3Mi05OTkxPzA9BgNVBAMMNlRFU1QgSEREVCBDVFkgQ1AgQ0jhu64gS8OdIFPhu5AgVkkgTkEg4oCTIFRQIEjDoCBO4buZaTESMBAGA1UEBwwJSMOgIE7hu5lpMQswCQYDVQQGEwJWTjCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAmtDVohfJ1k31KrkNGKOvW2bWfwNW9F8G2e12xFVwDtTxd2W+RKp51kNj3CVbHK0WLPPDW6uMZ9run0eXysLBBZ+6TXSvT+dm5FgC95sfimLeyjg85m/hIegd6jPruRyTr2KnrQMYOO2BN6qbgI19WPPiJJSsLeME6QhWYiXRkl0CAwEAAaOCAfAwggHsMHIGCCsGAQUFBwEBBGYwZDA1BggrBgEFBQcwAoYpaHR0cHM6Ly9zbWFydHNpZ24uY29tLnZuL3NtYXJ0c2lnbjI1Ni5jcnQwKwYIKwYBBQUHMAGGH2h0dHA6Ly9vY3NwMjU2LnNtYXJ0c2lnbi5jb20udm4wHQYDVR0OBBYEFLl5XbBV2z2egSODVaJVRzFyh9yJMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAU0ApZUhzKisAJ0gQokuqT++NChh8wKAYIKwYBBQUHAQMEHDAaMBgGCCsGAQUFBwsBMAwGCisGAQQBge0DAQcwgZEGA1UdIASBiTCBhjCBgwYKKwYBBAGB7QMBBzB1MEoGCCsGAQUFBwICMD4ePABUAGgAaQBzACAAaQBzACAAYQBjAGMAcgBlAGQAaQB0AGUAZAAgAGMAZQByAHQAaQBmAGkAYwBhAHQAZTAnBggrBgEFBQcCARYbaHR0cDovL3NtYXJ0c2lnbi5jb20udm4vY3BzMC8GA1UdHwQoMCYwJKAioCCGHmh0dHA6Ly9jcmwyNTYuc21hcnRzaWduLmNvbS52bjAOBgNVHQ8BAf8EBAMCA8gwKQYDVR0lBCIwIAYIKwYBBQUHAwIGCCsGAQUFBwMEBgorBgEEAYI3CgMMMA0GCSqGSIb3DQEBCwUAA4IBAQBfbN/4yM2uNQT7lhMJKO1AyZkguSgjz3xNW43pI/b5sUmDFp5Ii3OriRCWC0hn8VRvKWpQp9eHxHtn/goem5CWHpDJ2T7w5urz+5ckYeSdtnsBvJxNY3Ag5TUCkce96+Psaacqa3qSvlw2eg8W6DeG+B5lFTjFQOt9BmpNS414U+dBKHp5DpvCb7QPOVr5gGRJZGUHKmbxQNpTrdmWOEuNKdUdkWxJszzUo7Z1HiZLp2hHpKOXb5GFMEWbgTrbDVVjmhoepPjaXw+C90g50Y/iq1dmzMG2RH7JAIn2crbL3QSpsssOAs7IShB/0HOmwlk8W/SpKv7y8PTv18JCavcC</X509Certificate></X509Data></KeyInfo><Object Id=\"NBanObject\"><SignatureProperties><SignatureProperty Id=\"NBanTgDKySo\" Target=\"#NBan\"><SigningTime>2022-03-04T14:25:35.467</SigningTime></SignatureProperty></SignatureProperties></Object></Signature></NBan></DSCKS></HDon>"
        },
        "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,
        "CMND":null
        },
        "DSHHDVu":{
        "HHDVu":[
        {
        "TChat":1,
        "MHHDVu":null,
        "THHDVu":"Test sản phẩm 1",
        "DVTinh":"cái",
        "SLuong":1.0,
        "DGia":10000.0,
        "TLCKhau":0,
        "STCKhau":0.0,
        "ThTien":10000.0,
        "TSuat":-1
        }
        ]
        },
        "TToan":{
        "TSuat":-1,
        "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,
        "TgTCThue":10000.0,
        "TgTThue":0.0,
        "TTCKTMai":0.0,
        "TgTTTBSo":10000.0,
        "TgTTTBChu":"Mười nghìn đồng"
        }
        }

Mô tả lỗi

Status	Mã lỗi: 500: Ký số không thành công 406: Không tạo được hóa đơn
Error	Mô tả lỗi


    {error: "Thông điệp không đúng định dạng XML"}