Skip to content
API Metotları ve Endpointler
/
E-Fatura işlemleri
/
E-Belge Durum Sorgulama

MikroAPI (1.0.0)

MikroAPI, ERP sistemleri ile entegre çalışabilen kapsamlı bir API çözümüdür. Bu doküman, tüm endpoint'lerin kullanımını detaylı, açık ve net ifadelerle anlatmaktadır. ERP geliştiricileri bu dokümanı kullanarak herhangi bir ek destek ihtiyacı olmaksızın hızlı ve kolay şekilde entegrasyonlarını tamamlayabilirler.

Download OpenAPI description
index.json
index.yaml
Languages
Servers
Mock server

https://apidocs.mikro.com.tr/_mock/apis/

Geliştirme ortamı

https://localhost:8084/

Login-Logoff

Kullanıcı giriş ve çıkış işlemleri.

Operations

Adres

Adres ekleme, silme ve düzenleme işlemleri.

Operations

Alım Satım Evrakı - Fatura

Alım satım evrağı ve fatura işlemleri.

Operations

Alınan Teklif

Alınan teklif kayıt ve düzenleme işlemleri.

Operations

Cari

Cari hesap kayıt ve güncelleme işlemleri.

Operations

Dekont

Dekont işlemleri.

Operations

Depolar Arası Sipariş

Depolar arası sipariş transferi işlemleri.

Operations

E-Fatura işlemleri

E-Fatura İşlemleri

Operations

Fatura PDF V2

Request

POST FaturaPdfV2 endpoint'i, ERP sisteminizde Kayıtlı Fatura Guid bilgisi gönderimi ile BASE64 formatında fatura bilgilerini response'da sizlere sunan MikroAPI endpointidir. Bu API endpoint'i üzerinden veri göndererek ilgili işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/API/APIMethods/FaturaPdfV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": " ",
      "CalismaYili": "2023",
      "Fatura_Guid": "E525C73E-53DB-49EC-93F1-95BEAD6A3FDA",
      "FirmaKodu": "MIKROFLY",
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff"
    }
  }'

Responses

Başarılı yanıt

E-Irsaliye Gönder

Request

POST EIrsaliyeGonderV2 endpoint'i, ERP sisteminizde Kesilen irsaliyeleri Gib'e gönderimek için Bu API endpoint'i üzerinden istenilen verileri Jsonda Post ederek ilgili işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/Api/apiMethods/EIrsaliyeGonderV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": "",
      "CalismaYili": 2025,
      "FirmaKodu": "MikroFLY",
      "KullaniciKodu": "SRV",
      "Sifre": "17e809cd7ec6d090ddc72e788d182adb",
      "evraklar": [
        {
          "sth_evrakno_seri": "FF",
          "sth_evrakno_sira": 11,
          "sth_evraktip": 1
        }
      ]
    }
  }'

Responses

Successful response

Fatura To E-Fatura

Request

POST FaturaToEFaturaV2 endpointi, ERP sisteminizde Kesilen faturaları Gib'e gönderimek için Bu API endpoint'i üzerinden istenilen verileri Jsonda Post ederek ilgili işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/Api/apiMethods/FaturaToEFaturaV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": "",
      "CalismaYili": 2025,
      "FirmaKodu": "MikroFLY",
      "KullaniciKodu": "SRV",
      "Sifre": "17e809cd7ec6d090ddc72e788d182adb",
      "evraklar": [
        {
          "cha_evrakno_seri": "FF,",
          "cha_evrakno_sira": 11
        }
      ]
    }
  }'

Responses

Successful response

GelenFaturalarKabulV2

Request

POST GelenFaturalarKabulV2 endpoint'i, Gib üzerinden kesilen E faturalarınızın listeleme menüsünde, kabul etmek istediğiniz faturanın Guid bilgisi ile Post edilmesi halinde faturanın kabul işlemi için kullanılır Bu API endpoint'i üzerinden veri göndererek ilgili Fatura Kabul işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/Api/apiMethods/GelenFaturalarKabulV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": " ",
      "CalismaYili": 2023,
      "EBelge": [
        {
          "UUID": "B5E9813C-FCFB-4D0F-9004-DA4095729339"
        }
      ],
      "FirmaKodu": "MIKROFLY",
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff"
    }
  }'

Responses

Successful response

GelenFaturalarRedV2

Request

POST GelenFaturalarRedV2 endpoint'i, Gib üzerinden kesilen E faturalarınızın listeleme menüsünde, Reddetmek etmek istediğiniz faturanın Guid bilgisi ile Post edilmesi halinde faturanın Red işlemi için kullanılır Bu API endpoint'i üzerinden veri göndererek ilgili Fatura Red işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/Api/apiMethods/GelenFaturalarRedV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": " ",
      "CalismaYili": 2023,
      "EBelge": [
        {
          "RedNedeni": "DENEME",
          "UUID": "B5E9813C-FCFB-4D0F-9004-DA4095729339"
        }
      ],
      "FirmaKodu": "MIKROFLY",
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff"
    }
  }'

Responses

Successful response

GelenFaturalarV2

Request

POST GelenFaturalarV2 endpoint'i, Gib üzerinden kesilen E faturalarınızın listelenmesi için kullanılır Bu API endpoint'i üzerinden veri göndererek ilgili Listeleme işlemleri hızlı, güvenli ve etkin şekilde gerçekleştirebilirsiniz. Entegrasyon sırasında gönderilecek verilerin formatı ve içerik doğruluğuna dikkat edilmesi gerekmektedir.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/Api/apiMethods/GelenFaturalarV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "ApiKey": " ",
      "CalismaYili": 2023,
      "FirmaKodu": "MIKROFLY",
      "GIBFaturaNo": "",
      "IlkTarih": "2025-01-01",
      "Index": 0,
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff",
      "Size": 20,
      "SonTarih": "2025-04-18",
      "VKNo": ""
    }
  }'

Responses

Successful response

E-Belge Mükellef Sorgulama

Request

POST EMukellefSorgulamaV2 endpoint'i, e-Belge statüsü sorgulama işlemleri için kullanılır. Şu anda e-Fatura ve e-Arşiv mükellef sorgulama işlemleri desteklenmektedir.

Bu endpoint ile, sorgulamak istediğiniz VKN/TCKN bilgisini göndererek, mükellef e-belge sistemlerine kayıtlı mı, değil mi bilgisini alabilirsiniz.

Bodyapplication/json
Mikroobject
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/API/APIMethods/EMukellefSorgulamaV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "FirmaKodu": "MikroFLY",
      "CalismaYili": 2025,
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff",
      "ApiKey": "",
      "EMukellef": {
        "VKN_TCKN": "11111111111"
      }
    }
  }'

Responses

Başarılı sorgu yanıtı

Bodyapplication/json
Response
application/json
{
  "success": true,
  "message": "Mükellef e-fatura sisteminde kayıtlıdır."
}

E-Belge Durum Sorgulama

Request

POST EBelgeDurumSorgulamaV2 endpoint'i, GIB'e gönderilen e-Belgelerin durumunu sorgulama işlemleri için kullanılır.
Şu anda e-Fatura ve e-Arşiv belgelerinin statü sorgulaması desteklenmektedir.

Bu endpoint ile, belge türü ve UUID bilgisi gönderilerek, ilgili belgenin durum kodu (örneğin 1300, 1200 vb.) ve durumu sorgulanabilir.

Bodyapplication/jsonrequired
Mikroobjectrequired
Mikro.​FirmaKodustringrequired

İlgili firmanın kodu

Example: "MikroFLY"
Mikro.​CalismaYiliintegerrequired

İşlem yapılan yıl

Example: 2025
Mikro.​KullaniciKodustringrequired

API kullanıcısının kodu

Example: "SRV"
Mikro.​Sifrestringrequired

API şifresi (MD5 formatında Günün tarihi ile hashlenmiş)

Example: "5c3f2964996a220cdcfa48f8798622ff"
Mikro.​ApiKeystringrequired
Example: ""
Mikro.​EBelgeobjectrequired
Mikro.​EBelge.​EFaturaTipiintegerrequired

0: Gönderilen, 1: Gelen

Enum01
Example: 0
Mikro.​EBelge.​EBelgeTipiintegerrequired

0: EFatura, 1: EArsiv

Enum01
Example: 1
Mikro.​EBelge.​UUIDstring(uuid)required

Belgenin benzersiz kimliği

Example: "381EF1A7-BE66-44E6-A3C2-65D75D05C78A"
curl -i -X POST \
  https://apidocs.mikro.com.tr/_mock/apis/API/APIMethods/EBelgeDurumSorgulamaV2 \
  -H 'Content-Type: application/json' \
  -d '{
    "Mikro": {
      "FirmaKodu": "MikroFLY",
      "CalismaYili": 2025,
      "KullaniciKodu": "SRV",
      "Sifre": "5c3f2964996a220cdcfa48f8798622ff",
      "ApiKey": "",
      "EBelge": {
        "EFaturaTipi": 0,
        "EBelgeTipi": 1,
        "UUID": "381EF1A7-BE66-44E6-A3C2-65D75D05C78A"
      }
    }
  }'

Responses

Başarılı sorgulama sonucu

Bodyapplication/json
statusstring
Example: "success"
dataobject

EBelge durum bilgisi

Response
application/json
{
  "status": "success",
  "data": {}
}

Etiket Basım Kaydet

Etiket basım kaydetme işlemleri.

Operations

Evrak Açıklamaları

Evrak açıklamaları işlemleri.

Operations

Evrak Belge Resim

Evrak belge resmi işlemleri.

Operations

Fiyat Değişikliği

Fiyat değişikliği işlemleri.

Operations

Image Data

Image data işlemleri.

Operations

İrsaliye

İrsaliye işlemleri.

Operations

Kasa Masraf Fişi

Kasa masraf fişi işlemleri.

Operations

Listeler

Listeleme ve sorgulama işlemleri.

Operations

Muhasebe

Muhasebe işlemleri.

Operations

Operasyon Tamamlama

Operasyon İşlemleri

Operations

Personel

Personel işlemleri.

Operations

Proforma Sipariş

Proforma sipariş işlemleri.

Operations

Satın Alma Şartı

Satın alma şartı kayıt işlemleri.

Operations

Satın Alma Talep

Satın alma talep işlemleri.

Operations

Satış Şartı

Satış şartı kayıt işlemleri.

Operations

Sayım Sonuç

Sayım İşlemleri

Operations

Sipariş

Sipariş oluşturma, güncelleme, silme ve ek bilgilerle ilgili işlemler.

Operations

Stok

Stok ekleme ve yönetim işlemleri.

Operations

Tahsilat Tediye

Tahsilat ve tediye işlemleri.

Operations

Üretim

Üretim İşlemleri

Operations

Ürün Reçete

Ürün reçete işlemleri.

Operations

Ürün Rota

Ürün rota işlemleri.

Operations

Verilen Teklif

Verilen teklif kayıt işlemleri.

Operations

SQL Sorgulama

SQL Sorgulama

Operations

Kayıt Kaydet

Operations