Lending — Accounts receivable

naftiko: 1.0.0-alpha2
info:
  label: Lending — Accounts receivable
  description: 'Lending — Accounts receivable. 23 operations. Lead operation: List customer attachments. Self-contained Naftiko
    capability covering one Codat business surface.'
  tags:
  - Codat
  - Accounts receivable
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CODAT_API_KEY: CODAT_API_KEY
capability:
  consumes:
  - type: http
    namespace: lending-accounts-receivable
    baseUri: https://api.codat.io
    description: Lending — Accounts receivable business capability. Self-contained, no shared references.
    resources:
    - name: companies-companyId-connections-connectionId-data-customers-customerId-attachmen
      path: /companies/{companyId}/connections/{connectionId}/data/customers/{customerId}/attachments
      operations:
      - name: listaccountingcustomerattachments
        method: GET
        description: List customer attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-customers-customerId-attachmen
      path: /companies/{companyId}/connections/{connectionId}/data/customers/{customerId}/attachments/{attachmentId}
      operations:
      - name: getaccountingcustomerattachment
        method: GET
        description: Get customer attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-customers-customerId-attachmen
      path: /companies/{companyId}/connections/{connectionId}/data/customers/{customerId}/attachments/{attachmentId}/download
      operations:
      - name: downloadaccountingcustomerattachment
        method: GET
        description: Download customer attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directIncomes
      path: /companies/{companyId}/connections/{connectionId}/data/directIncomes
      operations:
      - name: listaccountingdirectincomes
        method: GET
        description: List direct incomes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directIncomes-directIncomeId
      path: /companies/{companyId}/connections/{connectionId}/data/directIncomes/{directIncomeId}
      operations:
      - name: getaccountingdirectincome
        method: GET
        description: Get direct income
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a
      path: /companies/{companyId}/connections/{connectionId}/data/directIncomes/{directIncomeId}/attachments
      operations:
      - name: listaccountingdirectincomeattachments
        method: GET
        description: List direct income attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a
      path: /companies/{companyId}/connections/{connectionId}/data/directIncomes/{directIncomeId}/attachments/{attachmentId}
      operations:
      - name: getaccountingdirectincomeattachment
        method: GET
        description: Get direct income attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a
      path: /companies/{companyId}/connections/{connectionId}/data/directIncomes/{directIncomeId}/attachments/{attachmentId}/download
      operations:
      - name: downloadaccountingdirectincomeattachment
        method: GET
        description: Download direct income attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments
      path: /companies/{companyId}/connections/{connectionId}/data/invoices/{invoiceId}/attachments
      operations:
      - name: listaccountinginvoiceattachments
        method: GET
        description: List invoice attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments
      path: /companies/{companyId}/connections/{connectionId}/data/invoices/{invoiceId}/attachments/{attachmentId}
      operations:
      - name: getaccountinginvoiceattachment
        method: GET
        description: Get invoice attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments
      path: /companies/{companyId}/connections/{connectionId}/data/invoices/{invoiceId}/attachments/{attachmentId}/download
      operations:
      - name: downloadaccountinginvoiceattachment
        method: GET
        description: Download invoice attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-creditNotes
      path: /companies/{companyId}/data/creditNotes
      operations:
      - name: listaccountingcreditnotes
        method: GET
        description: List credit notes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-creditNotes-creditNoteId
      path: /companies/{companyId}/data/creditNotes/{creditNoteId}
      operations:
      - name: getaccountingcreditnote
        method: GET
        description: Get credit note
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-customers
      path: /companies/{companyId}/data/customers
      operations:
      - name: listaccountingcustomers
        method: GET
        description: List customers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-customers-customerId
      path: /companies/{companyId}/data/customers/{customerId}
      operations:
      - name: getaccountingcustomer
        method: GET
        description: Get customer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-invoices
      path: /companies/{companyId}/data/invoices
      operations:
      - name: listaccountinginvoices
        method: GET
        description: List invoices
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-invoices-invoiceId
      path: /companies/{companyId}/data/invoices/{invoiceId}
      operations:
      - name: getaccountinginvoice
        method: GET
        description: Get invoice
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-invoices-invoiceId-pdf
      path: /companies/{companyId}/data/invoices/{invoiceId}/pdf
      operations:
      - name: downloadaccountinginvoicepdf
        method: GET
        description: Get invoice as PDF
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-payments
      path: /companies/{companyId}/data/payments
      operations:
      - name: listaccountingpayments
        method: GET
        description: List payments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-data-payments-paymentId
      path: /companies/{companyId}/data/payments/{paymentId}
      operations:
      - name: getaccountingpayment
        method: GET
        description: Get payment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-reports-agedDebtor
      path: /companies/{companyId}/reports/agedDebtor
      operations:
      - name: getaccountingageddebtorsreport
        method: GET
        description: Aged debtors report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-reports-agedDebtor-available
      path: /companies/{companyId}/reports/agedDebtor/available
      operations:
      - name: isageddebtorsreportavailable
        method: GET
        description: Aged debtors report available
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies-companyId-reports-enhancedInvoices
      path: /companies/{companyId}/reports/enhancedInvoices
      operations:
      - name: listreconciledinvoices
        method: GET
        description: List reconciled invoices
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.CODAT_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: lending-accounts-receivable-rest
    port: 8080
    description: REST adapter for Lending — Accounts receivable. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/customers/{customerid}/attachments
      name: companies-companyid-connections-connectionid-data-customers-customerid-attachmen
      description: REST surface for companies-companyId-connections-connectionId-data-customers-customerId-attachmen.
      operations:
      - method: GET
        name: listaccountingcustomerattachments
        description: List customer attachments
        call: lending-accounts-receivable.listaccountingcustomerattachments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/customers/{customerid}/attachments/{attachmentid}
      name: companies-companyid-connections-connectionid-data-customers-customerid-attachmen
      description: REST surface for companies-companyId-connections-connectionId-data-customers-customerId-attachmen.
      operations:
      - method: GET
        name: getaccountingcustomerattachment
        description: Get customer attachment
        call: lending-accounts-receivable.getaccountingcustomerattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/customers/{customerid}/attachments/{attachmentid}/download
      name: companies-companyid-connections-connectionid-data-customers-customerid-attachmen
      description: REST surface for companies-companyId-connections-connectionId-data-customers-customerId-attachmen.
      operations:
      - method: GET
        name: downloadaccountingcustomerattachment
        description: Download customer attachment
        call: lending-accounts-receivable.downloadaccountingcustomerattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directincomes
      name: companies-companyid-connections-connectionid-data-directincomes
      description: REST surface for companies-companyId-connections-connectionId-data-directIncomes.
      operations:
      - method: GET
        name: listaccountingdirectincomes
        description: List direct incomes
        call: lending-accounts-receivable.listaccountingdirectincomes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directincomes/{directincomeid}
      name: companies-companyid-connections-connectionid-data-directincomes-directincomeid
      description: REST surface for companies-companyId-connections-connectionId-data-directIncomes-directIncomeId.
      operations:
      - method: GET
        name: getaccountingdirectincome
        description: Get direct income
        call: lending-accounts-receivable.getaccountingdirectincome
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directincomes/{directincomeid}/attachments
      name: companies-companyid-connections-connectionid-data-directincomes-directincomeid-a
      description: REST surface for companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a.
      operations:
      - method: GET
        name: listaccountingdirectincomeattachments
        description: List direct income attachments
        call: lending-accounts-receivable.listaccountingdirectincomeattachments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directincomes/{directincomeid}/attachments/{attachmentid}
      name: companies-companyid-connections-connectionid-data-directincomes-directincomeid-a
      description: REST surface for companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a.
      operations:
      - method: GET
        name: getaccountingdirectincomeattachment
        description: Get direct income attachment
        call: lending-accounts-receivable.getaccountingdirectincomeattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/directincomes/{directincomeid}/attachments/{attachmentid}/download
      name: companies-companyid-connections-connectionid-data-directincomes-directincomeid-a
      description: REST surface for companies-companyId-connections-connectionId-data-directIncomes-directIncomeId-a.
      operations:
      - method: GET
        name: downloadaccountingdirectincomeattachment
        description: Download direct income attachment
        call: lending-accounts-receivable.downloadaccountingdirectincomeattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/invoices/{invoiceid}/attachments
      name: companies-companyid-connections-connectionid-data-invoices-invoiceid-attachments
      description: REST surface for companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments.
      operations:
      - method: GET
        name: listaccountinginvoiceattachments
        description: List invoice attachments
        call: lending-accounts-receivable.listaccountinginvoiceattachments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/invoices/{invoiceid}/attachments/{attachmentid}
      name: companies-companyid-connections-connectionid-data-invoices-invoiceid-attachments
      description: REST surface for companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments.
      operations:
      - method: GET
        name: getaccountinginvoiceattachment
        description: Get invoice attachment
        call: lending-accounts-receivable.getaccountinginvoiceattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/connections/{connectionid}/data/invoices/{invoiceid}/attachments/{attachmentid}/download
      name: companies-companyid-connections-connectionid-data-invoices-invoiceid-attachments
      description: REST surface for companies-companyId-connections-connectionId-data-invoices-invoiceId-attachments.
      operations:
      - method: GET
        name: downloadaccountinginvoiceattachment
        description: Download invoice attachment
        call: lending-accounts-receivable.downloadaccountinginvoiceattachment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/creditnotes
      name: companies-companyid-data-creditnotes
      description: REST surface for companies-companyId-data-creditNotes.
      operations:
      - method: GET
        name: listaccountingcreditnotes
        description: List credit notes
        call: lending-accounts-receivable.listaccountingcreditnotes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/creditnotes/{creditnoteid}
      name: companies-companyid-data-creditnotes-creditnoteid
      description: REST surface for companies-companyId-data-creditNotes-creditNoteId.
      operations:
      - method: GET
        name: getaccountingcreditnote
        description: Get credit note
        call: lending-accounts-receivable.getaccountingcreditnote
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/customers
      name: companies-companyid-data-customers
      description: REST surface for companies-companyId-data-customers.
      operations:
      - method: GET
        name: listaccountingcustomers
        description: List customers
        call: lending-accounts-receivable.listaccountingcustomers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/customers/{customerid}
      name: companies-companyid-data-customers-customerid
      description: REST surface for companies-companyId-data-customers-customerId.
      operations:
      - method: GET
        name: getaccountingcustomer
        description: Get customer
        call: lending-accounts-receivable.getaccountingcustomer
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/invoices
      name: companies-companyid-data-invoices
      description: REST surface for companies-companyId-data-invoices.
      operations:
      - method: GET
        name: listaccountinginvoices
        description: List invoices
        call: lending-accounts-receivable.listaccountinginvoices
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/invoices/{invoiceid}
      name: companies-companyid-data-invoices-invoiceid
      description: REST surface for companies-companyId-data-invoices-invoiceId.
      operations:
      - method: GET
        name: getaccountinginvoice
        description: Get invoice
        call: lending-accounts-receivable.getaccountinginvoice
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/invoices/{invoiceid}/pdf
      name: companies-companyid-data-invoices-invoiceid-pdf
      description: REST surface for companies-companyId-data-invoices-invoiceId-pdf.
      operations:
      - method: GET
        name: downloadaccountinginvoicepdf
        description: Get invoice as PDF
        call: lending-accounts-receivable.downloadaccountinginvoicepdf
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/payments
      name: companies-companyid-data-payments
      description: REST surface for companies-companyId-data-payments.
      operations:
      - method: GET
        name: listaccountingpayments
        description: List payments
        call: lending-accounts-receivable.listaccountingpayments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/data/payments/{paymentid}
      name: companies-companyid-data-payments-paymentid
      description: REST surface for companies-companyId-data-payments-paymentId.
      operations:
      - method: GET
        name: getaccountingpayment
        description: Get payment
        call: lending-accounts-receivable.getaccountingpayment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/reports/ageddebtor
      name: companies-companyid-reports-ageddebtor
      description: REST surface for companies-companyId-reports-agedDebtor.
      operations:
      - method: GET
        name: getaccountingageddebtorsreport
        description: Aged debtors report
        call: lending-accounts-receivable.getaccountingageddebtorsreport
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/reports/ageddebtor/available
      name: companies-companyid-reports-ageddebtor-available
      description: REST surface for companies-companyId-reports-agedDebtor-available.
      operations:
      - method: GET
        name: isageddebtorsreportavailable
        description: Aged debtors report available
        call: lending-accounts-receivable.isageddebtorsreportavailable
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/companies/{companyid}/reports/enhancedinvoices
      name: companies-companyid-reports-enhancedinvoices
      description: REST surface for companies-companyId-reports-enhancedInvoices.
      operations:
      - method: GET
        name: listreconciledinvoices
        description: List reconciled invoices
        call: lending-accounts-receivable.listreconciledinvoices
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: lending-accounts-receivable-mcp
    port: 9090
    transport: http
    description: MCP adapter for Lending — Accounts receivable. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: list-customer-attachments
      description: List customer attachments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingcustomerattachments
      outputParameters:
      - type: object
        mapping: $.
    - name: get-customer-attachment
      description: Get customer attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingcustomerattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: download-customer-attachment
      description: Download customer attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.downloadaccountingcustomerattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: list-direct-incomes
      description: List direct incomes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingdirectincomes
      outputParameters:
      - type: object
        mapping: $.
    - name: get-direct-income
      description: Get direct income
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingdirectincome
      outputParameters:
      - type: object
        mapping: $.
    - name: list-direct-income-attachments
      description: List direct income attachments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingdirectincomeattachments
      outputParameters:
      - type: object
        mapping: $.
    - name: get-direct-income-attachment
      description: Get direct income attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingdirectincomeattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: download-direct-income-attachment
      description: Download direct income attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.downloadaccountingdirectincomeattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: list-invoice-attachments
      description: List invoice attachments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountinginvoiceattachments
      outputParameters:
      - type: object
        mapping: $.
    - name: get-invoice-attachment
      description: Get invoice attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountinginvoiceattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: download-invoice-attachment
      description: Download invoice attachment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.downloadaccountinginvoiceattachment
      outputParameters:
      - type: object
        mapping: $.
    - name: list-credit-notes
      description: List credit notes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingcreditnotes
      outputParameters:
      - type: object
        mapping: $.
    - name: get-credit-note
      description: Get credit note
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingcreditnote
      outputParameters:
      - type: object
        mapping: $.
    - name: list-customers
      description: List customers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingcustomers
      outputParameters:
      - type: object
        mapping: $.
    - name: get-customer
      description: Get customer
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingcustomer
      outputParameters:
      - type: object
        mapping: $.
    - name: list-invoices
      description: List invoices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountinginvoices
      outputParameters:
      - type: object
        mapping: $.
    - name: get-invoice
      description: Get invoice
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountinginvoice
      outputParameters:
      - type: object
        mapping: $.
    - name: get-invoice-pdf
      description: Get invoice as PDF
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.downloadaccountinginvoicepdf
      outputParameters:
      - type: object
        mapping: $.
    - name: list-payments
      description: List payments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listaccountingpayments
      outputParameters:
      - type: object
        mapping: $.
    - name: get-payment
      description: Get payment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingpayment
      outputParameters:
      - type: object
        mapping: $.
    - name: aged-debtors-report
      description: Aged debtors report
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.getaccountingageddebtorsreport
      outputParameters:
      - type: object
        mapping: $.
    - name: aged-debtors-report-available
      description: Aged debtors report available
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.isageddebtorsreportavailable
      outputParameters:
      - type: object
        mapping: $.
    - name: list-reconciled-invoices
      description: List reconciled invoices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: lending-accounts-receivable.listreconciledinvoices
      outputParameters:
      - type: object
        mapping: $.