The Purchasers API handles the complete order lifecycle from creation to fulfillment, including payment processing and status tracking.

​
Welcome to Purchasers API

The Purchasers API manages the entire purchase order workflow for your e-commerce platform. Create orders, process payments, and track fulfillment status with comprehensive order management.

​
Key Features

  • Order Creation: Create new purchase orders with items and payment details
  • Status Management: Track orders through the complete lifecycle
  • Payment Processing: Support for multiple payment methods
  • Order Tracking: Monitor order status and fulfillment
  • Address Management: Handle shipping and billing addresses
  • Approval Workflows: Multi-step approval processes with role-based access
  • Multi-Currency Support: Create and manage orders in different currencies
  • Urgency Levels: Prioritize orders with urgency classifications
  • Audit Trails: Complete approval and modification history

​
Authentication

All API endpoints are authenticated using Bearer tokens.

​
Order Lifecycle

​
Order Statuses

  • Pending: Order created, awaiting confirmation
  • Confirmed: Order confirmed and payment processed
  • Processing: Order being prepared for shipment
  • Shipped: Order dispatched to customer
  • Delivered: Order successfully delivered
  • Cancelled: Order cancelled by customer or system
  • Refunded: Order refunded to customer

​
Data Models

​
Purchase Order

  • Order Details: Order number, status, and timestamps
  • Items: Product SKUs, quantities, and pricing
  • Financial: Subtotal, tax, shipping, and total amounts
  • Addresses: Shipping and billing address information
  • Payment: Payment method and transaction details