Accounting and e-invoice integration
Uyumsoft e-Fatura / e-Arşiv
What it does
- Issues an e-invoice or e-archive invoice for each paid order through Uyumsoft, attaches the PDF, and emails it to the customer.
- Tracks the GİB accept or reject answer and shows it on the order.
- Runs cancellations and return invoices through the same Uyumsoft connection.
Provider based in Turkey
Uyumsoft is Kambloo's e-document integrator at launch. Turkish e-commerce sales must be documented with an e-archive or e-invoice within the legal window, and the platform does not issue those documents without a licensed integrator behind it. Uyumsoft was chosen first because it is widely used and priced for small merchants. The adapter is an Internal Module.
How it works with Kambloo
The adapter implements the InvoiceProvider contract: issue, cancel, fetch PDF, and check taxpayer status. When an order reaches paid, or shipped if you prefer that trigger, an invoice job is queued. The job builds the document from the order: line items with VAT from each product's tax class, shipping and surcharge lines, and the extra fields that GİB requires for internet sales such as shipment, payment, and website details. Uyumsoft returns the document, the PDF is stored and attached to the order, and the customer receives it by email.
GİB's answer does not always arrive at once. Kambloo tracks the accept or reject status by webhook or polling and shows it on the order. A rejected document is flagged on the integration health screen with the reason.
Cancellations and returns stay on the same channel. Approving a return request creates a return invoice through Uyumsoft; a cancelled order runs the cancellation flow. Invoice numbers follow the series you configure, and every document is tied to its order so the audit trail is complete.
Document type is chosen automatically. Before issuing, Kambloo calls checkTaxpayer with the customer's VKN or TCKN and chooses e-invoice for registered taxpayers and e-archive for everyone else. The result is recorded on the order, so you can see which document type was issued and why.
Requirements
- An Uyumsoft e-invoice and e-archive contract with API credentials.
- A tax class on every product so VAT lines are populated.
- Accountant sign-off on your invoice series and trigger before go-live.
Setup steps
The short version. The screens in your store admin follow the same order.
- Install the Uyumsoft module from the Market. It is free.
- Enter your Uyumsoft API credentials under Settings > Invoicing > Uyumsoft. They are stored encrypted.
- Choose the trigger: issue when the order is paid, or when it ships.
- Check that every product has a tax class so VAT lines are correct.
- Issue a test document in Uyumsoft's test environment before going live.
Questions about Uyumsoft e-Fatura / e-Arşiv
Can I sell without connecting an e-invoice integrator?
Kambloo does not issue invoices without an integrator. If you invoice outside the platform, you can switch the store to a declaration mode that records the order as invoiced externally.
Does Kambloo choose between e-invoice and e-archive automatically?
Yes. Before issuing, Kambloo checks the customer's VKN or TCKN through Uyumsoft's taxpayer lookup. Registered e-invoice taxpayers receive an e-invoice; everyone else receives an e-archive invoice.
Is this legal advice?
No. Kambloo implements the document flow. Thresholds, deadlines, and mandatory fields change; confirm your setup with your accountant before going live.