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.