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.

adamcofsky

<p>This plugin allows you to connect to The Fill Mill backend warehouse management system. This system can download your orders, process shipping, and upload shipping information back to WooCommerce. Entering your credentials into the plugin settings page allows you to verify your connection status to The Fill Mill warehouse management system.</p>


The Fill Mill

This plugin allows you to connect to The Fill Mill backend warehouse management system.

MetaBox Fulfillment vs The Fill Mill