Producteca

This is a small module, to make requests to Producteca API.

Install for development

First of all, you need to install Poetry, follow the instructions here.

Once installed, run poetry install to install the dependencies.

Usage

To use the Producteca client, first instantiate ProductecaClient with your credentials or add it directly to your env with PRODUCTECA_TOKEN and PRODUCTECA_API_KEY:

from producteca.client import ProductecaClient

client = ProductecaClient(token='your_token', api_key='your_api_key')

# Usage examples for SalesOrderService
sale_order_service = client.SalesOrder
# Get from api
sale_order = sale_order_service.get(123)
# or construct from db
sale_order = client.SalesOrder(...argswithid)
labels = sale_order.get_shipping_labels()
close_response = sale_order.close()
cancel_response = sale_order.cancel()
synchronized_order = sale_order.synchronize()
invoice_response = sale_order.invoice_integration(sale_order)
search_results = sale_order_service.search(params)
payment = sale_order.add_payment(payment_payload)
updated_payment = sale_order.update_payment(payment_id, payment_payload)
shipment = sale_order.add_shipment(shipment_payload)
updated_shipment = sale_order.update_shipment(shipment_id, shipment_payload)

# Usage examples for ProductService
product_service = client.Products
# Get from api
product = product_service.get(456)
bundle = product_service.get_bundle(456)
ml_integration = product_service.get_ml_integration(456)
search_results = product_service.search(search_params)
# Or construct from db
product = client.Products(...args)
created_product = product.create()
updated_product = product.update()

then with the client you should use every other module, like SalesOrder, Products, Payments, Shipments and Search

Contributing

We welcome contributions to improve this project! Here's how you can help:

Development Setup

Fork the repository
Clone your fork locally
Create a new branch for your feature/fix
Make your changes
Run tests to ensure everything works
Submit a pull request

Code Style

Follow PEP 8 guidelines
Write meaningful commit messages
Add tests for new features
Update documentation as needed

Reporting Issues

If you find a bug or have a feature request:

Check existing issues first
Create a new issue with:
- Clear description
- Steps to reproduce (for bugs)
- Expected vs actual behavior
- Version information

Questions?

Feel free to open an issue for any questions about contributing.

Metadata

Release files for producteca 2.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for producteca 2.1.3
File	Size	Uploaded
producteca-2.1.3.tar.gz	28.8 kB	Jan 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for producteca 2.1.3
File	Interpreter	ABI	Platform	Reset
producteca-2.1.3-py3-none-any.whl 36.3 kB Jan 19, 2026	Python 3	none	any	Details

Total release size: 65.2 kB

Release files / producteca-2.1.3.tar.gz

Download URL	producteca-2.1.3.tar.gz
Size	28.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`84c75ecded2bc6a13de5aa1bb50b4688c0a5e4d7ee6a90d56b6a111c82d94479`
BLAKE2b-256 checksum How to use checksums	`4547dc6ad8c57f39d366a67209e38a6180c3f8c6b4f7792115c9c3ff23959973`
Upload date	Jan 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ChromaAgency/producteca_python
Publishing commit: github.com/ChromaAgency/producteca_python/tree/636d8e2278f75bf96ca91d35d3bfe213d5d63367

Workflow

Publishing configuration: github.com/ChromaAgency/producteca_python/blob/636d8e2278f75bf96ca91d35d3bfe213d5d63367/.github/workflows/ci-cd.yml
Publishing logs: github.com/ChromaAgency/producteca_python/actions/runs/21150250847/attempts/1

Artifact

Subject: producteca-2.1.3.tar.gz
SHA-256 checksum: 84c75ecded2bc6a13de5aa1bb50b4688c0a5e4d7ee6a90d56b6a111c82d94479 Verifying attestations

Release files / producteca-2.1.3-py3-none-any.whl

Download URL	producteca-2.1.3-py3-none-any.whl
Size	36.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1ea1db9eeb8cd40557033aca8db882f01326591c621e81212dfaa07cfe7cba8e`
BLAKE2b-256 checksum How to use checksums	`cad0103e2db0f02cb3182228400a155b90c97be7fe55e2622c40a9a187083d53`
Upload date	Jan 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ChromaAgency/producteca_python
Publishing commit: github.com/ChromaAgency/producteca_python/tree/636d8e2278f75bf96ca91d35d3bfe213d5d63367

Workflow

Publishing configuration: github.com/ChromaAgency/producteca_python/blob/636d8e2278f75bf96ca91d35d3bfe213d5d63367/.github/workflows/ci-cd.yml
Publishing logs: github.com/ChromaAgency/producteca_python/actions/runs/21150250847/attempts/1

Artifact

Subject: producteca-2.1.3-py3-none-any.whl
SHA-256 checksum: 1ea1db9eeb8cd40557033aca8db882f01326591c621e81212dfaa07cfe7cba8e Verifying attestations