Reconciliation via API (Reject)
- Claudio Baldi
- Gajendra Singh
- Chad Nuesmeyer
PRODUCTION API ENDPOINTS Recap:
Single survey:
POST: https://api.spectrumsurveys.com/buyers/v2/adjustments/surveys/{surveyId}?operationType=LIVE_RECONCILIATION&reconStatus={1/2}
Multiple Survey:
POST: https://api.spectrumsurveys.com/buyers/v2/adjustments?operationType=LIVE_RECONCILIATION&reconStatus={1/2}Change the transaction status to Complete use
reconStatus = 1
Change the transaction status to Buyer_Reconciliation_Reject use
reconStatus = 2
In live reconciliation mode, it is possible to enter the reason for the reconciliation made in an additional field. Please note this is optional.
If included, the reason value should be added in
"change_reason"and these are the options:Suspected FraudRespondent Quality (speeding, straightlining, text response...)Ghost CompletesClient RejectedDuplicate Respondent
Any other variation is accepted and is recorded as
Respondent Quality.
Example Single Survey Call:
Buyer API Endpoint:
Change to Complete
POST: $apihost/adjustments/surveys/:surveyId?operationType=LIVE_RECONCILIATION&reconStatus=1
Change to Buyer_Reconciliation_Reject
POST: $apihost/adjustments/surveys/:surveyId?operationType=LIVE_RECONCILIATION&reconStatus=2
($apihost is the environment against which you are testing, and $basepath is the base path with the api version. All Buy API calls will require access-token parameter in the header)
Request Payload:
[
{
"transaction_id": "7lNK5AGrSL3bk5tV4gw0Tr",
"change_reason": "Suspected Fraud" // optional
},
{
"transaction_id": "7dTdSUUWkR9DBs7rUi5jdT"
},
{
"transaction_id": "5EmEbeX9mEblEpwP6yHG1K"
},
{
"transaction_id": "6HkYQWFMcIcDOTxfnIi6op"
}
]Response:
Response Code:
CODE: 202 ACCEPTED
Response Code (deprecated):
CODE: 200 OK
Response Body
NOTE: If one or more transaction_id/s (TXs) passed are ineligible or already reconciled, the system will start the reconciliation process and those TXs will be skipped.
Response explanation:
"eligible": are the transactions that are eligible and the status changed within the process"rejected": are the transactions that changed fromCompletetoBuyer_Reconciliation_Reject"completed”: are the transactions that changed fromBuyer_*toComplete"test": are the transactions captured via the button test (available in UI)"transactions": total completes uploaded"transactionsWithDesiredStatus": are the transactions that already have the status requested with this reconciliation process.
Errors Codes:
All transactions are invalid or belong to another survey
The reconciliation process will not start
Some, but not all, transactions are invalid or belong to another survey
The reconciliation process will not start
All transactions are ineligible for reconciliation
The reconciliation process will not start
The total TX rejects allowed is reached. The limit set at the moment is 50%
The reconciliation process will not start
DESCRIPTION:
STAGING API and Payload:
1 - Reconciliation Single Survey:
Buyer API endPoint - Change the transaction to Buyer_Reconciliation_Reject:
($apihost is the environment against which you are testing, and $basepath is the base path with the api version. All Buy API calls will require access-token parameter in the header)
Request Payload:
Response Code:
Response Code (deprecated):
Response Body:
2 - Reconciliation multiple surveys (Bulk Reconciliation)
Buyer API endPoint - Change the transaction to Buyer_Reconciliation_Reject:
Request Payload:
Response Code:
Response Code (deprecated):
Response Body:
These are the label shown:
Reject : Reconciliation via UI - TX changes to
buyer_rejectsReject (API): Reconciliation via API - TX changes to
buyer_rejectsComplete: Reconciliation via UI - TX changes to
completeComplete (API): Reconciliation via UI - TX changes to
buyer_rejectsAccept: Reconciliation via UI - Any TX in the file will changes to
completeif they are eligible, and the TX current completes not in the file, will changebuyer_rejectsAccept (API): Reconciliation via API - Any TX in the file will changes to
completeif they are eligible, and the TX current completes not in the file, will changebuyer_rejects
