Purchase Order Generator API

POST https://api.findutils.com/api/tools/purchase-order-generator/execute

Return a purchase order as structured data and as Markdown text: line items with amounts, subtotal, tax, shipping, and total, plus company, vendor, shipping, dates, notes, and terms. Amounts use 2 decimals. This tool does not produce a PDF.

Open the tool Try it

Request body

application/json

company_name

string optional

Buyer company name.
company_address

string optional

Buyer address; newlines separate lines.
vendor_name

string optional

Vendor name.
vendor_address

string optional

Vendor address.
vendor_contact

string optional

Vendor contact (email or phone).
po_number

string optional

Purchase order number. Default: PO-<timestamp>.
po_date

string optional

Order date as YYYY-MM-DD. Default: today (UTC).
delivery_date

string optional

Requested delivery date as YYYY-MM-DD.
currency

string optional

Currency code. Default: USD. One of USD · EUR · GBP · TRY · CAD · AUD.
shipping_address

string optional

Ship-to address when it differs from the buyer address.
shipping_method

string optional

Shipping method.
items

array required

Line items: { description, quantity, unit_price, item_number?, unit? }. 1-200 items.
tax_rate

number optional

Tax rate in percent applied to the subtotal. Default: 0.
shipping_cost

number optional

Shipping cost added after tax. Default: 0.
notes

string optional

Notes printed on the order.
terms

string optional

Terms and conditions.

Example arguments

Verified

{
  "company_name": "Acme Ltd",
  "vendor_name": "Widgets Inc",
  "po_number": "PO-000123",
  "po_date": "2026-01-15",
  "currency": "USD",
  "items": [
    {
      "description": "Widget",
      "quantity": 2,
      "unit_price": 10
    }
  ],
  "tax_rate": 10,
  "shipping_cost": 3
}

curl -X POST https://api.findutils.com/api/tools/purchase-order-generator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Ltd",
    "vendor_name": "Widgets Inc",
    "po_number": "PO-000123",
    "po_date": "2026-01-15",
    "currency": "USD",
    "items": [
      {
        "description": "Widget",
        "quantity": 2,
        "unit_price": 10
      }
    ],
    "tax_rate": 10,
    "shipping_cost": 3
  }'

const response = await fetch('https://api.findutils.com/api/tools/purchase-order-generator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"company_name":"Acme Ltd","vendor_name":"Widgets Inc","po_number":"PO-000123","po_date":"2026-01-15","currency":"USD","items":[{"description":"Widget","quantity":2,"unit_price":10}],"tax_rate":10,"shipping_cost":3}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/purchase-order-generator/execute",
    json={"company_name":"Acme Ltd","vendor_name":"Widgets Inc","po_number":"PO-000123","po_date":"2026-01-15","currency":"USD","items":[{"description":"Widget","quantity":2,"unit_price":10}],"tax_rate":10,"shipping_cost":3},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/purchase-order-generator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"company_name":"Acme Ltd","vendor_name":"Widgets Inc","po_number":"PO-000123","po_date":"2026-01-15","currency":"USD","items":[{"description":"Widget","quantity":2,"unit_price":10}],"tax_rate":10,"shipping_cost":3}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call purchase_order_generator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: purchase-order-generator
MCP name: purchase_order_generator
Category: Documents
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Documents tools

More to explore