forumNew topic

They said they'll do an API integration — what does that mean, should it be a separate line item?

MMeltemNew member
Job title
Bookstore
Organization type
cooperative
Joined
Sep 2024
Message
32
#1

We run a furniture manufacturing and retail sales company. Right now, we use an in-house accounting and ERP software; our inventory and invoicing are managed there. Currently, we're in talks with a digital agency to build a new e-commerce website and corporate site.

In the 180,000 TL development proposal submitted by the agency, there is a single line item that simply reads "API integration with your existing systems," with zero scope details provided. When we asked about it during the meeting, they said the website would talk to our ERP system and everything would run automatically, but they didn't go into any technical specifics.

What exactly is an API integration, and why is this scope kept so vague in the proposal? Should this be priced as a separate line item independent of the website, or is it a standard part of a web development package? What boundaries should we establish at the contract stage to avoid getting burned later?

GGökhan C***Member
Job title
Purchasing manager
Sector
Printing
Organization type
medium-sized business
Joined
Jun 2022
Message
181
Most Helpful#2

Short answer: An API integration is the technical bridge that allows two distinct software systems—like your e-commerce site and your accounting or warehouse software—to exchange data in real time without human intervention. This work should absolutely not be left as a single vague line item in a proposal; the direction and frequency of the synced data must be defined in a dedicated technical specification.

The reason agencies keep this clause vague is that they cannot anticipate upfront what technical hurdles they'll encounter once they dig into the work. Integration isn't a one-way street; having the website ready isn't enough—your ERP software must also support an API and have the proper licensing to expose data externally. Many commercial software vendors charge extra license fees for this module.

There are three main items you must clarify in the contract: 1) Direction of data flow: Will inventory and pricing flow from accounting to the site, or will orders and customer accounts be written from the site into accounting? 2) Trigger frequency: Will data sync in real time or, say, twice a day? 3) Exception handling: How will pending orders be logged when the internet drops or the ERP server fails to respond?

My recommendation is to request the API documentation from your ERP vendor and forward it to the agency before signing off on the proposal. Once the agency reviews this documentation, they should add the integration as a distinct deliverable with test cases and warranty terms included in the contract.

VVildan Ş***Member
Job title
Quality control inspector
Sector
Textile
Organization type
medium-sized business
Joined
Aug 2024
Message
162
#3

An API is the doorway through which two software programs query each other and receive responses in a standardized format. But if that door is locked on the ERP side, the agency can't do anything from the website end. Does your ERP vendor have ready-made REST services, or will a custom middleware service need to be built? Any contract signed without clarifying this will lead to unexpected extra costs.

PPerihan S***MemberCommunity member
Joined
Jul 2023
Message
352
#4

We made the exact same mistake on a similar project. The agency put integration as a single line item, and when the site was finished, our accounting software vendor said "our API license is 50,000 TL and you have to build the connection yourself." The agency stepped aside saying "we don't touch your accounting system." The project was deadlocked for six whole months with both companies pointing fingers at each other.

KKemal Ç***Member
Job title
Field sales representative
Sector
Plastic
Organization type
120-person company
Joined
Oct 2022
Message
140

Doki · Interface design · 2023

#5

Have them revise that one-liner in the proposal right away. Make sure every single data table to be synced is itemized in the contract: product records, price lists, inventory counts and order details. Also make it a contractual requirement to specify where errors will be logged whenever there's a data mismatch.

LLeyla Ç***Expert
Job title
Front office accounting
Sector
Security services
Organization type
medium-sized business
Joined
Jan 2026
Message
1
#6

In accordance with contract law and technical specification standards, integration commitments without a defined scope may be interpreted against the client in the event of a dispute. The acceptance criteria for integration services, bug tolerance windows, and the party responsible for third-party software licensing costs must be explicitly laid out in the contract annex.

VVildan D***Member
Job title
Quality control inspector
Sector
Electrical-electronics
Organization type
regional distributor
Joined
Apr 2024
Message
160

Doki · Phishing awareness training · 2024

#7

Promising a corporate website, an e-commerce infrastructure and a custom ERP integration all for a total budget of 180.000 TL doesn't sound very realistic to me. A solid two-way integration alone requires weeks of testing. They'll probably just set up a basic order transfer and call it a day.

SSena M***MemberCommunity member
Joined
Dec 2024
Message
142
#8

same thing happened to us, an order would come in from the site but the vat rates or discounts would sync incorrectly to the erp. staff was completely burnt out from fixing it manually. i wouldnt approve that clause without setting up a data mapping table first.

JJülide S***ExpertCommunity member
Joined
Sep 2023
Message
184
#9

Is the ERP software you're using a modern cloud-based system, or does it run on an on-premise local server? If it's an older desktop-style setup, external access will require a static IP and firewall configuration; did the agency look into these infrastructure requirements?

GGamze U***Member
Job title
Chief Technology Officer
Sector
Printing
Organization type
8-person team
Joined
Feb 2024
Message
270
#10

Just a heads-up. When making decisions, write down the worst-case scenario too, not just the best.

I'm also curious if anyone does it differently.

CCansu I***VeteranCommunity member
Joined
Jul 2022
Message
377
#11

Could you elaborate on that? Solutions that work at a small scale collapse when you grow; I learned this late.

Correct me if I'm wrong.

KKadir G***MemberCommunity member
Joined
Sep 2022
Message
44
#12

I've been down this road, let me tell you. Start with a small trial; don't commit to everything at once.

People defend habits, not processes. Resistance comes from there. Proven by experience.

HHilal D***MemberCommunity member
Joined
Dec 2024
Message
166
#13

I agree.

YYağmur P***Expert
Job title
Customer Relations Manager
Sector
Electrical-electronics
Organization type
120-person company
Joined
Jun 2025
Message
405
#14

If you're going this route, sort this out first. The cheapest quote is usually the least thought-out one.

If you have questions, write them; I'll answer as best I can.

LLale K***MemberCommunity member
Joined
Oct 2025
Message
323
#15

Thanks for writing this thats the right way. People defend habits, not processes. Resistance comes from there.

Thats all, sorry if I went on too long.

FFerhat A***ExpertCommunity member
Joined
Mar 2026
Message
124
#16

There's a common mistake people make when doing this. Solutions that work at a small scale collapse when you grow; I learned this late.

Of course, it varies if your situation is different.

MMert Ö***Member
Job title
Fuel station
Organization type
early-stage startup
Joined
Nov 2023
Message
64
#17

Quick summary for newcomers: If it's your first time, start small; scaling comes later.

When making decisions write down the worst-case scenario too, not just the best.

PPerihan K***Member
Job title
Product Manager
Sector
Catering
Organization type
20-person company
Joined
Feb 2024
Message
220

Doki · Corporate website · 2024

#18

We got stuck at the same point for a while. Start with a small trial; don't commit to everything at once.

I'm also curious if anyone does it differently.

AAslı G***ExpertCommunity member
Joined
Jan 2023
Message
1
#19

Thanks, that was the answer I was looking for.

FFatma E***MemberCommunity member
Joined
Oct 2025
Message
89
#20

thanks a lot I'll try it today then i mean don't hesitatte to ask; those who don't ask always pay more.

proven by experience.

Reply