Shipping Profiles

Returns all shipping rate profiles with ruleCount (number of wilaya rules) and productCount (how many products override the store default with this profile).

Creates a profile (rate-card metadata only). Use PUT /{id}/rules afterwards to populate wilaya rates. Setting isDefault: true atomically unsets the current default profile.

Returns the wilaya rules of the currently-active default profile. Used by the order form to auto-fill deliveryFee. Returns an empty array if no profile is marked default.

Returns a single profile with its full list of wilaya rules (including homeEnabled / stopDeskEnabled).

Partial update of profile metadata. Include only the fields you want to change. Set notes to null to clear it.

Default invariant: the system always keeps exactly one profile marked isDefault. Setting isDefault: true here atomically unsets the current default. Setting isDefault: false on the only default profile is rejected with 422 DEFAULT_PROFILE_REQUIRED.

Permanently deletes a profile and all of its wilaya rules (commune overrides cascade).

Blocked when:

• The profile is currently referenced by one or more products → 422 PROFILE_IN_USE
• The profile is the default profile → 422 DEFAULT_PROFILE_REQUIRED (set another profile as default first)

Atomically replaces the full rules list for a profile — prior rules are deleted (commune overrides cascade) before new ones are inserted.

Constraints:

• Each wilayaId may appear at most once per profile. Duplicates are rejected with DUPLICATE_WILAYA_RULE.
• Setting both homeEnabled: false and stopDeskEnabled: false on a wilaya effectively disables delivery for that wilaya under this profile.
• Sending an empty rules array clears all rules for the profile.

Returns every commune in a wilaya with its override status. For each commune the response includes:

• Raw override fields (homeEnabled, stopDeskEnabled, homePrice, stopDeskPrice) — null means that field inherits from the wilaya rule.
• Effective values (effectiveHome*, effectiveStopDesk*) — the actual values used during fee resolution (commune override merged onto the wilaya defaults).
• hasOverride — true if any override row exists for this commune.

Requires that the profile already has a rule for the given wilaya — otherwise responds 404 SHIPPING_RULE_NOT_FOUND.

Upserts a commune-level override on top of the wilaya rule.

Semantics:

• Any field set to null (or omitted — which is treated as null) inherits from the wilaya rule at fee-resolution time.
• If all four override fields (homeEnabled, stopDeskEnabled, homePrice, stopDeskPrice) are null, the override row is deleted (equivalent to DELETE).
• Prices must be ≥ 0 when provided.

Effects on orders: subsequent online orders with this wilaya + commune pair will use the overridden values. Disabling homeEnabled or stopDeskEnabled causes 422 DELIVERY_NOT_AVAILABLE at order creation for that mode.

Removes the commune override row — the commune will again inherit the wilaya rule. Returns 404 COMMUNE_OVERRIDE_NOT_FOUND if no override row exists for this commune.