Answer a packing exception for one card
Answer one held card in a redemption packing exception. accept_offer accepts the replacement card in the unit’s current offer; remove_card removes the card from the order and is the only answer for a no_offer unit. Copy offerId and offerRevision from packingException.units[].offer in a fresh getOrder or batchGetOrders read. The answer binds to the order, the unit and that exact offer revision. A refusal is 409 state_conflict with the reason in error.fields[0].code and changes nothing: stale_offer (the offer was replaced after your read), no_current_offer (accept_offer without a replacement), already_decided, response_window_closed, exception_resolved or submission_conflict (same key, different content). Each copy is answered on its own. An answer is final; a correction goes through the warehouse. The same submission key and content returns the original answer and operationId again and never applies it twice, also after the offer or the settlement changed; it never answers a newer offer. After a lost response, retry with the same key or read the order: the unit’s decision.operationId equals the answer’s operationId. A retry while the first request is still running returns 409 state_conflict with that operationId; retry later with the same key. outcome is received when the answer is stored, pending while the warehouse carries it out, and applied or refused when final. Only applied means the card was replaced or removed. In Test the answer is normally applied immediately; if not, a scheduled run applies it. In Live the answer is stored as received and the order stays held, because Live settlement is not available yet. An unanswered card defaults to remove_card at its responseDeadlineAt. There is no price approval: a revised estimate never needs an answer. Members and higher roles, and write-capable organization keys, may use this operation. Viewers and read-only keys are refused as forbidden.
/v1/organizations/{orgId}/orders/{orderId}/packing-exception/units/{unitId}/answerAuthorizationBasic auth · headerrequiredRegistered confidential integration credentials. Keep the secret server-side.
CookieAPI key · headerrequiredConsole-managed Vault session cookie; secure cookie naming may vary by environment.
AuthorizationBearer token (Vault TEST service token) · headerrequiredCustomer- and resource-bound service grant, rechecked on every call. Existing Live opening-feed authority remains narrow; ordinary Test business requests refuse until shared Test composition is available.
AuthorizationBearer token (Vault organization API key) · headerrequiredOrganization-owned credential with immutable mode and Read-only or Read/write permissions. Only explicitly declared ordinary customer operations accept it. Test business access refuses until shared Test composition is available; no staff, team, key-management or protocol authority is granted.
orderIdstringrequiredorgIdstringrequiredunitIdstringrequiredapplication/jsonanswerstringrequiredaccept_offerremove_cardofferIdstringrequiredofferRevisionintegerrequiredThe offer revision the answer was made against.
submissionKeystringrequiredSuccess
dataobjectrequiredShow propertiesHide properties
answerobjectrequiredShow propertiesHide properties
answerstringrequiredaccept_offerremove_cardansweredAtstring<date-time>requiredidstringrequiredofferIdstringrequiredofferRevisionintegerrequiredoperationIdstringrequiredoutcomestringrequiredreceived means the answer is stored; pending means it is being carried out; applied and refused are final.
receivedpendingappliedrefusedunitobjectrequiredShow propertiesHide properties
decisionobject | nullrequiredShow propertiesHide properties
answerstringrequiredaccept_offerremove_carddecidedAtstring<date-time>requiredofferRevisionintegerrequiredoperationIdstring | nullrequiredOperation ID of the answer that made this decision. Retry or recover an answer by this ID. Null when the warehouse or the deadline decided.
sourcestringrequiredanswer is the customer's own answer; warehouse is a decision the warehouse recorded on the customer's instruction; deadline_default removes the card when the response window closes without one.
answerwarehousedeadline_defaultnullfoundConditionstring | nullrequiredShow propertiesHide properties
stringnullidstringrequiredlineIndexintegerrequiredofferobjectrequiredShow propertiesHide properties
conditionstring | nullrequiredCondition of the offered replacement card, when graded.
Show propertiesHide properties
stringnullidstringrequiredkindstringrequiredreplacement offers one reserved card; no_offer means the only choice is removing the card.
replacementno_offerproductstring | nullrequiredThe SKU of the offered replacement card, or null for no_offer.
readableAtstring<date-time>requiredresponseDeadlineAtstring<date-time>requiredrevisionintegerrequiredorderedobjectrequiredShow propertiesHide properties
conditionstring | nullrequiredShow propertiesHide properties
stringnullproductstringrequiredskustring | nullrequiredoutcomestringrequiredawaiting_answerreceivedpendingappliedrefusedpackCardOrdinalinteger | nullrequiredShow propertiesHide properties
integernullreasonstringrequiredcondition_mismatchmissingdamagedresponseDeadlineAtstring<date-time>requiredunitIndexintegerrequiredmetaobjectrequiredShow propertiesHide properties
requestIdstringrequiredError
errorobjectrequiredShow propertiesHide properties
codestringrequiredforbiddeninternal_errornot_foundprovider_data_invalidprovider_outcome_unknownprovider_unavailablerate_limitedstate_conflictunauthenticatedvalidation_errorwarehouse_not_readyfieldsobject[]Show propertiesHide properties
objectcodestringrequiredmessagestringrequiredpathstringrequiredmessagestringrequiredoperationIdstringmetaobjectrequiredShow propertiesHide properties
requestIdstringrequired