Skip to main content

Overview

Purchase Orders represent confirmed orders to vendors for articles and materials. They include detailed pricing, shipping, tax information, and are typically generated from approved quotes and requisitions.

Purchase Order Object

id
number
required
Unique identifier for the purchase order
order_number
string
required
The purchase order number
justification
string
required
Justification for the purchase
article_purchase_order
array
required
Array of articles included in the purchase order
status
string
required
Current status of the purchase order
purchase_date
Date
required
Date when the purchase order was created
tax
number
required
Total tax amount for the purchase order
wire_fee
number
required
Wire transfer fee
card
Card
Payment card used (if applicable)
bank_account
BankAccount
Bank account used for payment (if applicable)
handling_fee
number
required
Handling fee amount
shipping_fee
number
required
Total shipping fee
ock_shipping
number
required
OCK shipping cost
usa_shipping
number
required
USA shipping cost
sub_total
number
required
Subtotal before taxes and fees
total
number
required
Grand total including all taxes and fees
vendor
Vendor
required
Vendor from whom the purchase is made
requisition_order
Requisition
required
Related requisition order
quote_order
Quote
required
Related quote order
location
Location
required
Location associated with the purchase order
created_by
string
required
User who created the purchase order
company
string
required
Company identifier

Example Response

{
  "id": 5678,
  "order_number": "PO-2026-0234",
  "justification": "Purchase for scheduled maintenance of Bell 412 fleet",
  "article_purchase_order": [
    {
      "id": 101,
      "batch": {
        "name": "Hydraulic Components Q1-2026"
      },
      "article_part_number": "HYD-4521-B",
      "quantity": 5,
      "unit": {
        "id": 1,
        "value": "EA",
        "label": "Each"
      },
      "unit_price": "1250.00",
      "article_tax": 125.00,
      "usa_tracking": "1Z999AA10123456784",
      "ock_tracking": "OCK-2026-789",
      "article_location": "Miami Warehouse"
    },
    {
      "id": 102,
      "batch": {
        "name": "Hydraulic Components Q1-2026"
      },
      "article_part_number": "HYD-9876-C",
      "quantity": 3,
      "unit": {
        "id": 1,
        "value": "EA",
        "label": "Each"
      },
      "unit_price": "850.00",
      "article_tax": 76.50,
      "usa_tracking": "1Z999AA10123456785",
      "ock_tracking": "OCK-2026-790",
      "article_location": "Miami Warehouse"
    }
  ],
  "status": "CONFIRMED",
  "purchase_date": "2026-03-11T14:22:00Z",
  "tax": 201.50,
  "wire_fee": 35.00,
  "card": null,
  "bank_account": {
    "id": 7,
    "name": "Corporate Account USD",
    "account_number": "****5678",
    "account_type": "CHECKING",
    "account_owner": "SIGEAC Operations LLC"
  },
  "handling_fee": 125.00,
  "shipping_fee": 450.00,
  "ock_shipping": 200.00,
  "usa_shipping": 250.00,
  "sub_total": 8800.00,
  "total": 9611.50,
  "vendor": {
    "id": 42,
    "name": "Aviation Parts International",
    "phone": "+1-305-555-0199",
    "type": "PROVEEDOR",
    "address": "1234 Aviation Blvd, Miami, FL 33142",
    "email": "[email protected]"
  },
  "requisition_order": {
    "id": 1234,
    "order_number": "REQ-2026-001"
  },
  "quote_order": {
    "id": 3456,
    "quote_number": "QTE-2026-067"
  },
  "location": {
    "id": 1,
    "name": "Main Base Caracas",
    "address": "Aeropuerto Internacional Simón Bolívar",
    "type": "BASE",
    "cod_iata": "CCS"
  },
  "created_by": "[email protected]",
  "company": "SIGEAC C.A."
}

Cost Breakdown

Purchase orders include multiple cost components:
  • Sub Total: Sum of all article prices
  • Tax: Total tax on articles
  • Shipping Fee: Combined USA and OCK shipping costs
  • Handling Fee: Additional handling charges
  • Wire Fee: Bank transfer fees
  • Total: Final amount including all costs

Tracking Information

Each article in a purchase order can have separate tracking numbers:
  • usa_tracking: Tracking number for USA-based shipping
  • ock_tracking: Tracking number for OCK logistics

Build docs developers (and LLMs) love