Đối soát COD online

Đối soát file COD của GHN, GHTK, SPX, J&T, Viettel Post, Ninja Van (XLSX / CSV) với đơn của shop: thiếu tiền, thiếu đơn, đơn trùng, phí, thực nhận.

Kết quả

Bấm “Chạy” để xem kết quả.

Tải lên bảng đối soát COD của hãng vận chuyển bằng multipart statement (XLSX hoặc CSV; được gửi nhiều file) hoặc gửi statement_rows dạng JSON, cùng danh sách đơn của shop trong orders (file hoặc mảng JSON có mã đơn và / hoặc mã vận đơn và tiền COD dự kiến). Cột được nhận diện theo tên tiêu đề tiếng Việt hoặc tiếng Anh, không phân biệt dấu ("Mã vận đơn", "Mã đơn shop", "Tiền thu hộ", "Phí vận chuyển", "Phí hoàn", "Thực nhận", "Waybill No.", "COD Amount"…), dòng tiêu đề nằm ở bất kỳ đâu trong 40 dòng đầu, dòng tổng được bỏ qua. Hãng vận chuyển được nhận diện từ tiêu đề / tên file hoặc từ định dạng mã vận đơn (tracking-detect).

Kết quả gồm số tổng (COD, phí vận chuyển, phí thu hộ, phí hoàn, bảo hiểm, phí khác, thực nhận dự kiến = COD − phí, thực nhận theo file), kiểm tra từng dòng (thực nhận ≠ COD − phí, đơn hoàn chưa có phí hoàn), đơn trùng, và khi có orders: đơn khớp, đơn lệch tiền (cod_short, cod_over, đơn hoàn vẫn có COD, phí ship khác báo giá của bạn), đơn có trong danh sách shop nhưng thiếu trên file đối soát và ngược lại. bank_amount so khoản chuyển khoản ngân hàng với tổng thực nhận; tolerance cho phép chênh lệch làm tròn.

Mẫu file của các hãng có thể thay đổi: cột nhận diện được trả về trong columns, và statement_rows cho phép bạn tự đặt tên cột. File chỉ xử lý trong bộ nhớ, không lưu lại.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/vn-cod-reconcile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"carrier":"ghn","statement_rows":[{"Mã đơn GHN":"GAB12CD3","Mã đơn shop":"DH001","Tiền thu hộ":350000,"Phí vận chuyển":22000,"Thực nhận":328000},{"Mã đơn GHN":"GAB12CD4","Mã đơn shop":"DH002","Tiền thu hộ":199000,"Phí vận chuyển":22000,"Thực nhận":177000}],"orders":[{"order_code":"DH001","cod":350000},{"order_code":"DH002","cod":250000},{"order_code":"DH003","cod":120000}]}'

const res = await fetch('https://apibox.io.vn/v1/vn-cod-reconcile', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "carrier": "ghn",
    "statement_rows": [
      {
        "Mã đơn GHN": "GAB12CD3",
        "Mã đơn shop": "DH001",
        "Tiền thu hộ": 350000,
        "Phí vận chuyển": 22000,
        "Thực nhận": 328000
      },
      {
        "Mã đơn GHN": "GAB12CD4",
        "Mã đơn shop": "DH002",
        "Tiền thu hộ": 199000,
        "Phí vận chuyển": 22000,
        "Thực nhận": 177000
      }
    ],
    "orders": [
      {
        "order_code": "DH001",
        "cod": 350000
      },
      {
        "order_code": "DH002",
        "cod": 250000
      },
      {
        "order_code": "DH003",
        "cod": 120000
      }
    ]
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-cod-reconcile",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"carrier": "ghn", "statement_rows": [{"Mã đơn GHN": "GAB12CD3", "Mã đơn shop": "DH001", "Tiền thu hộ": 350000, "Phí vận chuyển": 22000, "Thực nhận": 328000}, {"Mã đơn GHN": "GAB12CD4", "Mã đơn shop": "DH002", "Tiền thu hộ": 199000, "Phí vận chuyển": 22000, "Thực nhận": 177000}], "orders": [{"order_code": "DH001", "cod": 350000}, {"order_code": "DH002", "cod": 250000}, {"order_code": "DH003", "cod": 120000}]},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-cod-reconcile');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"carrier":"ghn","statement_rows":[{"Mã đơn GHN":"GAB12CD3","Mã đơn shop":"DH001","Tiền thu hộ":350000,"Phí vận chuyển":22000,"Thực nhận":328000},{"Mã đơn GHN":"GAB12CD4","Mã đơn shop":"DH002","Tiền thu hộ":199000,"Phí vận chuyển":22000,"Thực nhận":177000}],"orders":[{"order_code":"DH001","cod":350000},{"order_code":"DH002","cod":250000},{"order_code":"DH003","cod":120000}]}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Hỗ trợ những hãng nào?

Mọi bảng đối soát có cột mã vận đơn hoặc mã đơn và cột COD / phí / thực nhận. Tiêu đề cột của GHN, GHTK, SPX (Shopee Express), J&T, Viettel Post, Ninja Van được nhận diện, cả tiếng Việt lẫn tiếng Anh.

Đơn được ghép thế nào?

Theo mã vận đơn trước, sau đó theo mã đơn của shop (mỗi cột có thể chứa loại mã kia). Mỗi đơn chỉ ghép một lần; dòng lặp lại được liệt kê là đơn trùng.

Dữ liệu có bị lưu không?

Không. File chỉ được đọc trong bộ nhớ cho request đó rồi bỏ đi.