Destine234/nigerian_retail_and_ecommerce_supply_chain_logistics_data

Supply Chain Logistics Data

Dataset Description

Comprehensive supply chain logistics data for Nigerian retail and e-commerce analysis

Dataset Information

• —Category: Product and Inventory
• —Industry: Retail & E-Commerce
• —Country: Nigeria
• —Format: CSV, Parquet
• —Rows: 400,000
• —Columns: 12
• —Date Generated: 2025-10-06
• —Location: data/supply_chain_logistics_data/
• —License: GPL

Schema

Sample Data

shipment_id product_id supplier_name origin_city destination_city  ship_date expected_delivery_date actual_delivery_date  quantity  shipping_cost_ngn logistics_company delivery_status
SHIP0000000   PRD81347    Supplier_B       Abuja            Warri 2024-03-23             2024-03-29           2024-03-27       828           18379.93       DHL Nigeria         delayed
SHIP0000001   PRD68757    Supplier_D        Kano              Jos 2024-06-10             2024-06-21           2024-06-20       329           91632.07     Fedex Nigeria       delivered
SHIP0000002   PRD34311    Supplier_E       Lagos    Port Harcourt 2024-10-15             2024-10-19           2024-10-18       203           77141.08      Ace Couriers       delivered

Use Cases

• —Data analysis and insights
• —Machine learning model training
• —Business intelligence
• —Research and education
• —Predictive analytics

Nigerian Context

This dataset incorporates authentic Nigerian retail and e-commerce characteristics:

E-Commerce Platforms

• —Jumia (35% market share) - Leading marketplace
• —Konga (25% market share) - Major competitor
• —Jiji (20% market share) - Classifieds platform
• —PayPorte, Slot, and other platforms

Physical Retail

• —Shoprite, Spar, Game - Major supermarket chains
• —Slot, Pointek - Electronics retailers
• —Mr Price - Fashion retail
• —Traditional markets: Balogun Market, Computer Village

Payment Methods

• —Cash on Delivery (45%) - Most popular
• —Bank Transfer (25%)
• —Debit Card (15%)
• —USSD (8%)
• —Mobile Money (5%)
• —Credit Card (2%)

Logistics & Delivery

• —GIG Logistics - Nationwide coverage
• —Kwik Delivery - Fast urban delivery
• —DHL, FedEx - International and express
• —Red Star Express - Nationwide courier
• —Local dispatch riders

Geographic Coverage

Major Nigerian cities including:

• —Lagos - Commercial capital, highest retail density
• —Abuja - Federal capital, high e-commerce penetration
• —Kano - Northern commercial hub
• —Port Harcourt - Oil city, strong purchasing power
• —Ibadan - Large urban market
• —Plus 10+ other major cities

Products & Categories

• —Electronics: Tecno, Infinix, Samsung phones; laptops, TVs
• —Fashion: Ankara fabric, Agbada, Kaftan, sneakers
• —Groceries: Rice (50kg bags), Garri, Palm Oil, Indomie
• —Beauty: Shea butter, Black soap, hair extensions
• —Home: Generators, inverters, solar panels

Currency & Pricing

• —Currency: Nigerian Naira (NGN, ₦)
• —Exchange Rate: ~₦1,500/USD
• —Price Ranges: Realistic Nigerian market prices
• —Time Zone: West Africa Time (WAT, UTC+1)

File Formats

CSV

data/supply_chain_logistics_data/nigerian_retail_and_ecommerce_supply_chain_logistics_data.csv

Parquet (Recommended)

data/supply_chain_logistics_data/nigerian_retail_and_ecommerce_supply_chain_logistics_data.parquet

Nigerian Retail and E-Commerce - Loading the Dataset

Hugging Face Datasets

from datasets import load_dataset

# Load dataset
dataset = load_dataset("electricsheepafrica/nigerian_retail_and_ecommerce_supply_chain_logistics_data")

# Convert to pandas
df = dataset['train'].to_pandas()

print(f"Loaded {len(df):,} rows")

Pandas (Direct)

import pandas as pd

# Load CSV
df = pd.read_csv('data/supply_chain_logistics_data/nigerian_retail_and_ecommerce_supply_chain_logistics_data.csv')

# Load Parquet (recommended for large datasets)
df = pd.read_parquet('data/supply_chain_logistics_data/nigerian_retail_and_ecommerce_supply_chain_logistics_data.parquet')

PyArrow

import pyarrow.parquet as pq

# Load Parquet
table = pq.read_table('data/supply_chain_logistics_data/nigerian_retail_and_ecommerce_supply_chain_logistics_data.parquet')
df = table.to_pandas()

Data Quality

• —✅ Realistic Distributions: Based on Nigerian retail patterns
• —✅ No Missing Critical Fields: Complete core data
• —✅ Proper Data Types: Appropriate types for each column
• —✅ Consistent Naming: Clear, descriptive column names
• —✅ Nigerian Context: Authentic local characteristics
• —✅ Production Scale: Suitable for real-world applications

Ethical Considerations

• —This is synthetic data generated for research and development
• —No real customer data or personally identifiable information
• —Designed to reflect realistic patterns without privacy concerns
• —Safe for public use, testing, and education

License

GPL License - General Public License

This dataset is free to use for:

• —Research and academic purposes
• —Commercial applications
• —Educational projects
• —Open source development

Citation

@dataset{nigerian_retail_supply_chain_logistics_data_2025,
  title={Supply Chain Logistics Data},
  author={Electric Sheep Africa},
  year={2025},
  publisher={Hugging Face},
  howpublished={\url{https://huggingface.co/datasets/electricsheepafrica/nigerian-retail-supply-chain-logistics-data}}
}

Related Datasets

This dataset is part of the Nigerian Retail & E-Commerce Datasets collection, which includes 42 datasets covering:

• —Customer & Shopper Data
• —Sales & Transactions
• —Product & Inventory
• —Marketing & Engagement
• —Operations & Workforce
• —Pricing & Revenue
• —Customer Support
• —Emerging & Advanced Technologies

Browse all datasets: https://huggingface.co/electricsheepafrica

Updates & Maintenance

• —Version: 1.0
• —Last Updated: 2025-10-06
• —Maintenance: Active
• —Issues: Report via Hugging Face discussions

Contact

For questions, feedback, or collaboration:

• —Hugging Face: electricsheepafrica
• —Issues: Open a discussion on the dataset page
• —General Inquiries: Via Hugging Face profile

Part of the Nigerian Industry Datasets Initiative Building comprehensive, authentic datasets for African markets.