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

Recheck and save edited order import values

PATCH/v1/organizations/{orgId}/order-imports/{importId}/groups/{groupId}
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.

Path parameters
groupIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
importIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
orgIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
Request body
requiredapplication/json
expectedGroupRevisionintegerrequired
max 9007199254740991
expectedReviewIdstringrequired
matches ^[0-9a-f]{64}$
expectedReviewRevisionintegerrequired
max 9007199254740991
itemsobject[]
min items 1 · max items 100
Show properties
Array of object
namestringrequired
max length 500
quantityTextstringrequired
max length 100
skustringrequired
max length 500
sourceGroupintegerrequired
max 9007199254740991
recipientobjectrequired
Show properties
addressLine1stringrequired
max length 500
addressLine2stringrequired
max length 500
citystringrequired
max length 200
companystringrequired
max length 200
countrystringrequired
max length 200
emailstringrequired
max length 200
namestringrequired
max length 200
phonestringrequired
max length 200
postalCodestringrequired
max length 200
regionstringrequired
max length 200
sourceRowintegerrequired
max 9007199254740991
Responses
200

Success

dataobjectrequired
Show properties
groupIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
groupRevisionintegerrequired
max 9007199254740991
itemsobject[]required
Show properties
Array of object
mappingstringrequired
Allowed:ambiguousmissingmatched
namestringrequired
productIdstring | nullrequired
Show properties
Any of:
string
string
null
null
quantityinteger | nullrequired
Show properties
Any of:
integer
integer
null
null
quantityTextstring
skustringrequired
sourceGroupintegerrequired
max 9007199254740991
reviewobjectrequired
Show properties
addressobjectrequired
Show properties
addressLine1stringrequired
addressLine2stringrequired
citystringrequired
companystringrequired
countrystringrequired
emailstringrequired
namestringrequired
phonestringrequired
postalCodestringrequired
regionstringrequired
candidateobject | nullrequired
Show properties
Any of:
object
addressLine1stringrequired
addressLine2stringrequired
citystringrequired
companystringrequired
countrystringrequired
emailstringrequired
namestringrequired
phonestringrequired
postalCodestringrequired
regionstringrequired
null
null
providerobjectrequired
Show properties
codestring | nullrequired
fieldstring | nullrequired
outcomestringrequired
Allowed:acceptednot_runrejectedunavailable
rateCountintegerrequired
min 0 · max 9007199254740991
requestIdstring | nullrequired
reasonstring | nullrequired
selectedstringrequired
Allowed:editedoriginal
statestringrequired
Allowed:invalid-required-fieldneeds-reviewpassed-unchangedprovider-unavailable
autoAdvancebooleanrequired
eligibilitystringrequired
Allowed:ineligiblereadyunavailable
issuesstring[]required
productsobject[]required
Show properties
Array of object
productIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
revisionstring | nullrequired
skustring | nullrequired
weightobject | nullrequired
Show properties
Any of:
object
unitstringrequired
valuenumberrequired
null
null
reviewIdstringrequired
matches ^[0-9a-f]{64}$
reviewIdstringrequired
matches ^[0-9a-f]{64}$
reviewRevisionintegerrequired
max 9007199254740991
sourceIdentitystringrequired
sourceOrderIdstring | nullrequired
sourceRevisionintegerrequired
max 9007199254740991
sourceRowintegerrequired
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 PATCH '/v1/organizations/org_example/order-imports/order_import_demo/groups/order_import_group_demo' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "expectedGroupRevision": 1,
  "expectedReviewId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "expectedReviewRevision": 1,
  "items": [
    {
      "name": "Demo card sleeve",
      "quantityText": "2",
      "sku": "IMPORT-DEMO-SLEEVE",
      "sourceGroup": 1
    }
  ],
  "recipient": {
    "addressLine1": "1 Example Street",
    "addressLine2": "",
    "city": "Toronto",
    "company": "",
    "country": "CA",
    "email": "taylor@example.test",
    "name": "Taylor Example",
    "phone": "",
    "postalCode": "M5V 1E3",
    "region": "ON"
  },
  "sourceRow": 1
}'
Response
{
  "data": {
    "groupId": "order_import_group_demo",
    "groupRevision": 2,
    "items": [
      {
        "mapping": "matched",
        "name": "Demo card sleeve",
        "productId": "product_import_demo",
        "quantity": 2,
        "sku": "IMPORT-DEMO-SLEEVE",
        "sourceGroup": 1
      }
    ],
    "review": {
      "address": {
        "addressLine1": "1 Example Street",
        "addressLine2": "",
        "city": "Toronto",
        "company": "",
        "country": "CA",
        "email": "taylor@example.test",
        "name": "Taylor Example",
        "phone": "",
        "postalCode": "M5V 1E3",
        "region": "ON",
        "candidate": null,
        "provider": {
          "code": null,
          "field": null,
          "outcome": "accepted",
          "rateCount": 1,
          "requestId": "rate_import_demo_revised"
        },
        "reason": null,
        "selected": "edited",
        "state": "passed-unchanged"
      },
      "autoAdvance": true,
      "eligibility": "ready",
      "issues": [],
      "products": [
        {
          "productId": "product_import_demo",
          "revision": "product-import-demo-revision",
          "sku": "IMPORT-DEMO-SLEEVE",
          "weight": {
            "unit": "ounces",
            "value": 1
          }
        }
      ],
      "reviewId": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
    },
    "reviewId": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
    "reviewRevision": 2,
    "sourceIdentity": "json:IMPORT-DEMO-1:1",
    "sourceOrderId": "IMPORT-DEMO-1",
    "sourceRevision": 1,
    "sourceRow": 1
  },
  "meta": {
    "requestId": "example-reviseOrderImportGroup"
  }
}