Cari.com.tr Integration for WooCommerce
The Cari.com.tr Integration for WooCommerce plugin allows you to automatically transfer orders from your WooCommerce store to the Cari.com.tr accounting system.
External services
This plugin relies on the Cari.com.tr API to synchronize your WooCommerce data with the Cari.com.tr accounting system.
It connects to the endpoint https://sistem.cari.com.tr/api to create invoices and update customer records.
When an order reaches the configured order status (e.g., Completed) or is synced manually, the plugin securely sends the following data to the Cari.com.tr API:
* Order Details: Invoice prefix, order subtotal, tax amounts, and grand total.
* Customer Data: Billing name, company name, address, phone, email, and Tax/National ID numbers.
* Product Data: Line items, quantities, subtotal prices, and tax rates.
This external service is required for the core functionality of the plugin. This service is provided by Cari.com.tr. By using this plugin, you agree to their Terms of Service and Privacy Policy.
Features
- Automatic Synchronization: Automatically transfer orders to Cari.com.tr when they reach specific statuses.
- Manual Transfer: Manually sync individual or bulk orders.
- Customizable Invoice Format: Define your own invoice prefix.
- Customer Management: Automatically synchronize customer information.
- Detailed Logging: Log all API requests and responses.
- Error Management: Track and manage transfer errors.
- Modern UI: Sleek and user-friendly admin panel.
- HPOS Compatible: Full support for WooCommerce High-Performance Order Storage.
- Turkish Language Support: Fully localized (once approved, via translate.wordpress.org).
How It Works
- Install and activate the plugin.
- Go to Cari.com.tr > Settings and enter your company code (firma kodu).
- Test the connection.
- Select the order statuses that should trigger an automatic sync.
- Your orders will start syncing automatically!
Requirements
- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
- An active Cari.com.tr account
- Cari.com.tr company code
Support
For questions or issues: * Support Forum: https://wordpress.org/support/plugin/cari-com-tr-integration-woocommerce/ * Documentation: https://cari.com.tr/
Additional Info
Security
This plugin includes the following security measures: * Nonce verification * User capability checks * Protection against SQL injection * Protection against XSS * Data sanitization and validation
Performance
- Minimized database queries
- Optimized API requests
- Asynchronous processing support
- Performance gains with HPOS
Compatibility
- WordPress multisite support
- WPML compatible
- PHP 8.x compatible
- WooCommerce HPOS (High-Performance Order Storage) compatible
- WooCommerce 8.x+ compatible
Developer Notes
The plugin includes hooks and filters:
Filters:
* caricomtr_invoice_data – Customize invoice data
* caricomtr_customer_data – Customize customer data
* caricomtr_invoice_serie – Customize invoice prefix
* caricomtr_invoice_number – Customize invoice sequence number
* caricomtr_logs_retention_days – Change log retention period
* caricomtr_remove_data_on_uninstall – Delete data on uninstall
Actions:
* caricomtr_before_sync – Before sync
* caricomtr_after_sync – After sync
* caricomtr_sync_error – On sync error
* caricomtr_cleanup_logs – Log cleanup task
Example usage:
add_filter('caricomtr_invoice_data', function($data, $order) {
$data['fatura']['seri_no'] = 'CUSTOM';
return $data;
}, 10, 2);