naftiko: 1.0.0-alpha2
info:
  label: eBay Finances API — Transaction
  description: 'eBay Finances API — Transaction. 2 operations. Lead operation: Transaction. Self-contained Naftiko capability
    covering one Ebay business surface.'
  tags:
  - Ebay
  - Transaction
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: finances-transaction
    baseUri: https://apiz.ebay.com{basePath}
    description: eBay Finances API — Transaction business capability. Self-contained, no shared references.
    resources:
    - name: transaction
      path: /transaction
      operations:
      - name: gettransactions
        method: GET
        description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
          #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the seller's eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
            " target="_blank ">HTTP request
          required: true
        - name: filter
          in: query
          type: string
          description: 'Numerous filters are available for the <strong>getTransactions</strong> method, and these filters
            are discussed below. One or more of these filter types can be '
        - name: limit
          in: query
          type: string
          description: The number of monetary transactions to return per page of the result set. Use this parameter in conjunction
            with the <b>offset</b> parameter to control the pagi
        - name: offset
          in: query
          type: string
          description: This integer value indicates the actual position that the first monetary transaction returned on the
            current page has in the results set. So, if you wanted to v
        - name: sort
          in: query
          type: string
          description: 'By default, monetary transactions that match the input criteria are sorted in descending order according
            to the transaction date (i.e, most recent transactions '
    - name: transaction_summary
      path: /transaction_summary
      operations:
      - name: gettransactionsummary
        method: GET
        description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
          #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the seller's eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
            " target="_blank ">HTTP request
          required: true
        - name: filter
          in: query
          type: string
          description: Numerous filters are available for the <strong>getTransactionSummary</strong> method, and these filters
            are discussed below. One or more of these filter types c
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: finances-transaction-rest
    port: 8080
    description: REST adapter for eBay Finances API — Transaction. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/transaction
      name: transaction
      description: REST surface for transaction.
      operations:
      - method: GET
        name: gettransactions
        description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
          #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
        call: finances-transaction.gettransactions
        with:
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          filter: rest.filter
          limit: rest.limit
          offset: rest.offset
          sort: rest.sort
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/transaction-summary
      name: transaction-summary
      description: REST surface for transaction_summary.
      operations:
      - method: GET
        name: gettransactionsummary
        description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
          #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
        call: finances-transaction.gettransactionsummary
        with:
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: finances-transaction-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Finances API — Transaction. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: div-class-msgbox-important-p-class-msgbox-importantindiv
      description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
        #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: finances-transaction.gettransactions
      with:
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        filter: tools.filter
        limit: tools.limit
        offset: tools.offset
        sort: tools.sort
      outputParameters:
      - type: object
        mapping: $.
    - name: div-class-msgbox-important-p-class-msgbox-importantindiv-2
      description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="&lt;b&gt;&lt;span style=&quot;color:
        #dd1e31;&quot; class=&quot;mcFormatColor&quot;&gt;Important! &lt;/span&gt;&lt;/b&gt;"><span class="autonumber"><span><b><sp'
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: finances-transaction.gettransactionsummary
      with:
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.