Axonomy Documentation

WooCommerce Integration

The Axonomy WooCommerce plugin automatically generates invoices in Axonomy when orders are completed in your WooCommerce store.

Features

  • Automatic invoice generation when WooCommerce orders are marked as completed
  • Syncs customer billing and shipping information
  • Handles multi-tax rates for different products
  • Includes shipping costs as line items
  • Supports multi-currency
  • Preserves product descriptions and order details

Installation

  1. Download the WooCommerce Axonomy Invoices plugin
  2. Upload and activate it in your WordPress admin panel
  3. Navigate to Settings > Axonomy Invoices
  4. Enter your Axonomy API key

Configuration

API Key Setup

  1. Get your API key from your Axonomy dashboard
  2. Go to WordPress admin > Settings > Axonomy Invoices
  3. Paste your API key in the "API Key" field
  4. Click "Save Changes"

How It Works

When an order is marked as completed in WooCommerce, the plugin automatically:

  1. Collects order information including:
    • Customer details (name, email, addresses)
    • Line items with quantities and prices
    • Tax rates for each item
    • Shipping information and costs
    • Currency details
  2. Creates an invoice in Axonomy with:
    • Correct tax calculations for each line item
    • Separate shipping line item (if applicable)
    • Billing and shipping addresses
    • Complete customer information

Data Mapping

Customer Information

{
name: [Billing First Name + Last Name],
email: [Billing Email],
address: [Billing Address Line 1],
city: [Billing City],
postalCode: [Billing Postcode],
country: [Billing Country],
phone: [Billing Phone],
company: [Billing Company Name]
}

Line Items

{
name: [Product Name],
quantity: [Order Quantity],
pricePerUnit: [Unit Price with Tax],
description: [Product Description],
taxRate: [Calculated Tax Rate]
}

Troubleshooting

The plugin creates debug files in your wp-content directory:

  • axonomy-debug-payload.json: Contains the data sent to Axonomy
  • axonomy-debug-response.json: Contains the API response

Check these files if you encounter any issues with invoice generation.

Requirements

  • WordPress 5.0 or higher
  • WooCommerce 3.0 or higher
  • Active Axonomy Freelancer Plan or higher
  • Based on your traffic you can use the free plan, bare in mind that the free plan has a limit of 5 invoices per month
  • Valid Axonomy API key

Support

If you encounter any issues:

  1. Check the debug files in wp-content
  2. Verify your API key is correct
  3. Ensure your Axonomy plan supports API access
  4. Contact Axonomy support with your debug files