Python SDK

Installation

pip

pip install tracktile

poetry

poetry add tracktile

uv

uv add tracktile

Quick Start

from tracktile import Tracktile

client = Tracktile(jwt="your-api-token")

products = client.products.list()

Authentication

client = Tracktile(jwt="your-api-token")

Available Resources

Resource	Methods
client.inventory	receive, move, update, waste, assign, unassign, bundle, merge, unmerge
client.orders	list, create, get, update, delete, get_product_attributes
client.products	list, create, get, update, delete, batch_update, fetch_by_ids
client.purchase_orders	list, create, get, update, delete
client.shipments	list, create, get, update, patch, delete, get_items
client.suppliers	list, create, get, update, delete, get_default_order
client.transports	list, create, get, update, delete

Async Support

The SDK provides both synchronous and asynchronous clients:

import asyncio
from tracktile import AsyncTracktile

async def main():
    client = AsyncTracktile(jwt="your-api-token")
    products = await client.products.list()
    print(products)

asyncio.run(main())

Error Handling

from tracktile.models import errors

try:
    product = client.products.get(id="invalid")
except errors.BadRequestError:
    # Handle 400 errors
    pass
except errors.UnauthorizedError:
    # Handle 401 errors
    pass
except errors.ForbiddenError:
    # Handle 403 errors
    pass
except errors.NotFoundError:
    # Handle 404 errors
    pass
except errors.ServerError:
    # Handle 500 errors
    pass

Retries

from tracktile import Tracktile
from tracktile.utils import BackoffStrategy, RetryConfig

client = Tracktile(
    jwt="your-api-token",
    retry_config=RetryConfig(
        strategy="backoff",
        backoff=BackoffStrategy(
            initial_interval=1,
            max_interval=50,
            exponent=1.1,
            max_elapsed_time=100,
        ),
        retry_connection_errors=False,
    ),
)

Debug Logging

import logging

logging.basicConfig(level=logging.DEBUG)

client = Tracktile(
    jwt="your-api-token",
    debug_logger=logging.getLogger("tracktile"),
)

Runtime Support

Runtime	Version
Python	3.8+

Both sync and async clients are available. The SDK uses httpx under the hood for HTTP requests.