carrier_claims_write
carrierClaimCreate
File a carrier claim for a package in the store, found by its tracking number, as the return page or the order’s fulfillment page would. Returns null if no package in the store has that number, or none of a kind the caller may file: return packages need the app’s File carrier claims permission and outbound ones Receive order updates, and an API key has its maker’s. Fails with AMBIGUOUS_PACKAGE, listing the matches in extensions.candidates, when more than one package does; pass a candidate’s packageId, or orderName, to pick one. Fails with CLAIM_EXISTS if the package already has a claim, CARRIER_NOT_SUPPORTED if Redo can’t claim with its carrier, and NOT_CLAIMABLE if its label wasn’t bought through Redo. Fails with EVIDENCE_REQUIRED (422) when the claim needs evidence the request lacks, each listed in extensions.missing by its evidence, such as PHOTOS; new evidence values may be added, so handle unknown ones. A damage claim needs photos, which the API doesn’t take yet. Fails with CLAIM_IN_PROGRESS (503) while another request is filing a claim for the same package; retry after a short wait.