EInvoice.IntegratedLib 1.0.1

TÀI LIỆU TÍCH HỢP THƯ VIỆN

1. Phương thức tích hợp

• Gọi thư viện của Softdreams.
• Cài đặt thư viện tại: https://www.nuget.org/packages/EInvoice.IntegratedLib

2. Mô tả đầu hàm

• Đầu hàm tích hợp:

public void Initialize(string username, string password)
public string RemoteLaunchInvoices(string Pattern, string Serial, string XmlData, string SignDate = null)

• Mô tả:

• Initialize: dùng để khởi tạo thư viện . username: tài khoản tích hợp được SDS cung cấp . password: mật khẩu tích hợp được SDS cung cấp

• RemoteLaunchInvoices: tạo danh sách hóa đơn lên hệ thống Hóa đơn điện tử EasyInvoice và đồng thời phát hành danh sách trên với chứng thư số cài đặt ở máy người dùng. . Pattern: Mẫu số hóa đơn. . Serial: Ký hiệu hóa đơn. . XmlData: Dữ liệu hóa đơn đóng gói từ phần mềm cần tích hợp. Cụ thể định dạng được mô tả ở phần dưới. . SignDate: ngày tạo lập (và phát hành) danh sách hóa đơn. Nếu không truyền vào tham số này, hệ thống sẽ phát hành dựa vào ngày tạo lập trong dữ liệu hóa đơn (XmlData).

  (*) Cấu trúc của XmlData (các trường * là bắt buộc):

<Invoices>
        <Inv>
	<key>Giá trị khóa để xác định cho hóa đơn là duy nhất</key>
	<Invoice>
		<CusCode>Mã khách hàng</CusCode>
		<Buyer>Tên người mua hàng</ Buyer >
		<CusName>Tên khách hàng*</CusName>
		<CusAddress>Địa chỉ khách hàng</CusAddress>
		<CusBankName>Tên ngân hàng của khách hàng</ CusBankName >
		<CusBankNo>Số tài khoản ngân hàng của khách hàng</ CusBankNo >
		<CusPhone>Điện thoại khách hàng</CusPhone>
		<CusTaxCode>Mã số thuế (Bắt buộc với KH Doanh nghiệp)</CusTaxCode>
		<PaymentMethod>Phương thức thanh toán (xem phụ lục V.1)</PaymentMethod>
		<ArisingDate>Ngày phát sinh hóa đơn (mặc định là ngày hiện tại, định dạng dd/MM/yyyy)</ArisingDate>
		<ExchangeRate>Tỉ giá chuyển đổi</ExchangeRate>
		<CurrencyUnit>Đơn vị tiền tệ (ví dụ VND, USD)</ CurrencyUnit >
		<Extra>Thông tin bổ sung (định dạng json có các thuộc tính theo quy ước)</Extra>
		<Products>
		<Product>
			<Code>Mã sản phẩm</Code>
		<ProdName>Tên sản phẩm*</ProdName>
		<ProdUnit>Đơn vị tính</ProdUnit>
		<ProdQuantity>Số lượng</ProdQuantity>
		<ProdPrice>Đơn giá</ProdPrice>
		<Total>Tổng tiền trước thuế</ Total >
		<VATRate>Thuế suất (xem phụ lục V.3)</ VATRate >
		<VATAmount>Tiền thuế</VATAmount>
		<Amount>Tổng tiền (Nếu hóa đơn thuộc mẫu chung thuế suất, Amount cần được gán giá trị của Total)*</Amount>
		</Product>
		</Products>
		<Total>Tổng tiền trước thuế*</Total>
		<VATRate>Thuế GTGT (xem phụ lục V.3)*</VATRate>
		<VATAmount>Tiền thuế GTGT*</VATAmount>
		<Amount>Tổng tiền*</Amount>
		<AmountInWords>Số tiền viết bằng chữ*</AmountInWords>
	</Invoice>
	</Inv>
	<Inv>...</Inv>
</Invoices>

3. Ví dụ mẫu

using System;

namespace EInvoice.IntegratedLib
{
    public class Program
    {
        public static void Main()
        {
            //Sample invoice data
            string XmlData = @"<Invoices>
            <Inv>
                <key>e7c5c058-bbe1-4c9b-a6f1-8c8be0f9a060</key>
                <Invoice>
                    <CusCode>AAA</CusCode>
                    <Buyer/>
                    <CusName>Công ty Cổ Phần AAA</CusName>
                    <CusAddress>Địa chỉ công ty AAA - 3</CusAddress>
                    <CusBankName>Vietcombank</CusBankName>
                    <CusBankNo>999999999</CusBankNo>
                    <CusTaxCode>0105987432</CusTaxCode>
                    <PaymentMethod>Tiền mặt</PaymentMethod>
                    <CurrencyUnit>VND</CurrencyUnit>
                    <ExchangeRate>1.0000</ExchangeRate>
                    <PaymentStatus>1</PaymentStatus>
                    <Products>
                        <Product>
                            <ProdName>Chi phí mua hàng</ProdName>
                            <ProdUnit/>
                            <ProdQuantity>5</ProdQuantity>
                            <ProdPrice>2500000</ProdPrice>
                            <Total>12500000</Total>
                            <VATRate>10</VATRate>
                            <VATAmount>1250000</VATAmount>
                            <Amount>12500000</Amount>
                        </Product>
                        <Product>
                            <ProdName>Chiết khấu</ProdName>
                            <ProdUnit/>
                            <ProdQuantity/>
                            <ProdPrice/>
                            <Total>-250000</Total>
                            <VATRate>10</VATRate>
                            <VATAmount>-25000</VATAmount>
                            <Amount>-250000</Amount>
                        </Product>
                        <Product>
                            <ProdName>Chỉ khâu 500m</ProdName>
                            <ProdUnit>Cuộn</ProdUnit>
                            <ProdQuantity>50</ProdQuantity>
                            <ProdPrice>10000</ProdPrice>
                            <Total>500000</Total>
                            <VATRate>10</VATRate>
                            <VATAmount>50000</VATAmount>
                            <Amount>500000</Amount>
                        </Product>
                    </Products>
                    <ArisingDate>05/06/2018</ArisingDate>
                    <Total>12750000</Total>
                    <VATRate>10</VATRate>
                    <VATAmount>1275000</VATAmount>
                    <Amount>14025000</Amount>
                    <AmountInWords>Mười bốn triệu không trăm hai mươi lăm nghìn đồng.</AmountInWords>
                </Invoice>
            </Inv>
            </Invoices>";
			
            EInvoiceLib lib = new EInvoiceLib();
            //Init library
            lib.Initialize("your-username", "your-password");
            // Import and publish invoices
            string response = lib.RemoteLaunchInvoices("01GTKT0/001", "PP/18E", XmlData);
            Console.WriteLine(response);
            Console.ReadLine();
        }
    }
}