e-Invoice integration
Foriba+Özel Yazılım
Auto-generate GIB-compliant e-invoices and e-archive receipts from your orders or sales via Foriba API.
Quick answer
Foriba e-invoice integration automatically converts order/sales data into GIB (Turkish Revenue Administration)-compliant e-invoices and e-archive receipts. Triggered from Trendyol, WooCommerce, or custom ERP; delivered simultaneously to accounting software and GIB. Eliminates manual invoicing entirely.
Setup cost
$700-2K
Monthly
Foriba license $17-100/month + per-invoice fee (volume-based)
Duration
2-4 weeks
Who is this for
→E-commerce order → auto e-invoice
→ERP sales document → GIB e-invoice
→Bulk e-invoicing (monthly + annual)
→e-Archive invoice (to end consumers)
→e-Delivery note (cargo + shipment)
Data flow
Order/Sales system → Foriba API → GIB integrator → GIB → Foriba → Customer email/portal. Success/error callback updates order system.
Setup steps
- 01
Foriba contract + account
Apply at foriba.com. GIB e-invoice taxpayer registration required (>1M TL turnover or by choice).
- 02
Sandbox + API key
Foriba test environment + API credentials. Choose e-invoice type (UBL-TR).
- 03
Invoice data model
UBL-TR XML format — Seller, Buyer, Line Items, Taxes, Totals.
- 04
API integration
POST /invoice/create → get invoice UUID. GET /invoice/{uuid}/status to check state.
- 05
GIB approval + transmission
Foriba transmits to GIB; approval in 0-24 hours. Retry + alert on error.
- 06
Test + go-live
50 test invoices (scenarios: return, VAT-exempt, export) + production.
Common pitfalls
- GIB taxpayer registration required (else e-invoice impossible)
- UBL-TR XML format error → GIB rejects
- VAT calculation error (rate + base)
- Cancellation e-invoice flow needs separate development
- Test and production API endpoints differ
Frequently asked questions
Is Foriba mandatory, are there alternatives?
Foriba is a GIB-authorized e-invoice integrator. Alternatives: Paraşüt, Logo, Uyumsoft, Nebim, Mikro (own integrators). Choose based on your software stack.
What is the difference between e-invoice and e-archive?
e-Invoice: to GIB-registered taxpayers (companies). e-Archive: to end consumers (individuals). ~90% of invoices are e-archive; company-to-company is e-invoice.
VAT refund + export invoice?
Export invoice is a separate type in UBL-TR (EXPORT). VAT-exempt or zero-rated transactions. Foriba supports these types; correct configuration is critical.
Get a quote for Foriba + Özel Yazılım integration
Fixed-scope written proposal after a 30-minute discovery call.
Start a discovery call