chore: initial commit

2026-07-30 17:59:42 +08:00
commit 155f06846d
62 changed files with 7852 additions and 0 deletions
@@ -0,0 +1,248 @@
+import { apiRequest } from '@/api/http'
+
+export type ApiFirstLegStatus = 'DRAFT' | 'SUBMITTED' | 'APPROVED' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED' | 'PROCESSING' | 'COMPLETED'
+export type ApiTransportMode = 'SEA' | 'AIR' | 'RAIL' | 'TRUCK'
+export type ApiPickupMethod = 'SELF_EXPRESS' | 'PICKUP' | 'SELF_TRUCK'
+export type ApiTaxMode = 'BUY_DECLARATION' | 'TAX_REFUND'
+export type ApiContainerMode = 'FULL_CONTAINER' | 'LCL'
+export type ApiDestinationType = 'FBA' | 'OVERSEAS' | 'PRIVATE'
+
+export interface PageResult<T> {
+  records: T[]
+  page: number
+  size: number
+  total: number
+  pages: number
+}
+
+export interface MerchantWarehouse {
+  id: number | string
+  warehouseCode: string
+  warehouseName: string
+  warehouseType: string
+  countryCode: string
+  timezone: string | null
+  contactName: string | null
+  contactPhone: string | null
+  contactEmail: string | null
+  status: 'ACTIVE' | 'INACTIVE'
+  remark: string | null
+  updatedAt: string | null
+}
+
+export interface MerchantWarehouseAddress {
+  countryCode: string
+  stateProvince: string | null
+  city: string | null
+  district: string | null
+  postalCode: string | null
+  addressLine1: string
+  addressLine2: string | null
+}
+
+export interface MerchantWarehouseCapability {
+  capabilityCode: string
+  capabilityName: string
+  enabled: boolean
+  cutoffTime: string | null
+  description: string | null
+}
+
+export interface MerchantWarehouseDetail {
+  warehouse: MerchantWarehouse
+  addresses: MerchantWarehouseAddress[]
+  capabilities: MerchantWarehouseCapability[]
+}
+
+export interface MerchantPartner {
+  id: number | string
+  partnerCode: string
+  partnerName: string
+  partnerType: string
+  contactName: string | null
+  contactPhone: string | null
+  contactEmail: string | null
+  countryCode: string
+  province: string | null
+  city: string | null
+  district: string | null
+  addressLine: string
+  postalCode: string | null
+  status: 'ACTIVE' | 'INACTIVE'
+}
+
+export interface FirstLegOrderPartyPayload {
+  companyName: string
+  contactName: string
+  phone: string
+  email?: string
+  countryCode: string
+  province?: string
+  city: string
+  district?: string
+  addressLine: string
+  postalCode?: string
+}
+
+export interface FirstLegOrderCargoPayload {
+  cargoName: string
+  hsCode?: string
+  packageType: string
+  packageCount: number
+  grossWeightKg: number
+  volumeCbm: number
+  declaredValue?: number
+  currency?: string
+  dangerousGoods?: boolean
+  cargoRemark?: string
+  skuNo?: string
+  cargoNameEn?: string
+  totalQuantity?: number
+  netWeightKg?: number
+}
+
+export interface FirstLegOrderSaveRequest {
+  customerId?: number | string
+  customerName: string
+  transportMode: ApiTransportMode
+  tradeTerm?: string
+  destinationCountryCode: string
+  destinationWarehouseId?: number | string
+  destinationWarehouseName: string
+  expectedShipDate?: string
+  customerRemark?: string
+  sender: FirstLegOrderPartyPayload
+  receiver: FirstLegOrderPartyPayload
+  cargoes: FirstLegOrderCargoPayload[]
+  pickupMethod: ApiPickupMethod
+  receivingWarehouseId: number | string
+  receivingWarehouseName: string
+  receivingWarehouseAddress?: string | null
+  receivingTime?: string | null
+  channelCode: string
+  channelName: string
+  taxMode: ApiTaxMode
+  containerMode?: ApiContainerMode
+  customsInspection: boolean
+  destinationType: ApiDestinationType
+  amazonWarehouseCode?: string
+  shipmentId?: string
+  referenceId?: string
+}
+
+export interface MerchantFirstLegOrder {
+  id: number | string
+  orderNo: string | null
+  customerId: number | string | null
+  customerName: string
+  status: ApiFirstLegStatus
+  transportMode: ApiTransportMode
+  tradeTerm: string | null
+  destinationCountryCode: string
+  destinationWarehouseId: number | string | null
+  destinationWarehouseName: string
+  expectedShipDate: string | null
+  customerRemark: string | null
+  pickupMethod: ApiPickupMethod
+  receivingWarehouseId: number | string
+  receivingWarehouseName: string
+  channelCode: string
+  channelName: string
+  taxMode: ApiTaxMode
+  containerMode: ApiContainerMode | null
+  customsInspection: boolean
+  destinationType: ApiDestinationType
+  amazonWarehouseCode: string | null
+  shipmentId: string | null
+  referenceId: string | null
+  expressCompany?: string | null
+  expressTrackingNo?: string | null
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface MerchantFirstLegOrderCargo extends FirstLegOrderCargoPayload {
+  id: number | string
+  itemNo: number
+}
+
+export interface MerchantFirstLegOrderParty extends FirstLegOrderPartyPayload {
+  id: number | string
+  partyType: 'SENDER' | 'RECEIVER' | string
+}
+
+export interface MerchantOrderStatusHistory {
+  id: number | string
+  fromStatus: ApiFirstLegStatus | null
+  toStatus: ApiFirstLegStatus
+  action: string
+  reason: string | null
+  operatorName: string | null
+  occurredAt: string
+}
+
+export interface MerchantFirstLegOrderDetail {
+  order: MerchantFirstLegOrder
+  cargoes: MerchantFirstLegOrderCargo[]
+  parties: MerchantFirstLegOrderParty[]
+  internalNotes: []
+  statusHistory: MerchantOrderStatusHistory[]
+}
+
+export interface FirstLegOrderQuery {
+  keyword?: string
+  status?: ApiFirstLegStatus
+  customerId?: number | string
+  destinationWarehouseId?: number | string
+  createdFrom?: string
+  createdTo?: string
+  page?: number
+  size?: number
+}
+
+export function getMerchantWarehouses() {
+  return apiRequest<PageResult<MerchantWarehouse>>({ method: 'GET', url: '/merchant/v1/warehouses', params: { page: 1, size: 200, status: 'ACTIVE' } })
+}
+
+export function getMerchantWarehouseDetail(id: number | string) {
+  return apiRequest<MerchantWarehouseDetail>({ method: 'GET', url: `/merchant/v1/warehouses/${id}` })
+}
+
+export function getMerchantPartnerCandidates(type: 'SHIPPER' | 'CONSIGNEE') {
+  return apiRequest<MerchantPartner[]>({ method: 'GET', url: '/merchant/v1/partners/candidates', params: { type } })
+}
+
+export function getMerchantFirstLegOrders(params: FirstLegOrderQuery = {}) {
+  return apiRequest<PageResult<MerchantFirstLegOrder>>({ method: 'GET', url: '/merchant/v1/orders/first-leg', params: { page: 1, size: 200, ...params } })
+}
+
+export function getMerchantFirstLegOrder(id: number | string) {
+  return apiRequest<MerchantFirstLegOrderDetail>({ method: 'GET', url: `/merchant/v1/orders/first-leg/${id}` })
+}
+
+export function createMerchantFirstLegOrder(payload: FirstLegOrderSaveRequest) {
+  return apiRequest<number | string>({
+    method: 'POST',
+    url: '/merchant/v1/orders/first-leg',
+    data: payload,
+    headers: { 'Idempotency-Key': createIdempotencyKey('first-leg-create') },
+  })
+}
+
+export function updateMerchantFirstLegOrder(id: number | string, payload: FirstLegOrderSaveRequest) {
+  return apiRequest<void>({ method: 'PUT', url: `/merchant/v1/orders/first-leg/${id}`, data: payload })
+}
+
+export function submitMerchantFirstLegOrder(id: number | string) {
+  return apiRequest<void>({
+    method: 'POST',
+    url: `/merchant/v1/orders/first-leg/${id}/submit`,
+    headers: { 'Idempotency-Key': createIdempotencyKey(`first-leg-submit-${id}`) },
+  })
+}
+
+function createIdempotencyKey(scope: string) {
+  const randomPart = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`
+  return `${scope}-${randomPart}`
+}