Purchase invoices

This set of APIs lets businesses automatically retrieve purchase invoices (input invoices issued by sellers to the business) from the General Department of Taxation (TCT) portal, for reconciliation, accounting and expense management.

Requirements

• The business has registered for the purchase invoice service with the XCyber provider (x-cyber). Other providers do not support this service yet.
• The e-invoice account on TINGEE is configured with the input-invoice service via the Create/Update account API.

Before you start

• Base URL: https://uat-open-api.tingee.vn (UAT) · https://open-api.tingee.vn (PROD)
• Authentication: Every request must include the x-client-id and x-request-timestamp headers and the x-signature signature (HMAC SHA512). See How to get an API Key & generate the signature.
• Account used: Every API accepts accountId (the e-invoice account ID). If empty, the system uses the default account.

Integration flow

1

Configure the account

Call the Create/Update account API with provider = "x-cyber" and services containing "input-invoice".

2

Connect the tax account

Call the input/connect API to connect your General Department of Taxation e-invoice portal account. You can skip this step if the information is already saved at the provider.

3

Sync invoices

Call the input/sync API to sync invoices for a time range.

4

Look up & download invoices

Use input/list to get the list, input/detail to view details and input/preview-base64 to download the PDF file.

Flow diagram

Purchase invoice retrieval flow

← Swipe to see more →

API catalog

Function	Method	Endpoint
Connect tax account	POST	/v1/e-invoice/input/connect
Disconnect tax account	POST	/v1/e-invoice/input/disconnect
Sync purchase invoices	POST	/v1/e-invoice/input/sync
List purchase invoices	POST	/v1/e-invoice/input/list
Purchase invoice details	POST	/v1/e-invoice/input/detail
Invoice rendition (PDF)	POST	/v1/e-invoice/input/preview-base64