Salv data-upload API

## Steps to upload data using CSV1. Format the csv file and add all the mandatory data fields indicated in the [User Manual](https://help.salv.com/en/articles/154650-data-overview)2. Upload the [csv file via API](#tag/data-upload/operation/uploadData). Note: the upload API response contains the id that will to be used in status check API call (step 3). When a data file has been successfully uploaded, an HTTP response with 202 status code is returned. A response with 202 status code indicates that the file has been uploaded successfully and the system will try to process the data. It does not guarantee that data will be successfully processed. What will happen next? 1. First comes the **validation phase**: 1. If the Schemas are added in the UI, then our system will validate the file against the schemas (e.g. if there is a field added with DATE type, then system will validate if the date format is correct) 2. If no Schemas are added in the UI, then our system will consider all fields as STRING Note: during this validation phase we do not check if the transaction has been added to the system before. 3. If there are any errors, then no data will be uploaded. In this case calling [check status API call](#tag/data-upload/operation/getDataUploadStatus) will return FAILED status and a error message for the the first error encountered. The error message will be in the `reason` field in a human readable text. 4. If there are no errors, then the upload phase starts. 2. Second (if no errors occurred) comes the **upload phase**: our system will start uploading and saving data in batches of 1000, and in case of transaction file will check for duplicates and if the person is present in the system. 1. If no errors occur, then the file is uploaded successfully. 2. If an error occurs, then when step no 3 ([check status API call](#tag/data-upload/operation/getDataUploadStatus)) is done, then: 1. system will show the first error and give the id of the person or transaction that caused the error. 2. system will show the id of the last uploaded person or transaction and the id of the first person or transaction that was not uploaded. and, 3. the data following the last uploaded person or transaction will not be uploaded. - Example: > Csv file has 200 000 rows. There is a duplicate id on row 87 456. In **validation phase** duplicate errors are not checked thus the file will move on to the **upload phase**. First 87 000 rows are uploaded without any errors. Rows starting from 87 001 will not get uploaded because there is a duplicate error in the batch (the patch of 1000 that gets checked). System will show that there is a duplicate, will show the id of the duplicate Person or Transaction and will show the last uploaded Person or Transaction id and the last id that was not added. Example of an **upload phase** error message: ```jsx { "status": "PARTIALLY_COMPLETED", "reason": "The upload appears to contain transactions (id ameio-1234567) that have already been added to Salv. Please make sure that your upload does not contain any duplicates or transactions that have already been added to Salv. The first transaction not added to Salv with this upload has id fmeio-1234567. Last processed and saved row was with id: dseio-1234567" } ```3. In order to check the status of the file upload either use [get status of data upload API call](#tag/data-upload/operation/getDataUploadStatus) or check Data upload page on app.salv.com. This will provide the status and any further information about the errors.