WooCommerce Sequential Order Numbers Pro compatibility

Use this skill when a WooCommerce plugin must cooperate with Sequential Order Numbers Pro (SONP). The core rule is simple: the WooCommerce order ID remains the database primary key; the sequential order number is the human-facing business number.

Mental model

• Treat $order->get_id() as the immutable internal identifier.
• Treat $order->get_order_number() as the display/order-document number.
• Do not build UI, emails, PDFs, CSVs, invoices, ERP payloads, or customer messages from #{$order_id} when SONP may be active.
• Do not parse the formatted number back into an ID. It may have prefixes, suffixes, date/time tokens, leading zeroes, or a free-order identifier.
• Do not write _order_number* meta directly unless you are repairing data in a controlled migration.

Plugin contract