forumNew topic

They said "we'll do an API integration" — how does the process work, and what's expected of us?

NNuri N***MemberCommunity member
Joined
Nov 2023
Message
4
#1

We process an average of 60-70 orders a day on our e-commerce store. Until now, an employee manually keyed invoices and stock movements into our accounting software every evening. We finally hired an outside dev team to automate the sync between orders customer accounts, and inventory. They quoted us 45,000 TL and a 3-week delivery timeline.

In our kickoff meeting they said "get the other side's API endpoints and sandbox environment ready, we'll take care of the rest." But we aren't a tech company. When we called our accounting software provider, they demanded an extra 12,000 TL just to upgrade our API license, sent over a link to some documentation, and stepped aside completely.

What does an API integration process actually look like in practice? What permissions, credentials and data do we as a business need to provide so things don't get blocked? And how realistic is this 3-week timeline?

RRecep T***New member
Job title
Field sales representative
Sector
Logistics
Organization type
a company within a holding
Joined
Aug 2026
Message
39

Doki · Backup setup · 2023

Most Helpful#2

Short answer: An API integration simply enables your website and accounting software to automatically exchange data based on predefined rules. To move forward, you need to purchase the API license from your accounting provider, pass the developer documentation to your developers, and provide a test environment where they can build without touching live data.

The process typically follows four stages. The first stage is data mapping: matching fields on your website (customer name, tax ID, SKU, VAT rate, shipping cost) one-to-one with fields in your accounting software. The second stage is development and sandbox integration, where the developers create mock orders to test the data pipeline into the accounting system.

The third stage covers edge cases and error handling. For instance, what happens if an order comes in without a Turkish ID number, how are discount codes broken down on the invoice, and how are cancellations or returns resolved in the ledger? The fourth stage involves entering production API keys, going live with real orders, and monitoring closely for the first few days.

You'll basically be asked for three things: 1) API credentials and dev docs from your accounting software vendor, 2) Test database access, 3) Written sign-off on your business logic (when an invoice is generated, inventory management rules, discount structures). If the accounting provider delivers clear docs promptly, 3 weeks is very realistic; however, if their support is sluggish, it can easily stretch to 5 weeks.

UUfuk S***Member
Job title
Front office accounting
Sector
Agriculture
Organization type
cooperative
Joined
Jun 2022
Message
74

Doki · Incident response support · 2025

#3

The single most critical issue is SKU mismatches. If the product SKUs on your e-commerce store don't match your accounting inventory codes character-for-character, the integration will blow up on day one. Before handing the work over to the devs, open a spreadsheet and manually verify that all your product codes align with the accounting system.

CCanMember
Job title
SEO Specialist
Joined
Mar 2024
Message
172
#4

Get it in writing whether the integration is one-way or two-way. Are orders just flowing from the website into accounting, or will stock levels and price updates from the warehouse sync back to the website? Two-way sync involves API rate limits and conflict resolution logic, which adds substantial development time.

KKader U***Member
Job title
Store associate
Sector
Media and publishing
Organization type
family business
Joined
Jun 2024
Message
86
#5

We did a similar integration last year. It took a full 9 days just to get the API license and sandbox credentials from our accounting vendor. The dev team finished coding in 12 days, but testing took an extra 8 days because shipping fees and line-item discounts kept posting to the wrong accounts. All in all, it took 29 days to go live.

OOrhan T***MemberCommunity member
Joined
Mar 2024
Message
242
#6

Here should be your side's prep checklist: 1) Request the sandbox environment and docs from your accounting vendor. 2) Sit down with your accountant to define clear written rules for handling cancellations, returns, and split shipments. 3) Run at least 15 different test invoice scenarios before flipping the switch to production.

YYaseminMember
Job title
SME owner
Joined
Jul 2024
Message
98
#7

Is your accounting software cloud-based, or is it installed on a local server in your office? If it's running on an office computer you'll need a static IP and open ports to the server. That can create security vulnerabilities and also cause the integration to stop whenever the office internet drops; have you discussed this?

TTaner E***Member
Job title
Purchasing manager
Sector
Leather
Organization type
early-stage startup
Joined
Jun 2023
Message
132
#8

at first our accountant kept triggering errors on invoices for foreign customers without a tc kimlik numarası. if you take international orders or issue corporate invoices, figure out how those fields will be mapped right now, otherwise orders just end up hanging in the system.

edit: I wrote something wrong above, sorry about that.

SSinemExpert
Job title
Project manager
Joined
Oct 2023
Message
176
#9

Put your software dev team and the tech support from your accounting software into a shared email group or communication channel. You shouldn't have to understand the tech jargon or act as a middleman. Let the technical folks figure out the parameters and endpoints directly between themselves.

VVahide K***Member
Job title
Graphic Designer
Sector
Energy
Organization type
120-person company
Joined
Nov 2023
Message
411
#10

On our first integration we didn't want to pay 12.000 TL for a test environment so we tested directly on the live database. While the developer was issuing a test invoice, actual e-arşiv invoices and SMS notifications went out to real customers. That was the day we realized paying for a test environment is honestly the cheapest insurance you can buy.

OOnur M***Expert
Job title
Accounting clerk
Sector
Plastic
Organization type
medium-sized business
Joined
May 2023
Message
7
#11

Saved.

HHüseyin S***VeteranCommunity member
Joined
Jul 2022
Message
175
#12

The answer above hits the nail on the head. The real issue isn't the number, but what it's based on.

Hasty decisions become decisions you have to fix six months later. I'm also curious if anyone does it differently.

İİbrahim Y***MemberCommunity member
Joined
Dec 2024
Message
182
#13

There's a part I don't understand. If code ownership isn't in the contract, you have no bargaining power when leaving.

I'm also curious if anyone does it differently.

HHilal B***Veteran
Job title
Graphic Designer
Sector
Electrical-electronics
Organization type
regional distributor
Joined
Dec 2023
Message
17
#14

Let me share my experience. Access credentials should be opened in the company's name, not personal accounts.

Just leaving this note, it might be useful.

İİbrahim Y***MemberCommunity member
Joined
Feb 2026
Message
3
#15

i agree.

EElifMember
Job title
Cafe chain owner
Organization type
40-person manufacturing company
Joined
Aug 2024
Message
63

Doki · Incident response support · 2024

#16

Don't miss this: The cheapest quote is usually the least thought-out one.

If I were you I'd go this route.

HHavva K***MemberCommunity member
Joined
Jul 2024
Message
111
#17

The cheap-looking path usually ends up costing more later. Access credentials should be opened in the company's name, not personal accounts.

The biggest time-waster for us was not knowing who had the final say. If you have questions, write them; I'll answer as best I can.

MMehmet A***Expert
Job title
Software developer
Sector
Education
Organization type
300-person organization
Joined
Jul 2022
Message
2
#18

Just a heads-up. Any unwritten clause becomes a point of disagreement later, as both sides remember it differently.

If I were you, I'd go this route.

KKübra G***Expert
Job title
IT manager
Sector
Sports and fitness
Organization type
20-person company
Joined
Nov 2025
Message
10
#19

I went through the same thing. Weekly written progress reports are much more useful than asking for dates.

Start with a small trial; don't commit to everything at once. Good luck with that.

OOsman K***MemberCommunity member
Joined
Mar 2024
Message
117
#20

Thanks for writing this, that's the right way. Hasty decisions become decisions you have to fix six months later.

Don't hesitate to ask; those who don't ask always pay more. That's all, sorry if I went on too long.

Reply