Skip to content
Stashtab Docs
Esc
↑↓navigate↵open⌘Jpreview

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.

POST/v1/organizations/{orgId}/orders/{orderId}/packing-exception/units/{unitId}/answer
Authorization
AuthorizationBasic auth · headerrequired

Registered confidential integration credentials. Keep the secret server-side.

or
CookieAPI key · headerrequired

Console-managed Vault session cookie; secure cookie naming may vary by environment.

or
AuthorizationBearer token (Vault TEST service token) · headerrequired

Customer- 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.

or
AuthorizationBearer token (Vault organization API key) · headerrequired

Organization-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.

Path parameters
orderIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
orgIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
unitIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
Request body
requiredapplication/json
answerstringrequired
Allowed:accept_offerremove_card
offerIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
offerRevisionintegerrequired

The offer revision the answer was made against.

min 1 · max 9007199254740991
submissionKeystringrequired
min length 8 · max length 128 · matches ^[A-Za-z0-9_.:-]+$
Responses
200

Success

dataobjectrequired
Show properties
answerobjectrequired
Show properties
answerstringrequired
Allowed:accept_offerremove_card
answeredAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
idstringrequired
offerIdstringrequired
offerRevisionintegerrequired
min 1 · max 9007199254740991
operationIdstringrequired
outcomestringrequired

received means the answer is stored; pending means it is being carried out; applied and refused are final.

Allowed:receivedpendingappliedrefused
unitobjectrequired
Show properties
decisionobject | nullrequired
Show properties
Any of:
object
answerstringrequired
Allowed:accept_offerremove_card
decidedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
offerRevisionintegerrequired
min 1 · max 9007199254740991
operationIdstring | nullrequired

Operation ID of the answer that made this decision. Retry or recover an answer by this ID. Null when the warehouse or the deadline decided.

sourcestringrequired

answer 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.

Allowed:answerwarehousedeadline_default
null
null
foundConditionstring | nullrequired
Show properties
Any of:
string
string
null
null
idstringrequired
lineIndexintegerrequired
min 0 · max 9007199254740991
offerobjectrequired
Show properties
conditionstring | nullrequired

Condition of the offered replacement card, when graded.

Show properties
Any of:
string
string
null
null
idstringrequired
kindstringrequired

replacement offers one reserved card; no_offer means the only choice is removing the card.

Allowed:replacementno_offer
productstring | nullrequired

The SKU of the offered replacement card, or null for no_offer.

readableAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
responseDeadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
revisionintegerrequired
min 1 · max 9007199254740991
orderedobjectrequired
Show properties
conditionstring | nullrequired
Show properties
Any of:
string
string
null
null
productstringrequired
skustring | nullrequired
outcomestringrequired
Allowed:awaiting_answerreceivedpendingappliedrefused
packCardOrdinalinteger | nullrequired
Show properties
Any of:
integer
integer
null
null
reasonstringrequired
Allowed:condition_mismatchmissingdamaged
responseDeadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
unitIndexintegerrequired
min 0 · max 9007199254740991
metaobjectrequired
Show properties
requestIdstringrequired
default

Error

errorobjectrequired
Show properties
codestringrequired
Allowed:forbiddeninternal_errornot_foundprovider_data_invalidprovider_outcome_unknownprovider_unavailablerate_limitedstate_conflictunauthenticatedvalidation_errorwarehouse_not_ready
fieldsobject[]
Show properties
Array of object
codestringrequired
messagestringrequired
pathstringrequired
messagestringrequired
operationIdstring
metaobjectrequired
Show properties
requestIdstringrequired
Request
curl -X POST '/v1/organizations/org_example/orders/9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a/packing-exception/units/4a3b2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d/answer' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "answer": "accept_offer",
  "offerId": "0b6f5a8e-3c1d-4e2f-9a7b-5c4d3e2f1a0b",
  "offerRevision": 2,
  "submissionKey": "packing-answer-demo-1"
}'
Response
{
  "data": {
    "answer": {
      "answer": "accept_offer",
      "answeredAt": "2026-11-18T15:00:00.000Z",
      "id": "7e6d5c4b-3a29-4180-9f7e-6d5c4b3a2918",
      "offerId": "0b6f5a8e-3c1d-4e2f-9a7b-5c4d3e2f1a0b",
      "offerRevision": 2
    },
    "operationId": "operation_demo_1",
    "outcome": "received",
    "unit": {
      "decision": {
        "answer": "accept_offer",
        "decidedAt": "2026-11-18T15:00:00.000Z",
        "offerRevision": 2,
        "operationId": "operation_demo_1",
        "source": "answer"
      },
      "foundCondition": "lp",
      "id": "4a3b2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d",
      "lineIndex": 0,
      "offer": {
        "condition": "nm",
        "id": "0b6f5a8e-3c1d-4e2f-9a7b-5c4d3e2f1a0b",
        "kind": "replacement",
        "product": "DEMO-CARD-NM",
        "readableAt": "2026-11-18T09:00:00.000Z",
        "responseDeadlineAt": "2026-11-25T09:00:00.000Z",
        "revision": 2
      },
      "ordered": {
        "condition": "nm",
        "product": "Demo card",
        "sku": "DEMO-CARD-NM"
      },
      "outcome": "received",
      "packCardOrdinal": 3,
      "reason": "condition_mismatch",
      "responseDeadlineAt": "2026-11-25T09:00:00.000Z",
      "unitIndex": 1
    }
  },
  "meta": {
    "requestId": "example-answerPackingException"
  }
}

Was this page helpful?