metaboxfulfillment

<p>The <strong>MetaBox Fulfillment</strong> safely and automatically connects your WooCommerce store to the MetaBox fulfillment system.</p>
<p>What does the plugin do?</p>
<ul>
<li>Sends new orders to MetaBox (automatically and/or manually).</li>
<li>Syncs <strong>order statuses</strong> from MetaBox back to WooCommerce.</li>
<li>Handles <strong>stock synchronization</strong> (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce).</li>
<li>Lets you map <strong>shipping methods</strong> and <strong>payment methods</strong> to MetaBox.</li>
<li>Provides a simple admin UI to manage your MetaBox account and settings.</li>
<li>Makes it easy to send individual products to MetaBox.</li>
</ul>
<p>Design goals:</p>
<ul>
<li><strong>Security:</strong> only the plugin talks to MetaBox; no direct inbound calls into your store.</li>
<li><strong>Stability:</strong> dedicated database tables, clear mappings, logging.</li>
<li><strong>Future-proof:</strong> separate settings for orders, statuses and stock handling.</li>
</ul>
<h3>Leírás</h3>
<p>A <strong>MetaBox Fulfillment</strong> célja, hogy a WooCommerce áruházadat biztonságosan és automatizáltan összekösse a MetaBox fulfillment rendszerrel.</p>
<p>Mit csinál a plugin?</p>
<ul>
<li>Új rendeléseket áttölt a MetaBox rendszerbe (automatikusan és/vagy kézzel).</li>
<li>A MetaBox-ból visszajött <strong>rendelés státuszokat</strong> visszaírja WooCommerce-be.</li>
<li>Kezeli a <strong>készletszinkront</strong> (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce).</li>
<li>Lehetővé teszi a <strong>szállítási módok</strong> és <strong>fizetési módok</strong> párosítását a MetaBoxhoz.</li>
<li>Egyszerű admin felületet ad a MetaBox fiók és beállítások kezeléséhez.</li>
<li>Egyszerűen áttölthetővé teszi az egyes termékeket a MetaBoxba.</li>
</ul>
<p>A plugin tervezésénél kiemelt szempont volt:</p>
<ul>
<li>Biztonság: a MetaBox rendszer felé csak a plugin kommunikál, befelé nem engedünk közvetlen hívást.</li>
<li>Stabilitás: saját adatbázistáblák, egyértelmű mappingek, naplózás.</li>
<li>Jövőállóság: külön kezelt rendelés-, státusz- és készletkezelési beállítások.</li>
</ul>
<h3>Fő funkciók</h3>
<ul>
<li>
<p><strong>MetaBox fiók beállítás</strong></p>
<ul>
<li>API kapcsolat beállítása (partner azonosító, API kulcs, backend URL).</li>
<li>Kapcsolati állapot ellenőrzése (ping/health check).</li>
</ul>
</li>
<li>
<p><strong>Rendelések kezelése</strong></p>
<ul>
<li>Új rendelések automatikus áttöltése a MetaBoxba (opcionálisan kapcsolható).</li>
<li>Manuális áttöltés meglévő rendeléseknél (pl. rendelés lista / rendelés szerkesztőből).</li>
<li>Meta adatok a rendelésen:</li>
<li><code>_mtbxfc_pushed_to_fulfillment</code> – sikeres áttöltés jelölése</li>
<li><code>_mtbxfc_push_response</code> – utolsó API válasz mentése</li>
</ul>
</li>
<li>
<p><strong>Státusz mapping (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">↔</span> WooCommerce)</strong></p>
<ul>
<li>Fulfillment (MetaBox) státuszok párosítása WooCommerce rendelés státuszokkal.</li>
<li>A státusz szinkron csak olyan sorokra fut, ahol van mapping.</li>
<li>WordPress cron segítségével fut, konfigurálható intervallummal.</li>
</ul>
</li>
<li>
<p><strong>Készletkezelés</strong></p>
<ul>
<li>Készlet szinkron beállítások (intervallum, kapcsolók).</li>
<li>Saját log tábla a szinkronizálási futásokhoz.</li>
</ul>
</li>
<li>
<p><strong>Szállítási módok</strong></p>
<ul>
<li>WooCommerce szállítási mód instance-ok párosítása MetaBox szállítási típusokkal (pl. HOME_DELIVERY, PICKUP_POINT stb.) és futárszolgálatokkal (GLS, MPL, stb.).</li>
</ul>
</li>
<li>
<p><strong>Fizetési módok</strong></p>
<ul>
<li>WooCommerce fizetési gateway-ek összekötése MetaBox oldali beállításokkal (pl. melyik fizetés tekintendő utánvétnek, COD).</li>
</ul>
</li>
<li>
<p><strong>Termék áttöltés</strong></p>
<ul>
<li>Egyedi termék MetaBoxba történő áttöltése / frissítése termékszerkesztőből.</li>
<li>Alap adatok, ár, súly, méretek, barcode, SKU továbbítása.</li>
</ul>
</li>
<li>
<p><strong>Dashboard Widget</strong></p>
<ul>
<li>A WordPress Vezérlőpulton megjelenő kis widget, amely mutatja a MetaBox kapcsolat állapotát (online/offline), és rövid infót ad a kapcsolatról.</li>
</ul>
</li>
</ul>
<h3>Rendszerkövetelmények</h3>
<ul>
<li>WordPress 6.0 vagy újabb</li>
<li>WooCommerce 7.0 vagy újabb</li>
<li>PHP 8.0 vagy újabb</li>
<li>Aktív MetaBox fulfillment fiók (partner azonosítóval és API kulccsal)</li>
</ul>
<h3>Telepítés</h3>
<ol>
<li>
<p><strong>Plugin feltöltése</strong></p>
<ul>
<li>Töltsd le a bővítményt <code>.zip</code> formátumban.</li>
<li>WordPress adminban: <em>Bővítmények <span aria-hidden="true" class="wp-exclude-emoji">→</span> Új hozzáadása <span aria-hidden="true" class="wp-exclude-emoji">→</span> Bővítmény feltöltése</em>.</li>
<li>Válaszd ki a zip fájlt, majd <em>Telepítés</em> és <em>Bekapcsolás</em>.</li>
</ul>
<p>VAGY</p>
</li>
</ol>
<ul>
<li>Csomagold ki a zipet, és a plugin mappáját másold a <code>/wp-content/plugins/</code> könyvtárba.</li>
<li>A WordPress admin felületen kapcsold be a bővítményt.</li>
</ul>
<ol>
<li>
<p><strong>MetaBox fiók beállítása</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> MetaBox Fiók</strong> menüpontra.</li>
<li>Add meg a MetaBox által kiadott API adatokat (pl. partner azonosító, API kulcs – attól függően, mit kér a felület).</li>
<li>Mentsd a beállításokat.</li>
<li>Ellenőrizd a kapcsolatot (státusz jelzés a felső sávban / dashboard widgetben).</li>
</ul>
</li>
<li>
<p><strong>Rendelés áttöltés beállítása</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> Megrendelések kezelése</strong> oldalra.</li>
<li>Kapcsold be, ha szeretnéd, hogy új rendelések automatikusan átkerüljenek a MetaBoxba.</li>
<li>Állítsd be, hogy mely WooCommerce rendelés státusz(ok) esetén történjen az áttöltés.</li>
</ul>
</li>
<li>
<p><strong>Státusz mapping</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> Státuszok kezelése</strong> oldalra.</li>
<li>Itt tudod párosítani, hogy a MetaBoxból érkező státuszok (pl. PACKING, SHIPPED) mely WooCommerce rendelés státuszokra váltsanak.</li>
<li>Csak a párosított státuszokat fogja a plugin frissíteni WooCommerce-ben.</li>
</ul>
</li>
<li>
<p><strong>Szállítási módok és futárok</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> Szállítási módok</strong> oldalra.</li>
<li>Válaszd ki, hogy az egyes WooCommerce szállítási mód instance-ok mely MetaBox szállítási típusnak és futárszolgáltatónak felelnek meg.</li>
<li>A plugin ezt használja az order payload építésénél.</li>
</ul>
</li>
<li>
<p><strong>Fizetési módok</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> Fizetési módok</strong> oldalra.</li>
<li>Itt tudod megadni, melyik WooCommerce fizetési mód számít utánvétnek (COD), stb.</li>
<li>A plugin ez alapján számítja például az utánvét összegét.</li>
</ul>
</li>
<li>
<p><strong>Készlet szinkron beállítása</strong></p>
<ul>
<li>Menj a <strong>MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> Készletkezelés</strong> oldalra.</li>
<li>Kapcsold be a készletszinkront, és állítsd be az intervallumot.</li>
<li>A plugin WP-Cronon keresztül fogja frissíteni a készleteket.</li>
</ul>
</li>
</ol>
<h3>Használat</h3>
<h3>Rendelések áttöltése MetaBoxba</h3>
<ul>
<li>Ha az automatikus áttöltés be van kapcsolva, a megfelelő státuszba kerülő új rendeléseket a plugin automatikusan elküldi a MetaBox API felé.</li>
<li>Ha valamiért kézzel szeretnél áttölteni:
<ul>
<li>Nyisd meg a rendelés adatlapját WooCommerce-ben.</li>
<li>Használd a MetaBox-hoz kapcsolódó műveletet (pl. rendelés sor művelet / gomb – a pluginben definiált hely szerint).</li>
<li>Siker/hiba esetén a rendszer:</li>
<li>rendelés megjegyzést ír,</li>
<li>illetve admin értesítést (notice) jeleníthet meg.</li>
</ul>
</li>
</ul>
<h3>Termék áttöltése</h3>
<ul>
<li>Nyisd meg a WooCommerce termék szerkesztő felületét.</li>
<li>A MetaBox Fulfillment meta boxban hagyd bepipálva az áttöltést / frissítést.</li>
<li>Mentsd a terméket.</li>
<li>A plugin ekkor felépíti a termék payloadot, és elküldi a MetaBoxnak.</li>
<li>Siker esetén meta mezőkben jelzi, hogy a termék már át lett küldve.</li>
</ul>
<h3>Rendelés státusz szinkron</h3>
<ul>
<li>A MetaBox rendszer időnként visszaküldi az aktuális rendelés státuszokat.</li>
<li>A plugin a beállított időközönként (WP-Cron) lekérdezi a változásokat:
<ul>
<li>csak azokat a sorokat dolgozza fel, amelyek az utolsó futás óta módosultak,</li>
<li>csak azokat a státuszokat írja át, amelyekre létezik mapping.</li>
</ul>
</li>
<li>Ha valamelyik fulfillment státuszra nincs mapping, azt egyszerűen kihagyja (nem nyúl a rendeléshez).</li>
</ul>
<h3>Cron és időzítés</h3>
<p>A plugin több helyen is a WordPress beépített cron rendszerét használja:</p>
<ul>
<li>
<p><strong>Rendelés státusz szinkron (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce)</strong></p>
<ul>
<li>Saját hook: <code>mtbxfc_order_status_sync</code></li>
<li>Dinamikus, perc alapú intervallum (a beállításoknál konfigurálható).</li>
</ul>
</li>
<li>
<p><strong>Készletszinkron (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce)</strong></p>
<ul>
<li>Saját hook a készlethez (pl. <code>mtbxfc_stock_sync</code> – a konkrét név a kódban definiált).</li>
</ul>
</li>
</ul>
<p>Ha a tárhelyeden a WP-Cron nem fut megbízhatóan, érdemes valódi cron jobot beállítani, ami rendszeresen hívja a <code>wp-cron.php</code>-t.</p>
<p>Ha valami nem működik:</p>
<ol>
<li>Ellenőrizd a MetaBox fiók beállításait (API kulcs, URL, partner azonosító stb.).</li>
<li>Nézd meg a WooCommerce rendelés megjegyzéseit – a plugin oda is ír.</li>
<li>Kapcsold be a WordPress debug / error logot és nézd meg a MetaBoxkal kapcsolatos sorokat.</li>
</ol>
<h3>Gyakori kérdések</h3>
<h4>Nem frissül a rendelés státusza WooCommerce-ben. Miért?</h4>
<ul>
<li>Nézd meg, hogy a <strong>Státuszok kezelése</strong> oldalon van-e mapping az adott MetaBox státuszra.</li>
<li>Ha nincs, a plugin szándékosan nem nyúl a Woo rendeléshez.</li>
<li>Ellenőrizd, hogy a cron fut-e (van-e futás a logban).</li>
</ul>
<h4>A rendelés nem megy át MetaBoxba.</h4>
<ul>
<li>Ellenőrizd, hogy be van-e állítva a MetaBox fiók és érvényes-e az API kulcs.</li>
<li>Nézd meg a rendelés megjegyzéseit – általában ott szerepel, ha a MetaBox API hibát dob.</li>
<li>Ellenőrizd a bővítmény logját (WordPress error_log).</li>
</ul>
<h4>Miért jelzi azt, hogy „Nincs konfigurálva”?</h4>
<ul>
<li>Ha a MetaBox API kulcs vagy az API URL hiányzik, a plugin „nincs konfigurálva” állapotot jelez.</li>
<li>A MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> MetaBox Fiók oldalon töltsd ki és mentsd a fiókbeállításokat.</li>
</ul>
<h3>Támogatás</h3>
<p>Ez a bővítmény MetaBox fulfillment rendszerrel dolgozik.<br />
Ha technikai problémád van a plugin működésével kapcsolatban, készíts:</p>
<ul>
<li>WordPress / WooCommerce verzió adatokat,</li>
<li>a releváns log sorokat (MetaBox-hoz kapcsolódó hibák),</li>
<li>és egy rövid leírást arról, mit próbáltál.</li>
</ul>
<p>Ezek birtokában sokkal gyorsabban behatárolható a hiba oka.</p>
<h3>Licence</h3>
<p>A bővítmény a GPLv2 vagy újabb licenc alatt kerül terjesztésre.</p>
<h3></h3>
<h3>English</h3>
<h3></h3>
<p>Connect your WooCommerce store to your MetaBox fulfillment system. Automatic order export, status and stock sync, shipping and payment method mapping – all in a single plugin.</p>
<h3>Main Features</h3>
<ul>
<li>
<p><strong>MetaBox account setup</strong></p>
<ul>
<li>Configure the API connection (partner ID, API key, backend URL).</li>
<li>Check connection health (ping / health check).</li>
</ul>
</li>
<li>
<p><strong>Order handling</strong></p>
<ul>
<li>Automatically export new orders to MetaBox (optional).</li>
<li>Manually push existing orders (e.g. from the order list / order edit screen).</li>
<li>Order-level meta data:</li>
<li><code>_mtbxfc_pushed_to_fulfillment</code> – marks successful export</li>
<li><code>_mtbxfc_push_response</code> – stores the last API response</li>
</ul>
</li>
<li>
<p><strong>Status mapping (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">↔</span> WooCommerce)</strong></p>
<ul>
<li>Map fulfillment (MetaBox) statuses to WooCommerce order statuses.</li>
<li>Status sync only runs for rows that have a mapping.</li>
<li>Uses WordPress cron with a configurable interval.</li>
</ul>
</li>
<li>
<p><strong>Stock handling</strong></p>
<ul>
<li>Stock sync settings (interval, switches).</li>
<li>Own log table for sync runs.</li>
</ul>
</li>
<li>
<p><strong>Shipping methods</strong></p>
<ul>
<li>Map WooCommerce shipping method instances to MetaBox shipping types (e.g. HOME_DELIVERY, PICKUP_POINT, etc.) and carriers (GLS, MPL, etc.).</li>
</ul>
</li>
<li>
<p><strong>Payment methods</strong></p>
<ul>
<li>Map WooCommerce payment gateways to MetaBox-side settings (e.g. which ones are considered Cash on Delivery / COD).</li>
<li>Used to calculate COD amounts.</li>
</ul>
</li>
<li>
<p><strong>Product export</strong></p>
<ul>
<li>Send or update a single product in MetaBox from the product edit screen.</li>
<li>Sends basic data, price, weight, dimensions, barcode, SKU.</li>
</ul>
</li>
<li>
<p><strong>Dashboard Widget</strong></p>
<ul>
<li>A small widget on the WordPress Dashboard that shows the MetaBox connection status (online/offline) and a short summary.</li>
</ul>
</li>
</ul>
<h3>Requirements</h3>
<ul>
<li>WordPress 6.0 or newer</li>
<li>WooCommerce 7.0 or newer</li>
<li>PHP 8.0 or newer</li>
<li>An active MetaBox fulfillment account (with partner ID and API key)</li>
</ul>
<h3>Usage</h3>
<h3>Sending orders to MetaBox</h3>
<ul>
<li>If automatic export is enabled, new orders reaching the configured status will be sent to the MetaBox API.</li>
<li>If you want to export manually:
<ul>
<li>Open the order details in WooCommerce.</li>
<li>Use the MetaBox-related action (e.g. a row action or button, depending on the plugin UI).</li>
<li>On success/failure the system:</li>
<li>adds an order note,</li>
<li>and may display an admin notice.</li>
</ul>
</li>
</ul>
<h3>Exporting products</h3>
<ul>
<li>Open the WooCommerce product edit screen.</li>
<li>In the MetaBox Fulfillment meta box, keep the checkbox enabled to export/update the product.</li>
<li>Save the product.</li>
<li>The plugin will build the product payload and send it to MetaBox.</li>
<li>On success, it stores meta fields indicating that the product has been exported.</li>
</ul>
<h3>Order status synchronization</h3>
<ul>
<li>The MetaBox system periodically sends back the current order statuses.</li>
<li>The plugin, at the configured interval (via WP-Cron), fetches the changes:
<ul>
<li>only processes rows changed since the last run,</li>
<li>only updates WooCommerce orders if there is a mapping for the given status.</li>
</ul>
</li>
<li>If a fulfillment status has no mapping, the plugin simply skips it (does not touch the Woo order).</li>
</ul>
<h3>Cron and Scheduling</h3>
<p>The plugin uses the built-in WordPress cron system in several places:</p>
<ul>
<li>
<p><strong>Order status sync (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce)</strong></p>
<ul>
<li>Custom hook: <code>mtbxfc_order_status_sync</code></li>
<li>Dynamic, minute-based interval (configurable in settings).</li>
</ul>
</li>
<li>
<p><strong>Stock sync (MetaBox <span aria-hidden="true" class="wp-exclude-emoji">→</span> WooCommerce)</strong></p>
<ul>
<li>Own hook for stock (defined in the code, e.g. <code>mtbxfc_stock_sync</code>).</li>
</ul>
</li>
</ul>
<p>If WP-Cron is not reliable on your hosting, consider setting up a real cron job that regularly hits <code>wp-cron.php</code>.</p>
<p>If something doesn’t seem to run:</p>
<ol>
<li>Check your MetaBox account settings (API key, URL, partner ID, etc.).</li>
<li>Look at the WooCommerce order notes – the plugin writes messages there.</li>
<li>Enable WordPress debug / error logging and search for MetaBox-related entries.</li>
</ol>
<h3>Support</h3>
<p>This plugin is designed to work with the MetaBox fulfillment system.<br />
If you have technical issues with the plugin:</p>
<ul>
<li>Collect your WordPress / WooCommerce version information,</li>
<li>gather relevant log entries (MetaBox-related errors),</li>
<li>and write a short description of what you tried.</li>
</ul>
<p>With this information, the root cause can be identified much faster.</p>
<h3>License</h3>
<p>This plugin is distributed under the GPLv2 or later license.<br />
See: https://www.gnu.org/licenses/gpl-2.0.html</p>


MetaBox Fulfillment

A MetaBox fulfillment rendszer és a WooCommerce összekötése: rendelés export, státusz- és készletszinkron, szállítási és fizetési mód mapping.

heathdillon

<h4>WAREHOUSE SPACE FOR ANY BUSINESS IN ANY LOCATION</h4>
<p>Warehouse.Space is a logistics and order fulfillment service for businesses that sell products online and want to grow their business into new global markets.</p>
<h4>SAME DAY DELIVERY</h4>
<p>In selected cities around the world, we are able to provide same day shipping so your customer can receive you items within a few hours of ordering on your site. Contact us for more information on this service.</p>
<h4>FAST SHIPMENT</h4>
<p>We have distribution centers located around the world, so that your products can be closer to your customers, reducing shipping time and costs.</p>
<p>Ship your items with Warehouse.Space to Europe, Asia, America and Oceania. We have warehouses in the UK, Estonia, Spain, Italy, Singapore, Hong Kong, Russia, Australia, The Netherlands and New Zealand.</p>
<h4>GET FREE STORAGE SPACE</h4>
<p>Depending on the number of shipments you ship per week, you will be given an amount of free storage in our warehouse. To get two free pallets in our warehouse ship at least 25 orders per week. The more you ship, the more space you’ll get.</p>
<h3>Plugin</h3>
<p>This plugin has many powerful features that will integrate your website with Warehouse.Space service. These are the following features:</p>
<ul>
<li>Export all products either automatically or manually from your online store to Warehouse.Space.</li>
<li>All orders that will be created after the plugin is activated, are going to be sent to Warehouse.Space automatically.</li>
<li>After Warehouse.Space has picked, packaged and shipped your customer’s order, it will update the status of that order in your store.</li>
<li>Editing “processing order status” in your store will change “order status” in Warehouse.Space.</li>
<li>Editing “product” in your store will update “product information” on Warehouse.Space.</li>
<li>“Orders table” and “order single” views are updated with several fields that will allow tracking order shipment.</li>
</ul>


Warehouse.Space – International order fulfillment partner

Ship your products faster and cheaper by storing them closer to your customers. Use Warehouse.Space…

MetaBox Fulfillment vs Warehouse.Space – International order fulfillment partner