Integrations Overview

Waqti supports integration with various enterprise systems to streamline your procurement operations.

Available Integrations

Accounting & ERP Systems

System	Status	Features
Qoyod	✅ Available	Vendor sync, Invoice sync, Payment sync (Saudi)
Odoo	✅ Available	PO sync, Vendor sync, Invoice sync
QuickBooks Online	✅ Available	Invoice sync, Vendor sync, Chart of accounts

E-Signature Providers

Provider	Status	Features
Signit.sa	✅ Available	Saudi-compliant digital signatures, Nafath auth
DocuSign	✅ Available	PO & contract signatures, templates
SignNow	✅ Available	Mobile signing, templates

Automation

Platform	Status	Features
Zapier	✅ Available	5000+ app connections, webhooks, triggers
REST API	✅ Available	Full programmatic access (Pro+ plans)

Authentication Providers

Provider	Status	Protocol
Microsoft Entra ID	✅ Ready	SAML 2.0 / OIDC
Google Workspace	✅ Ready	OIDC
Okta	✅ Ready	SAML 2.0
LDAP/Active Directory	✅ Available	LDAP v3

Payment Gateways

Gateway	Status	Region
Tap Payments	✅ Active	GCC & International
Moyasar	✅ Active	Saudi Arabia
Stripe	🔜 Coming	International

Setting Up Integrations

1. Navigate to Integrations

Settings → Integrations → Add New

2. Select Integration Type

Choose from:

• ERP/Accounting
• Authentication
• Payment

3. Configure Credentials

Each integration requires specific credentials:

Security

Integration credentials are encrypted at rest and never exposed in logs or exports.

4. Test Connection

Always test the connection before enabling sync:

// Connection test response
{
  "status": "success",
  "message": "Connected to Odoo ERP",
  "version": "16.0",
  "database": "production"
}

5. Configure Sync Settings

Set up what data should sync and how often:

Setting	Options	Default
Sync Frequency	Real-time, Hourly, Daily	Hourly
Direction	One-way, Two-way	One-way
Conflict Resolution	Waqti wins, External wins	Waqti wins

Integration Status

Monitor your integrations from the dashboard:

┌─────────────────────────────────────────────────────┐
│ Integration Status                                   │
├─────────────────────────────────────────────────────┤
│ ✅ Odoo ERP          Last sync: 5 minutes ago       │
│ ✅ QuickBooks        Last sync: 1 hour ago          │
│ ⚠️ LDAP              Connection timeout             │
│ ❌ SAP               Not configured                 │
└─────────────────────────────────────────────────────┘

Error Handling

Common Issues

Error	Cause	Solution
CONNECTION_TIMEOUT	Network/firewall issue	Check firewall rules
AUTHENTICATION_FAILED	Invalid credentials	Regenerate API keys
RATE_LIMITED	Too many requests	Reduce sync frequency
DATA_MISMATCH	Schema differences	Review field mappings

Logging

Integration logs are available at:

Settings → Integrations → [Integration] → Logs

Logs include:

• Request/Response data
• Timestamps
• Error messages
• Sync statistics

Data Mapping

Purchase Order Fields

Waqti Field	Odoo Field	QuickBooks Field
po_number	name	DocNumber
vendor_id	partner_id	VendorRef
total_inc_vat	amount_total	TotalAmt
status	state	TxnStatus

Vendor Fields

Waqti Field	Odoo Field	QuickBooks Field
name	name	DisplayName
email	email	PrimaryEmailAddr
vat_number	vat	TaxIdentifier
payment_terms	property_payment_term_id	SalesTermRef

Webhooks

Receive real-time updates from Waqti:

Available Events

• po.created
• po.approved
• po.rejected
• invoice.received
• vendor.created

Webhook Payload

{
  "event": "po.approved",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "po_number": "PO-2025-0042",
    "vendor": "Acme Corp",
    "total": 15000.00,
    "currency": "SAR"
  },
  "signature": "sha256=..."
}

Security Considerations

1. API Keys - Rotate every 90 days
2. IP Whitelisting - Restrict to known IPs
3. Audit Trail - All syncs are logged
4. Data Encryption - TLS 1.3 for transit

Next Steps

• Qoyod Integration Setup - Saudi accounting
• Odoo Integration Setup
• QuickBooks Integration Setup
• Signit.sa Integration - Saudi-compliant e-signatures
• DocuSign Integration
• Zapier Integration - Automation
• LDAP/SSO Configuration
• REST API Documentation