action fulfillment_put_returns {
  label: "Inform us of an RMA"
  description: "Inform FDC of an expected return."
  provider: fulfillment
  method: PUT
  path: "/returns"
  encoding: json
  input: {
    type: "object"
    required: ["items", "recipient", "rmaNumber"]
    properties: {
      items: {
        type: "array"
        items: {
          type: "object"
          required: ["sku", "quantityExpected"]
          properties: {
            quantityExpected: {
              type: "integer"
            }
            sku: {
              type: "string"
            }
          }
        }
      }
      merchantOrderId: {
        type: "string"
      }
      recipient: {
        type: "object"
        additionalProperties: true
      }
      rmaNumber: {
        type: "string"
      }
    }
  }
  output: {
    type: "object"
    required: ["items", "recipient", "rmaNumber"]
    properties: {
      items: {
        type: "array"
        items: {
          type: "object"
          required: ["sku", "quantityExpected"]
          properties: {
            quantityExpected: {
              type: "integer"
            }
            sku: {
              type: "string"
            }
          }
        }
      }
      merchantOrderId: {
        type: "string"
      }
      recipient: {
        type: "object"
        required: ["address1", "addressLocality", "addressRegion", "country", "firstName", "id", "lastName", "postalCode"]
        properties: {
          address1: {
            type: "string"
          }
          address2: {
            type: "string"
          }
          addressLocality: {
            type: "string"
            description: "City"
          }
          addressRegion: {
            type: "string"
            description: "Province / State"
          }
          companyName: {
            type: "string"
          }
          country: {
            type: "string"
            description: "Ideally provide the two character ISO code"
          }
          email: {
            type: "string"
          }
          firstName: {
            type: "string"
          }
          id: {
            type: "integer"
          }
          iso: {
            type: "object"
            properties: {
              id: {
                type: "integer"
              }
              iso2: {
                type: "string"
                description: "Two character ISO code"
              }
              name: {
                type: "string"
                description: "Country Name"
              }
            }
          }
          lastName: {
            type: "string"
          }
          phone: {
            type: "string"
          }
          postalCode: {
            type: "string"
            description: "Postal Code / Zip"
          }
          updatedAt: {
            type: "string"
            format: "date-time"
          }
          updatedBy: {
            type: "object"
            additionalProperties: true
          }
        }
      }
      rmaNumber: {
        type: "string"
      }
    }
  }
}