Work a Justt pre-chargeback alert to a reported outcome

arazzo: 1.0.1
info:
  title: Work a Justt pre-chargeback alert to a reported outcome
  version: 1.0.0
  description: >-
    Pull pre-chargeback alerts from Ethoca / Verifi, read one, and report its
    outcome back to Justt using the alert networks' own outcome vocabulary. Note
    the read operations and the write operation live in two different Justt
    specifications.
  x-realizes-capability-ids:
  - BC-1340.70
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-1340.70
      capability_name: Card Transaction Processing Management
      spec: justt-pre-chargeback-alerts-api-openapi.yml
      confidence: 0.7
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: preChargebackAlertsApi
  url: ../openapi/justt-pre-chargeback-alerts-api-openapi.yml
  type: openapi
workflows:
- workflowId: alertToOutcome
  summary: List alerts, read one, report the outcome
  inputs:
    type: object
    required: [providerName, refunded, outcome]
    properties:
      referenceAccountId:
        type: string
      limit:
        type: integer
        default: 50
      providerName:
        type: string
        enum: [Verifi RDR, Verifi CDRN, Ethoca]
      refunded:
        type: string
        enum: [refunded, not refunded, not settled]
      outcome:
        type: string
        description: >-
          An OutcomeStatus value — either a readable status (resolved,
          previously_refunded, unresolved_dispute, stopped, partially_stopped,
          previously_cancelled, missed, notfound, account_suspended, in_progress,
          shipper_contacted, other) or a network numeric code (100, 101, 102, 130,
          900, 901, 902, 940, 950-957, 951).
      comments:
        type: string
  steps:
  - stepId: listAlerts
    description: Retrieve pre-chargeback alerts matching the given criteria
    operationId: $sourceDescriptions.preChargebackAlertsApi.AlertController_findAll
    parameters:
    - name: limit
      in: query
      value: $inputs.limit
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      firstAlertId: $response.body#/data/0/id
      hasMore: $response.body#/hasMore
  - stepId: readAlert
    description: Retrieve a single alert by its internal id
    operationId: $sourceDescriptions.preChargebackAlertsApi.AlertController_findOne
    parameters:
    - name: internalAlertId
      in: path
      value: $steps.listAlerts.outputs.firstAlertId
    successCriteria:
    - condition: $statusCode == 200
  - stepId: reportOutcome
    description: >-
      Record what was done about the alert. Lives in the REST API specification,
      not in the Alerts specification.
    operationId: $sourceDescriptions.preChargebackAlertsApi.PreChargebackAlertsController_createOutcome
    parameters:
    - name: reference-account-id
      in: header
      value: $inputs.referenceAccountId
    requestBody:
      contentType: application/json
      payload:
        providerName: $inputs.providerName
        alertId: $steps.listAlerts.outputs.firstAlertId
        refunded: $inputs.refunded
        outcome: $inputs.outcome
        comments: $inputs.comments
    successCriteria:
    - condition: $statusCode == 201
  outputs:
    alertId: $steps.listAlerts.outputs.firstAlertId