ARITO API Integration Documentation
  • Introduce
  • List API
    • Authentication
    • Import Customer
    • Export Customer
    • Import Goods
    • Export Goods
    • Import Invoice
Powered by GitBook
On this page
  1. List API

Import Invoice

Last updated 1 year ago

Used to retrieve a list of customers based on specified conditions

Authorization

Type

Bearer Token

Token

{{access_token}}

Body

{
    "memvars": {
        "master": [
            {
                "api_code": 1,
                "so_ct": "API-001",
                "ngay_ct": "2023-05-23T00:00:00.000Z",
                "ma_nt": "VND",
                "ty_gia": 1,
                "ma_kh": "API-KH0001",
                "ma_nvbh": ""
            }
        ],
        "detail": [
            {
                "api_code": 1,
                "ma_vt": "API-VT0001",
                "dvt": "CAI",
                "ma_kho": "BAR2",
                "so_luong": 10,
                "gia_nt2": 20000,
                "tien_nt2": 200000
            },
            {
                "api_code": 1,
                "ma_vt": "API-VT0001",
                "dvt": "CAI",
                "ma_kho": "KTP",
                "so_luong": 5,
                "gia_nt2": 10000,
                "tien_nt2": 50000
            }
        ],
        "payment": [
            {
                "api_code": 1,
                "ma_httt": "TIENMAT",
                "t_tt_nt": 150000
            },
            {
                "api_code": 1,
                "ma_httt": "VISA",
                "t_tt_nt": 100000
            }
        ]
    }
}

Parameter description

  1. General information on the invoice: memvars.master

Name
(*)
Type
Description

api_code

string

The unique key for each invoice, within the same secret connecting to the API, this api_code is not allowed to be duplicated

so_ct

string

Invoice number

ngay_ct

datetime

Invoice date, ISO 8601 format

ma_nt

string

Currency code

ty_gia

numeric

Invoice Exchange Rate

ma_kh

string

Customer Purchase Code

ma_nvbh

string

Salesperson Code

  1. Invoice details: memvars.detail

This detailed data must not be left blank

Name
(*)
Type
Description

api_code

string

The key to the invoice, this key is set the same as the api_code string in the master. Within the same invoice, this string is identical

ma_vt

string

Product code

dvt

string

Unit code

ma_kho

string

Sales warehouse code

so_luong

numeric

Sales quantity

gia_nt2

numeric

Unit selling price

tien_nt2

nuemric

Total amount

  1. Payment information: memvars.payment

The payment data is allowed to be blank if the invoice does not track by payment method

Name
(*)
Type
Description

api_code

string

The key to the invoice, this key is set to be identical to the api_code string in the master. In the same invoice, this string is the same

ma_httt

string

Payment method code for invoices

t_tt_nt

numeric

The total amount to be paid using this method

{
    "code": 200,
    "msg": "Ok",
    "value": null,
    "data": null
}

Descripsion result

Tên
Diễn giải

code

When successfully executed, the status code is 200. For other codes, such as 401, 452... it indicates a failed operation, accompanied by a descriptive message explaining the result

msg

Description of API execution results

Method

Link

{{host}}/Invoice/Import