post
https://api.caas.staging.bancocdc.com.br/assignment/status/
The update assignment status route updates the status of a specific assignment.
Attention points:
- To use the route, it is necessary to use the assignment code obtained through the assignment launch
- If the current assignment status is not changeable by a partner (2, 3, 6, 7, 8) the API will return:
{ "request_code": "63d9cd45-c578-49a7-932f-6f7ef436738b", "return": false, "return_code": "400-30", "message": "Status unidentified or without permission to use." }
Below are the assignment statuses and their respective movement authors, who are responsible for moving certain statuses.
Status Description
| Value | Type | Description | Author |
|---|---|---|---|
| 1 | Typing | Creation of the assignment package with the operations. | Partner |
| 2 | Analysis | The moment when CDC will analyze the assignment data and sales agreement. | Partner |
| 3 | Approved | When the assignment and the agreement are correct to proceed with the sale. | CDC |
| 4 | Refused | When the assignment and the agreement are not correct to proceed with the sale. | CDC |
| 5 | Signature | Signing of the sales agreement. | Partner |
| 6 | Sale off | CDC is requesting the buyer to make the payment for the assignment agreement. | CDC |
| 7 | Finished | Assignment completed successfully. | CDC |
| 8 | Cancelled | Cancel the generated assignment. In this status, the operations do not return to the assignment pipeline unless it is deleted. | Partner / CDC |
| 9 | Signed contact | When the contract is signed by all parties, the system will update the assignment status to 9, but only if the assignment is currently in status 5. | System |
Response
| Http Code | Return Code | Message |
|---|---|---|
| 200 | 200-01 | Success. |
| 400 | 400-01 | Something unexpected happened. |
| 400 | 400-09 | There are no results for the query. |
| 400 | 400-30 | Status unidentified or without permission to use. |
| 401 | 401-06 | The requested module is not enabled. |
Response Parameters
| Parameter | Format | Description |
|---|---|---|
| request_code | String | Unique identifier for the request |
| return | Boolean | Indicates if the request was successful |
| return_code | String | Code indicating the result of the request |
| message | String | Description of the result of the request |