Workday Financials Procure To Pay

naftiko: "1.0.0-alpha1"

info:
  label: "Workday Financials Procure To Pay"
  description: "Unified capability for the procure-to-pay process combining supplier management, purchase requisitions, purchase orders, goods receipts, and supplier invoice processing."
  tags:
    - Workday
    - Financials
    - Procurement
    - Procure To Pay
    - Accounts Payable
    - Suppliers
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WORKDAY_FINANCIALS_ACCESS_TOKEN: WORKDAY_FINANCIALS_ACCESS_TOKEN
      WORKDAY_TENANT: WORKDAY_TENANT

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

  exposes:
    - type: rest
      port: 8081
      namespace: workday-financials-p2p-api
      description: "Unified REST API for Workday Financials procure-to-pay process."
      resources:
        - path: /v1/suppliers
          name: suppliers
          description: "Supplier account management"
          operations:
            - method: GET
              name: list-suppliers
              description: "List suppliers"
              call: "financials-procurement.list-suppliers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/purchase-requisitions
          name: purchase-requisitions
          description: "Purchase requisition management"
          operations:
            - method: GET
              name: list-purchase-requisitions
              description: "List purchase requisitions"
              call: "financials-procurement.list-purchase-requisitions"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-purchase-requisition
              description: "Create a purchase requisition"
              call: "financials-procurement.create-purchase-requisition"
              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: "financials-procurement.list-purchase-orders"
              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: "financials-core.list-supplier-invoices"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9091
      namespace: workday-financials-p2p-mcp
      transport: http
      description: "MCP server for AI-assisted Workday Financials procure-to-pay process."
      tools:
        - name: list-suppliers
          description: "List supplier accounts in Workday Financials"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-procurement.list-suppliers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-supplier
          description: "Get details of a specific supplier"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-procurement.get-supplier"
          with:
            supplierId: "tools.supplierId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-purchase-requisitions
          description: "List purchase requisitions"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-procurement.list-purchase-requisitions"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-purchase-requisition
          description: "Create a new purchase requisition"
          hints:
            readOnly: false
            destructive: false
          call: "financials-procurement.create-purchase-requisition"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-purchase-orders
          description: "List purchase orders"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-procurement.list-purchase-orders"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-purchase-order
          description: "Get details of a specific purchase order"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-procurement.get-purchase-order"
          with:
            poId: "tools.poId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-supplier-invoices
          description: "List supplier invoices for payment processing"
          hints:
            readOnly: true
            openWorld: true
          call: "financials-core.list-supplier-invoices"
          outputParameters:
            - type: object
              mapping: "$."