Tạo và ký phiếu xuất kho

Mô tả và thông tin API

Endpoint: api/HDon/CreateInvoiceSign

Phương thức: POST

Mô tả: API này cho phép người dùng tạo và thêm phiếu xuất kho vào hệ thống.

Tham số Kiểu dữ liệu Ràng buộc Mô tả
TTChung (object) Bắt buộc Thông tin chung của phiếu xuất kho
MSTCNhanh (string) Không bắt buộc Mã số thuế chi nhánh
KHMSHDon (string) Bắt buộc Mẫu số hóa đơn liên quan
KHHDon (string) Bắt buộc Ký hiệu hóa đơn liên quan
SHDon (int) Không bắt buộc Số hóa đơn liên quan
NLap (datetime) Bắt buộc Ngày lập: yyyy-MM-ddThh:mm:ss
Ví dụ: 2024-08-19T08:54:08
DVTTe (string) Bắt buộc Đơn vị tiền tệ (VND, USD, EUR, JPY, CAD, AUD, SGD)
TGia (decimal) Bắt buộc Tỷ giá
HTTToan (string) Không bắt buộc Hình thức thanh toán
MBMat (string) Bắt buộc Mã bí mật (GuideId) dùng để định danh phiếu xuất kho.
Mã này có thể dùng để truy xuất phiếu khi cần.
MNBo (string) Không bắt buộc Mã nội bộ
MTCuu (string) Không bắt buộc Mã tra cứu
GChu (string) Không bắt buộc Ghi chú
XML (string) Không bắt buộc Dữ liệu XML liên quan
LDDSo (string) Bắt buộc Căn cứ lệnh điều động số
NDDong (datetime) Bắt buộc Ngày điều động: yyyy-MM-ddThh:mm:ss
Ví dụ: 2024-08-19T08:54:08
BPDDong (string) Không bắt buộc Bộ phận điều động
DDVViec (string) Bắt buộc Về việc (mô tả mục đích điều động)
KNhap (string) Bắt buộc Nhập tại kho
KXuat (string) Bắt buộc Xuất tại kho
NNhap (string) Không bắt buộc Nguồn nhập
NXuat (string) Không bắt buộc Nguồn xuất
TNVChuyen (string) Bắt buộc Họ tên người vận chuyển
PTVChuyen (string) Bắt buộc Phương tiện vận chuyển
HDSo (string) Bắt buộc Hợp đồng số
HDGiua (string) Không bắt buộc Hợp đồng của phòng ban
HDVa (string) Không bắt buộc Hợp đồng với phòng ban
PTTToan (string) Không bắt buộc Phương thức thanh toán
NgayChungTu (datetime) Không bắt buộc Ngày chứng từ: yyyy-MM-ddThh:mm:ss
Ví dụ: 2024-08-19T08:54:08
NNCap (string) Không bắt buộc Người cung cấp
HVTNXHang (string) Bắt buộc Họ và tên người xuất hàng
HVTNNHang (string) Bắt buộc Họ và tên người nhận hàng
Ten (string) Bắt buộc Tên đơn vị người nhận hàng
MST (string) Không bắt buộc Mã số thuế người nhận hàng
DChi (string) Không bắt buộc Địa chỉ kho nhận hàng
SDThoai (string) Không bắt buộc Số điện thoại
DCTDTu (string) Không bắt buộc Địa chỉ email
HVTNMHang (string) Không bắt buộc Họ và tên người mua hàng
STKNHang (string) Không bắt buộc Số tài khoản ngân hàng
TNHang (string) Không bắt buộc Tên ngân hàng
CMND (string) Không bắt buộc CMND/CCCD của người nhận hàng
HHDVu (object) Bắt buộc Thông tin hàng hóa xuất kho
TChat (int) Bắt buộc Tính chất:
1: Hàng hóa
2: Khuyến mãi
3: Chiết khấu
4: Ghi chú
MHHDVu (string) Không bắt buộc Mã hàng hóa
THHDVu (string) Bắt buộc Tên hàng hóa
DVTinh (string) Bắt buộc Đơn vị tính
SLuong (double) Bắt buộc Số lượng
DGia (decimal) Không bắt buộc Đơn giá
TLCKhau (int) Không bắt buộc Tỷ lệ chiết khấu
STCKhau (decimal) Không bắt buộc Số tiền chiết khấu
ThTien (decimal) Không bắt buộc Thành tiền
TSuat (int) Không bắt buộc Thuế suất:
-2: KKKNT
-1: KCT
0: 0%
5: 5%
8: 8%
10: 10%
SLo (string) Không bắt buộc Số lô
HDung (datetime) Không bắt buộc Hạn dùng: yyyy-MM-ddThh:mm:ss
Ví dụ: 2024-08-19T08:54:08
SLTNhap (double) Không bắt buộc Số lượng thực nhập
SLTXuat (double) Bắt buộc Số lượng thực xuất
TSuat (int) Bắt buộc Thuế suất:
-2: KKKNT
-1: KCT
0: 0%
5: 5%
8: 8%
10: 10%
TgTTTKCThue (decimal) Không bắt buộc Tổng tiền trước thuế
TgTSKCThue (decimal) Không bắt buộc Tổng tiền sau chiết khấu trước thuế
TgTTTThue0 (decimal) Không bắt buộc Tổng tiền trước thuế (0%)
TgTSTCThue0 (decimal) Không bắt buộc Tổng tiền sau chiết khấu (0%)
TgTTTThue5 (decimal) Không bắt buộc Tổng tiền trước thuế (5%)
TgTThue5 (decimal) Không bắt buộc Tổng thuế (5%)
TgTSTCThue5 (decimal) Không bắt buộc Tổng tiền sau chiết khấu (5%)
TgTTTThue10 (decimal) Không bắt buộc Tổng tiền trước thuế (10%)
TgTThue10 (decimal) Không bắt buộc Tổng thuế (10%)
TgTSTCThue10 (decimal) Không bắt buộc Tổng tiền sau chiết khấu (10%)
TgTCThue (decimal) Không bắt buộc Tổng tiền chưa thuế
TgTThue (decimal) Không bắt buộc Tổng tiền thuế
TTCKTMai (decimal) Không bắt buộc Tổng tiền chiết khấu
TgTTTBSo (decimal) Bắt buộc Tổng tiền bằng số
TgTTTBChu (string) Bắt buộc Số tiền bằng chữ

Mã nguồn ví dụ


var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://apiehd.smartsign.com.vn/api/PhieuXuatKho/Create");
request.Headers.Add("Authorization", "Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
string jsonData = @"{
  ""TTChung"": {
    ""MSTCNhanh"": null,
    ""KHMSHDon"": ""6"",
    ""KHHDon"": ""C24BDC"",
    ""SHDon"": 0,
    ""NLap"": ""2024-08-19T08:54:08.58"",
    ""DVTTe"": ""VND"",
    ""TGia"": 1,
    ""HTTToan"": null,
    ""MBMat"": ""20240819007"",
    ""MNBo"": """",
    ""MTCuu"": null,
    ""GChu"": null,
    ""XML"": null,
    ""LDDSo"": ""122d9179-1685-430f-a78e-627a66c10277"",
    ""NDDong"": ""2024-08-19T08:54:08.58"",
    ""BPDDong"": null,
    ""DDVViec"": ""Điều động test"",
    ""KNhap"": ""Chi nhánh xăng dầu số 03"",
    ""KXuat"": ""Phòng Kinh doanh"",
    ""NNhap"": null,
    ""NXuat"": null,
    ""TNVChuyen"": ""Lê Văn Hoàng Sĩ"",
    ""PTVChuyen"": ""57K-4458"",
    ""HDSo"": ""123"",
    ""HDGiua"": null,
    ""HDVa"": null,
    ""PTTToan"": null,
    ""SPCon"": """",
    ""NgayChungTu"": null,
    ""NNCap"": ""Người cung cấp test"",
    ""HVTNXHang"": ""Tên người xuất"",
    ""HVTNNHang"": ""Tên người nhận""
  },
  ""NMua"": {
    ""Ten"": ""Nguyễn Văn A"",
    ""MST"": ""0309612872-999"",
    ""DChi"": null,
    ""SDThoai"": null,
    ""DCTDTu"": null,
    ""HVTNMHang"": null,
    ""STKNHang"": null,
    ""TNHang"": null,
    ""CMND"": null
  },
  ""NBan"": null,
  ""DSHHDVu"": {
    ""HHDVu"": [
      {
        ""TChat"": 1,
        ""MHHDVu"": ""AEN9Z4"",
        ""THHDVu"": ""Xăng RON 95-IV"",
        ""DVTinh"": ""Lít"",
        ""SLuong"": 15702,
        ""DGia"": 0,
        ""TLCKhau"": 0,
        ""STCKhau"": 0,
        ""ThTien"": 0,
        ""TSuat"": 0,
        ""SLo"": null,
        ""HDung"": null,
        ""SLTNhap"": 15702,
        ""SLTXuat"": null
      },
      {
        ""TChat"": 1,
        ""MHHDVu"": ""AEN9Z4"",
        ""THHDVu"": ""DO 0,001S-V"",
        ""DVTinh"": ""Lít"",
        ""SLuong"": 11848,
        ""DGia"": 0,
        ""TLCKhau"": 0,
        ""STCKhau"": 0,
        ""ThTien"": 0,
        ""TSuat"": 0,
        ""SLo"": null,
        ""HDung"": null,
        ""SLTNhap"": 11848,
        ""SLTXuat"": null
      },
      {
        ""TChat"": 1,
        ""MHHDVu"": ""AEM019"",
        ""THHDVu"": ""Dầu DO (0.05 S)"",
        ""DVTinh"": ""Lít"",
        ""SLuong"": 8511,
        ""DGia"": 0,
        ""TLCKhau"": 0,
        ""STCKhau"": 0,
        ""ThTien"": 0,
        ""TSuat"": 0,
        ""SLo"": null,
        ""HDung"": null,
        ""SLTNhap"": 8511,
        ""SLTXuat"": null
      }
    ]
  },
  ""TToan"": {
    ""TSuat"": 0,
    ""TgTTTKCThue"": 0,
    ""TgTSKCThue"": 0,
    ""TgTTTThue0"": 0,
    ""TgTSTCThue0"": 0,
    ""TgTTTThue5"": 0,
    ""TgTThue5"": 0,
    ""TgTSTCThue5"": 0,
    ""TgTTTThue10"": 0,
    ""TgTThue10"": 0,
    ""TgTSTCThue10"": 0,
    ""TgTCThue"": 0,
    ""TgTThue"": 0,
    ""TTCKTMai"": 0,
    ""TgTTTBSo"": 0,
    ""TgTTTBChu"": ""Không đồng""
  }
}";
var content = new StringContent(jsonData, Encoding.UTF8, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());


var settings = {
  "url": "https://apiehd.smartsign.com.vn/api/PhieuXuatKho/Create",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "TTChung": {
      "MSTCNhanh": null,
      "KHMSHDon": "6",
      "KHHDon": "C24BDC",
      "SHDon": 0,
      "NLap": "2024-08-19T08:54:08.58",
      "DVTTe": "VND",
      "TGia": 1,
      "HTTToan": null,
      "MBMat": "20240819007",
      "MNBo": "",
      "MTCuu": null,
      "GChu": null,
      "XML": null,
      "LDDSo": "122d9179-1685-430f-a78e-627a66c10277",
      "NDDong": "2024-08-19T08:54:08.58",
      "BPDDong": null,
      "DDVViec": "Điều động test",
      "KNhap": "Chi nhánh xăng dầu số 03",
      "KXuat": "Phòng Kinh doanh",
      "NNhap": null,
      "NXuat": null,
      "TNVChuyen": "Lê Văn Hoàng Sĩ",
      "PTVChuyen": "57K-4458",
      "HDSo": "123",
      "HDGiua": null,
      "HDVa": null,
      "PTTToan": null,
      "SPCon": "",
      "NgayChungTu": null,
      "NNCap": "Người cung cấp test",
      "HVTNXHang": "Tên người xuất",
      "HVTNNHang": "Tên người nhận"
    },
    "NMua": {
      "Ten": "Nguyễn Văn A",
      "MST": "0309612872-999",
      "DChi": null,
      "SDThoai": null,
      "DCTDTu": null,
      "HVTNMHang": null,
      "STKNHang": null,
      "TNHang": null,
      "CMND": null
    },
    "NBan": null,
    "DSHHDVu": {
      "HHDVu": [
        {
          "TChat": 1,
          "MHHDVu": "AEN9Z4",
          "THHDVu": "Xăng RON 95-IV",
          "DVTinh": "Lít",
          "SLuong": 15702,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 15702,
          "SLTXuat": null
        },
        {
          "TChat": 1,
          "MHHDVu": "AEN9Z4",
          "THHDVu": "DO 0,001S-V",
          "DVTinh": "Lít",
          "SLuong": 11848,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 11848,
          "SLTXuat": null
        },
        {
          "TChat": 1,
          "MHHDVu": "AEM019",
          "THHDVu": "Dầu DO (0.05 S)",
          "DVTinh": "Lít",
          "SLuong": 8511,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 8511,
          "SLTXuat": null
        }
      ]
    },
    "TToan": {
      "TSuat": 0,
      "TgTTTKCThue": 0,
      "TgTSKCThue": 0,
      "TgTTTThue0": 0,
      "TgTSTCThue0": 0,
      "TgTTTThue5": 0,
      "TgTThue5": 0,
      "TgTSTCThue5": 0,
      "TgTTTThue10": 0,
      "TgTThue10": 0,
      "TgTSTCThue10": 0,
      "TgTCThue": 0,
      "TgTThue": 0,
      "TTCKTMai": 0,
      "TgTTTBSo": 0,
      "TgTTTBChu": "Không đồng"
    }
  })
};
$.ajax(settings).done(function (response) {
  console.log(response);
});


var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://apiehd.smartsign.com.vn/api/PhieuXuatKho/Create',
  'headers': {
    'Authorization': 'Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "TTChung": {
      "MSTCNhanh": null,
      "KHMSHDon": "6",
      "KHHDon": "C24BDC",
      "SHDon": 0,
      "NLap": "2024-08-19T08:54:08.58",
      "DVTTe": "VND",
      "TGia": 1,
      "HTTToan": null,
      "MBMat": "20240819007",
      "MNBo": "",
      "MTCuu": null,
      "GChu": null,
      "XML": null,
      "LDDSo": "122d9179-1685-430f-a78e-627a66c10277",
      "NDDong": "2024-08-19T08:54:08.58",
      "BPDDong": null,
      "DDVViec": "Điều động test",
      "KNhap": "Chi nhánh xăng dầu số 03",
      "KXuat": "Phòng Kinh doanh",
      "NNhap": null,
      "NXuat": null,
      "TNVChuyen": "Lê Văn Hoàng Sĩ",
      "PTVChuyen": "57K-4458",
      "HDSo": "123",
      "HDGiua": null,
      "HDVa": null,
      "PTTToan": null,
      "SPCon": "",
      "NgayChungTu": null,
      "NNCap": "Người cung cấp test",
      "HVTNXHang": "Tên người xuất",
      "HVTNNHang": "Tên người nhận"
    },
    "NMua": {
      "Ten": "Nguyễn Văn A",
      "MST": "0309612872-999",
      "DChi": null,
      "SDThoai": null,
      "DCTDTu": null,
      "HVTNMHang": null,
      "STKNHang": null,
      "TNHang": null,
      "CMND": null
    },
    "NBan": null,
    "DSHHDVu": {
      "HHDVu": [
        {
          "TChat": 1,
          "MHHDVu": "AEN9Z4",
          "THHDVu": "Xăng RON 95-IV",
          "DVTinh": "Lít",
          "SLuong": 15702,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 15702,
          "SLTXuat": null
        },
        {
          "TChat": 1,
          "MHHDVu": "AEN9Z4",
          "THHDVu": "DO 0,001S-V",
          "DVTinh": "Lít",
          "SLuong": 11848,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 11848,
          "SLTXuat": null
        },
        {
          "TChat": 1,
          "MHHDVu": "AEM019",
          "THHDVu": "Dầu DO (0.05 S)",
          "DVTinh": "Lít",
          "SLuong": 8511,
          "DGia": 0,
          "TLCKhau": 0,
          "STCKhau": 0,
          "ThTien": 0,
          "TSuat": 0,
          "SLo": null,
          "HDung": null,
          "SLTNhap": 8511,
          "SLTXuat": null
        }
      ]
    },
    "TToan": {
      "TSuat": 0,
      "TgTTTKCThue": 0,
      "TgTSKCThue": 0,
      "TgTTTThue0": 0,
      "TgTSTCThue0": 0,
      "TgTTTThue5": 0,
      "TgTThue5": 0,
      "TgTSTCThue5": 0,
      "TgTTTThue10": 0,
      "TgTThue10": 0,
      "TgTSTCThue10": 0,
      "TgTCThue": 0,
      "TgTThue": 0,
      "TTCKTMai": 0,
      "TgTTTBSo": 0,
      "TgTTTBChu": "Không đồng"
    }
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Đối tượng trả về

Đối tượng Mô tả
Data

Đối tượng chứa thông tin phiếu xuất kho đã gửi lên
TTHDLQuan

Thông tin phiếu xuất kho liên quan
KHMSHDCLQuan

Ký hiệu mẫu số phiếu xuất kho liên quan
KHHDCLQuan

Ký hiệu phiếu xuất kho liên quan
SHDCLQuan

Số phiếu xuất kho liên quan
Ky

Ký
MCCQT

Mã của cơ quan thuế

Mã nguồn JSON ví dụ


{
  "TTChung": {
    "MSTCNhanh": null,
    "KHMSHDon": "6",
    "KHHDon": "C24BDC",
    "SHDon": 0,
    "NLap": "2024-08-19T08:54:08.58",
    "DVTTe": "VND",
    "TGia": 1,
    "HTTToan": null,
    "MBMat": "20240819007",
    "MNBo": "",
    "MTCuu": null,
    "GChu": null,
    "XML": null,
    "LDDSo": "122d9179-1685-430f-a78e-627a66c10277",
    "NDDong": "2024-08-19T08:54:08.58",
    "BPDDong": null,
    "DDVViec": "Điều động test",
    "KNhap": "Chi nhánh xăng dầu số 03",
    "KXuat": "Phòng Kinh doanh",
    "NNhap": null,
    "NXuat": null,
    "TNVChuyen": "Lê Văn Hoàng Sĩ",
    "PTVChuyen": "57K-4458",
    "HDSo": "123",
    "HDGiua": null,
    "HDVa": null,
    "PTTToan": null,
    "SPCon": "",
    "NgayChungTu": null,
    "NNCap": "Người cung cấp test",
    "HVTNXHang": "Tên người xuất",
    "HVTNNHang": "Tên người nhận"
  },
  "NMua": {
    "Ten": "Nguyễn Văn A",
    "MST": "0309612872-999",
    "DChi": null,
    "SDThoai": null,
    "DCTDTu": null,
    "HVTNMHang": null,
    "STKNHang": null,
    "TNHang": null,
    "CMND": null
  },
  "NBan": null,
  "DSHHDVu": {
    "HHDVu": [
      {
        "TChat": 1,
        "MHHDVu": "AEN9Z4",
        "THHDVu": "Xăng RON 95-IV",
        "DVTinh": "Lít",
        "SLuong": 15702,
        "DGia": 0,
        "TLCKhau": 0,
        "STCKhau": 0,
        "ThTien": 0,
        "TSuat": 0,
        "SLo": null,
        "HDung": null,
        "SLTNhap": 15702,
        "SLTXuat": null
      },
      {
        "TChat": 1,
        "MHHDVu": "AEN9Z4",
        "THHDVu": "DO 0,001S-V",
        "DVTinh": "Lít",
        "SLuong": 11848,
        "DGia": 0,
        "TLCKhau": 0,
        "STCKhau": 0,
        "ThTien": 0,
        "TSuat": 0,
        "SLo": null,
        "HDung": null,
        "SLTNhap": 11848,
        "SLTXuat": null
      },
      {
        "TChat": 1,
        "MHHDVu": "AEM019",
        "THHDVu": "Dầu DO (0.05 S)",
        "DVTinh": "Lít",
        "SLuong": 8511,
        "DGia": 0,
        "TLCKhau": 0,
        "STCKhau": 0,
        "ThTien": 0,
        "TSuat": 0,
        "SLo": null,
        "HDung": null,
        "SLTNhap": 8511,
        "SLTXuat": null
      }
    ]
  },
  "TToan": {
    "TSuat": 0,
    "TgTTTKCThue": 0,
    "TgTSKCThue": 0,
    "TgTTTThue0": 0,
    "TgTSTCThue0": 0,
    "TgTTTThue5": 0,
    "TgTThue5": 0,
    "TgTSTCThue5": 0,
    "TgTTTThue10": 0,
    "TgTThue10": 0,
    "TgTSTCThue10": 0,
    "TgTCThue": 0,
    "TgTThue": 0,
    "TTCKTMai": 0,
    "TgTTTBSo": 0,
    "TgTTTBChu": "Không đồng"
  },
  "TTHDLQuan": {
    "KHMSHDCLQuan": null,
    "KHHDCLQuan": null,
    "SHDCLQuan": 0,
    "Ky": false
  },
  "MCCQT": null
}