外掛標籤
開發者團隊
② 後台搜尋「Fuuffy Integration for WooCommerce」→ 直接安裝（推薦）
原文外掛簡介
Fuuffy Integration for WooCommerce provides secure REST API endpoints that allow Fuuffy.com to access your WooCommerce order data and update tracking information for shipments.
Key Features
Order Data API: Secure endpoint for Fuuffy.com to fetch WooCommerce order data
Tracking Updates: API endpoint for Fuuffy.com to update tracking information
Comprehensive Order Data: Includes shipping addresses, product details, and customer information
Custom Fields Support: Supports HS codes and origin country for customs declarations
Comprehensive Logging: Detailed activity logs for troubleshooting
Admin Dashboard: Easy management interface for API settings and tracking overview
How It Works
Install and Configure: Install the plugin and set an API key in WooCommerce settings
Fuuffy.com Integration: Users on Fuuffy.com can click “Sync WooCommerce Order” to fetch order data
Order Processing: Fuuffy.com reads order status and creates shipments for eligible orders
Tracking Updates: When tracking numbers are generated, they’re automatically synced back to WooCommerce
API Endpoints
The plugin provides these REST API endpoints for Fuuffy.com (all require X-API-Key header):
Order Management:
* GET /wp-json/fuufinfo/v1/orders – Fetch orders with filters (status, date_from, date_to, page, per_page)
* GET /wp-json/fuufinfo/v1/orders/{id} – Get specific order details with all tracking records
Tracking Management (Multiple tracking numbers per order):
* GET /wp-json/fuufinfo/v1/orders/{id}/tracking – Get all tracking records for an order
* POST /wp-json/fuufinfo/v1/orders/{id}/tracking – Add new tracking record
* PUT /wp-json/fuufinfo/v1/orders/{id}/tracking/{tracking_id} – Update specific tracking record
* DELETE /wp-json/fuufinfo/v1/orders/{id}/tracking/{tracking_id} – Delete specific tracking record
For Fuuffy.com Users
After the plugin is installed on a WooCommerce store, Fuuffy.com users can:
* Use the “Sync WooCommerce Order” button to fetch order data
* Access comprehensive order information including shipping addresses and product details
* Automatically generate customs declarations from product data
* Update tracking numbers that sync back to WooCommerce
External services
This plugin connects to Fuuffy-operated external services (https://api.fuuffy.com, https://www.fuuffy.com, and https://dev.fuuffy.com) to provide WooCommerce connection, order sync, and tracking updates.
Service purpose:
– Validate and manage Fuuffy integration credentials for this WooCommerce store.
– Allow merchants to connect their store to Fuuffy from the plugin settings page.
– Exchange order and tracking data between WooCommerce and Fuuffy.
Data sent and when:
– When an admin connects the store from WooCommerce > Fuuffy Integration, the plugin sends store metadata (site URL, site name, admin email), plugin API endpoint URL, and WooCommerce REST API credentials generated for integration.
– When Fuuffy syncs orders through the plugin API, order data is made available to Fuuffy, including customer contact details, billing/shipping addresses, product line items, and tracking records.
– When API key validation runs, the plugin sends the configured Fuuffy API key to Fuuffy’s validation endpoint.
These services are provided by Fuuffy:
– Terms of Use: https://fuuffy.com/terms-of-use
– Privacy Policy: https://fuuffy.com/privacy-policy
Configuration
API Setup
API Key: Set a secure API key that Fuuffy.com will use to authenticate requests
Endpoint URL: Share yoursite.com/wp-json/fuufinfo/v1/ with Fuuffy.com users
REST API Endpoints
Get Orders: GET /wp-json/fuufinfo/v1/orders
Query parameters:
– status – Filter by order status
– date_from – Filter orders from date (Y-m-d)
– date_to – Filter orders to date (Y-m-d)
– page – Page number
– per_page – Orders per page (max 100)
Get Single Order: GET /wp-json/fuufinfo/v1/orders/{id}
Get Order Tracking: GET /wp-json/fuufinfo/v1/orders/{id}/tracking
Returns array of all tracking records for the order.
Add Tracking: POST /wp-json/fuufinfo/v1/orders/{id}/tracking
Body parameters:
– tracking_number (required) – Tracking number
– tracking_status – Tracking status (default: “pending”)
– courier_provider – Courier name (e.g., “ups”, “dhl”)
– estimated_delivery – Estimated delivery date (Y-m-d)
Update Tracking: PUT /wp-json/fuufinfo/v1/orders/{id}/tracking/{tracking_id}
Body parameters:
– tracking_number – Tracking number
– tracking_status – Tracking status (e.g., “in_transit”, “delivered”)
– courier_provider – Courier name (e.g., “ups”, “dhl”)
– estimated_delivery – Estimated delivery date (Y-m-d)
Delete Tracking: DELETE /wp-json/fuufinfo/v1/orders/{id}/tracking/{tracking_id}
Authentication
API requests require the X-API-Key header with your configured API key.
Shipping Method
The plugin includes a WooCommerce shipping method that provides real-time rates from Fuuffy:
Go to WooCommerce > Settings > Shipping
Add “Fuuffy Shipping” to your shipping zones
Configure rate display options and markup settings
Customers will see live shipping rates during checkout
Order Data Format
Orders are provided to Fuuffy.com with comprehensive data including:
`json
{
“order_id”: 123,
“order_number”: “123”,
“order_date”: “2024-01-15 10:30:00”,
“order_status”: “processing”,
“currency”: “USD”,
“total_value”: “99.99”,
“customer”: {
“shipping_address”: {
“address_1”: “123 Main St”,
“city”: “New York”,
“country”: “US”,
“postcode”: “10001”
}
},
“line_items”: [
{
“name”: “Product Name”,
“quantity”: 1,
“price”: “99.99”,
“hs_code”: “1234.56.78”,
“origin_country”: “US”
}
],
“fuufinfo_tracking”: [
{
“id”: 1,
“tracking_number”: “1Z999AA1234567890”,
“courier_provider”: “ups”,
“tracking_status”: “in_transit”,
“estimated_delivery”: “2024-01-20”,
“created_at”: “2024-01-15 10:30:00”,
“updated_at”: “2024-01-16 14:20:00”
},
{
“id”: 2,
“tracking_number”: “1Z999BB9876543210”,
“courier_provider”: “dhl”,
“tracking_status”: “delivered”,
“estimated_delivery”: “2024-01-18”,
“created_at”: “2024-01-16 09:15:00”,
“updated_at”: “2024-01-18 16:45:00”
}
]
}
`
Developer Information
Hooks and Filters
Developers can use WordPress filters to customize the order data format sent to Fuuffy.com.
Database Tables
wp_fuufinfo_tracking – Tracking information storage
wp_fuufinfo_api_log – API activity logging
REST API Authentication
Include the X-API-Key header with your configured API key for all requests.
Support
For support and documentation, visit our website or contact our support team. We provide integration assistance for connecting with Fuuffy.com.
