Re-quotes a pending application alteration package against the application's current product module definition and replaces it. The new package is created with refreshed_from_alteration_package_id set to the original, and the original is archived. If quoting fails, nothing is archived and the original stays pending.
The original's input is replayed: data from the request body if present, otherwise the data the original was created with.
A refresh is only sound when the alteration hook's validation accepts its own output unchanged, and when the hook reads no application data other than monthly_premium, sum_assured, billing_frequency and the module keys the package carries.
Issued and cancelled applications can't be refreshed.
The package is not pending, the application is issued or cancelled, the alteration hook is not in the application's current product module definition, the stored input failed validation, the product module returned other than one alteration package, or the currency changed. The original stays pending.
The alteration package was not found, it is archived, or it belongs to another application.
Another request superseded, archived or applied the package first. When another refresh won, the message names the alteration package that replaced it.