Fetch Paazl Shipment Status in Magento | Auto Order Updates
Looking for Magento 2 Paazl checkout integration? View the full Magento 2 Paazl checkout integration page to explore features, configuration options, and pricing.
The Fetch Shipment Status feature provides instant visibility into the shipment status of your Paazl orders within Magento. Instead of manually checking if a shipment has been created, the system automatically retrieves and displays this information in the order grid. This saves time and reduces uncertainty in your fulfillment process. You can choose to run this automatically in the background or check statuses manually per order. Additionally, Magento order statuses can be updated automatically when a shipment is detected. This ensures your order management stays accurate and up to date.
Fetch Shipment Status
The Fetch Shipment Status feature allows you to check whether a shipment has been created in Paazl for your Magento orders. Once an order is sent to Paazl, this feature queries the Paazl system to find out if a shipment has been created, and displays that information directly in your Magento order grid. Optionally, it can also automatically update the Magento order status when a shipment is detected.
Configuration
Navigate to Stores > Configuration > Sales > Shipping Methods > Paazl Checkout Widget and scroll to the Paazl Status Fetching section.
Available settings
Automatically update Paazl status in overview Enable this to allow the system to automatically check for shipment creation in the background. When enabled, a scheduled task runs every 15 minutes and checks all orders that have been sent to Paazl within the last 30 days but have not yet had a shipment created.
Update order status Only visible when automatic status fetching is enabled. When set to "Yes", the Magento order status will be automatically changed when a Paazl shipment is detected.
Order status when shipment is created Only visible when both automatic fetching and order status updating are enabled. Select the Magento order status that should be applied when a Paazl shipment is created (e.g., "Complete", "Shipped", or any custom status you have configured).
When an order status is automatically updated, a comment is added to the order history:
"Paazl shipment created. Order status changed automatically."
How to use
Viewing shipment status in the order grid
A new column "Paazl Shipment Created" is available in the sales order grid (Sales > Orders). This column shows:
- Yes — A shipment has been created in Paazl for this order.
- No — No shipment has been created yet (or the order hasn't been checked).
You can filter orders by this column using the dropdown filter at the top of the column.
Fetching status manually via mass action
If you want to check the shipment status immediately without waiting for the automatic schedule:
- Go to Sales > Orders.
- Select the orders you want to check by ticking the checkboxes.
- From the Actions dropdown, select "Fetch Paazl Status".
- Click Submit.
After processing, you will see messages indicating:
- How many orders were successfully checked.
- How many orders were skipped (because they are not Paazl orders).
- Any errors that occurred during the check.
Non-Paazl orders in your selection are automatically skipped — no action is taken on them.
Fetching status via command line
For developers or system administrators, a CLI command is available:
bin/magento paazl:order:fetch-status <order_id> [<order_id2> ...]
Replace <order_id> with the Magento entity ID of the order (not the increment/order number). You can pass multiple IDs separated by spaces. The command will output the result for each order:
Order ID 123: Shipment created = Yes
Order ID 456: Shipment created = No
Order ID 789: Order has not been sent to Paazl yet.
Automatic scheduling
When automatic status fetching is enabled, the system runs a background check every 15 minutes. It only processes orders that meet all of the following criteria:
- The order has been sent to Paazl.
- No shipment has been detected yet.
- The order was sent to Paazl within the last 30 days.
Orders older than 30 days are excluded to avoid unnecessary API calls. Once a shipment is detected for an order, it will no longer be checked on subsequent runs.
Frequently asked questions
Q: Why does the "Paazl Shipment Created" column show "No" for my order? The shipment may not have been created in Paazl yet, or the status hasn't been fetched. Use the mass action "Fetch Paazl Status" to check immediately, or wait for the next automatic run.
Q: What happens if I use the mass action on non-Paazl orders? They are simply skipped. You will see a notice message telling you how many orders were skipped.
Q: Can I change the order status mapping later? Yes. Changing the configured status in the admin panel only affects future status updates. Orders that have already been updated will keep their current status.
Q: Does the automatic check continue after a shipment is found?
No. Once a shipment is detected (Shipment Created = Yes), the order is excluded from future automatic checks.
Q: What if the Paazl API is unreachable? Errors are logged and the order will be retried on the next scheduled run. Other orders in the batch are not affected by a single order's failure.
Q: Where can I see logs for this feature?
API calls and status changes are logged to var/log/paazl.log when debug mode is enabled in the Paazl configuration.
For a complete overview of features and configuration options, see Magento 2 Paazl checkout integration.