{"id":10647,"date":"2026-05-18T12:29:47","date_gmt":"2026-05-18T04:29:47","guid":{"rendered":"https:\/\/aeosub.com\/fuuffy-integration-for-woocommerce\/"},"modified":"2026-05-18T12:29:47","modified_gmt":"2026-05-18T04:29:47","slug":"fuuffy-integration-for-woocommerce","status":"publish","type":"post","link":"https:\/\/aeosub.com\/zh\/fuuffy-integration-for-woocommerce\/","title":{"rendered":"Fuuffy Integration for WooCommerce"},"content":{"rendered":"<div class=\"plugin-info-card\" style=\"border: 1px solid #e2e8f0;border-radius: 10px;overflow: hidden;margin-bottom: 30px;font-family: -apple-system, system-ui, sans-serif;background: #fff\">\n<table style=\"width: 100%;border-collapse: collapse;font-size: 14px\">\n<tr style=\"border-bottom: 1px solid #edf2f7\">\n<th style=\"padding: 15px 20px;text-align: left;width: 35%;color: #4a5568;background: #fcfcfc\"><img decoding=\"async\" src=\"https:\/\/ps.w.org\/fuuffy-integration-for-woocommerce\/assets\/icon-256x256.jpg?rev=3535021\" style=\"width: 40px;height: 40px;border-radius: 6px;margin-right: 12px;vertical-align: middle\"> Developer<\/th>\n<td style=\"padding: 15px 20px;font-weight: 500\"><a href=\"https:\/\/profiles.wordpress.org\/davidfuuffy\/\" target=\"_blank\" rel=\"noopener\">davidfuuffy<\/a><\/td>\n<\/tr>\n<tr style=\"border-bottom: 1px solid #edf2f7\">\n<th style=\"padding: 12px 20px;text-align: left;color: #4a5568;background: #fcfcfc\">Version<\/th>\n<td style=\"padding: 12px 20px\">v1.0.0<\/td>\n<\/tr>\n<tr style=\"border-bottom: 1px solid #edf2f7\">\n<th style=\"padding: 12px 20px;text-align: left;color: #4a5568;background: #fcfcfc\">Active Installs<\/th>\n<td style=\"padding: 12px 20px\">0 +<\/td>\n<\/tr>\n<tr style=\"border-bottom: 1px solid #edf2f7\">\n<th style=\"padding: 12px 20px;text-align: left;color: #4a5568;background: #fcfcfc\">Requires \/ Tested<\/th>\n<td style=\"padding: 12px 20px\">5.0 \/ 6.9.4<\/td>\n<\/tr>\n<tr style=\"border-bottom: 1px solid #edf2f7\">\n<th style=\"padding: 12px 20px;text-align: left;color: #4a5568;background: #fcfcfc\">Last Updated<\/th>\n<td style=\"padding: 12px 20px\">2026-05-18 3:29am GMT<\/td>\n<\/tr>\n<tr>\n<th style=\"padding: 12px 20px;text-align: left;color: #4a5568;background: #fcfcfc\">Official Link<\/th>\n<td style=\"padding: 12px 20px\"><a href=\"https:\/\/wordpress.org\/plugins\/fuuffy-integration-for-woocommerce\/\" target=\"_blank\" style=\"text-decoration: none;color: #4a3bca;font-weight: bold\" rel=\"noopener\">View Details \u2192<\/a><\/td>\n<\/tr>\n<\/table><\/div>\n<div class=\"plugin-short-desc\" style=\"margin: 20px 0;padding: 12px 15px;background: #f9fafb;border-left: 4px solid #4a3bca;border-radius: 6px;font-style: italic;color: #4a5568\">Provides REST API endpoints for Fuuffy.com to sync WooCommerce orders and update tracking information.<\/div>\n<p>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.<\/p>\n<h4>Key Features<\/h4>\n<ul>\n<li><strong>Order Data API<\/strong>: Secure endpoint for Fuuffy.com to fetch WooCommerce order data<\/li>\n<li><strong>Tracking Updates<\/strong>: API endpoint for Fuuffy.com to update tracking information<\/li>\n<li><strong>Comprehensive Order Data<\/strong>: Includes shipping addresses, product details, and customer information<\/li>\n<li><strong>Custom Fields Support<\/strong>: Supports HS codes and origin country for customs declarations<\/li>\n<li><strong>Comprehensive Logging<\/strong>: Detailed activity logs for troubleshooting<\/li>\n<li><strong>Admin Dashboard<\/strong>: Easy management interface for API settings and tracking overview<\/li>\n<\/ul>\n<h4>How It Works<\/h4>\n<ol>\n<li><strong>Install and Configure<\/strong>: Install the plugin and set an API key in WooCommerce settings<\/li>\n<li><strong>Fuuffy.com Integration<\/strong>: Users on Fuuffy.com can click &#8220;Sync WooCommerce Order&#8221; to fetch order data<\/li>\n<li><strong>Order Processing<\/strong>: Fuuffy.com reads order status and creates shipments for eligible orders<\/li>\n<li><strong>Tracking Updates<\/strong>: When tracking numbers are generated, they&#8217;re automatically synced back to WooCommerce<\/li>\n<\/ol>\n<h4>API Endpoints<\/h4>\n<p>The plugin provides these REST API endpoints for Fuuffy.com (all require <code>X-API-Key<\/code> header):<\/p>\n<p><strong>Order Management:<\/strong><br \/>\n* <code>GET \/wp-json\/fuufinfo\/v1\/orders<\/code> &#8211; Fetch orders with filters (status, date_from, date_to, page, per_page)<br \/>\n* <code>GET \/wp-json\/fuufinfo\/v1\/orders\/{id}<\/code> &#8211; Get specific order details with all tracking records<\/p>\n<p><strong>Tracking Management (Multiple tracking numbers per order):<\/strong><br \/>\n* <code>GET \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking<\/code> &#8211; Get all tracking records for an order<br \/>\n* <code>POST \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking<\/code> &#8211; Add new tracking record<br \/>\n* <code>PUT \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking\/{tracking_id}<\/code> &#8211; Update specific tracking record<br \/>\n* <code>DELETE \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking\/{tracking_id}<\/code> &#8211; Delete specific tracking record<\/p>\n<h4>For Fuuffy.com Users<\/h4>\n<p>After the plugin is installed on a WooCommerce store, Fuuffy.com users can:<br \/>\n* Use the &#8220;Sync WooCommerce Order&#8221; button to fetch order data<br \/>\n* Access comprehensive order information including shipping addresses and product details<br \/>\n* Automatically generate customs declarations from product data<br \/>\n* Update tracking numbers that sync back to WooCommerce<\/p>\n<h3>External services<\/h3>\n<p>This plugin connects to Fuuffy-operated external services (<code>https:\/\/api.fuuffy.com<\/code>, <code>https:\/\/www.fuuffy.com<\/code>, and <code>https:\/\/dev.fuuffy.com<\/code>) to provide WooCommerce connection, order sync, and tracking updates.<\/p>\n<p>Service purpose:<br \/>\n&#8211; Validate and manage Fuuffy integration credentials for this WooCommerce store.<br \/>\n&#8211; Allow merchants to connect their store to Fuuffy from the plugin settings page.<br \/>\n&#8211; Exchange order and tracking data between WooCommerce and Fuuffy.<\/p>\n<p>Data sent and when:<br \/>\n&#8211; When an admin connects the store from WooCommerce &gt; 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.<br \/>\n&#8211; 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.<br \/>\n&#8211; When API key validation runs, the plugin sends the configured Fuuffy API key to Fuuffy&#8217;s validation endpoint.<\/p>\n<p>These services are provided by Fuuffy:<br \/>\n&#8211; Terms of Use: <a href=\"https:\/\/fuuffy.com\/terms-of-use\" rel=\"nofollow ugc noopener\" target=\"_blank\">https:\/\/fuuffy.com\/terms-of-use<\/a><br \/>\n&#8211; Privacy Policy: <a href=\"https:\/\/fuuffy.com\/privacy-policy\" rel=\"nofollow ugc noopener\" target=\"_blank\">https:\/\/fuuffy.com\/privacy-policy<\/a><\/p>\n<h3>Configuration<\/h3>\n<h4>API Setup<\/h4>\n<ol>\n<li><strong>API Key<\/strong>: Set a secure API key that Fuuffy.com will use to authenticate requests<\/li>\n<li><strong>Endpoint URL<\/strong>: Share <code>yoursite.com\/wp-json\/fuufinfo\/v1\/<\/code> with Fuuffy.com users<\/li>\n<\/ol>\n<h4>REST API Endpoints<\/h4>\n<p><strong>Get Orders<\/strong>: <code>GET \/wp-json\/fuufinfo\/v1\/orders<\/code><br \/>\nQuery parameters:<br \/>\n&#8211; <code>status<\/code> &#8211; Filter by order status<br \/>\n&#8211; <code>date_from<\/code> &#8211; Filter orders from date (Y-m-d)<br \/>\n&#8211; <code>date_to<\/code> &#8211; Filter orders to date (Y-m-d)<br \/>\n&#8211; <code>page<\/code> &#8211; Page number<br \/>\n&#8211; <code>per_page<\/code> &#8211; Orders per page (max 100)<\/p>\n<p><strong>Get Single Order<\/strong>: <code>GET \/wp-json\/fuufinfo\/v1\/orders\/{id}<\/code><\/p>\n<p><strong>Get Order Tracking<\/strong>: <code>GET \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking<\/code><br \/>\nReturns array of all tracking records for the order.<\/p>\n<p><strong>Add Tracking<\/strong>: <code>POST \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking<\/code><br \/>\nBody parameters:<br \/>\n&#8211; <code>tracking_number<\/code> (required) &#8211; Tracking number<br \/>\n&#8211; <code>tracking_status<\/code> &#8211; Tracking status (default: &#8220;pending&#8221;)<br \/>\n&#8211; <code>courier_provider<\/code> &#8211; Courier name (e.g., &#8220;ups&#8221;, &#8220;dhl&#8221;)<br \/>\n&#8211; <code>estimated_delivery<\/code> &#8211; Estimated delivery date (Y-m-d)<\/p>\n<p><strong>Update Tracking<\/strong>: <code>PUT \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking\/{tracking_id}<\/code><br \/>\nBody parameters:<br \/>\n&#8211; <code>tracking_number<\/code> &#8211; Tracking number<br \/>\n&#8211; <code>tracking_status<\/code> &#8211; Tracking status (e.g., &#8220;in_transit&#8221;, &#8220;delivered&#8221;)<br \/>\n&#8211; <code>courier_provider<\/code> &#8211; Courier name (e.g., &#8220;ups&#8221;, &#8220;dhl&#8221;)<br \/>\n&#8211; <code>estimated_delivery<\/code> &#8211; Estimated delivery date (Y-m-d)<\/p>\n<p><strong>Delete Tracking<\/strong>: <code>DELETE \/wp-json\/fuufinfo\/v1\/orders\/{id}\/tracking\/{tracking_id}<\/code><\/p>\n<h4>Authentication<\/h4>\n<p>API requests require the <code>X-API-Key<\/code> header with your configured API key.<\/p>\n<h3>Shipping Method<\/h3>\n<p>The plugin includes a WooCommerce shipping method that provides real-time rates from Fuuffy:<\/p>\n<ol>\n<li>Go to WooCommerce &gt; Settings &gt; Shipping<\/li>\n<li>Add &#8220;Fuuffy Shipping&#8221; to your shipping zones<\/li>\n<li>Configure rate display options and markup settings<\/li>\n<li>Customers will see live shipping rates during checkout<\/li>\n<\/ol>\n<h3>Order Data Format<\/h3>\n<p>Orders are provided to Fuuffy.com with comprehensive data including:<\/p>\n<pre><code>`json\n<\/code><\/pre>\n<p>{<br \/>\n  &#8220;order_id&#8221;: 123,<br \/>\n  &#8220;order_number&#8221;: &#8220;123&#8221;,<br \/>\n  &#8220;order_date&#8221;: &#8220;2024-01-15 10:30:00&#8221;,<br \/>\n  &#8220;order_status&#8221;: &#8220;processing&#8221;,<br \/>\n  &#8220;currency&#8221;: &#8220;USD&#8221;,<br \/>\n  &#8220;total_value&#8221;: &#8220;99.99&#8221;,<br \/>\n  &#8220;customer&#8221;: {<br \/>\n    &#8220;shipping_address&#8221;: {<br \/>\n      &#8220;address_1&#8221;: &#8220;123 Main St&#8221;,<br \/>\n      &#8220;city&#8221;: &#8220;New York&#8221;,<br \/>\n      &#8220;country&#8221;: &#8220;US&#8221;,<br \/>\n      &#8220;postcode&#8221;: &#8220;10001&#8221;<br \/>\n    }<br \/>\n  },<br \/>\n  &#8220;line_items&#8221;: [<br \/>\n    {<br \/>\n      &#8220;name&#8221;: &#8220;Product Name&#8221;,<br \/>\n      &#8220;quantity&#8221;: 1,<br \/>\n      &#8220;price&#8221;: &#8220;99.99&#8221;,<br \/>\n      &#8220;hs_code&#8221;: &#8220;1234.56.78&#8221;,<br \/>\n      &#8220;origin_country&#8221;: &#8220;US&#8221;<br \/>\n    }<br \/>\n  ],<br \/>\n  &#8220;fuufinfo_tracking&#8221;: [<br \/>\n    {<br \/>\n      &#8220;id&#8221;: 1,<br \/>\n      &#8220;tracking_number&#8221;: &#8220;1Z999AA1234567890&#8221;,<br \/>\n      &#8220;courier_provider&#8221;: &#8220;ups&#8221;,<br \/>\n      &#8220;tracking_status&#8221;: &#8220;in_transit&#8221;,<br \/>\n      &#8220;estimated_delivery&#8221;: &#8220;2024-01-20&#8221;,<br \/>\n      &#8220;created_at&#8221;: &#8220;2024-01-15 10:30:00&#8221;,<br \/>\n      &#8220;updated_at&#8221;: &#8220;2024-01-16 14:20:00&#8221;<br \/>\n    },<br \/>\n    {<br \/>\n      &#8220;id&#8221;: 2,<br \/>\n      &#8220;tracking_number&#8221;: &#8220;1Z999BB9876543210&#8221;,<br \/>\n      &#8220;courier_provider&#8221;: &#8220;dhl&#8221;,<br \/>\n      &#8220;tracking_status&#8221;: &#8220;delivered&#8221;,<br \/>\n      &#8220;estimated_delivery&#8221;: &#8220;2024-01-18&#8221;,<br \/>\n      &#8220;created_at&#8221;: &#8220;2024-01-16 09:15:00&#8221;,<br \/>\n      &#8220;updated_at&#8221;: &#8220;2024-01-18 16:45:00&#8221;<br \/>\n    }<br \/>\n  ]<br \/>\n}<br \/>\n    `<\/p>\n<h3>Developer Information<\/h3>\n<h4>Hooks and Filters<\/h4>\n<p>Developers can use WordPress filters to customize the order data format sent to Fuuffy.com.<\/p>\n<h4>Database Tables<\/h4>\n<ul>\n<li><code>wp_fuufinfo_tracking<\/code> &#8211; Tracking information storage<\/li>\n<li><code>wp_fuufinfo_api_log<\/code> &#8211; API activity logging<\/li>\n<\/ul>\n<h4>REST API Authentication<\/h4>\n<p>Include the <code>X-API-Key<\/code> header with your configured API key for all requests.<\/p>\n<h3>Support<\/h3>\n<p>For support and documentation, visit our website or contact our support team. We provide integration assistance for connecting with Fuuffy.com.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Provides REST API endpoints for Fuuffy.com to sync WooCommerce orders and update tracking information.<\/p>","protected":false},"author":1,"featured_media":9317,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[252],"tags":[716,1148,1149,690,569,555],"class_list":["post-10647","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-trends","tag-api","tag-fuuffy","tag-order-sync","tag-tracking","tag-woocommerce","tag-wordpress-plugin"],"_links":{"self":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10647","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/comments?post=10647"}],"version-history":[{"count":0,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10647\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media\/9317"}],"wp:attachment":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media?parent=10647"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/categories?post=10647"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/tags?post=10647"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}