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.

Rocco Marco Guglielmi

<p>Piwi Warehouse is a simple warehouse management system that allows you to keep track of your items, their location and record loan and restitutions.</p>
<p>Piwi Warehouse introduces the following elements:</p>
<ul>
<li>Items – the element you want to keep track of.</li>
<li>Types – a hierarchical taxonomy to organize your Items.</li>
<li>Locations – the locations of your Warehouse where the item will be stored (e.g. “Facility A01”, “Lab 1”, “Cabinet B03”, “Box B22”).</li>
<li>Purchases – an operation that increases the Item total amount and availability in a specific Location</li>
<li>Holders – an entity that can loan Items</li>
<li>Movements – an operation that assigns a specific amount of Items to an Holder. The Movement keep an history log of all the operations.</li>
</ul>


Piwi Warehouse

Piwi Warehouse is a simple warehouse management system that allows you to keep track of your items, their location and record loan and restitutions.

MetaBox Fulfillment vs Piwi Warehouse