Shipping integration
Aras Kargo
What it does
- Generates Aras labels with barcode and tracking number directly from confirmed orders.
- Tracks parcels through polling and Aras's file-based status service, then updates the order and the customer.
- Supports cash on delivery by passing the collection amount to Aras at shipment creation.
Provider based in Turkey
Aras Kargo is in Kambloo's launch catalog alongside Yurtiçi. The adapter implements the same ShippingCarrier contract as every other carrier module: create a shipment, track it, cancel it, and price it. Aras is an Internal Module. Kambloo does not charge for it; you ship under your own Aras agreement.
How it works with Kambloo
Shipment creation starts from the order. Kambloo sends the recipient, parcel, and service details to Aras and receives the label, barcode, and tracking number in return. The label PDF goes to your store's bucket, where it can be printed on its own or merged into one PDF with the rest of the day's labels. The tracking number is written to the order and sent to the customer with a tracking link. Which channel carries that message, email, SMS, or WhatsApp, is a store setting.
Status updates come from two sources. A tracking job polls Aras every 30 minutes for shipments that are still open. Aras also offers a file-based status service, and the adapter can read it as a second source. Both paths update the same shipment record, so the order timeline stays consistent no matter which one reports first. Every outbound call carries an idempotency key, and retries never create a second shipment.
Cash on delivery is passed as an option on the createShipment call. Aras collects the amount at the door. Because payment is not awaited, COD orders convert the stock reservation into a firm deduction when the order is placed. Collection is confirmed in the admin panel, and the COD reconciliation report matches Aras collections to orders.
Cart pricing uses your rate table. Kambloo calculates the desi value from the parcel dimensions, compares it with the real weight, and looks up the larger figure with the origin and destination provinces in the CSV you uploaded. Free-shipping thresholds from your campaigns are applied on top.
Requirements
- An Aras Kargo customer agreement with API access.
- Your negotiated rate table in CSV form.
- Dimensions and weight on products so desi calculation is accurate.
Setup steps
The short version. The screens in your store admin follow the same order.
- Install the Aras Kargo module from the Market. It is free.
- Add your Aras customer credentials under Settings > Shipping > Aras Kargo. They are stored encrypted.
- Upload your Aras rate table as CSV for cart price calculation.
- Ship a test order and check that the tracking number appears on the order.
- Turn the carrier on for the zones you deliver to.
Questions about Aras Kargo
Does Aras send status updates to Kambloo automatically?
Not as webhooks. Kambloo polls Aras on a 30-minute schedule and can also read Aras's file-based status service. Both feed the same shipment status on the order.
Can customers choose Aras at checkout?
Yes. You assign carriers per shipping zone. Where more than one carrier is enabled for a zone, checkout compares their prices and lets the customer pick. Prices come from your uploaded rate tables.
How is a refused COD parcel handled?
The return closes the order, stock is restored, and the customer's COD refusal count goes up. After a set number of refusals, COD is no longer offered to that customer.