⚓ Kargomucuz SDK

Official SDK for Kargomucuz. Unified cargo operations, shipment automation, and enterprise-grade logistics infrastructure.

@vorlaxen-labs/kargomucuz-sdk provides a modern, strongly-typed, zero-hassle integration layer for accessing the Kargomucuz API platform.

Designed for scalable e-commerce systems, ERP infrastructures, marketplaces, warehouse management software, and modern backend services.

🔥 Why Kargomucuz SDK?

Cargo integrations in Türkiye are usually absolute chaos:

• Different authentication systems
• Different XML/SOAP nightmares
• Different tracking structures
• Different provider limitations
• Different error formats

@vorlaxen-labs/kargomucuz-sdk normalizes the entire experience into a single, predictable developer workflow.

• 🚀 Unified API abstraction
• 📦 Multi-carrier shipment management
• 🔒 Secure token-based authentication
• ⚡ Fully typed TypeScript support
• 🌲 Tree-shakable architecture
• 🛠️ Enterprise-ready infrastructure
• 🧩 Modular SDK structure
• 📈 High-performance request handling

Because nobody wants to debug prehistoric cargo APIs at 3 AM while staring at cursed SOAP XML responses like forbidden ancient scrolls.

📦 Installation

pnpm add @vorlaxen-labs/kargomucuz-sdk
# or
npm install @vorlaxen-labs/kargomucuz-sdk
# or
yarn add @vorlaxen-labs/kargomucuz-sdk

🚀 Quick Start

import { Kargomucuz } from '@vorlaxen-labs/kargomucuz-sdk';

const km = new Kargomucuz({
  auth: {
    apiKey: process.env.KARGOMUCUZ_API_KEY
  },

  environment: 'production', // production or development

  timeout: 10_000,

  retry: {
    retries: 3,
    backoff: 'exponential'
  },

  logger: console
});

🛠️ SDK Architecture

The SDK is built around modular service namespaces.

Core Modules

• Shipments
• Labels
• Orders

⚡ Features

📦 Shipment Management

Create, manage, cancel, and automate cargo operations from a single API layer.

🔒 Secure by Default

Enterprise-focused authentication and request validation systems.

🌍 Built For

• E-Commerce Platforms
• ERP Systems
• Warehouse Software
• Marketplace Infrastructure
• Logistics Automation
• Enterprise SaaS Products
• Modern Node.js Backends

🌲 Tree-Shakable Imports

Import only what you use.

import { Kargomucuz } from '@vorlaxen-labs/kargomucuz-sdk';

📖 Documentation

Full documentation, API references, examples, provider integrations, and advanced guides are available on the official documentation platform.

Official Links

• Website → https://kargomucuz.com
• Documentation → https://docs.vorlaxen.com/projects/kargomucuz-sdk
• API Platform → https://api.kargomucuz.com

📐 Design Philosophy

"Logistics infrastructure should feel invisible."

@vorlaxen-labs/kargomucuz-sdk is designed to eliminate operational friction between your application and cargo providers.

Instead of forcing developers to deal with fragmented logistics ecosystems, the SDK provides a clean, stable, and scalable abstraction layer.

The goal is simple:

Write less integration code. Ship more packages. Lose less sanity.

⚖️ License

Distributed under the MIT License.

Built with precision by Vorlaxen Labs.