Opereit — audit a carrier invoice against a contract

arazzo: 1.0.1
info:
  title: Opereit — audit a carrier invoice against a contract
  version: 1.0.0
  summary: Upload a contract, upload and audit an invoice against it, then read the findings.
  x-realizes-capability-ids:
  - BC-2520.20
  - BC-2530.20
  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-2520.20
      capability_name: Contract Rate Management
      spec: opereit-contracts-api-openapi.yml
      confidence: 0.75
    - capability_id: BC-2530.20
      capability_name: Freight Audit and Payment Management
      spec: opereit-invoice-audits-api-openapi.yml
      confidence: 0.92
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: contractsApi
  url: ../openapi/opereit-contracts-api-openapi.yml
  type: openapi
- name: invoiceAuditsApi
  url: ../openapi/opereit-invoice-audits-api-openapi.yml
  type: openapi
workflows:
- workflowId: auditCarrierInvoice
  summary: End-to-end carrier invoice audit
  description: >-
    Uploads a carrier contract, waits for extraction, creates an invoice audit
    against it, then retrieves the discrepancy findings.
  inputs:
    type: object
    required: [contract_file, contract_carrier_name, contract_signing_date, invoice_file]
    properties:
      contract_file:
        type: string
        description: Path/binary of the carrier contract document (PDF, PNG, JPEG, CSV, XLS, XLSX).
      contract_carrier_name:
        type: string
        example: DHL Express
      contract_signing_date:
        type: string
        example: '2026-01-15'
      invoice_file:
        type: string
        description: Path/binary of the carrier invoice (PDF or CSV).
  steps:
  - stepId: uploadContract
    operationId: uploadContract
    requestBody:
      contentType: multipart/form-data
      payload:
        file: $inputs.contract_file
        carrier_name: $inputs.contract_carrier_name
        signing_date: $inputs.contract_signing_date
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      contract_id: $response.body#/contract/id
  - stepId: createAudit
    operationId: createInvoiceAudit
    requestBody:
      contentType: multipart/form-data
      payload:
        file: $inputs.invoice_file
        contract_id: $steps.uploadContract.outputs.contract_id
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      audit_id: $response.body#/audit/id
  - stepId: listFindings
    operationId: listInvoiceAuditFindings
    parameters:
    - name: audit_id
      in: path
      value: $steps.createAudit.outputs.audit_id
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      findings: $response.body#/data
  outputs:
    contract_id: $steps.uploadContract.outputs.contract_id
    audit_id: $steps.createAudit.outputs.audit_id
    findings: $steps.listFindings.outputs.findings