SInvoice - Create invoice

Developing

POST

https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/createInvoice/0100109106-507

Request

Header Params

Body Params application/json

Example

{
    "generalInvoiceInfo": { 
        "transactionUuid": "859f390a-1e59-4a05-9663-1e9ec7afdb8g",
        "invoiceType": "01GTKT0",
        "templateCode": "01GTKT0/001",
        "invoiceSeries": "AB/21E",
        "invoiceIssuedDate": 1754446407000,
        "currencyCode": "VND",
        "adjustmentType": "1",
        "paymentStatus": true,
        "cusGetInvoiceRight": true,
        "reservationCode": "681DDYKLMOEFD",
        "validation": 1
    },
    "buyerInfo": { 
        "buyerName": "Tên khách hàng",
        "buyerLegalName": "Tên đơn vị",
        "buyerTaxCode": "0100109106",
        "buyerAddressLine": "An Khánh Hoài Đức Hà Nội",
        "buyerPostalCode": "2342324323",
        "buyerDistrictName": "Số 9, đường 11, VSIP Bắc Ninh, Thị xã Từ Sơn, Tỉnh",
        "buyerCityName": "Thành Phố Hà Nội",
        "buyerCountryCode": "84",
        "buyerPhoneNumber": "987999999",
        "buyerFaxNumber": "0458954",
        "buyerEmail": "minhltt@viettel.com.vn",
        "buyerBankName": "Ngân hàng Quân đội MB",
        "buyerBankAccount": "01578987871236547",
        "buyerIdType": "3",
        "buyerIdNo": "8888899999",
        "buyerCode": "832472343b_b",
        "buyerBirthDay": ""
    },
    "sellerInfo": { 
        "sellerLegalName": "Người bán hàng",
        "sellerTaxCode": "0100109106-507",
        "sellerAddressLine": "Thành Phố Hà Nội - Việt Nam",
        "sellerPhoneNumber": "0123456789",
        "sellerFaxNumber": "0123456789",
        "sellerEmail": "email@gmail.com",
        "sellerBankName": "Ngân hàng ",
        "sellerBankAccount": "012345678901",
        "sellerDistrictName": "",
        "sellerCityName": "Thành Phố Hà Nội",
        "sellerCountryCode": "84",
        "sellerWebsite": "sinvoice.viettel.vn"
    },
    "payments": [ 
        {
            "paymentMethod": "2",
            "paymentMethodName": "CK"
        }
    ],
    "itemInfo": [ 
        {
            "lineNumber": 1,
            "itemCode": "PCDELLV3653_i56400_R4H10DVDRW",
            "itemName": "Máy tính để bàn DELL VOSTRO 3653 Desktop Core i5-6400 upto3.30Ghz/ 4GB/ 1TB HDD/DVDRW/NVIDIA Geforce 705 2Gb/ Wireless-Bluetooth/ K/ M/1Yr Pro",
            "unitName": "Cái",
            "itemNote": "",
            "unitPrice": 10300000,
            "quantity": 1,
            "itemTotalAmountWithoutTax": 10300000,
            "taxPercentage": 10,
            "discount": 0
        }
    ],
    "metadata": [ 
    ],
    "meterReading": [ 
    ],
    "summarizeInfo": { 
    },
    "taxBreakdowns": [ 
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/InvoiceAPI/InvoiceWS/createInvoice/0100109106-507' \
--header 'Cookie: access_token:' \
--header 'Content-Type: application/json' \
--data-raw '{
    "generalInvoiceInfo": { 
        "transactionUuid": "859f390a-1e59-4a05-9663-1e9ec7afdb8g",
        "invoiceType": "01GTKT0",
        "templateCode": "01GTKT0/001",
        "invoiceSeries": "AB/21E",
        "invoiceIssuedDate": 1754446407000,
        "currencyCode": "VND",
        "adjustmentType": "1",
        "paymentStatus": true,
        "cusGetInvoiceRight": true,
        "reservationCode": "681DDYKLMOEFD",
        "validation": 1
    },
    "buyerInfo": { 
        "buyerName": "Tên khách hàng",
        "buyerLegalName": "Tên đơn vị",
        "buyerTaxCode": "0100109106",
        "buyerAddressLine": "An Khánh Hoài Đức Hà Nội",
        "buyerPostalCode": "2342324323",
        "buyerDistrictName": "Số 9, đường 11, VSIP Bắc Ninh, Thị xã Từ Sơn, Tỉnh",
        "buyerCityName": "Thành Phố Hà Nội",
        "buyerCountryCode": "84",
        "buyerPhoneNumber": "987999999",
        "buyerFaxNumber": "0458954",
        "buyerEmail": "minhltt@viettel.com.vn",
        "buyerBankName": "Ngân hàng Quân đội MB",
        "buyerBankAccount": "01578987871236547",
        "buyerIdType": "3",
        "buyerIdNo": "8888899999",
        "buyerCode": "832472343b_b",
        "buyerBirthDay": ""
    },
    "sellerInfo": { 
        "sellerLegalName": "Người bán hàng",
        "sellerTaxCode": "0100109106-507",
        "sellerAddressLine": "Thành Phố Hà Nội - Việt Nam",
        "sellerPhoneNumber": "0123456789",
        "sellerFaxNumber": "0123456789",
        "sellerEmail": "email@gmail.com",
        "sellerBankName": "Ngân hàng ",
        "sellerBankAccount": "012345678901",
        "sellerDistrictName": "",
        "sellerCityName": "Thành Phố Hà Nội",
        "sellerCountryCode": "84",
        "sellerWebsite": "sinvoice.viettel.vn"
    },
    "payments": [ 
        {
            "paymentMethod": "2",
            "paymentMethodName": "CK"
        }
    ],
    "itemInfo": [ 
        {
            "lineNumber": 1,
            "itemCode": "PCDELLV3653_i56400_R4H10DVDRW",
            "itemName": "Máy tính để bàn DELL VOSTRO 3653 Desktop Core i5-6400 upto3.30Ghz/ 4GB/ 1TB HDD/DVDRW/NVIDIA Geforce 705 2Gb/ Wireless-Bluetooth/ K/ M/1Yr Pro",
            "unitName": "Cái",
            "itemNote": "",
            "unitPrice": 10300000,
            "quantity": 1,
            "itemTotalAmountWithoutTax": 10300000,
            "taxPercentage": 10,
            "discount": 0
        }
    ],
    "metadata": [ 
    ],
    "meterReading": [ 
    ],
    "summarizeInfo": { 
    },
    "taxBreakdowns": [ 
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "errorCode": null,
    "description": null,
    "result": {
        "supplierTaxCode": "0100109106-507",
        "invoiceNo": "AB/21E0000248",
        "transactionID": "175462732971161684",
        "reservationCode": "X04QTK8GB1PE67J",
        "codeOfTax": null
    }
}

Modified at 2025-08-08 04:38:20

SInvoice - Kê khai thuế