# Register validation of the returned items

Allows to notify the result of validation process for returned items

Endpoint: POST /gradings
Version: 1.4.2
Security: bearerAuth

## Request fields (application/only-registered+json):

  - `shopCode` (string)
    Shop code which belongs the return request or RMA. This field is mandatory if the authorization token will be used by more than one shop. In case this field is not informed, it will be obtained from security context. In case it is informed, it will be validated against the security context
    Example: "marchelacolombine"

  - `shipmentId` (string, required)
    ID of the shipment. The ID must exist in the platform. API will use this value to search the shipment whose status will be updated.
    Example: "R1-64231"

  - `shipmentIdType` (string, required)
    Type of ID that is being reported   RETURN_ID - ID of the return. The last active shipment/transport will be searched. This value is generated by iF at the moment the return request is created. It has the GUID format (f1844145-28a8-48d5-97b4-b00505e98cdc)  RETURN_NAME - Name of the return. The last active shipment/transport will be searched. This value is generated by iF at the moment the return request is created. It has the format R#-{ORDER_NAME} (R1-64231)
    Enum: "RETURN_ID", "RETURN_NAME"

  - `status` (string, required)
    Grading status of the return assigned after the validation
    Enum: "OK", "INCIDENT"

  - `itemsWithIncidents` (array)

  - `itemsWithIncidents.sku` (string, required)
    SKU of the returned item
    Example: "1234567"

  - `itemsWithIncidents.barcode` (string)
    Barcode of the returned item
    Example: "8893892"

  - `itemsWithIncidents.status` (string, required)
    Grading status assigned after the validation
    Enum: "DEFECT-ODOURS-OR-DIRTY", "DEFECT-BROKEN-PRODUCT", "ISSUE-INCORRECT-PRODUCT-OR-SKU", "ISSUE-MISSING-PRODUCT-OR-SKU", "ISSUE-INCOMPLETE-PRODUCT-OR-SKU", "ISSUE-UNKNOWN-PRODUCT-OR-SKU", "ISSUE-FALSIFICATION", "ISSUE-OTHER"

  - `itemsWithIncidents.note` (string)
    Additional notes reported for the grading
    Example: "picking error"

  - `itemsWithIncidents.validatedAt` (string)
    Date when the validation was performed (UTC)'
    Example: "2022-11-17 12:01:00"

## Response 200 fields (application/json):

  - `statusCode` (string)
    Example: "200"

  - `description` (string)
    Example: "Your grading have been received correctly"


## Response 400 fields

## Response 401 fields

## Response 404 fields

## Response 405 fields

## Response 500 fields