Mintsoft · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Accounting API

16 actions 16 updates phrasing extends openapi/mintsoft-accounting-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Mintsoft's API. It is a proposal applied on top of the contract, not a document Mintsoft publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 16

$.info
$.paths['/api/Accounting/Invoice/List'].get
$.paths['/api/Accounting/Invoice/All'].get
$.paths['/api/Accounting/Invoice/{id}'].get
$.paths['/api/Accounting/Invoice/{id}/Orders'].get
$.paths['/api/Accounting/Invoice/Orders/{OrderId}'].get
$.paths['/api/Accounting/AddCourierCost'].post
$.paths['/api/Accounting/Invoice/{id}/Returns'].get
$.paths['/api/Accounting/Invoice/{id}/GoodsIn'].get
$.paths['/api/Accounting/Invoice/{id}/Collections'].get
$.paths['/api/Accounting/Invoice/{id}/Other'].get
$.paths['/api/Account/Invoice/InvoiceItemTypes'].get
$.paths['/api/Account/Invoice/AddAdditionalInvoiceItem'].post
$.paths['/api/Accounting/LocationTypeStoragePrice'].post
$.paths['/api/Account/Invoice/GetUnconfirmedInvoiceSummary'].get
$.paths['/api/Account/Invoice/GetUnconfirmedInvoiceStorageCosts'].get

OpenAPI Overlay

mintsoft-accounting-api-phrasing-overlay.yaml Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Accounting API
  version: 1.0.0
extends: openapi/mintsoft-accounting-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-11-20'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 15
- target: $.paths['/api/Accounting/Invoice/List'].get
  update:
    x-apievangelist-phrasing:
      intent: List confirmed invoices
      effect: read
      questions:
      - Which confirmed invoices have been raised for a client?
      - Can I list invoices updated since a certain date?
      instructions:
      - text: List confirmed invoices for client {ClientId}.
        slots:
          ClientId: query.ClientId
      - text: Show invoices updated since {SinceDate}.
        slots:
          SinceDate: query.SinceDate
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/All'].get
  update:
    x-apievangelist-phrasing:
      intent: Get all confirmed invoices
      effect: read
      questions:
      - Can I pull every confirmed invoice summary at once?
      - Is there an unpaginated list of all invoices I can access?
      instructions:
      - text: Get all confirmed invoice summaries.
      - text: Export every invoice I have access to.
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a confirmed invoice
      effect: read
      questions:
      - What are the totals on a specific confirmed invoice?
      - Can I look up one invoice by its ID?
      instructions:
      - text: Get confirmed invoice {id}.
        slots:
          id: path.id
      - text: Show the totals for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Orders'].get
  update:
    x-apievangelist-phrasing:
      intent: List an invoice's order charges
      effect: read
      questions:
      - Which order charges make up a confirmed invoice?
      - Can I see the line items from orders on an invoice?
      instructions:
      - text: List the order charges on invoice {id}.
        slots:
          id: path.id
      - text: Show the order line items for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/Orders/{OrderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the invoice item for an order
      effect: read
      questions:
      - What did an order get charged on the invoice?
      - Can I look up an invoice item by its order number?
      instructions:
      - text: Find the invoice item for order {OrderId}.
        slots:
          OrderId: path.OrderId
      - text: Show how order {OrderId} was charged on the invoice.
        slots:
          OrderId: path.OrderId
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/AddCourierCost'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a courier cost to an invoice item
      effect: write
      questions:
      - How do I add a courier cost to an invoice item that failed to price?
      - Can I set a postage cost for a tracking number on an invoice item?
      instructions:
      - text: Add courier cost {PostageCost} to invoice item for order {OrderId}.
        slots:
          PostageCost: requestBody.PostageCost
          OrderId: requestBody.OrderId
      - text: Set postage cost {PostageCost} for tracking {TrackingNumber} on invoice item {OrderNumber}.
        slots:
          PostageCost: requestBody.PostageCost
          TrackingNumber: requestBody.TrackingNumber
          OrderNumber: requestBody.OrderNumber
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Returns'].get
  update:
    x-apievangelist-phrasing:
      intent: List an invoice's return charges
      effect: read
      questions:
      - Which return charges are on a confirmed invoice?
      - Can I see the return line items on an invoice?
      instructions:
      - text: List the return charges on invoice {id}.
        slots:
          id: path.id
      - text: Show the return line items for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/GoodsIn'].get
  update:
    x-apievangelist-phrasing:
      intent: List an invoice's goods in charges
      effect: read
      questions:
      - Which goods in (ASN) charges are on a confirmed invoice?
      - Can I see the goods in line items on an invoice?
      instructions:
      - text: List the goods in charges on invoice {id}.
        slots:
          id: path.id
      - text: Show the ASN line items for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Collections'].get
  update:
    x-apievangelist-phrasing:
      intent: List an invoice's collection charges
      effect: read
      questions:
      - Which collection charges are on a confirmed invoice?
      - Can I see the collection line items on an invoice?
      instructions:
      - text: List the collection charges on invoice {id}.
        slots:
          id: path.id
      - text: Show the collection line items for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Other'].get
  update:
    x-apievangelist-phrasing:
      intent: List an invoice's generic charges
      effect: read
      questions:
      - Which generic (additional) charges are on a confirmed invoice?
      - Can I see the other line items on an invoice?
      instructions:
      - text: List the generic charges on invoice {id}.
        slots:
          id: path.id
      - text: Show the other line items for invoice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/InvoiceItemTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List additional invoice item types
      effect: read
      questions:
      - What additional item types can I add to an invoice?
      - Which invoice item types are available for additional charges?
      instructions:
      - text: List the additional invoice item types.
      - text: Show the available invoice item types.
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/AddAdditionalInvoiceItem'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an additional charge to an invoice
      effect: write
      questions:
      - How do I add a one-off charge to an invoice?
      - Can I add a generic item to an invoice for a specific warehouse?
      instructions:
      - text: Add {Type} item of {Amount} to invoice for client {ClientId} dated {InvoiceDate}.
        slots:
          Type: query.Type
          Amount: query.Amount
          ClientId: query.ClientId
          InvoiceDate: query.InvoiceDate
      - text: Add {Type} charge {Amount} to client {ClientId} invoice dated {InvoiceDate} with comment {Comment}.
        slots:
          Type: query.Type
          Amount: query.Amount
          ClientId: query.ClientId
          InvoiceDate: query.InvoiceDate
          Comment: query.Comment
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Accounting/LocationTypeStoragePrice'].post
  update:
    x-apievangelist-phrasing:
      intent: Set a storage price for a location type
      effect: write
      questions:
      - How do I set a storage cost per location type?
      - Can I define a storage price that applies to a location type?
      instructions:
      - text: Set storage cost {Cost} for location type {LocationType}.
        slots:
          Cost: requestBody.Cost
          LocationType: requestBody.LocationType
      - text: Define a {Frequency} storage price of {Cost} for {LocationType} at client {Client}.
        slots:
          Frequency: requestBody.Frequency
          Cost: requestBody.Cost
          LocationType: requestBody.LocationType
          Client: requestBody.Client
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/GetUnconfirmedInvoiceSummary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize unconfirmed invoices
      effect: read
      questions:
      - What is the total of unconfirmed invoices for a client?
      - Can I get a summary of invoices not yet confirmed?
      instructions:
      - text: Summarize unconfirmed invoices for client {clientID} from {fromDate} to {toDate}.
        slots:
          clientID: query.clientID
          fromDate: query.fromDate
          toDate: query.toDate
      - text: Give me the unconfirmed invoice total for {clientID} between {fromDate} and {toDate}.
        slots:
          clientID: query.clientID
          fromDate: query.fromDate
          toDate: query.toDate
      method: generated
      generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/GetUnconfirmedInvoiceStorageCosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List unconfirmed storage costs on invoices
      effect: read
      questions:
      - Which storage costs are still unconfirmed on invoices?
      - Can I page through unconfirmed invoice storage costs?
      instructions:
      - text: List unconfirmed storage costs for client {clientID} from {fromDate} to {toDate}.
        slots:
          clientID: query.clientID
          fromDate: query.fromDate
          toDate: query.toDate
      - text: Show page {pageNo} of unconfirmed storage costs for {clientID} between {fromDate} and {toDate}, {limit} per page.
        slots:
          pageNo: query.pageNo
          clientID: query.clientID
          fromDate: query.fromDate
          toDate: query.toDate
          limit: query.limit
      method: generated
      generated: '2026-11-20'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/mintsoft-accounting-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.