About this plugin
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
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
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
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:
com/terms-of-use
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”)
, “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
, “in_transit”, “delivered”)
, “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
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”,
99”,
“customer”: {
“shipping_address”: {
“address_1”: “123 Main St”,
“city”: “New York”,
“country”: “US”,
“postcode”: “10001”
}
},
“line_items”: [
{
“name”: “Product Name”,
“quantity”: 1,
99”,
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
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. com.