What this error means

When you push a Purchase Order (or a PO Shipment) to an externally managed warehouse — such as your Amazon FBA connection through TrackStar — Luminous must be able to identify every product on that PO in the external system. If one or more products have never been published to that integration, Luminous cannot include them in the inbound shipment payload and stops the push. You will see a "Product Mappings Missing" dialog listing the affected SKUs.

This is different from reconciling an inbound shipment that Amazon has already created. It applies specifically to the Push as Inbound Shipment action on a Purchase Order or PO Shipment.

Luminous provides a one-click fix directly inside the error dialog:

  1. Attempt the Push as Inbound Shipment action on your Purchase Order or PO Shipment.
  2. When the Product Mappings Missing dialog appears, review the list of unmapped SKUs. Each SKU name links to its product page if you need to verify the product details.
  3. Click Publish next to each unmapped SKU. Luminous will push that product's details to your integration (e.g., TrackStar / FBA). A spinner shows while publishing is in progress.
  4. When a SKU is successfully published, it shows a green Published badge.
  5. Once every SKU in the list shows Published, a success banner appears: "All products published. You can now close this dialog and retry the shipment push."
  6. Click Done to close the dialog.
  7. Retry the Push as Inbound Shipment action — it should now complete without error.

If a SKU fails to publish, an error message appears beneath it. Common reasons include: the product is inactive, required fields (such as weight) are missing, or the integration account is temporarily unreachable. Correct the product data and try publishing again.

Prevent the error proactively

If you regularly create POs for products that haven't yet been pushed to your 3PL or FBA integration, you can publish them in bulk before any push is needed:

  1. Go to Settings → Integrations and open the integration account for your externally managed warehouse.
  2. Navigate to the Manage Products tab.
  3. Use the filters to find products that are not yet mapped, then push them to the integration in bulk.

Publishing a product once is sufficient — Luminous will remember the mapping for future POs and shipment pushes.

Why some products are unmapped

A product may be missing its mapping if:

  • It was added to Luminous after the initial integration setup and was never pushed to the 3PL.
  • It was previously published but the connection was reset or the product was deleted from the external system.
  • A new SKU variant was created in Luminous and has not yet been synced outbound.

Need more help?

If publishing a SKU from the dialog repeatedly fails, or if you do not see the Push as Inbound Shipment option on a PO, contact Luminous Support with the PO number and the SKU names shown in the error dialog.