UpInvoice: Invoice AI Processing Skill

UpInvoice: Invoice AI Processing Skill

This skill allows any OpenClaw-powered agent to extract structured JSON data from invoice images or PDFs using the UpInvoice.eu AI service. It is designed to be the fastest and most cost-effective way to automate invoice processing for ERP systems.

🛠️ Tools Defined

process_invoice

Extracts structured data from an invoice file (PDF or Image).

• Endpoint: https://upinvoice.eu/api/process-invoice
• Method: POST
• Header: Authorization: Bearer <YOUR_API_KEY>
• Parameters:
  • invoice_file (string, required): The base64-encoded string of the file (PDF, PNG, JPG). Must include the data URI prefix (e.g., data:application/pdf;base64,...).
  • company_name (string, optional): Your company name for extraction context.
  • company_tax_id (string, optional): Your tax/VAT ID.

Typical Response Payload Example:

{
  "success": true,
  "data": {
    "supplier": {
      "name": "ACME Spain S.L.",
      "name_alias": "ACME Tech",
      "phone": "+34 912 345 678",
      "email": "invoices@acme.es",
      "idprof1": "B12345678",
      "tva_intra": "ESB12345678",
      "address": "Calle Mayor 1",
      "zip": "28001",
      "town": "Madrid",
      "country_code": "ES",
      "state": "Madrid"
    },
    "ref_supplier": "2024-FAC-045",
    "date": "2024-03-15",
    "total_ht": 100.00,
    "total_tva": 21.00,
    "total_ttc": 121.00,
    "tva_tx": 21.0,
    "localtax2": 0.0,
    "is_credit_invoice": false,
    "lines": [
      {
        "product_desc": "Cloud Hosting Service - March 2024",
        "qty": 1,
        "pu_ht": 100.00,
        "tva_tx": 21.0,
        "total_ht": 100.00,
        "total_ttc": 121.00,
        "product_type": 1
      }
    ],
    "available_points": 3
  }
}

Note: available_points shows remaining credits for the current user.

🚀 Setup & Registration

1. Register for Free

Go to UpInvoice.eu/register and create an account. No credit card is required to start.

2. Get Your 4 Free Invoices

Upon registration, your account is automatically credited with 4 free invoice processings. This allows you to test the API integration fully before committing to a plan.

3. Generate Your API Key

1. Log in to your dashboard at UpInvoice.eu.
2. Go to the API Tokens section.
3. Click on Create Token, give it a name (e.g., "OpenClaw Skill") and click Save.
4. Important: Copy your token immediately; it will only be shown once.

4. Configure in OpenClaw

Add the generated token as a Bearer Token in your OpenClaw tool configuration or environment variables.

💎 Why UpInvoice?

• Low Cost: We offer the most competitive pricing in the market. Check our recurring plans for high-volume discounts.
• High Speed: Our specialized AI model is optimized for instant extraction, usually returning data in under 2 seconds.
• Accuracy: Designed specifically for European and International invoice formats, including detailed line-item extraction.
• Easy ERP Sync: The structured JSON returned is ready to be mapped to ERPs like Dolibarr, Holded, or Sage.

🏗️ ERP Integration (Workflow Hint)

Since UpInvoice returns a perfectly structured JSON, a bot can easily take this data and send it to any ERP.

Recommended Workflow for the Bot:

1. Extract: Call process_invoice to get the JSON.
2. Review: Present the extracted data (Supplier, Date, Total, Lines) to the user for validation.
3. Map: Map the JSON fields to your ERP's API (e.g., Dolibarr, Holded, Factusol, SAP).
4. Push: Send the validated data to the ERP.

🤖 Bot Instructions (System Prompt Hint)

"When a user provides an invoice or receipt as an image or PDF, first convert it to a Base64 string. Then, call the process_invoice tool. Use the structured data returned to verify the information with the user or prepare it for upload to an ERP system."