# Nami Cargo Shipping

**Contributors:** namicargo
**Tags:** shipping, nami, cargo, nami-cargo, dynamic shipping  
**Requires at least:** 5.2
**Tested up to:** 6.8
**Stable tag:** 1.0.1  
**Requires PHP:** 7.4  
**License:** GPLv2 or later  
**Last Updated:** April 4, 2025
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html  

A custom WooCommerce shipping plugin that dynamically calculates shipping rates using the Nami Cargo API.

## Description

Nami Cargo Shipping is a WooCommerce plugin designed to provide dynamic shipping options for your store. It integrates seamlessly with the Nami Cargo API to calculate shipping rates, estimated times of arrival (ETA), and more.

### Features

- Dynamic shipping rate calculation using the Nami Cargo API.  
- Support for multiple warehouses and product stock validation.  
- Configurable shipping options through WooCommerce settings.

== External Services ==

This plugin connects to the **Nami Cargo Shipping API** to fetch warehouse details, product stock availability, and customer shipping information. It then retrieves shipping charges and estimated delivery time (ETA) based on the provided data.

**What data is sent and when?**  
Whenever an order is placed or shipping details are needed, the plugin sends the following information to the Nami Cargo Shipping API:  

- **Warehouse Data:** Warehouse name, address, city, country, and available product stock.  
- **Product Data:** SKU, product name, quantity, dimensions (width, height, depth), and price.  
- **Customer Data:** Shipping address, first name, last name, phone number, email, city, country, and optional delivery instructions.  
- **Order Details:** Order ID, order type, total value, payment method, and shipping preferences set by the admin.  

**Where is this data sent?**  
The data is sent to **Nami Cargo Shipping** servers: [https://www.nami.la/cargo](https://www.nami.la/cargo)  

**Why is this data sent?**  
The data is required to calculate accurate shipping costs, determine available delivery options, and manage warehouse stock updates.

**Links to Terms of Service and Privacy Policy:**  
- **Terms and Conditions:** [https://cdn.prod.website-files.com/6697efb919e7ec45f4ee44f4/66b278cdbe9d67bffd94be64_TERMINOS%20Y%20CONDICIONES%20SERVICIOS%20NAMI.pdf](https://cdn.prod.website-files.com/6697efb919e7ec45f4ee44f4/66b278cdbe9d67bffd94be64_TERMINOS%20Y%20CONDICIONES%20SERVICIOS%20NAMI.pdf)  
- **License and Agreement:** [https://www.nami.la/licencia-y-acuerdo](https://www.nami.la/licencia-y-acuerdo)  

By using this plugin, users agree to share this data with Nami Cargo Shipping to facilitate order fulfillment.

## Installation

### Using FTP

1. Download the plugin ZIP file (`nami-cargo-shipping.zip`).
2. Extract the ZIP file.
3. Upload the extracted folder to the `/wp-content/plugins/` directory on your WordPress installation using FTP.
4. Log in to your WordPress Admin Dashboard.
5. Navigate to **Plugins > Installed Plugins**.
6. Locate "Nami Cargo Shipping" in the list and click **Activate**.
7. Look for Nami Cargo Shipping to do required setting at the left side.

### Using the WordPress Admin Dashboard

1. Log in to your WordPress Admin Dashboard.
2. Navigate to **Plugins > Add New**.
3. Click the **Upload Plugin** button at the top.
4. Choose the `nami-cargo-shipping.zip` file and click **Install Now**.
5. Once the installation is complete, click **Activate Plugin**.
6. Look for Nami Cargo Shipping to do required setting at the left side.

## Frequently Asked Questions

### Q: Is this plugin works with gutenberg blocks?
A: No.

### Q: How do I configure the plugin?
A: Navigate to **Nami Cargo Shipping** at the left bottom there are settings available to setup.

### Q: What happens if the API is unreachable?
A: The plugin will not display shipping options if the API call fails. Ensure the API endpoint and credentials are correctly configured.

## Changelog

### 1.0.0
* Initial release with dynamic shipping calculations and basic configuration options.
### 1.0.1
* Updated Tracking URL in email.

## Upgrade Notice

### 1.0.0
First release. Ensure you have WooCommerce installed and configured before activating this plugin.

## Support
For support, please contact [info@nami.la](mailto:info@nami.la).

== Screenshots ==

1. **Plugin Settings Menu** – The Nami Cargo Shipping settings appear in the WordPress admin menu.  
2. **Warehouses List** – Add, edit, and manage warehouses in a dedicated section.  
3. **Warehouse Stock Management** – Manage stock for each warehouse directly from the product edit page.  
4. **Variation Stock Management** – Control stock levels for product variations based on warehouses.