# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara Tax Calculation API
  version: 1.0.0
extends: openapi/avalara-tax-calculation-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/calculations'].post
  update:
    x-apievangelist-phrasing:
      intent: Calculate Brazilian taxes on a transaction
      effect: read
      questions:
      - How much ICMS, IPI, PIS and COFINS applies to a sale in Brazil?
      - Can I calculate ISS on a Brazilian service transaction?
      instructions:
      - text: Calculate Brazilian taxes for header {header} and lines {lines}.
        slots:
          header: requestBody.header
          lines: requestBody.lines
      - text: Work out ICMS and IPI on these lines {lines} with header {header}.
        slots:
          lines: requestBody.lines
          header: requestBody.header
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/CalcTaxes'].post
  update:
    x-apievangelist-phrasing:
      intent: Calculate communications taxes
      effect: read
      questions:
      - What telecom taxes apply to a VoIP invoice?
      - Can I calculate communications taxes on several invoices in one batch?
      instructions:
      - text: Calculate communications taxes for company {cmpn} on invoices {inv}.
        slots:
          cmpn: requestBody.cmpn
          inv: requestBody.inv
      - text: Run a telecom tax calculation on {inv} for {cmpn}.
        slots:
          inv: requestBody.inv
          cmpn: requestBody.cmpn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit a communications tax transaction
      effect: write
      questions:
      - How do I finalize a communications tax calculation for reporting?
      - Can I commit a previously calculated telecom invoice by document code?
      instructions:
      - text: Commit communications document {doc}.
        slots:
          doc: requestBody.doc
      - text: Set commit flag {cmmt} on communications tax document {doc}.
        slots:
          cmmt: requestBody.cmmt
          doc: requestBody.doc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/CalcAdj'].post
  update:
    x-apievangelist-phrasing:
      intent: Calculate taxes on a credit or refund
      effect: read
      questions:
      - How much communications tax do I reverse on a customer credit?
      - Can I calculate adjustment taxes for a refund on a committed invoice?
      instructions:
      - text: Calculate adjustment taxes for {adj} on invoice {inv}.
        slots:
          adj: requestBody.adj
          inv: requestBody.inv
      - text: Work out the tax credit for a refund on company {cmpn} invoice {inv}.
        slots:
          cmpn: requestBody.cmpn
          inv: requestBody.inv
      method: generated
      generated: '2026-09-26'