---
swagger: "2.0"
info:
  x-ibm-name: rmas
  title: Rmas
  version: 1.0.0
  description: ""
schemes:
- https
basePath: /v1
consumes:
- application/json
produces:
- application/json
securityDefinitions:
  oauth2:
    type: oauth2
    description: ""
    flow: accessCode
    authorizationUrl: https://api-sandbox.supplychain.fedex.com/api/sandbox/fsc/oauth2/authorize
    scopes:
      Fulfillment_Returns: Read/Write access to Orders, Items, RMAs, Inventory,location,tracking
        objects
    tokenUrl: https://api-sandbox.supplychain.fedex.com/api/sandbox/fsc/oauth2/token
    x-tokenIntrospect:
      url: https://vp1npmqdp01-v1.genco.com/api/sandbox/fsc/oauth/introspect
  Client_Secret:
    type: apiKey
    description: Enter Client Secret
    in: header
    name: X-IBM-Client-Secret
  Client_Id:
    type: apiKey
    in: header
    name: X-IBM-Client-Id
    description: Enter Client ID
security:
- Client_Id: []
  Client_Secret: []
  oauth2:
  - Fulfillment_Returns
x-ibm-configuration:
  testable: true
  enforced: true
  phase: realized
paths:
  /rmas:
    post:
      responses:
        200:
          description: 200 OK
      tags: []
      description: Creates a new RMA and all of the item level details required for
        a return.  The RMA API does have a flag within to depict if a label is needed
        or not.
      summary: Create RMA
      parameters:
      - name: create_rma_json_body
        required: false
        in: body
        description: "{\"requestIdentifier\" : \"234234234234234\",\"rmaNumber\" :
          null,\t\"customer\" : {\"firstName\" : \"Kamesh\",\"lastName\" : \"Kumar\",\"addressLine1\"
          : \"452 Edinburgh Rd\",\"addressLine2\" : \"\",\"city\" : \"Dublin\",\"stateCode\"
          : \"OH\",\"zipCode\" : \"43017\",\"countryCode\" : \"US\",\"phoneNumber\"
          : \"2624227887\",\"emailAddress\" : \"k.kameshwaran@gmail.com\"\t},\t\"trackingNumber\"
          : null,\"shippingService\" : null,\"shippingCost\" : 0,\t\"labelRequired\"
          : null,\"emailNotification\" : null,\"returnEmployeeId\" : null,\"returnEmployeeName\"
          : null,\"shipToAddressId\" : null,\"shippingCostResponsibility\" : null,\"externalASNId\"
          : null,\"casAccountNumber\" : 0,\t\"billToFirstName\" : null,\"billToLastName\"
          : null,\"billToAddress1\" : null,\"billToAddress2\" : null,\"billToCity\"
          : null,\"billToStateCode\" : null,\"billToZipCode\" : null,\t\"specialtyFlag\"
          : null,\t\"orders\" : [{\"orderNumber\" : \"RMS-1451-O2\",\"orderDate\"
          : \"2017-02-15\",\"items\" : [{\"sku\" : \"testsku23\",\"quantity\" : 3,\"returnItemInfo\"
          : {\"returnReason\" : \"Wrong Size\",\"returnEligibilityOverride\" : \"true\",\"finalSale\"
          : false}}]}]}"
        schema:
          type: object
      - name: AccessToken
        type: string
        required: false
        in: header
        description: Enter AccessToken, it is mandatory in case of basic authentication.
      security:
      - Client_Secret: []
        Client_Id: []
      - oauth2:
        - Fulfillment_Returns
      consumes:
      - application/json
      - text/plain
    get:
      responses:
        200:
          description: 200 OK
      summary: GET RMA
      description: Retrieves rma or list of rmas based on the query parameters provided
        in the request.
      parameters:
      - name: AccessToken
        type: string
        required: false
        in: header
        description: Enter AccessToken, it is mandatory in case of basic authentication.
      - name: id
        type: string
        required: false
        in: query
        description: 2408-2103
      - name: status
        type: string
        required: false
        in: query
        description: Canceled or Approved
      - name: createdTimestamp
        type: string
        required: false
        in: query
        description: ge|2017-03-01T14:30:59-05:00
      - name: lastUpdatedTimestamp
        type: string
        required: false
        in: query
        description: ge|2017-03-01T14:30:59-05:00
      - name: responseFilter
        type: string
        required: false
        in: query
        description: Details
      - name: pageLimit
        type: string
        required: false
        in: query
        description: "5"
      - name: prevTimestamp
        type: string
        required: false
        in: query
        description: "1481059745000"
      - name: nextTimestamp
        type: string
        required: false
        in: query
        description: "1481059745000"
      - name: rmaNumber
        type: string
        required: false
        in: query
      security:
      - Client_Secret: []
        Client_Id: []
      - oauth2:
        - Fulfillment_Returns
      consumes:
      - application/json
      - text/plain
  /rmas/{rmaId}/credit:
    post:
      responses:
        200:
          description: 200 OK
      summary: Credit RMA
      description: This API flags an existing RMA as having been issued credit by
        providing the RMA ID, the order numbers and items/quantities to be marked
        credited. This can only be called when the RMA is not in Canceled status.
      parameters:
      - name: AccessToken
        type: string
        required: false
        in: header
        description: Enter AccessToken, it is mandatory in case of basic authentication.
      - name: rmaId
        type: string
        required: true
        in: path
        description: 8057-1232
      security:
      - Client_Secret: []
        Client_Id: []
      - oauth2:
        - Fulfillment_Returns
      consumes:
      - application/json
      - text/plain
  /rmas/{rmaId}/receive:
    post:
      responses:
        200:
          description: 200 OK
      summary: Receive RMA
      description: This API flags an existing RMA as having been received by providing
        the RMA ID, the items/quantities to be marked as Received. This can only be
        called when the RMA is not in Canceled status.
      parameters:
      - name: receiverma_json_body
        required: true
        in: body
        schema:
          type: object
        description: '{"items" : [{"sku" : "sku1","quantity" : 1}, {"sku" : "sku2","quantity"
          : 2}]}'
      - name: AccessToken
        type: string
        required: false
        in: header
        description: Enter AccessToken, it is mandatory in case of basic authentication.
      - name: rmaId
        type: string
        required: true
        in: path
        description: 8057-1232
      security:
      - Client_Secret: []
        Client_Id: []
      - oauth2:
        - Fulfillment_Returns
      consumes:
      - application/json
      - text/plain
  /rmas/{rmaId}/cancel:
    post:
      responses:
        200:
          description: 200 OK
      summary: Cancel RMA
      description: This API cancels an existing RMA by providing the RMA ID. The RMA
        can be canceled only when the RMA has not been received at FXO or the return
        center.
      parameters:
      - name: rmaId
        type: string
        required: true
        in: path
        description: 8057-1232
      - name: AccessToken
        type: string
        required: false
        in: header
        description: Enter AccessToken, it is mandatory in case of basic authentication.
      consumes:
      - application/json
      - text/plain
      security:
      - Client_Secret: []
        Client_Id: []
      - oauth2:
        - Fulfillment_Returns
tags: []
x-ibm-endpoints:
- endpointUrl: https://api-sandbox.supplychain.fedex.com/api/sandbox
  type:
  - development
...