Responses and Errors

Response Body

For GET requests to the Order resource, the RepSpark API returns a JSON body containing one or more Order's data. For POST and PUT requests to resources, the API either returns a successful 200 HTTP status code or an error response body. Known errors generally include an error code, a quick description, and may include additional details to assist with troubleshooting.

Response Headers

X-RepSpark-ErrorCode: Contains the custom RepSpark error response code.
X-RepSpark-TransactionTrackingNumber: Helps RepSpark assist with troubleshooting.
X-RepSpark-TransactionBatchTrackingNumber: Helps RepSpark assist with troubleshooting.

Response Codes

Extra details will appear in place of the notation.

RepSpark's API uses the following response codes:

Duplicates

Submitting duplicate entity data usually returns an error response in the style of the example below:

{
  "ErrorCode": "DuplicateEntities",
  "ErrorMessage": "Uploaded data for Product entity contains duplicates. Duplicates are not allowed
                  for this entity sync. See Details below for a list of duplicates in your data.",
  "Details": 
  {
    "Duplicates": 
    [
      {
        "ProductNumber": "W7100TRA",
        "ColorCode": "BLU",
        "Count": 2
      },
      {
        "ProductNumber": "BLS-RTL",
        "ColorCode": "Englewood ",
        "Count": 5
      }
    ]
  }
}

If the ErrorCode returned indicates Duplicate Entities, but the duplicate items are not specified in Details, then duplicates may be present in the array properties within items.