✓ Verified 💻 Development ✓ Enhanced Data

Upinvoice

This skill allows any OpenClaw-powered agent to extract structured JSON data from invoice images or

Rating: 4.6 (90 reviews)
Downloads: 43,562 downloads
Version: 1.0.0

Overview

This skill allows any OpenClaw-powered agent to extract structured JSON data from invoice images or PDFs.

Complete Documentation

View Source →

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
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:

json

{
  "success": true,
  "data": {
    "supplier": {
      "name": "ACME Spain S.L.",
      "name_alias": "ACME Tech",
      "phone": "+34 912 345 678",
      "email": "[email protected]",
      "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

Log in to your dashboard at UpInvoice.eu.
Go to the API Tokens section.
Click on Create Token, give it a name (e.g., "OpenClaw Skill") and click Save.
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:

Extract: Call process_invoice to get the JSON.
Review: Present the extracted data (Supplier, Date, Total, Lines) to the user for validation.
Map: Map the JSON fields to your ERP's API (e.g., Dolibarr, Holded, Factusol, SAP).
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."

Installation

Terminal bash


openclaw install upinvoice

Copied!

💻Code Examples

#### Typical Response Payload Example:

-typical-response-payload-example.json

{
  "success": true,
  "data": {
    "supplier": {
      "name": "ACME Spain S.L.",
      "name_alias": "ACME Tech",
      "phone": "+34 912 345 678",
      "email": "[email protected]",
      "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
  }
}