Kết nối API KiotViet là gì? Public API và code PHP cho WordPress

Nếu bạn làm web cho shop bán lẻ dùng KiotViet, sớm muộn sẽ nhận một tin nhắn kiểu “nối API KiotViet giúp anh để web tự lấy hàng hoá với tồn kho”. Trước khi báo giá phải trả lời được hai câu: kết nối API KiotViet là gì, và gian hàng của khách có được dùng API không. Phần đầu bài viết cho chủ shop không biết code. Phần sau dành cho dev: lấy access token theo OAuth, hai header bắt buộc, phân trang hàng hoá, giới hạn 5.000 request GET mỗi giờ, code PHP chạy trong WordPress, và lúc nào nên dùng plugin cho đỡ việc.

Kết nối API KiotViet: Public API, access token và code PHP cho website WordPress, WooCommerce

Endpoint, tham số và giới hạn trong bài lấy từ trang Public API (ngành Bán buôn, Bán lẻ) trong hướng dẫn sử dụng KiotViet. Trang ghi cập nhật ngày 06/10/2026, mình đọc lại tháng 10/2026. KiotViet đang chuyển sang giao diện quản lý mới 2026, nên tên menu và vị trí nút có thể khác ảnh trong bài. Plugin nhắc ở phần cuối là sản phẩm mình viết, dùng Public API của KiotViet như mọi phần mềm bên ngoài khác. Code là mẫu rút gọn để nắm luồng, chạy thử trên bản sao website trước khi đưa lên site thật.

Kết nối API KiotViet là gì?

Nói gọn cho chủ shop: KiotViet mở một cổng để phần mềm khác (website, sàn thương mại điện tử, CRM) đọc và ghi dữ liệu của gian hàng mà không cần ai mở màn hình bán hàng. Cổng đó tên là Public API. “Kết nối API” là việc chủ gian hàng tạo một bộ mã cho phép rồi đưa cho bên làm web. Máy chủ website dùng bộ mã đó gọi sang KiotViet mỗi khi cần hàng hoá, tồn kho, hoặc khi gửi đơn đặt hàng.

Để duy trì blog nên mình có làm aff cho 1 số bên hosting. Nhưng dù aff mình cũng chọn 1 số nhà cung cấp uy tín về chất lượng và support nên các bạn cứ yên tâm nhé.

Nếu có mua hosting mà có trong list dưới đây các bạn click vào link trước khi mua để ủng hộ mình nhé. Mình cảm ơn nhiều

Bộ mã có ba phần, nằm ở Thiết lập → Cửa hàng → Kết nối API trên KiotViet:

  • 🏪 Tên kết nối là tên gian hàng. Mọi lệnh gọi API đều gửi tên này trong header Retailer.
  • 🔑 Client ID là mã định danh của kết nối.
  • 🔒 Mã bảo mật, tài liệu Public API gọi là client_secret. Ai có Client ID và mã này là đọc, sửa được dữ liệu gian hàng qua API, nên giữ nó như mật khẩu.

Theo tài liệu Kết nối API, mã chỉ hiện trên tài khoản vai trò admin của chủ gian hàng, và lúc tạo phải nhập mã xác thực gửi về số điện thoại trên hợp đồng. Từng bước bấm, kèm ảnh, có ở bài lấy Client ID, Client Secret KiotViet.

Infographic Kết nối API của KiotViet: 4 bước Truy cập, Xác thực OTP, Tạo mã bảo mật, Lấy thông tin, và phạm vi Nhóm hàng, Hàng hóa, Đặt hàng, Hóa đơn, Khách hàng, Phiếu nhập hàng
Bốn bước tạo mã kết nối và phạm vi đọc, ghi của Public API. Ảnh: tài liệu Kết nối API của KiotViet.

KiotViet có API không, gói nào được dùng?

Có. Bảng phí ngành bán lẻ trên kiotviet.vn/phi-dich-vu (mình xem tháng 10/2026) chỉ ghi “Hỗ trợ kết nối API” ở thẻ Gói cao cấp, còn khối tính năng ghi “Public API (Gói Cao cấp)”. Gian hàng đang ở gói khác thì hỏi KiotViet trước khi nhận việc. Giá gói thay đổi theo đợt nên mình không chép số vào đây.

Bài này chỉ nói Public API ngành Bán buôn, Bán lẻ, máy chủ public.kiotapi.com. KiotViet FnB (nhà hàng, cafe) có trang tài liệu API riêng, đừng áp nguyên code trong bài sang gian hàng FnB.

KiotViet Public API đọc, ghi được những gì?

Phần giới thiệu của tài liệu kể sáu nhóm đọc, ghi: nhóm hàng, hàng hoá, đặt hàng, hoá đơn, khách hàng, phiếu nhập hàng. Đi kèm là các API phụ như chi nhánh, người dùng, tài khoản ngân hàng, thu khác, webhook, nhóm khách hàng, sổ quỹ. Mục lục còn dài hơn phần giới thiệu: bảng giá, chuyển hàng, trả hàng, đặt hàng nhập, location, thiết lập cửa hàng, voucher, thương hiệu, nhà cung cấp, thuế, hoá đơn điện tử và QR thanh toán đều có API riêng.

Mấy API hay dùng khi nối website bán hàng:

Việc cần làmAPI
Lấy access tokenPOST https://id.kiotviet.vn/connect/token
Danh sách hàng hoá, kèm tồn kho, bảng giáGET /products
Một hàng hoá theo mã hàngGET /products/code/{code}
Tồn kho theo chi nhánhGET /productOnHands
Nhóm hàngGET /categories
Chi nhánhGET /branches
Bảng giá, giá từng hàng hoá trong bảngGET /pricebooks, GET /pricebooks/{id}
Tạo đơn đặt hàngPOST /orders
Đăng ký webhookPOST /webhooks

Mọi API trừ lấy token đều nằm dưới https://public.kiotapi.com.

⚠️ Lúc tạo mã có ô “Cho phép truy xuất thông tin khách hàng, hoá đơn, đặt hàng từ gian hàng của bạn”. Không tick thì màn hình Kết nối API hiện dòng đỏ “Bên thứ ba không được phép truy xuất thông tin khách hàng, hoá đơn, đơn đặt hàng từ cửa hàng của bạn”. Web cần đọc ba nhóm dữ liệu này thì nhắc chủ shop tick ô đó.

Màn hình Thông tin kết nối API của KiotViet: Tên kết nối, Trạng thái Đang hoạt động, Client ID và Mã bảo mật che dấu sao, dòng xanh cho phép bên thứ ba truy xuất thông tin khách hàng, hoá đơn, đơn đặt hàng
Kết nối xong: trạng thái Đang hoạt động, dòng xanh cho phép truy xuất. Ảnh: tài liệu Kết nối API của KiotViet.

Bước 1: lấy access token KiotViet (client_credentials)

KiotViet Public API xác thực theo OAuth 2.0. Website dùng luồng client_credentials: máy chủ tự đổi Client ID và Mã bảo mật lấy token, không có màn hình đăng nhập nào hiện ra cho người dùng.

  • Gửi POST https://id.kiotviet.vn/connect/token với header Content-Type: application/x-www-form-urlencoded.
  • Body gồm scopes=PublicApi.Access, grant_type=client_credentials, client_id và client_secret. Tài liệu viết tên tham số là scopes, có chữ s ở cuối; code bên dưới gửi đúng như vậy.
  • Phản hồi có access_token, token_type là Bearer và expires_in bằng 86400 giây, tức 24 giờ.
  • Tài liệu không nhắc refresh token. Hết hạn thì gọi lại API này; máy chủ đã giữ sẵn Client ID và Mã bảo mật nên chủ shop không phải làm gì.

Ba thông tin để trong wp-config.php, không lưu trong database, không commit lên Git:

define( 'DEVVN_KV_RETAILER', 'ten-gian-hang' );
define( 'DEVVN_KV_CLIENT_ID', 'YOUR_CLIENT_ID' );
define( 'DEVVN_KV_CLIENT_SECRET', 'YOUR_CLIENT_SECRET' );

Hàm dưới cất token vào transient và cho nó hết hạn sớm hơn KiotViet 5 phút, để lệnh gọi không mang theo token sắp hết hạn:

define( 'DEVVN_KV_TOKEN_URL', 'https://id.kiotviet.vn/connect/token' );
define( 'DEVVN_KV_TOKEN_KEY', 'devvn_kv_access_token' );
define( 'DEVVN_KV_TOKEN_MARGIN', 5 * MINUTE_IN_SECONDS );
define( 'DEVVN_KV_TIMEOUT', 20 );

/**
 * Lấy access token KiotViet: còn trong transient thì dùng lại, hết thì xin token mới.
 *
 * @return string|WP_Error Access token hoặc lỗi xác thực.
 */
function devvn_kv_get_token() {
	$token = get_transient( DEVVN_KV_TOKEN_KEY );
	if ( $token ) {
		return $token;
	}
	$res = wp_remote_post(
		DEVVN_KV_TOKEN_URL,
		array(
			'timeout' => DEVVN_KV_TIMEOUT,
			'body'    => array(
				'scopes'        => 'PublicApi.Access',
				'grant_type'    => 'client_credentials',
				'client_id'     => DEVVN_KV_CLIENT_ID,
				'client_secret' => DEVVN_KV_CLIENT_SECRET,
			),
		)
	);
	if ( is_wp_error( $res ) ) {
		return $res;
	}
	$json = json_decode( wp_remote_retrieve_body( $res ), true );
	if ( 200 !== (int) wp_remote_retrieve_response_code( $res ) || empty( $json['access_token'] ) ) {
		return new WP_Error( 'kv_token', 'Không lấy được access token, kiểm lại Client ID và Mã bảo mật.' );
	}
	$ttl = isset( $json['expires_in'] ) ? (int) $json['expires_in'] : HOUR_IN_SECONDS;
	set_transient( DEVVN_KV_TOKEN_KEY, $json['access_token'], max( MINUTE_IN_SECONDS, $ttl - DEVVN_KV_TOKEN_MARGIN ) );
	return $json['access_token'];
}

Truyền mảng vào body của wp_remote_post() thì WordPress tự mã hoá dạng form và gắn header application/x-www-form-urlencoded, khớp với ví dụ trong tài liệu.

Bước 2: header Retailer, Authorization và giới hạn 5.000 request/giờ

Trừ API lấy token, mọi lệnh gọi phải có hai header như sau:

Retailer: ten-gian-hang
Authorization: Bearer eyJhbGciOi...

Các hàm GET bị giới hạn 5.000 request mỗi giờ. Tính thử với gian hàng 10.000 mã hàng: kéo theo trang 100 dòng tốn 100 request, còn gọi chi tiết từng mã bằng GET /products/{id} thì tốn 10.000 request, gấp đôi hạn mức của cả giờ. Kéo theo trang, đừng gọi từng mã.

Tài liệu không có bảng mã lỗi chung, cũng không ghi KiotViet trả mã HTTP nào khi vượt hạn mức. Hàm gọi chung dưới đây chỉ xử lý riêng HTTP 401 theo cách thông thường của Bearer token: xoá token đang lưu, xin token mới, gọi lại đúng một lần. Mã khác thành WP_Error mang mã kv_http_ cộng số HTTP, kèm đoạn đầu phản hồi để đọc log.

define( 'DEVVN_KV_API_URL', 'https://public.kiotapi.com/' );
define( 'DEVVN_KV_ERROR_LENGTH', 300 );

/**
 * Gọi một API của KiotViet Public API; gặp HTTP 401 thì xin token mới và gọi lại một lần.
 *
 * @param string $method GET, POST, PUT hoặc DELETE.
 * @param string $path   Đường dẫn sau tên miền API, ví dụ 'products'.
 * @param array  $data   Tham số URL (GET) hoặc body JSON (phương thức khác).
 * @param bool   $retry  Còn được gọi lại khi token hỏng hay không.
 * @return array|WP_Error Mảng JSON KiotViet trả về, hoặc lỗi.
 */
function devvn_kv_request( $method, $path, array $data = array(), $retry = true ) {
	$token = devvn_kv_get_token();
	if ( is_wp_error( $token ) ) {
		return $token;
	}
	$url  = DEVVN_KV_API_URL . ltrim( $path, '/' );
	$args = array(
		'method'  => $method,
		'timeout' => DEVVN_KV_TIMEOUT,
		'headers' => array(
			'Retailer'      => DEVVN_KV_RETAILER,
			'Authorization' => 'Bearer ' . $token,
		),
	);
	if ( 'GET' === $method && $data ) {
		$url .= '?' . http_build_query( $data, '', '&' );
	} elseif ( 'GET' !== $method && $data ) {
		$args['headers']['Content-Type'] = 'application/json';
		$args['body']                    = wp_json_encode( $data );
	}
	$res = wp_remote_request( $url, $args );
	if ( is_wp_error( $res ) ) {
		return $res;
	}
	$code = (int) wp_remote_retrieve_response_code( $res );
	if ( 401 === $code && $retry ) {
		delete_transient( DEVVN_KV_TOKEN_KEY );
		return devvn_kv_request( $method, $path, $data, false );
	}
	$body = wp_remote_retrieve_body( $res );
	if ( $code < 200 || $code >= 300 ) {
		return new WP_Error( 'kv_http_' . $code, wp_html_excerpt( $body, DEVVN_KV_ERROR_LENGTH ), array( 'status' => $code ) );
	}
	$json = json_decode( $body, true );
	return is_array( $json ) ? $json : new WP_Error( 'kv_json', 'Phản hồi không phải JSON.', array( 'status' => $code ) );
}
  • Timeout đặt 20 giây. Mặc định của wp_remote_request() chỉ 5 giây, dễ cắt ngang một trang 100 hàng hoá kèm tồn kho và bảng giá.
  • GET gửi tham số trên URL, các phương thức khác gửi body JSON. Mỗi API ghi có cấu trúc body riêng; đăng ký webhook chẳng hạn phải bọc mọi trường trong object Webhook. Cách đăng ký, kiểm chữ ký và nhận webhook có ở bài webhook KiotViet.
  • Chỉ gọi từ máy chủ. Đưa Mã bảo mật hay token xuống JavaScript ở trình duyệt thì người nào mở mã nguồn trang cũng đọc được, rồi sửa được dữ liệu gian hàng.

Bước 3: phân trang hàng hoá bằng pageSize và currentItem

GET /products trả hàng hoá theo trang. Các tham số nên biết:

  • pageSize mặc định 20, tối đa 100 dòng một trang.
  • currentItem là vị trí bắt đầu lấy. Trang sau gửi currentItem bằng tổng số dòng đã nhận.
  • includeInventory kèm mảng inventories với tồn từng chi nhánh (branchId, onHand, reserved…), còn includePricebook kèm mảng priceBooks.
  • isActive lọc hàng đang kinh doanh, categoryId lọc theo nhóm hàng, lastModifiedFrom chỉ lấy hàng sửa từ một mốc thời gian.
  • includeRemoveIds trả thêm removeId, tức danh sách ID hàng hoá đã xoá tính theo lastModifiedFrom.
  • Phản hồi có total (tổng số hàng hoá), pageSize và mảng data.

Hàng hoá cùng loại cần để ý. Tài liệu có bộ lọc masterProductId (hàng hoá cùng loại) và masterUnitId (hàng hoá đơn vị), mảng units cũng ghi ID, mã hàng riêng cho từng đơn vị tính. Nghĩa là mỗi biến thể, mỗi đơn vị tính là một mã hàng riêng. Muốn ghép thành sản phẩm biến thể trên WooCommerce thì tự gom theo các ID này.

Đoạn dưới quét toàn bộ hàng hoá đang kinh doanh, cộng onHand các chi nhánh rồi ghi vào sản phẩm, biến thể WooCommerce có SKU trùng mã hàng (code). Chạy bằng WP-CLI để không vướng giới hạn thời gian của PHP khi chạy qua trình duyệt:

define( 'DEVVN_KV_PAGE_SIZE', 100 );

/**
 * Duyệt toàn bộ hàng hoá KiotViet theo trang, mỗi trang gọi $callback một lần.
 *
 * @param callable $callback Hàm nhận mảng hàng hoá của một trang.
 * @param array    $filters  Tham số lọc thêm cho GET /products.
 * @return int|WP_Error Số hàng hoá đã đọc, hoặc lỗi của trang hỏng.
 */
function devvn_kv_walk_products( callable $callback, array $filters = array() ) {
	$current = 0;
	do {
		$page = devvn_kv_request(
			'GET',
			'products',
			array_merge(
				$filters,
				array(
					'pageSize'    => DEVVN_KV_PAGE_SIZE,
					'currentItem' => $current,
				)
			)
		);
		if ( is_wp_error( $page ) ) {
			return $page;
		}
		$rows = isset( $page['data'] ) ? (array) $page['data'] : array();
		if ( $rows ) {
			call_user_func( $callback, $rows );
		}
		$current += count( $rows );
		$total    = isset( $page['total'] ) ? (int) $page['total'] : 0;
	} while ( $rows && $current < $total );
	return $current;
}

/**
 * Tìm sản phẩm, biến thể WooCommerce theo danh sách SKU bằng một truy vấn.
 *
 * @param array $skus Danh sách SKU (mã hàng KiotViet).
 * @return WC_Product[] Mảng SKU => sản phẩm, bỏ qua sản phẩm cha có biến thể.
 */
function devvn_kv_find_by_sku( array $skus ) {
	if ( ! $skus ) {
		return array();
	}
	$ids = get_posts(
		array(
			'post_type'      => array( 'product', 'product_variation' ),
			'post_status'    => 'any',
			'fields'         => 'ids',
			'posts_per_page' => -1,
			'no_found_rows'  => true,
			'meta_query'     => array(
				array(
					'key'     => '_sku',
					'value'   => array_map( 'strval', $skus ),
					'compare' => 'IN',
				),
			),
		)
	);
	_prime_post_caches( $ids, false, true );
	$found = array();
	foreach ( $ids as $id ) {
		$product = wc_get_product( $id );
		if ( $product && ! $product->is_type( 'variable' ) ) {
			$found[ $product->get_sku() ] = $product;
		}
	}
	return $found;
}

/**
 * Ghi tồn kho vào sản phẩm, biến thể WooCommerce theo SKU; số không đổi thì bỏ qua.
 *
 * @param array $stock Mảng SKU => số lượng.
 * @return void
 */
function devvn_kv_apply_stock( array $stock ) {
	foreach ( devvn_kv_find_by_sku( array_keys( $stock ) ) as $sku => $product ) {
		if ( ! isset( $stock[ $sku ] ) || ( $product->get_manage_stock() && (int) $product->get_stock_quantity() === (int) $stock[ $sku ] ) ) {
			continue;
		}
		$product->set_manage_stock( true );
		$product->set_stock_quantity( (int) $stock[ $sku ] );
		$product->save();
	}
}

/**
 * Cộng onHand các chi nhánh của một trang hàng hoá rồi ghi vào tồn kho WooCommerce.
 *
 * @param array $rows Mảng data của GET /products có includeInventory.
 * @return void
 */
function devvn_kv_save_stock( array $rows ) {
	$stock = array();
	foreach ( $rows as $row ) {
		if ( ! empty( $row['code'] ) ) {
			$inventories                    = isset( $row['inventories'] ) ? (array) $row['inventories'] : array();
			$stock[ (string) $row['code'] ] = max( 0, (int) floor( array_sum( array_column( $inventories, 'onHand' ) ) ) );
		}
	}
	devvn_kv_apply_stock( $stock );
}

/**
 * Lệnh "wp devvn-kv sync-stock": quét hàng hoá đang kinh doanh và ghi tồn kho về WooCommerce.
 *
 * @return void
 */
function devvn_kv_cli_sync_stock() {
	$done = devvn_kv_walk_products(
		'devvn_kv_save_stock',
		array(
			'includeInventory' => 'true',
			'isActive'         => 'true',
		)
	);
	if ( is_wp_error( $done ) ) {
		WP_CLI::error( $done->get_error_code() . ': ' . $done->get_error_message() );
	}
	WP_CLI::success( sprintf( 'Đã đọc %d hàng hoá từ KiotViet.', $done ) );
}

if ( defined( 'WP_CLI' ) && WP_CLI ) {
	WP_CLI::add_command( 'devvn-kv sync-stock', 'devvn_kv_cli_sync_stock' );
}
  • Lệnh chạy là wp devvn-kv sync-stock. Trang nào lỗi thì dừng ở trang đó và in mã lỗi.
  • Mỗi trang 100 dòng chỉ tốn một truy vấn tìm theo SKU, cache meta được nạp trước rồi mới đọc. Tồn không đổi thì không ghi.
  • Sản phẩm cha của biến thể được bỏ qua, tồn ghi vào từng biến thể.
  • Code cộng mọi chi nhánh, kể cả chi nhánh đang âm kho. Shop chỉ bán online từ vài chi nhánh thì lọc theo branchId trước khi cộng.
  • Phân trang theo vị trí nên hàng hoá thêm, xoá giữa lúc quét có thể làm một dòng trượt sang trang khác. Tồn được ghi theo giá trị (không cộng trừ), chạy lại lệnh không sinh sai số.
  • ⚠️ Tài liệu không nói ngày sửa của hàng hoá có đổi khi chỉ tồn kho đổi. Đừng dựa vào lastModifiedFrom để bắt thay đổi tồn; phần đó để webhook stock.update lo.

Tự code hay dùng plugin?

Gọi được API là phần dễ. Tốn công là các ca lệch giữa hai hệ thống: biến thể, nhiều chi nhánh, nhiều bảng giá, webhook bị KiotViet tắt, địa chỉ khách mà KiotViet không nhận. Tự viết hợp khi web không chạy WooCommerce, hoặc chỉ cần một luồng lẻ như hiện tồn kho trên một landing page. Web WooCommerce cần đủ hàng hoá, giá, tồn kho và đơn hàng thì danh sách việc dài hơn nhiều.

Với plugin đồng bộ KiotViet cho WooCommerce của mình (bản 1.3.4), những phần sau đã có sẵn:

  • ✅ Nhập “Retailer”, “Client ID”, “Client Secret” ở tab “Cài đặt API” rồi bấm “Kiểm tra kết nối”. Token tự làm mới.
  • ✅ Hàng hoá cùng loại trên KiotViet thành sản phẩm biến thể, thuộc tính tạo tự động, SKU là mã hàng KiotViet.
  • ✅ Tồn kho cộng từ các chi nhánh anh em chọn, có ô bỏ qua kho âm, trừ hàng tạm giữ (reserved) và hỗ trợ tồn số lẻ.
  • ✅ “Mapping Giá” lấy giá niêm yết hoặc một bảng giá cho giá thường, một nguồn riêng cho giá khuyến mãi.
  • ✅ Webhook vào hàng đợi chạy nền, sự kiện trùng được gộp. Webhook bị KiotViet tắt thì plugin tự đăng ký lại, mặc định kiểm mỗi 1 giờ.
  • ✅ Đơn web lên KiotViet thành phiếu Đặt hàng. Phường/xã KiotViet không nhận thì plugin bỏ bớt phần đó rồi gửi lại.

Giới hạn cũng nói luôn: plugin chỉ chạy với KiotViet bán buôn, bán lẻ, kéo hàng hoá một chiều từ KiotViet về web, và không lấy giá vốn, đơn vị tính.

Tab Cài đặt API của plugin đồng bộ KiotViet cho WooCommerce: ô Retailer, Client ID, Client Secret đã che giá trị, ô Chi nhánh và nút Kiểm tra kết nối
Phần OAuth trong plugin: điền Retailer, Client ID, Client Secret, chọn Chi nhánh, bấm Kiểm tra kết nối. Giá trị đã che.

Dev cần tuỳ biến mà không sửa lõi thì dùng 17 filter của plugin. Ví dụ devvn_kiotviet_sync_order_payload sửa toàn bộ dữ liệu đơn gửi lên, devvn_kiotviet_sync_order_has_paid_statuses chọn trạng thái đơn được tính là đã thanh toán khi tự động đăng, devvn_kiotviet_sync_order_description (từ bản 1.3.4) sửa ghi chú đơn. Đoạn dưới thêm số đơn web vào ghi chú phiếu Đặt hàng trên KiotViet:

/**
 * Thêm số đơn WooCommerce vào ghi chú phiếu Đặt hàng plugin gửi lên KiotViet.
 *
 * @param string   $description Ghi chú plugin đã dựng.
 * @param WC_Order $order       Đơn WooCommerce đang đăng.
 * @return string
 */
function devvn_kv_add_order_number( $description, $order ) {
	return trim( $description . "\nĐơn web #" . $order->get_order_number() );
}
add_filter( 'devvn_kiotviet_sync_order_description', 'devvn_kv_add_order_number', 10, 2 );

Danh sách đủ 17 filter, tham số từng cái, có ở trang hook cho lập trình viên trong tài liệu plugin. Phần nhập API có ở trang cài đặt API. Còn đang cân nhắc giữa KiotViet Web, tự code và plugin thì xem bài kết nối KiotViet với website.

Câu hỏi thường gặp

KiotViet open API có phải Public API không?

Tài liệu chính thức cho bán buôn, bán lẻ trên kiotviet.vn mang tên Public API, máy chủ public.kiotapi.com. Gõ “kiotviet open api” hay “api kiotviet” thì trang cần đọc vẫn là trang Public API này.

KiotViet API document nằm ở đâu?

Ở trang Public API trong mục Kết nối API của hướng dẫn sử dụng KiotViet. Trang dài, chia từ mục 2.1 tới 2.29: mục 2.2 là lấy token, 2.4 là hàng hoá, 2.11 là webhook. Cách tạo mã nằm ở trang Kết nối API cùng mục.

Có môi trường thử (sandbox) không?

Trang Public API không nhắc môi trường thử. API ghi (thêm hàng hoá, đặt hàng, hoá đơn) chạy thẳng vào dữ liệu thật của gian hàng. Thử các API đọc trước, chỉ gọi API ghi khi đã chắc dữ liệu gửi đi.

Gian hàng KiotViet FnB dùng được code này không?

Không. Code và plugin trong bài chỉ dùng Public API ngành Bán buôn, Bán lẻ. FnB có trang tài liệu API riêng trên kiotviet.vn.

Anh em đang tích hợp API KiotViet mà vướng ở token, phân trang hay header nào cứ để lại bình luận. Nhớ che Client ID, Mã bảo mật và token trước khi dán log nhé. 🚀

Bài viết trong series

Kết nối WooCommerce với KiotViet

0/6đã đọc
  1. 1 KiotViet Sync đã đóng: web WooCommerce đang dùng nên làm gì? Đang đọc Đã đọc
  2. 2 Kết nối KiotViet với website: 3 cách và 6 bước nối WooCommerce Đang đọc Đã đọc
  3. 3 Đồng bộ tồn kho KiotViet với website: cơ chế và cách xử lý khi lệch Đang đọc Đã đọc
  4. 4 Đồng bộ sản phẩm KiotViet về WooCommerce: biến thể, ảnh, bảng giá Đang đọc Đã đọc
  5. 5 Đồng bộ đơn hàng KiotViet: đẩy đơn website thành phiếu Đặt hàng Đang đọc Đã đọc
  6. 6 Kết nối API KiotViet là gì? Public API và code PHP cho WordPress Đang đọc Đã đọc
Sản phẩm nổi bật của Toản
x