AppZen Purchase Orders API
The Purchase Orders API from AppZen — 4 operation(s) for purchase orders.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/appzen-purchase-orders-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
openapi: 3.2.0
info:
title: Autonomous AP APIs Chart of Accounts Purchase Orders 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: Purchase Orders
paths:
/purchase-order:
post:
tags:
- Purchase Orders
summary: Creates/Updates a purchase order
description: Creates a new purchase order in AppZen and returns a uuid that uniquely identifies it. When there already exists a purchase order (purchase_order_number), then the operation is an update (the `status` would be `UPDATED` in this case).
parameters:
- $ref: '#/components/parameters/purchase-order-json-schema'
- 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'
/purchase-order/{uuid}:
get:
tags:
- Purchase Orders
summary: Returns a purchase order's details
description: Returns the details of a purchase order by uuid
parameters:
- $ref: '#/components/parameters/uuid'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/purchase-order'
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'
/purchase-order/purchase-order-number/{po-number}:
get:
tags:
- Purchase Orders
summary: Returns a purchase order's details
description: Returns the details of a purchase order for a purchase order number
parameters:
- in: path
description: external purchase order number
required: true
name: po-number
schema:
type: string
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/purchase-order'
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'
/purchase-order/purchase-order-number/{po-number}/purchase-order-unique-id/{po-unique-id}:
get:
tags:
- Purchase Orders
summary: Returns a purchase order's details
description: Returns the details of a purchase order for a purchase order number and its unique id
parameters:
- in: path
description: external purchase order number
required: true
name: po-number
schema:
type: string
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/purchase-order'
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'
components:
schemas:
purchase-order:
type: object
properties:
purchase_order_number:
type: string
example: 193-994K
description: The Purchase Order(PO) Number from source system
entity_id:
type: string
example: '1002'
description: The unique entity identifier
entity_name:
type: string
example: Acme Inc
description: The entity name
supplier_id:
type: string
example: '3009293'
description: The unique supplier identifier in the source system that matches with the supplier reference sent in supplier file. Refer to supplier template
gl_code:
type: string
example: 1002.369.922.0000.0000
payment_term_id:
type: string
example: '8900012'
description: This value should be unique in the customer’s ERP system to distinguish payment terms
external_unique_id:
type: string
example: XP-1234-01
description: The unique identifier in ERP
comments:
type: string
example: Buying whiteboards for office
exchange_rate:
allOf:
- $ref: '#/components/schemas/exchange-rate'
start_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date when the purchase order has been issued to a vendor
end_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date for which delivery of any Product is stated in a Purchase Order and confirmed by Supplier
total_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The total amount of the PO
amount_limit:
allOf:
- $ref: '#/components/schemas/amount'
min_release_amount:
allOf:
- $ref: '#/components/schemas/amount'
email_address:
type: string
example: john.doe@acme.org
purchase_requisition_id:
type: string
example: null
purchase_order_type:
type: string
description: Can be of type for example Blanket/Standard/Contract
purchase_order_status:
type: string
example: Issued
description: This status value shows the purchase order (header level) status as shown in the customer’s ERP system
appzen_purchase_order_status:
type: string
enum:
- PO_STATUS_NOT_AVAILABLE
- PO_ISSUED
- PO_CLOSED
example: PO_ISSUED
description: AppZen purchase order status
ship_to_location:
type: string
ship_to_location_id:
type: string
requester:
type: string
custom_json:
type: object
po_conditions:
type: array
items:
allOf:
- $ref: '#/components/schemas/purchase-order-condition'
description: Header-level PO conditions (e.g., overall freight charges, taxes applied to entire PO)
purchase_order_lines:
type: array
items:
type: object
properties:
po_line_id:
type: string
description: The unique identifier of the line from source system
line_number:
type: number
description: The reference of the line
gl_code:
type: string
line_item_code:
type: string
line_description:
type: string
quantity:
type: number
description: The quantity of goods and services provided by the supplier. If not specified, defaults to 1
unit_price:
allOf:
- $ref: '#/components/schemas/amount'
description: Per unit price. If not specified, defaults to amount divided by quantity
price_per_unit:
type: number
example: 2.55
amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The line amount of the purchase order line
line_vat_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The total line vat amount of the purchase order line
line_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/vat-breakdown-item'
- description: The break down of vat amount for the purchase order line
line_allocations:
type: array
items:
allOf:
- $ref: '#/components/schemas/po-line-allocation'
contractor_name:
type: string
contractor_start_date:
allOf:
- $ref: '#/components/schemas/date'
closed_flag:
type: boolean
closed_by:
type: string
closed_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date on which PO was closed
closed_reason:
type: string
description: The reason for closing the PO
cancel_flag:
type: boolean
description: If the PO is cancelled
cancel_date:
allOf:
- $ref: '#/components/schemas/date'
- description: Date on which the PO was cancelled.
cancel_reason:
type: string
description: Reason for cancellation
taxable_flag:
type: boolean
description: If the PO is taxable
tax_code_id:
type: string
description: The tax code Id of the purchase order
tax_name:
type: string
description: The tax name on the purchase order
type_1099:
type: string
committed_amount:
allOf:
- $ref: '#/components/schemas/amount'
amount_limit:
allOf:
- $ref: '#/components/schemas/amount'
unit_list_price:
allOf:
- $ref: '#/components/schemas/amount'
- description: The unit list price you charge per unit of goods or services
base_list_price:
allOf:
- $ref: '#/components/schemas/amount'
uninvoiced_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: Balance left in the PO line
received_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: Received Amount in the PO line
progress_payment_rate:
type: number
item_category:
type: string
description: category name
item_category_id:
type: string
hazard_class_id:
type: string
unit_of_measure:
type: string
description: The unit of measure for the line item. Ex. each, pallet, package, etc
committed_quantity:
type: number
description: The mandatory quantity to be provided
ordered_quantity:
type: number
received_quantity:
type: number
uninvoiced_quantity:
type: number
service_line_start_date:
allOf:
- $ref: '#/components/schemas/date'
service_line_end_date:
allOf:
- $ref: '#/components/schemas/date'
match_basis:
type: string
enum:
- NONE_MATCH_BASIS
- AMOUNT
- QUANTITY
match_type:
allOf:
- $ref: '#/components/schemas/po_policy_match_type'
line_type:
type: string
enum:
- NONE_LINE_TYPE
- GOODS
- SERVICE
- FREIGHT
- TAX
- MISCELLANEOUS
purchase_order_line_status:
type: string
description: This status value shows the purchase order line status as shown in the customer’s ERP system
appzen_purchase_order_line_status:
type: string
description: This status value shows the appzen purchase order line status as configured during purchase order ingestion
purchase_requisition_id:
type: string
buyer:
type: string
custom_json:
type: object
amortization_start_date:
allOf:
- $ref: '#/components/schemas/date-time'
amortization_end_date:
allOf:
- $ref: '#/components/schemas/date-time'
amortization_schedule_details:
type: object
properties:
id:
type: integer
name:
type: string
hsn_sac_code:
type: string
po_line_conditions:
type: array
items:
allOf:
- $ref: '#/components/schemas/purchase-order-condition'
description: Line-level PO conditions specific to this PO line (e.g., line-specific freight charges, taxes)
required:
- line_number
- gl_code
- amount
- uninvoiced_amount
- purchase_order_line_status
- appzen_purchase_order_line_status
required:
- entity_id
- supplier_id
- purchase_order_number
- purchase_order_status
- appzen_purchase_order_status
- purchase_order_lines
exchange-rate:
description: Optional. If the exchange_rate is provided, then all three fields (from_currency_code, to_currency_code and conversion_rate) are required.
example:
from_currency_code: USD
to_currency_code: EUR
conversion_rate: 0.92
required:
- from_currency_code
- to_currency_code
- conversion_rate
properties:
conversion_rate:
type: number
example: 0.92
from_currency_code:
type: string
example: USD
to_currency_code:
type: string
example: EUR
type: object
http-404-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 404
error:
type: string
example: Not Found
message:
type: string
example: 'Error code : 17e3338d - The resource you specified cannot be not found'
date-time:
type: string
format: date-time
example: '2024-03-01T11:01:00Z'
description: date should be in UTC format
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'
po_policy_match_type:
type: string
enum:
- PO_NONE_MATCH_TYPE
- PO_POLICY_TWO_WAY_MATCH
- PO_POLICY_THREE_WAY_MATCH
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'
uuid-updated:
type: object
properties:
uuid:
type: string
example: 5fc03087-d265-11e7-b8c6-83e29cd24f4c
status:
type: string
example: UPDATED
purchase-order-json-schema:
type: object
properties:
purchase_order_number:
type: string
example: 193-994K
description: The Purchase Order(PO) Number from source system
entity_id:
type: string
example: '1002'
description: The unique entity identifier
supplier_id:
type: string
example: '3009293'
description: The unique supplier identifier in the source system that matches with the supplier reference sent in supplier file. Refer to supplier template
gl_code:
type: string
example: 1002.369.922.0000.0000
payment_term_id:
type: string
example: '8900012'
description: This value should be unique in the customer’s ERP system to distinguish payment terms
external_unique_id:
type: string
example: XP-1234-01
description: The unique identifier in ERP
comments:
type: string
exchange_rate:
allOf:
- $ref: '#/components/schemas/exchange-rate'
start_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date when the purchase order has been issued to a vendor
end_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date for which delivery of any Product is stated in a Purchase Order and confirmed by Supplier
total_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The total amount of the PO
amount_limit:
allOf:
- $ref: '#/components/schemas/amount'
min_release_amount:
allOf:
- $ref: '#/components/schemas/amount'
email_address:
type: string
example: john.doe@acme.org
purchase_requisition_id:
type: string
example: null
purchase_order_type:
type: string
description: Can be of type for example Blanket/Standard/Contract
purchase_order_status:
type: string
example: Issued
description: This status value should contain the purchase order (header level) status as shown in the customer’s ERP system
appzen_purchase_order_status:
type: string
enum:
- PO_STATUS_NOT_AVAILABLE
- PO_ISSUED
- PO_CLOSED
example: PO_ISSUED
description: Mapping from customer's purchase_order_status to AppZen’s defined purchase order status values
ship_to_location:
type: string
ship_to_location_id:
type: string
requester:
type: string
custom_json:
type: object
description: 20 fields allowed, 500 chars per field
po_conditions:
type: array
items:
allOf:
- $ref: '#/components/schemas/purchase-order-condition'
description: Header-level PO conditions (e.g., overall freight charges, taxes applied to entire PO)
purchase_order_lines:
type: array
items:
type: object
properties:
po_line_id:
type: string
description: The unique identifier of the line from source system
line_number:
type: number
description: The reference of the line
gl_code:
type: string
line_item_code:
type: string
line_description:
type: string
quantity:
type: number
description: The quantity of goods and services provided by the supplier. Should be assigned value of 1 if value is missing
unit_price:
allOf:
- $ref: '#/components/schemas/amount'
price_per_unit:
type: number
example: 2.55
amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The line amount of the purchase order line
line_vat_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: The total line vat amount of the purchase order line
line_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/vat-breakdown-item'
- description: The break down of vat amount for the purchase order line
line_allocations:
type: array
items:
allOf:
- $ref: '#/components/schemas/po-line-allocation'
contractor_name:
type: string
contractor_start_date:
allOf:
- $ref: '#/components/schemas/date'
closed_flag:
type: boolean
closed_by:
type: string
closed_date:
allOf:
- $ref: '#/components/schemas/date'
- description: The date on which PO was closed
closed_reason:
type: string
description: The reason for closing the PO
cancel_flag:
type: boolean
description: If the PO is cancelled
cancel_date:
allOf:
- $ref: '#/components/schemas/date'
- description: Date on which the PO was cancelled.
cancel_reason:
type: string
description: Reason for cancellation
taxable_flag:
type: boolean
description: If the PO is taxable
tax_code_id:
type: string
description: The tax code Id of the purchase order
tax_name:
type: string
description: The tax name on the purchase order
type_1099:
type: string
committed_amount:
allOf:
- $ref: '#/components/schemas/amount'
amount_limit:
allOf:
- $ref: '#/components/schemas/amount'
unit_list_price:
allOf:
- $ref: '#/components/schemas/amount'
- description: The unit list price you charge per unit of goods or services
base_list_price:
allOf:
- $ref: '#/components/schemas/amount'
uninvoiced_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: Balance left in the PO line
received_amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: Received Amount in the PO line
progress_payment_rate:
type: number
item_category:
type: string
description: category name
item_category_id:
type: string
hazard_class_id:
type: string
unit_of_measure:
type: string
description: The unit of measure for the line item. Ex. each, pallet, package, etc
committed_quantity:
type: number
description: The mandatory quantity to be provided
ordered_quantity:
type: number
received_quantity:
type: number
uninvoiced_quantity:
type: number
service_line_start_date:
allOf:
- $ref: '#/components/schemas/date'
service_line_end_date:
allOf:
- $ref: '#/components/schemas/date'
match_basis:
type: string
enum:
- NONE_MATCH_BASIS
- AMOUNT
- QUANTITY
match_type:
allOf:
- $ref: '#/components/schemas/po_policy_match_type'
line_type:
type: string
enum:
- NONE_LINE_TYPE
- GOODS
- SERVICE
- FREIGHT
- TAX
- MISCELLANEOUS
purchase_order_line_status:
type: string
description: This status value should contain the purchase order line status as shown in the customer’s ERP system
appzen_purchase_order_line_status:
type: string
enum:
- PO_STATUS_NOT_AVAILABLE
- PO_ISSUED
- PO_CLOSED
example: PO_ISSUED
description: Mapping from customer's purchase_order_line_status to AppZen’s defined purchase order line status values
purchase_requisition_id:
type: string
buyer:
type: string
amortization_start_date:
allOf:
- $ref: '#/components/schemas/date-time'
amortization_end_date:
allOf:
- $ref: '#/components/schemas/date-time'
amortization_schedule_details:
type: object
properties:
id:
type: integer
name:
type: string
hsn_sac_code:
type: string
custom_json:
description: 20 fields allowed, 500 chars per field
type: object
po_line_conditions:
type: array
items:
allOf:
- $ref: '#/components/schemas/purchase-order-condition'
description: Line-level PO conditions specific to this PO line (e.g., line-specific freight charges, taxes)
required:
- line_number
- gl_code
- quantity
- unit_price
- amount
- uninvoiced_amount
- purchase_order_line_status
- appzen_purchase_order_line_status
purchase_order_date:
allOf:
- $ref: '#/components/schemas/date'
required:
- entity_id
- supplier_id
- purchase_order_number
- purchase_order_status
- appzen_purchase_order_status
- purchase_order_lines
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'
purchase-order-condition:
type: object
description: Represents a condition on a PO (e.g., freight charges, taxes, discounts). Can be at header level (applying to entire PO) or line level (specific to a PO line)
required:
- scope
- po_header_id
- condition_type
- condition_basis
- planned_amount
- is_statistical
properties:
scope:
type: string
enum:
- HEADER
- LINE
example: HEADER
description: Whether this condition applies to the entire PO (HEADER) or a specific PO line (LINE). Use HEADER for po_conditions; use LINE for po_line_conditions
po_header_id:
type: string
example: PO-12345
description: The PO identifier this condition belongs to
po_line_id:
type: string
example: '10'
description: The PO line identifier (required when scope is LINE, empty for HEADER scope)
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_FO
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/appzen/refs/heads/main/openapi/appzen-purchase-orders-api-openapi.yml