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.

Shelfless by Bring

averysphere

<p>Shelfless by Bring for WooCommerce plugin integrates Bring’s Mybring and Shelfless solutions to WooComerce. Shelfless by Bring for WooComerce enables the integration of your WooCommerce store to Bring’s Mybring and Shelfless services, wherein you will have the ability to fulfill and ship the orders through Bring’s warehouses straight from your WooCommerce store’s administrative interface.</p>
<p>This plugin needs an account from Bring, such as Mybring Customer ID and API Key, in order to work. You may get these details from your MyBring account or from a Bring executive handling your account. Additionally, a Shelfless API key has to be set up for you by your account executive. If you have no Shelfless account yet, you may reach us through <a href="https://www.bring.com/customer-service" rel="nofollow ugc">Bring Customer Service</a> and we will be glad to process it for you.</p>
<p>This plugin will use two Bring APIs:</p>
<ul>
<li><a href="https://www.bring.no/radgivning/netthandel/shelfless" rel="nofollow ugc">Shelfless by Bring Fulfillment Services APIs</a> – the Shelfless API services used exclusively by Bring’s developers in creating official Bring solutions such as Shelfless by Bring for WooComerce.</li>
<li><a href="https://developer.bring.com/" rel="nofollow ugc">Bring Integration APIs, such as the Shipping Guide API</a> – the general integrations APIs used by third-party developers for integrating with ecommerce sites and logistics software.</li>
</ul>
<h3>Features</h3>
<ul>
<li>Works with major shipping and checkout plugins available, but does not interfere with their respective functions</li>
<li>Works with WooCommerce’s free shipping and flat rate tables</li>
<li>Ability to select which order statuses to process fulfillment</li>
<li>Includes detection of specific custom statuses created by other third-party extensions and allows them to be the selector for fulfillment</li>
<li>Includes the ability to move to certain statuses (usually Complete) when fulfillment has been completed and orders are shipped</li>
<li>Includes the integration of tracking numbers directly to WooCommerce’s orders’ notes</li>
<li>When orders are canceled or cannot be fulfilled at the warehouse, the conditions and statuses will be transmitted back to the WooCommerce store so merchants are aware</li>
<li>Has a set of Shelfless-only custom statuses that can be enabled by merchants if they want to identify orders that have been processed by Shelfess by Bring</li>
<li>Automatically fetches stock counts and inventory from a Shelfless warehouse, and updates the local inventory</li>
<li>Allows for total control on product and order fulfillment: merchants can choose which products are allowed to be shipped by Shelfless, and products to be updated with Shelfless inventory</li>
<li>Products created on WooCommerce can be automatically created and pushed to the Shelfless warehouse, as well as product information updates such as product names and descriptions</li>
<li>Uses standard SKU naming conventions: WooCommerce SKUs are the same as the Shelfless SKUs</li>
</ul>


Shelfless by Bring plugin integrates Bring's Mybring and Shelfless solutions with your WooCommerce store.

MetaBox Fulfillment vs Shelfless by Bring