Skip to content
ToolCargo

Docs · Updated 2026-09-11

ZATCA e-invoices — tool reference

VAT-correct invoices from a conversation. This does not submit to ZATCA or sign with a CSID.

Server URL: https://toolcargo.com/mcp/zatca · Scope: connector:zatca · Included with Site Audit.

Seller VAT numbers must be 15 digits, starting and ending with 3. Standard VAT is 15%. Zero-rated lines may pass vatRate: 0.

validate_invoice

Checks required fields and arithmetic. Not counted toward the monthly quota.

input
{
  "invoiceNumber": "2026-104",
  "issueDate": "2026-09-28",
  "sellerName": "Halawa Studio",
  "sellerVat": "300000000000003",
  "sellerAddress": "Riyadh",
  "buyerName": "Acme Co",
  "lines": [{ "description": "Design work", "quantity": 1, "unitPrice": 1000 }]
}

create_invoice

Same input. Returns totals, UBL-style XML and a Phase-1 TLV QR (base64). Counts as one Site Audit call. The QR is not a clearance stamp.