=== DTA Express CR - División Territorial & Correos de Costa Rica ===
Contributors: ragonz, datos1
Tags: costa rica, shipping, woocommerce, checkout, pymexpress
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Official Costa Rica territorial division and Pymexpress Correos de Costa Rica shipping for WooCommerce.

== Description ==

DTA Express CR is the official and modern shipping solution for WooCommerce stores in Costa Rica, developed and maintained by Datos1 (ragonz).

It resolves all historical challenges for Costa Rican online merchants: full compatibility with the new WooCommerce Checkout Blocks (Gutenberg / React), prevention of fatal errors caused by special characters or accented letters in district names, complete up-to-date territorial database, and fast reliable shipping calculations.

=== Key Features ===

* **Official Administrative Territorial Division:** All 7 provinces, 84 official cantons (including Monteverde and Puerto Jimenez), and 489 districts with automatic 5-digit postal code mapping.
* **Dual Checkout Compatibility:** Works on both Classic Checkout and WooCommerce Checkout Blocks (React / Store API).
* **Correos de Costa Rica (Pymexpress) Integration:** Real-time rates based on parcel weight and origin/destination.
* **Contingency Fallback Flat Rates:** Automatic fallback rates if the carrier API undergoes maintenance.
* **Ultra-Low Resource Consumption:** Packaged static JSON data with zero heavy SQL queries.
* **Smart Conflict Detector:** Detects obsolete or incompatible shipping plugins and allows safe 1-click resolution.

== Installation ==

1. Upload the `dta-express-cr` folder to the `/wp-content/plugins/` directory, or install the ZIP from **Plugins > Add New > Upload Plugin**.
2. Activate the plugin via the **Plugins** menu in WordPress.
3. Go to **WooCommerce > DTA Express CR** in your admin sidebar.
4. The plugin comes pre-configured with official Costa Rica rates. If you have a Pymexpress contract, enter your Client Code, API User, and Password.
5. Done! Your checkout now shows the Province, Canton, and District cascade with automatic calculation.

== Frequently Asked Questions ==

= Does it work with the new Block Checkout (Gutenberg / React)? =
Yes, 100%. DTA Express CR was built specifically with the WooCommerce Blocks Store API to ensure the cascade selectors work natively.

= What happens if I don't have Pymexpress credentials yet? =
The plugin works immediately using official flat rates from Correos de Costa Rica (GAM and outside GAM) based on your buyer's canton and district.

= Are Monteverde and Puerto Jimenez included? =
Yes. All 84 official cantons from the National Geographic Institute of Costa Rica are included.

= Where can I request technical support? =
Contact us at hola@datos1.com or visit https://datos1.com.

== Screenshots ==

1. Centralized configuration panel in WooCommerce with conflict detection.
2. Cascade dropdowns (Province, Canton, District) at Checkout with postal code autocomplete.
3. Interactive modal with template for requesting Pymexpress Web Service credentials.

== Changelog ==

= 1.0.1 =
* Native support for WooCommerce Checkout Blocks (Store API) and Classic Checkout.
* Complete DTA database with 7 provinces, 84 cantons, and 489 districts.
* Bidirectional sanitization of special characters for Pymexpress.
* Diagnostics panel and priority support by DATOS1.com.
* 1-click conflict detection and resolution engine.

= 1.0.0 =
* Initial release.
