Skip to main content

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

  1. 01

    Foriba contract + account

    Apply at foriba.com. GIB e-invoice taxpayer registration required (>1M TL turnover or by choice).

  2. 02

    Sandbox + API key

    Foriba test environment + API credentials. Choose e-invoice type (UBL-TR).

  3. 03

    Invoice data model

    UBL-TR XML format — Seller, Buyer, Line Items, Taxes, Totals.

  4. 04

    API integration

    POST /invoice/create → get invoice UUID. GET /invoice/{uuid}/status to check state.

  5. 05

    GIB approval + transmission

    Foriba transmits to GIB; approval in 0-24 hours. Retry + alert on error.

  6. 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