Courier company · Settings

Partner network

Opening your firm to jobs from Kapıyayemek businesses — turning the setting on, choosing the delivery type / district / price list / customer type, what the business sees, how orders arrive, the courier share, suspending / ending connected businesses and leaving the network.

The partner network lets your firm take jobs from Kapıyayemek (a food ordering platform) businesses. When you turn the setting on, your firm appears in the list of businesses looking for couriers. A business connects to your firm, sees your couriers on shift and gives its order to the courier it chooses.

The setting is off by default; unless you turn it on, your firm is not visible to any business. Staff allowed to manage settings (firm owner and manager) see this tab.

Joining the network

In the left menu, click Administration › Settings.
Choose the Partner network tab at the top.
Turn on Accept jobs from Kapıyayemek businesses.
Choose the Delivery type, District, Price list and Customer type (explained below). Save stays disabled until all four are chosen.
Click Save. A green Saved. message appears; your firm is now listed.

The badge next to the title shows whether a business has connected to your firm: No connection yet or Kapıyayemek connected.

Selections

Field	What it does
Delivery type	The business's orders are created with this delivery type (e.g. Normal).
District	Orders are created from this district. The business sees your couriers of this district's branch; couriers of other branches are not shown.
Price list	The business's orders are priced from this list.
Customer type	The customer type of the Kapıyayemek customer record.

Only active records appear in the lists. Delivery types, districts, price lists and customer types are defined on the Settings › Pricing tab; details: Pricing basics.

What the business sees

Your firm's name and how many of your couriers are on shift at that moment.
After connecting, your couriers' name, shift and work status, number of jobs in hand and last location.
Your couriers' phone number, national ID number, documents and earnings are not shown.
Your other customers, orders and prices are not shown.

How orders arrive

When a business connects to your firm for the first time, a customer record named Kapıyayemek is created in your firm automatically. No SMS or email notifications are sent to this customer.
The business's order lands in the pool under this customer, with the delivery type, district and price list you chose.
The business gives the order to the courier it picks from the list. In the courier app the job looks like a job you assigned.
The order is tracked on your Orders and Operations screens like any other order; the customer account, charges and courier earnings follow your usual rules.

The business can only give jobs to a courier who is on shift, available and in that branch. While the order is in the pool, your auto-assignment or your dispatcher can also give it to a courier; the business's choice is then void.

Courier share

The courier share is the percentage of the product amount of the business's order that is paid to your firm. The business pays it; Kapıyayemek collects it and passes it on to your firm. Example: at a 5% rate you receive 20 TL from a 400 TL order.

Your firm has one rate; it is the same for every business.
It starts at 5%. In the Courier share (%) field you can enter a number between 0 and 20 with at most two decimals (e.g. 7.5).
Lowering the rate applies at once. Businesses are not asked to approve.
Raising the rate needs the approval of each connected business.

Caution — read before raising the rate. When you raise the rate, each connected business is asked about the new rate. Until a business approves in its Kapıyayemek panel, you stay suspended for that business: it cannot request couriers from you and you cannot take jobs from it. That business's status in the list becomes Awaiting approval. Work with a business that approves continues at the new rate; work with a business that does not approve stops. This is why the system asks you to confirm again when you click Save.

To change the rate:

Open the Settings › Partner network tab.
Enter the new rate in the Courier share (%) field.
Click Save.
If you raised the rate, the Raise the courier share? window opens. Read the warning; click Yes, raise it if you are sure, otherwise Cancel.

A rate above 20% cannot be entered on this screen.

Connected businesses

The Connected businesses table below the settings shows the Kapıyayemek businesses that chose your firm as their courier firm. If nobody has chosen you yet, it says "No connected businesses yet".

Column	Meaning
Business	The name of the business.
Approved rate	The courier share the business last approved. If you raised the rate, the old rate is shown until the business approves.
Status	One of the five statuses below.

Status	Meaning
Active	The business can request couriers from you.
Awaiting approval	You raised the rate; the business has not approved the new rate yet. Until then no jobs come from this business.
Suspended by the business	The business paused working with your firm by its own choice.
Suspended by you	You paused working with this business temporarily.
Ended	You ended the cooperation.

The buttons at the end of each row:

Suspend: Pauses working with the business temporarily. The business cannot request couriers from you.
Continue: Resumes working with a business you suspended.
End cooperation: Ends working with the business. Click Yes, end it in the confirmation window. The business cannot choose you again; only you can restart the cooperation.
Reopen: Restarts a cooperation you ended.

Suspending and ending affect that business only; work with the other businesses continues. Orders already on the road are not affected; your courier completes the delivery.

Leaving the network

Open the Settings › Partner network tab.
Turn off Accept jobs from Kapıyayemek businesses.
Click Save.

Your firm leaves the list, no new business can connect and your couriers are no longer listed.

Turning the setting off does not revoke Kapıyayemek's API key in your firm; orders can still be created with the existing key. To cut it off completely, open the Kapıyayemek customer card on the Customers page and Revoke the key in the Integration API keys section. Details: Customer card.

Having trouble?

The Partner network tab is not visible: Staff allowed to manage settings see the tab. If you signed in with a dispatcher or accountant account, ask the firm owner.
The Save button is disabled: While the setting is on, all four selections are required. The courier share must be a number between 0 and 20 with at most two decimals. The button is also disabled if you haven't changed anything.
I raised the rate and no jobs come from the businesses: A raise waits for each business's approval. Businesses shown as Awaiting approval in the Connected businesses table have not approved the new rate yet. If you don't want to wait, lower the rate back to its old value; lowering applies at once.
A business is not in the list: The table shows only the businesses that chose your firm as their courier firm.
"not found or inactive" warning: The record you chose has been made inactive. Choose an active record or reactivate it on the Pricing tab.
"a firm tied to the partner cannot join the network" warning: Your firm was created directly by Kapıyayemek; it is already tied to the partner and the network setting does not apply.
The business can't see my courier: Check that the courier is on shift and in the branch of the district you chose. Couriers of other branches are not listed.