AppZen Invoices API

The Invoices API from AppZen — 3 operation(s) for invoices.

Operations 3

POST /invoice Creates/Updates an invoice #
POST /invoice/search Returns all invoices uuid that match the search criteria #
GET /invoice/{uuid} Returns an invoice's details #

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API
curl "https://apis.io/api/v1/apis/appzen-invoices-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

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

OpenAPI Specification

appzen-invoices-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Autonomous AP Invoices API
  description: Public APIs for integrating with Autonomous AP
  version: 2.0.3
servers:
- url: https://<env>.appzen.com/dictionary-data-services
security:
- API Key Header: []
  Customer Id Header: []
  Customer Key Header: []
tags:
- name: Invoices
paths:
  /invoice:
    post:
      tags:
      - Invoices
      summary: Creates/Updates an invoice
      description: This will create a new invoice in AppZen referred by uuid. This invoice will be processed further by AppZen for extraction and validation. When there already exists an invoice (invoice_id), then the operation is an update (the `status` would be `UPDATED` in this case).
      parameters:
      - $ref: '#/components/parameters/invoice-json-schema'
      - in: header
        name: historical
        required: false
        description: Flag to indicate whether the invoice is historical or not
        schema:
          type: boolean
          default: false
      - in: header
        name: bypass-coa-lookup
        required: false
        description: Flag to indicate whether the Chart of Account segments should be identified/constructed by parsing gl_code
        schema:
          type: boolean
          default: false
      responses:
        200:
          description: Updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/uuid-updated'
        201:
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/uuid'
        400:
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-400-error-response'
        401:
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-401-error-response'
        403:
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-403-error-response'
        404:
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-404-error-response'
        500:
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-500-error-response'
      operationId: postInvoice
      x-operation-id-source: derived
  /invoice/search:
    post:
      tags:
      - Invoices
      summary: Returns all invoices uuid that match the search criteria
      description: Returns a list of the invoice uuids that match the status, from-date and end-date
      parameters:
      - $ref: '#/components/parameters/find-invoice-query-spec'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/find-invoice-result-spec'
        400:
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-400-error-response'
        401:
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-401-error-response'
        403:
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-403-error-response'
        404:
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-404-error-response'
        500:
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-500-error-response'
      operationId: postInvoiceSearch
      x-operation-id-source: derived
  /invoice/{uuid}:
    get:
      tags:
      - Invoices
      summary: Returns an invoice's details
      description: Returns the details of an invoice by uuid
      parameters:
      - $ref: '#/components/parameters/uuid'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/invoice-get-json-schema'
        400:
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-400-error-response'
        401:
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-401-error-response'
        403:
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-403-error-response'
        404:
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-404-error-response'
        500:
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http-500-error-response'
      operationId: getInvoiceByUuid
      x-operation-id-source: derived
components:
  schemas:
    find-invoice-query-spec:
      properties:
        appzen-invoice-status:
          description: Audit status assigned to invoice by Appzen
          type: string
          enum:
          - PROCESSED
          - REJECTED
        erp-invoice-status:
          description: ERP invoice status
          type: string
          example: Pending Manager Review
        invoice-id:
          type: string
        invoice-number:
          type: string
        supplier-id:
          type: string
        from-last-appzen-update-time:
          description: Start Date Range value for Appzen processing date specified in UTC format
          allOf:
          - $ref: '#/components/schemas/date-time'
        to-last-appzen-update-time:
          description: End Date Range for Appzen processing date specified in UTC format
          allOf:
          - $ref: '#/components/schemas/date-time'
      required:
      - from-last-appzen-update-time
      - to-last-appzen-update-time
    http-401-error-response:
      type: object
      properties:
        timestamp:
          type: string
          example: 2019-01-17T16:12:45.977+0000
        status:
          type: string
          example: 401
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: 'Error code : 17e3338d - Unable to authenticate credentials'
    invoice-line-condition:
      type: object
      description: Represents a PO condition associated with an invoice line (used for subsequent invoice types like freight, tax, etc.)
      properties:
        scope:
          type: string
          enum:
          - HEADER
          - LINE
          example: LINE
          description: Whether this charge originated from a header-level PO condition (HEADER) or a line-level PO condition (LINE). Used to match with PO conditions
        condition_type:
          type: string
          example: FRA1
          description: The condition type code from the PO (e.g., FRA1 for freight, TAX1 for tax). Used to match with PO conditions
        condition_category:
          type: string
          enum:
          - PURCHASE_ORDER_CONDITION_CATEGORY_UNSPECIFIED
          - TAX_JUR_CODE_TRIGGER
          - TAX_EXEMPTION_LICENSE_VIA_CONDITIONS
          - TOTAL_CHARGES_IS_OIL
          - CHARGES_CONDITION_RECORDS_IS_OIL
          - TAX_JURISDICTION_LEVEL_1_WITH_LICENSE
          - TAX_JURISDICTION_LEVEL_2
          - TAX_JURISDICTION_LEVEL_3
          - TAX_JURISDICTION_LEVEL_4
          - CUSTOMER_RESERVE_5
          - CUSTOMER_RESERVE_6
          - CUSTOMER_RESERVE_7
          - CUSTOMER_RESERVE_8
          - CUSTOMER_RESERVE_9
          - PACKAGING
          - DELIVERY_COSTS
          - INSURANCE
          - CONDITION_TAX
          - CASH_DISCOUNT
          - CONDITION_FREIGHT
          - INTERNAL_PRICE
          - BASIC_PRICE
          - PRICE_FOR_INTERCOMPANY_BILLING
          - CUSTOMER_EXPECTED_PRICE
          - BASE_AMOUNT_EXCLUDING_TAX
          - GENERALLY_NEW_WHEN_COPYING
          - SALES_TAX_WITH_LICENSE_CHECKING
          - INPUT_TAX_NOT_DEDUCTIBLE
          - VARIANTS
          - BASE_AMOUNT_INCLUDING_TAX
          - COSTING
          - INVOICE_LIST_CONDITION
          - STANDARD_COST
          - MOVING_COST
          - DISCOUNT_SURCHARGE_FOR_PRECIOUS_METALS
          - PRICE_COMPONENT
          - EXPECTED_SALES_PRICE_INCLUDING_TAX
          - CUSTOMER_RESERVE_X
          - CUSTOMER_RESERVE_Y
          - CUSTOMER_RESERVE_Z
          - RESERVED_FIXED_EXTRA_PAY
          - TRANSFER_PRICE_FOR_GROUP_VALUATION
          - TRANSFER_PRICE_FOR_PROFIT_CENTERS
          - CONFIRMED_PURCHASE_NET_PRICE
          - DOWN_PAYMENT_REQUEST
          - FREE_GOODS_INCLUSIVE
          - CONDITION_PAYMENT
          - PROFIT_CENTER_COST
          - SHIP_AND_DEBIT_1_IBU_HITEC
          - SHIP_AND_DEBIT_2_IBU_HITEC
          - TP_ILV_BASE_TARIF_COVERS_COSTS
          - SSR_DISCOUNT_IS_OIL
          - PROFIT_CENTER_INTERNAL_PRICE_ROUTE
          - AFS_SEASON_DETERMINATION
          - SSR_PARTNER_COMMISSION_IS_OIL
          - AFS_VALUE_ADDED_SERVICES
          example: CONDITION_FREIGHT
          description: The category of the condition
        condition_supplier_id:
          type: string
          example: CARRIER_001
          description: '[Deprecated] Use charge_vendor_id instead. The supplier/vendor ID for this condition'
          deprecated: true
        charge_vendor_id:
          type: string
          example: CARRIER_A
          description: The actual vendor/supplier ID from the invoice for this charge
        charge_vendor_name:
          type: string
          example: DHL Express
          description: The vendor/supplier name for this charge
    amount:
      properties:
        amount:
          example: 1.5
          type: number
        currency:
          example: USD
          type: string
      type: object
    invoice-get-json-schema:
      type: object
      required:
      - invoice_id
      - invoice_number
      - supplier_id
      - invoice_date
      - payment_term
      - total_amount
      - entity_id
      properties:
        total_amount:
          required:
          - amount
          - currency
          type: object
          properties:
            amount:
              type: number
            currency:
              type: string
        invoice_id:
          type: string
        invoice_status:
          type: string
        entity_id:
          type: string
        entity_name:
          type: string
        purchase_order_numbers:
          type: array
          example:
          - 12321XP
          items:
            type: string
        site_id:
          type: string
        invoice_number:
          type: string
        invoice_date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        invoice_type:
          type: string
          enum:
          - INVOICE
          - CREDIT_NOTE
          - DEBIT_NOTE
          - PROFORMA
          - TAX_ONLY
          - DOWN_PAYMENT
          - MPREQ
        original_invoice_id:
          type: string
        original_invoice_date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        original_invoice_number:
          type: string
        payment_term_id:
          type: string
          description: This value should be unique in the customer’s ERP system to distinguish payment terms
        default_tax_option:
          type: string
          example: Calculate
        tax_applicability_id:
          type: string
          example: 2A3B
        remit_to_bank_info:
          type: object
          properties:
            bank_acct_last4:
              type: string
            routing_number_last4:
              type: string
            bank_account_name:
              type: string
            bank_account_type:
              type: string
        requester:
          type: string
          example: pos
        requester_id:
          type: string
          example: SX123
        requester_email_address:
          type: string
          example: pos@appzen.ai
        product_category:
          type: string
          example: software
        documents:
          description: Invoice attachment document
          type: array
          items:
            type: object
            properties:
              uuid:
                example: 6586942e-ff4d-454c-a83f-3a6b9a021c3b
                type: string
              name:
                example: invoice_from_supplier123243
                type: string
              mime_type:
                example: pdf
                type: string
              image_url:
                type: string
                example: https://download-link.appzen.com/Staged_Documents/0102/6586942e-ff4d-454c-a83f-3a6b9a021c3b/AEMB7W..<very-long-url>
              link_expires_after:
                allOf:
                - $ref: '#/components/schemas/date-time'
        supporting_documents:
          description: All other supporting documents for an invoice
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
              name:
                type: string
              mime_type:
                type: string
              image_url:
                type: string
              link_expires_after:
                allOf:
                - $ref: '#/components/schemas/date-time'
          example:
          - uuid: 7586946e-ff4d-9984-f8af-1a9b9a021c3d
            name: supplier_notes.txt
            mime_type: text/plain
            image_url: https://download-link.appzen.com/Staged_Documents/0102/7586946e-ff4d-9984-f8af-1a9b9a021c3d/AEMB7W..<very-long-url>
            link_expires_after: '2024-03-01T11:01:00Z'
          - uuid: 5fc03087-d265-11e7-b8c6-83e29cd24f4c
            name: sop.doc
            mime_type: application/msword
            image_url: https://download-link.appzen.com/Staged_Documents/0102/5fc03087-d265-11e7-b8c6-83e29cd24f4c/AEMB7W..<very-long-url>
            link_expires_after: '2024-03-01T11:01:00Z'
        payments:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/payment'
        payment_notes:
          type: array
          items:
            type: string
          example:
          - First payment on 01/2023
          - Second overdue
        payment_status:
          type: string
          example: Paid half
        memo:
          type: string
          example: apply towards expenses
        shipping_handling_amount:
          allOf:
          - $ref: '#/components/schemas/amount'
        miscellaneous_charges:
          allOf:
          - $ref: '#/components/schemas/amount'
        submission_date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        submitter:
          type: string
        supplier_name:
          type: string
        supplier_number:
          type: string
        supplier_id:
          type: string
        is_one_time_supplier:
          type: boolean
          default: false
          description: 'Stamped by the platform when the resolved supplier master record has

            `supplier_core.is_one_time = true` AND the invoice is not PO-backed.

            Distinct from `supplier_core.is_one_time`: that flag lives on the

            supplier master, this flag travels with the invoice payload and is

            what downstream consumers (validation, ERP export, automation rules,

            reporting) branch on. Read-only on inbound payloads.

            '
          example: false
        tax_amount:
          allOf:
          - $ref: '#/components/schemas/amount'
        vat_amount:
          allOf:
          - $ref: '#/components/schemas/amount'
        vat_breakdown:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/vat-breakdown-item'
            - description: The break down of vat amount for the invoice
        appzen_vat_breakdown:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/appzen-vat-breakdown-item'
            - description: Appzen break down of vat amount for the invoice
        vat_registration_numbers:
          type: array
          items:
            type: string
        total_amount_excluding_vat:
          allOf:
          - $ref: '#/components/schemas/amount'
        supplier_address:
          type: object
          properties:
            address_type:
              type: string
              enum:
              - REMIT_TO
              - BILL_TO
              - SHIP_TO
              - OFFICE
              - SUPPLIER_ADDRESS
              - CUSTOMER_ADDRESS
              - NONE_ADDRESS_TYPE
            address:
              allOf:
              - $ref: '#/components/schemas/addressCore'
          example:
            address_type: SHIP_TO
            address:
              address_line1: APPY LABS INC
              address_line2: 'ATTN: SHIPPING DESK'
              city: PUNE
              state: MAHARASHTRA
              zip: '411004'
              country: INDIA
        billing_address:
          type: object
          properties:
            address_type:
              type: string
              enum:
              - REMIT_TO
              - BILL_TO
              - SHIP_TO
              - OFFICE
              - SUPPLIER_ADDRESS
              - CUSTOMER_ADDRESS
              - NONE_ADDRESS_TYPE
            address:
              allOf:
              - $ref: '#/components/schemas/addressCore'
          example:
            address_type: BILL_TO
            address:
              address_line1: BILL COMPANY
              address_line2: 'ATTN: ACCOUNTS PAYABLE'
              address_line3: PO BOX ABC
              city: PHOENIX
              state: AZ
              zip: '94016'
              country: US
        shipping_address:
          type: object
          properties:
            address_type:
              type: string
              enum:
              - REMIT_TO
              - BILL_TO
              - SHIP_TO
              - OFFICE
              - SUPPLIER_ADDRESS
              - CUSTOMER_ADDRESS
              - NONE_ADDRESS_TYPE
            address:
              allOf:
              - $ref: '#/components/schemas/addressCore'
          example:
            address_type: SHIP_TO
            address:
              address_line1: APPY LABS INC
              address_line2: 'ATTN: SHIPPING DESK'
              city: PUNE
              state: MAHARASHTRA
              zip: '411004'
              country: INDIA
        remit_to_address:
          type: object
          properties:
            address_type:
              type: string
              enum:
              - REMIT_TO
              - BILL_TO
              - SHIP_TO
              - OFFICE
              - SUPPLIER_ADDRESS
              - CUSTOMER_ADDRESS
              - NONE_ADDRESS_TYPE
            address:
              allOf:
              - $ref: '#/components/schemas/addressCore'
          example:
            address_type: REMIT_TO
            address:
              address_line1: ABC COMPANY
              address_line2: 'ATTN: ACCOUNTS RECEIVABLE'
              address_line3: PO BOX 3212
              city: SAN JOSE
              state: CA
              zip: '95016'
              country: US
        other_addresses:
          allOf:
          - $ref: '#/components/schemas/abridgedAddresses'
        gl_code:
          type: string
        segments:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/invoice-account-segment'
        invoice_description:
          type: string
        payment_date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        payment_type_override:
          type: string
          example: CASH
        accounting_date_override:
          allOf:
          - $ref: '#/components/schemas/date-time'
        invoice_lines:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/invoice-line'
        custom_json:
          allOf:
          - $ref: '#/components/schemas/invoice-header-custom-json'
        custom_json_object:
          allOf:
          - $ref: '#/components/schemas/custom_json_object'
        total_wht_amount:
          allOf:
          - $ref: '#/components/schemas/amount'
        wht_breakdown:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/withholding-tax'
        header_discounts:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/discount'
          description: List of discounts applied at invoice header level
        total_discount:
          allOf:
          - $ref: '#/components/schemas/amount'
          description: Total discount amount for the invoice
        header_discount:
          allOf:
          - $ref: '#/components/schemas/amount'
          description: Header level discount amount
        sub_total_after_discount:
          allOf:
          - $ref: '#/components/schemas/amount'
          description: Subtotal after applying header discounts
        payment_type:
          allOf:
          - $ref: '#/components/schemas/payment_type'
          example: ACH
        iban:
          type: string
          example: GB29NWBK60161331926819
        bank_account_number:
          type: string
          example: '1234567890'
        part_bank_key:
          type: string
          description: Unique identifier for the bank account
          example: BANK001
    withholding-tax:
      type: object
      properties:
        type:
          type: string
        code:
          type: string
        base_amount:
          type: object
          required:
          - amount
          - currency
          properties:
            amount:
              type: number
            currency:
              type: string
        wht_amount:
          type: object
          required:
          - amount
          - currency
          properties:
            amount:
              type: number
            currency:
              type: string
    addressCore:
      required:
      - address_line1
      - country
      - zip
      properties:
        address_line1:
          default: ''
          title: The address_line1 schema
          type: string
          example: 12345 MARKET STREET
        address_line2:
          default: ''
          title: The address_line2 schema
          type: string
          example: SUITE 1234
        address_line3:
          default: ''
          title: The address_line3 schema
          type: string
          example: ''
        area_code:
          default: ''
          title: The area_code schema
          type: string
          example: '415'
        city:
          default: ''
          title: The city schema
          type: string
          example: SAN FRANCISCO
        company:
          default: ''
          title: The company schema
          type: string
          example: Preferred Supplier Inc.
        contact:
          default: ''
          title: The contact schema
          type: string
          example: Jane Doe
        country:
          default: ''
          title: The country schema
          type: string
          example: US
        country_iso3:
          default: ''
          title: The country_iso3 schema
          type: string
          example: USA
        email:
          default: ''
          title: The email schema
          type: string
          example: janedoe@supplier.com
        phone:
          default: ''
          title: The phone schema
          type: string
          example: '4042965282'
        province:
          default: ''
          title: The province schema
          type: string
          example: ''
        state:
          default: ''
          title: The state schema
          type: string
          example: CA
        zip:
          default: ''
          title: The zip schema
          type: string
          example: '94016'
    uuid:
      type: object
      properties:
        uuid:
          type: string
          example: 5fc03087-d265-11e7-b8c6-83e29cd24f4c
        status:
          type: string
          example: CREATED
    po_policy_match_type:
      type: string
      enum:
      - PO_NONE_MATCH_TYPE
      - PO_POLICY_TWO_WAY_MATCH
      - PO_POLICY_THREE_WAY_MATCH
    http-403-error-response:
      type: object
      properties:
        timestamp:
          type: string
          example: 2019-01-17T16:12:45.977+0000
        status:
          type: string
          example: 403
        error:
          type: string
          example: Forbidden
        message:
          type: string
          example: 'Error code : 17e3338d - You do not have permission to access this resource'
    abridgedAddresses:
      type: array
      items:
        type: object
        properties:
          address_type:
            type: string
            enum:
            - REMIT_TO
            - BILL_TO
            - SHIP_TO
            - OFFICE
            - SUPPLIER_ADDRESS
            - CUSTOMER_ADDRESS
            - NONE_ADDRESS_TYPE
          address:
            allOf:
            - $ref: '#/components/schemas/addressCore'
    http-400-error-response:
      type: object
      properties:
        timestamp:
          type: string
          example: 2019-01-17T16:12:45.977+0000
        status:
          type: string
          example: 400
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: 'Error code : 17e3338d - Invalid request, please fix and resend'
    invoice-goods-receipt:
      type: object
      properties:
        receipt_id:
          type: string
          example: 123AB
          description: The Receipt ID from source system
        amount:
          allOf:
          - $ref: '#/components/schemas/amount'
          - description: Amount allocated to invoice from this receipt
        quantity:
          type: integer
          format: int32
          example: 10
          description: Quantity allocated to invoice from this receipt
    appzen-vat-breakdown-item:
      type: object
      properties:
        code:
          description: A customer vat code maps to one of these predefined list of vat codes mantained by Appzen.
          type: string
          example: VAT
        rate:
          type: number
          description: rate as percentage
          example: 12
          exclusiveMinimum: 0
    custom_json_object:
      type: object
      description: Set of key value pairs, where each value is an object with two keys - name and id
      example:
        code-region:
          name: us-east
          id: region1s
        code-dept:
          name: wing-1
          id: '325'
    payment:
      type: object
      properties:
        status:
          type: string
        type:
          type: string
          enum:
          - PAYMENT
          - DISCOUNT
          - ADJUSTMENT
          - CREDIT
          example: DISCOUNT
        date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        scheduled_date:
          allOf:
          - $ref: '#/components/schemas/date-time'
        description:
          type: string
        amount:
          allOf:
          - $ref: '#/components/schemas/amount'
        payment_id:
          type: string
        payment_method:
          type: string
        payment_reference_number:
          type: string
        payment_block:
          type: string
        check_number:
          type: string
        remittance_notes:
          type: string
        payment_batch_id:
          type: string
        approval_status:
          type: string
        payment_instructions:
          type: string
        payment_medium:
          type: string
        transaction_fees:
          allOf:
          - $ref: '#/components/schemas/amount'
        requester:
          type: string
        approver:
          type: string
        exchange_rate:
          allOf:
          - $ref: '#/components/schemas/exchange-rate'
        bank_information:
          properties:
            bank_account_name:
              default: ''
              type: string
              example: ABC Bank
            bank_acct_number:
              type: string
              example: 213-29802-8674
    po_receipt_type:
      type: string
      enum:
      - PO
      - GOODS_RECEIPT
    invoice-header-custom-json:
      type: object
      description: 'Maximum of 20 fields allowed, 500 chars per field.

        The following is the list of predefined reserved field names. They are the only field names that can have prefix &quot;appzen&#58; &quot;. They are also not subject to the maximum count limit.


        appzen&#58; vendor_einvoice

        appzen&#58; exchange_rate

        appzen&#58; nota_fiscal_elec_num

        appzen&#58; nota_fiscal_type

        appzen&#58; nota_fiscal_material

        appzen&#58; nota_fiscal_service

        appzen&#58; withholding

        appzen&#58; invoice_category

        appzen&#58; business_place

        appzen&#58; section_code

        appzen&#58; gst_partner

        appzen&#58; place_of_supply

        appzen&#58; invoice_reference_no

        appzen&#58; payment_references

        appzen&#58; qr_reference_code

        appzen&#58; qr_bank

        appzen&#58; qr_unstructured_info

        appzen&#58; qr_structured_info

        appzen&#58; enasarco

        appzen&#58; partner_bank

        appzen&#58; assignment

        appzen&#58; sweden_ocr

        appzen&#58; norway_kid

        appzen&#58; denmark_fik

        appzen&#58; project

        appzen&#58; expenditure_org

        appzen&#58; expenditure_type

        appzen&#58; task

        appzen&#58; work_breakdown_structure

        appzen&#58; latam_vendor_vat_id

        appzen&#58; poland_ksef_id

        appzen&#58; israel_allocation_number

        appzen&#58; buyer_endpoint_id

        appzen&#58; buyer_reference

        appzen&#58; pl_ksef_number

        appzen&#58; pl_ksef_schema_version

        appzen&#58; pl_corrected_invoice_issue_date

        appzen&#58; pl_corrected_invoice_ksef_number

        appzen&#58; pl_corrected_invoice_number

        appzen&#58; pl_reason_for_correction

        appzen&#58; pl_type_of_correction

        appzen&#58; fr_supplier_siren

        appzen&#58; fr_supplier_siret

        appzen&#58; fr_customer_siren

        appzen&#58; fr_customer_siret

        appzen&#58; fr_invoice_format

        appzen&#58; fr_invoice_lifecycle_status

        appzen&#58; it_sdi_codice_destinatario

        appzen&#58; it_sdi_formato_trasmissione

        appzen&#58; it_sdi_id_trasmittente_code

        appzen&#58; it_sdi_id_trasmittente_country

        appzen&#58; it_sdi_pec_destinatario

        appzen&#58; it_sdi_progressivo_invio

        appzen&#58; es_dir3_oficina_contable

        appzen&#58; es_dir3_organo_gestor

        appzen&#58; es_dir3_unidad_tramitadora

        appzen&#58; es_facturae_version

        appzen&#58; de_einvoice_format

        appzen&#58; de_leitweg_id

        appzen&#58; nl_oin

        appzen&#58; nl_preferred_format

        appzen&#58; no_ehf_profile_id

        appzen&#58; no_org_number

        appzen&#58; pt_atcud

        appzen&#58; pt_qr_code_present

        appzen&#58; dk_cvr

        appzen&#58; dk_ean_gln

        appzen&#58; fi_einvoice_address

        appzen&#58; fi_business_id_y_tunnus

        appzen&#58; ie_exchange_rate

        appzen&#58; lu_exchange_rate

        appzen&#58; se_endpoint_id

        appzen&#58; hu_nav_rtir_reporting_required

        appzen&#58; bg_converted_vat_amount

        appzen&#58; be_company_number_kbo_cbe

        appzen&#58; bd_bin_or_tin

        appzen&#58; ca_gst_hst_registration

        appzen&#58; hk_business_registration_number

        appzen&#58; lk_vat_registration

        appzen&#58; mu_vat_number

        appzen&#58; ua_vat_number

        appzen&#

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/appzen/refs/heads/main/openapi/appzen-invoices-api-openapi.yml