TikTok - Manual Upload Tool

A simple React and Express application to to create Shopify orders and generate fulfillments from TikTok Order CSV files.

Features:

• Import TikTok order export CSVs and create corresponding Shopify orders
• Generate TikTok Fulfillment Import CSVs for bulk fulfillment updates
• Support for multiple Shopify fulfillments per order
• Simple, CSV-driven workflow

Use Case:

• TikTok orders are not syncing to Shopify automatically. This tool helps import those orders into Shopify and generate fulfillment files to update TikTok once the orders are shipped.

Setup

Generate a Shopify Admin API Access Token with the following scopes:

• write_customers
• read_customers
• write_discounts
• read_discounts
• write_draft_orders
• read_draft_orders
• write_orders
• read_orders
• read_products

Environmental Variables .env

# Shopify
SHOPIFY_ADMIN_API_VERSION=2025-07
SHOPIFY_STORE=suavecito
SHOPIFY_ACCESS_TOKEN=
# NetSuite
NETSUITE_ACCT_ID=
# netsuite integration : Suavecito API - Web Services
NETSUITE_CONSUMER_KEY=
NETSUITE_CONSUMER_SECRET=
NETSUITE_ACCESS_TOKEN=
NETSUITE_TOKEN_SECRET=
# restlets
NETSUITE_RESTLET_URL=

Generate Types

npm run type-gen

Build

Client

cd client
npm run build

Server

cd server
npm run build

Run

cd server
npm start

Docker Build & Run

# build for x86 linux
docker buildx build --platform=linux/amd64 -t jriv/tiktok-manual-upload:latest .
# copy to server without repository
docker save jriv/tiktok-manual-upload:latest | ssh jriv@192.168.1.123 "docker load"

Run on Server

# run
docker run -p 3001:3001 --env-file .env tiktok-manual-upload:latest