Cari.com.tr Integration for WooCommerce

Deskripzioa

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

1. Install and activate the plugin.
2. Go to Cari.com.tr > Settings and enter your company code (firma kodu).
3. Test the connection.
4. Select the order statuses that should trigger an automatic sync.
5. 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);