Workday Finance Financial Operations

naftiko: "1.0.0-alpha1"

info:
  label: "Workday Finance Financial Operations"
  description: "Unified capability for financial operations combining general ledger management, procurement, and accounts payable workflows. Enables finance teams to manage the full procure-to-pay and record-to-report lifecycle."
  tags:
    - Workday
    - Finance
    - Financial Management
    - Procurement
    - Accounts Payable
    - General Ledger
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WORKDAY_FINANCE_ACCESS_TOKEN: WORKDAY_FINANCE_ACCESS_TOKEN
      WORKDAY_TENANT: WORKDAY_TENANT

capability:
  consumes:
    - import: financial-management
      location: ./shared/financial-management.yaml
    - import: procurement
      location: ./shared/procurement.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: workday-finance-api
      description: "Unified REST API for Workday Finance financial operations."
      resources:
        - path: /v1/accounts
          name: accounts
          description: "General ledger account management"
          operations:
            - method: GET
              name: list-accounts
              description: "List financial accounts"
              call: "financial-management.list-accounts"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/journal-entries
          name: journal-entries
          description: "Journal entry management"
          operations:
            - method: GET
              name: list-journal-entries
              description: "List journal entries"
              call: "financial-management.list-journal-entries"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-journal-entry
              description: "Create a journal entry"
              call: "financial-management.create-journal-entry"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/cost-centers
          name: cost-centers
          description: "Cost center organization management"
          operations:
            - method: GET
              name: list-cost-centers
              description: "List cost centers"
              call: "financial-management.list-cost-centers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/worktags
          name: worktags
          description: "Financial dimension worktag management"
          operations:
            - method: GET
              name: list-worktags
              description: "List worktags"
              call: "financial-management.list-worktags"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/financial-periods
          name: financial-periods
          description: "Fiscal period management"
          operations:
            - method: GET
              name: list-financial-periods
              description: "List financial periods"
              call: "financial-management.list-financial-periods"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/suppliers
          name: suppliers
          description: "Supplier account management"
          operations:
            - method: GET
              name: list-suppliers
              description: "List suppliers"
              call: "procurement.list-suppliers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/purchase-orders
          name: purchase-orders
          description: "Purchase order management"
          operations:
            - method: GET
              name: list-purchase-orders
              description: "List purchase orders"
              call: "procurement.list-purchase-orders"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-purchase-order
              description: "Create a purchase order"
              call: "procurement.create-purchase-order"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/supplier-invoices
          name: supplier-invoices
          description: "Supplier invoice processing"
          operations:
            - method: GET
              name: list-supplier-invoices
              description: "List supplier invoices"
              call: "procurement.list-supplier-invoices"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-supplier-invoice
              description: "Create a supplier invoice"
              call: "procurement.create-supplier-invoice"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/requisitions
          name: requisitions
          description: "Purchase requisition management"
          operations:
            - method: GET
              name: list-requisitions
              description: "List purchase requisitions"
              call: "procurement.list-requisitions"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: workday-finance-mcp
      transport: http
      description: "MCP server for AI-assisted Workday Finance operations."
      tools:
        - name: list-accounts
          description: "List general ledger accounts in Workday Finance"
          hints:
            readOnly: true
            openWorld: true
          call: "financial-management.list-accounts"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-journal-entries
          description: "List journal entries, optionally filtered by period"
          hints:
            readOnly: true
            openWorld: true
          call: "financial-management.list-journal-entries"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-journal-entry
          description: "Create a new journal entry in the general ledger"
          hints:
            readOnly: false
            destructive: false
          call: "financial-management.create-journal-entry"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-cost-centers
          description: "List cost center organizations"
          hints:
            readOnly: true
            openWorld: true
          call: "financial-management.list-cost-centers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-worktags
          description: "List financial dimension worktags"
          hints:
            readOnly: true
            openWorld: true
          call: "financial-management.list-worktags"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-financial-periods
          description: "List fiscal periods and their open/close status"
          hints:
            readOnly: true
            openWorld: true
          call: "financial-management.list-financial-periods"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-suppliers
          description: "List supplier accounts in the procurement system"
          hints:
            readOnly: true
            openWorld: true
          call: "procurement.list-suppliers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-purchase-orders
          description: "List purchase orders, optionally filtered by status"
          hints:
            readOnly: true
            openWorld: true
          call: "procurement.list-purchase-orders"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-purchase-order
          description: "Create a new purchase order for a supplier"
          hints:
            readOnly: false
            destructive: false
          call: "procurement.create-purchase-order"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-supplier-invoices
          description: "List supplier invoices for accounts payable processing"
          hints:
            readOnly: true
            openWorld: true
          call: "procurement.list-supplier-invoices"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-supplier-invoice
          description: "Create a new supplier invoice for payment processing"
          hints:
            readOnly: false
            destructive: false
          call: "procurement.create-supplier-invoice"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-requisitions
          description: "List purchase requisitions"
          hints:
            readOnly: true
            openWorld: true
          call: "procurement.list-requisitions"
          outputParameters:
            - type: object
              mapping: "$."