# handel.halowerk.com VAT Resolve

> handel.halowerk.com VAT Resolve is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Validates a VAT number against VIES and determines the correct VAT treatment (domestic, intra-community reverse charge, B2C distance, or export) for a given supplier-customer transaction in a single call.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/vat-resolve
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/handel-halowerk-com-vat-resolve-f9a77d68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g4iE2pIG57h4wpz-73thn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability handel-halowerk-com-vat-resolve-f9a77d68 -d '<json body>'
```

Example prompt: Check if VAT number DE123456789 is valid and tell me the correct VAT treatment for a sale from a German supplier to a French business customer — I need to know whether to apply reverse charge or charge local VAT.

## When to prefer this

Use this endpoint when you need both VAT number validation and VAT treatment determination in a single API call for EU cross-border transactions. It is the right choice for automating invoice generation, quoting workflows, or compliance checks where you need to know both whether a customer's VAT number is legitimate and which tax regime applies. Prefer it over separate VIES lookups combined with manual treatment logic, especially when handling B2B, B2C, and export scenarios programmatically.

## Known failure modes

- VIES service temporarily unavailable — member state's registry may be offline at the time of consultation
- Invalid VAT number format — returns validation error before querying VIES
- Unknown or unsupported country code — treatment logic cannot be applied
- VAT number not found in VIES — returns invalid status with consultation date
- Network timeout if VIES member state is slow to respond

## How this service works

Two answers in one call. Validation: the number is checked against the VIES service of the member state that issued it, with the consultation date returned. Treatment: given the supplier country, the customer country and whether the customer is a business, it states whether the supply is domestic with the local rate, an intra-community B2B supply where the reverse charge shifts the liability to the customer, a B2C supply taxed where the customer sits, or an export outside the EU.

## Output

Returns two sets of results: (1) VAT validation — whether the number is currently registered in VIES, the member state that issued it, and the consultation timestamp; (2) VAT treatment — one of domestic (local rate applies), intra-community B2B (reverse charge, liability shifts to customer), B2C distance supply (taxed at customer location), or export outside the EU (zero-rated). The treatment is determined from the supplier country, customer country, and business status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vat_number": {
   "type": "string",
   "maxLength": 20,
   "minLength": 4,
   "description": "VAT number with country prefix, e.g. DE811907980."
  },
  "supply_type": {
   "enum": [
    "goods",
    "services",
    "digital_services"
   ],
   "type": "string",
   "default": "goods",
   "description": "What is being supplied."
  },
  "supplier_country": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "ISO country code of the supplier, for the treatment question."
  },
  "customer_is_business": {
   "type": "boolean",
   "default": true,
   "description": "Whether the customer is a business (B2B) or a consumer (B2C)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/handel-halowerk-com-vat-resolve-f9a77d68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from handel.halowerk.com](https://www.zero.xyz/host/handel.halowerk.com/llms.txt)