VIETTEL MILITARY INDUSTRY AND TELECOM GROUP
               VIETTEL TELECOM
                  S-invoice
             Technical service description
                                               Ha Noi, 09/2018
                                           TABLE OF CONTENT
             TABLE OF CONTENT................................................................................................................2
             1  Terminology and abbreviations............................................................................................4
             2  Purpose and scope..................................................................................................................4
             3  The connection model............................................................................................................4
             4  The standards.........................................................................................................................6
              4.1  Date...................................................................................................................................6
              4.2  Data...................................................................................................................................6
              4.3  special characters..............................................................................................................7
              4.4  Disinfect transactions........................................................................................................7
              4.5  Connection security standards..........................................................................................7
             5  Specification of invoiced input..............................................................................................7
              5.1  Overview...........................................................................................................................7
              5.2  generalInvoiceInfo............................................................................................................9
              5.3  sellerInfo.........................................................................................................................13
              5.4  buyerInfo.........................................................................................................................15
              5.5  extAttribute.....................................................................................................................18
              5.6  payments.........................................................................................................................18
              5.7  deliveryInfo.....................................................................................................................19
              5.8  itemInfo...........................................................................................................................19
              5.9  taxBreakdowns................................................................................................................26
              5.10 summarizeInfo................................................................................................................29
              5.11 metadata..........................................................................................................................31
              5.12 meterReading..................................................................................................................33
             6  Function description............................................................................................................34
              6.1  The concept.....................................................................................................................34
              6.2  Issue / replace / adjust invoice (For HSM digital certificates)........................................35
              6.3  Webservice gets the invoice file......................................................................................38
                                S_invoice Technical service                            
                                               2/71
                 6.4   Webservice gets  the invoice file Portal..........................................................................40
                 6.5   Webservice gets converted invoice(pdf).........................................................................42
                 6.6   Webservice cancels invoice.............................................................................................44
                 6.7   Webservice searchs invoice.............................................................................................46
                 6.8   Web service metadata......................................................................................................51
                 6.9   Webservice draft invoicing.............................................................................................55
                 6.10 Webservice batch invoicing............................................................................................57
                 6.11 Webservice updates Tax declaration...............................................................................58
                 6.12 Webservice provides using invoice status.......................................................................59
                 6.13 Webservice gets invoice list in period.............................................................................61
                 6.14 Webservice sends email to customer...............................................................................63
                 6.15 Webservice invoicing signing with USB token..............................................................64
                 6.16 Webservice inserts signature to USB token....................................................................67
                 6.17 Convert font....................................................................................................................68
                 6.18 Update payment status....................................................................................................69
                 6.19 Hủy trạng thái thanh toán................................................................................................71
                 6.20 Preview draft invoice......................................................................................................72
                 6.21 Look up invoices by transactionUuid.............................................................................73
               7   List of system error returns................................................................................................74
               8   Mapping between information fields and invoice forms..................................................74
               9   API test with Postman.........................................................................................................75
               1
                                      S_invoice Technical service                            
                                                        3/71
              1 Terminology and abbreviations
                 No      Abbreviation                               Meaning
                               s
                1        XML            eXtensible Markup Language
                2        VAN            Taxation Value Added Network
                3        ICC            Invoice Certification Center
                4        PSD            Portable Security Device
                5        SGML           Standard Generalized Markup Language
                6        W3C            World Wide Web Consortium
                7        SInvoice       Viettel's electronic invoice service / system
                8        HTTH           Accounting and business management software system integrated with
                                        SInvoice system to issue invoices
              2 Purpose and scope
              Describe in detail the connection standard so that the systems can connect to Viettel's Mass Electronic
              Invoice service to ensure the correct release of information.
              3 The connection model  
              The connection model between external system and Sinvoice:
                  The role of Sinvoice system are receiving invoice data from outside and issued as invoice form 
                  that selected by the enterprise. The SInvoice System APIs are provided under the Restful 
                  Webservice standard, which supports both XML and Json.
                  Firstly, the enterprise performed the operation of declaring the invoice form on the website of 
                  SInvoice system including:
                  -  Declare invoice type
                  -  Choose invoice form
                  -  Declare invoice serials
                                   S_invoice Technical service                            
                                                   4/71