FAIR

Federated and Independent Repositories

Cari.com.tr Integration for WooCommerce

Plugin Banner

Cari.com.tr Integration for WooCommerce

by caricomtr

Download
Description

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);

Automatic Installation

  1. In your WordPress admin panel, go to Plugins > Add New.
  2. Search for “Cari.com.tr Integration for WooCommerce”.
  3. Click “Install Now”.
  4. Activate the plugin.

Manual Installation

  1. Download the plugin files.
  2. Upload the plugin directory to /wp-content/plugins/.
  3. Activate the plugin in your WordPress admin panel.

After Installation

  1. Go to the “Cari.com.tr” menu.
  2. Enter your company code (Get it from Cari.com.tr > Ayarlar > Ä°ÅŸletme Bilgileri).
  3. Click the “Test Connection” button.
  4. Configure the automatic sync settings.
  5. Select the order statuses you wish to sync.

Custom Fields (Optional)

For Tax ID / National ID, use one of the following fields:
* billing_tc_no
* billing_vkn
* billing_tax_number
* _billing_tc_kimlik_no
* _billing_vergi_no

For Tax Office:
* _billing_vergi_dairesi

Which order statuses trigger an automatic sync?

You can select the desired order statuses on the settings page. By default, only “Completed” orders are synced.

Can the same order be synced more than once?

No. The plugin keeps track of successfully synced orders and will not send them again.

How can I see sync errors?

You can view the complete transfer history and any errors on the Cari.com.tr > Logs page.

How can I test the API connection?

You can check your API connection using the “Test Connection” button on the settings page. You cannot save settings until the test is successful.

Is customer information also synced?

Yes. If you enable the “Sync Customer” option on the settings page, customer information will be created or updated before the invoice is generated.

Is the shipping fee included in the invoice?

Yes. The shipping fee is automatically added to the invoice as a separate line item.

Can I change the invoice number format?

Yes. You can specify a prefix for your invoice numbers (e.g., WEB, SITE, E-COM) in the “Invoice Prefix” field on the settings page.

How long are logs kept?

By default, logs are stored for 30 days. This duration can be customized via a filter hook.

Can I bulk sync orders?

Yes. On the Orders page, you can select multiple orders and use the “Sync to Cari.com.tr” option from the “Bulk Actions” menu.

Is it compatible with WooCommerce HPOS?

Yes. The plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

1.0.2

  • Updated plugin name to comply with WordPress.org trademark guidelines.
  • Removed placeholder content from readme.
  • Improved admin menu consistency.
  • Enhanced compliance with WordPress.org Plugin Directory Guidelines.

1.0.1

  • Refactored code to meet WordPress.org standards (unique prefixes).
  • Translated all descriptions and UI text to English as the base language.

1.0.0 – 2025-03-15

  • Initial release
  • Automatic order synchronization
  • Manual sync feature
  • Customizable invoice prefix
  • Customer synchronization
  • Detailed logging system
  • Bulk sync support
  • Modern admin UI
  • API connection test
  • WooCommerce HPOS compatibility
Back to top