احتفظ بنظامك، ونحن نربطه بزاتكا

curl -X POST https://YOUR-ACCOUNT.xrero.com/api/zatca/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "INV-1001",
    "invoice_type": "simplified",
    "payment_means": "10",
    "lines": [
      {"name": "Basmati rice 5kg", "quantity": 2, "unit_price": 49},
      {"name": "Bottled water 1.5L", "quantity": 6, "unit_price": 1.5}
    ]
  }'

{
  "external_id": "INV-1002",
  "buyer": {
    "name": "Al Noor Trading Co.", "vat": "311111111100003",
    "street": "King Fahd Road", "building_number": "1234",
    "district": "Al Olaya", "city": "Riyadh", "postal_code": "12211"
  },
  "lines": [{"name": "Office chair", "quantity": 4, "unit_price": 350, "discount_percent": 5}]
}

HTTP/1.1 201 Created
{
  "id": 88, "external_id": "INV-1002", "number": "INV/2026/00088",
  "document_type": "invoice", "invoice_type": "standard",
  "status": "cleared", "can_deliver": true,
  "uuid": "…", "icv": 45, "qr": "AQ9…",
  "totals": {"net": 1330.0, "vat": 199.5, "total": 1529.5, "currency": "SAR"},
  "messages": {"errors": [], "warnings": []},
  "links": {"pdf": "…/documents/88/pdf", "xml": "…/documents/88/xml"}
}

{
  "external_id": "CN-1001",
  "document_type": "credit_note",
  "original": {"external_id": "INV-1001"},
  "reason": "Customer returned one bottle",
  "lines": [{"name": "Bottled water 1.5L", "quantity": 1, "unit_price": 1.5}]
}