# Taksit Oluşturma

> Taksit Oluşturma, Evobulut ön muhasebe / ERP yazılımının Taksit modülüne ait bir REST API servisidir. POST yöntemiyle `https://ws.evobulut.com/api/taksit/base/` adresine JSON gönderilerek çağrılır.

- **Modül:** Taksit
- **Yöntem:** POST
- **Endpoint:** `https://ws.evobulut.com/api/taksit/base/`
- **Kimlik doğrulama:** Login servisinden alınan Token UID
- **Son güncelleme:** 2025-01-03
- **Doküman:** https://dev.evobulut.com/servis/taksit/taksit-olusturma-297

## Açıklama

| Onaylanmış bir satış faturası için taksitli ödeme planı oluşturmada kullanılacak servis kanalıdır. | | | |
| --- | --- | --- | --- |
| Request Body JSON Açıklamaları | | | |
| | | | |
| Alan | Veri Tipi | Zorunlu | Açıklama |
| cmd | string | E | taksit_olustur |
| UID | string | E | KULLANICI_UID Login Anında Alınan UID Token Verisi |
| Ana : [ | | E | Ana Veri Bilgileri JSON Tag ismi Array [1] 0. index kullanılır |
| Modul_Id | int | E | Taksit in bağlanacağı kayıt modul nosu Faturfa için 1054 |
| Modul_Ref_Id | int | E | İlgili Kaydın ID Numarası 1054 için Fatura ID Nosu |
| Doviz_Id | int | E | Yerel para birimi ID (TL) için (0) Bakınız Ana[0].ID |
| Doviz_Kuru | float | E | Döviz Kuru Yerel Para Birimi için 1 |
| Aciklama | string | H | Taksitli satış açıklaması |
| Detay : [ | | E | Detay Veri Bilgileri JSON Tag ismi Array [0..n] n adet taksit satırı |
| Taksit_Tarihi | string | E | gg.aa.yyyy formatında |
| Taksit_Tutari | float | E | Binikiyüzotuzdört Lira Ellialtı Kuruş için (1234.56) xxxxxx.yy Ondalık Ayraç (.) Nokta |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| Response Body JSON Açıklamaları | | | |
| | | | |

## İstek gövdesi

```json
{
  "cmd": "taksit_olustur",
  "UID": "KULLANICI_UID",
  "Ana": [
    {
      "Modul_Id": "1054",
      "Modul_Ref_Id": "17846",
      "Doviz_Id": "0",
      "Doviz_Kuru": "1",
      "Aciklama": ""
    }
  ],
  "Detay": [
    {
      "Taksit_Tarihi": "01.02.2025",
      "Taksit_Tutari": "25.00"
    },
    {
      "Taksit_Tarihi": "01.03.2025",
      "Taksit_Tutari": "25.00"
    },
    {
      "Taksit_Tarihi": "01.04.2025",
      "Taksit_Tutari": "50.00"
    }
  ]
}
```

## Örnek istek (cURL)

```bash
curl -X POST "https://ws.evobulut.com/api/taksit/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "cmd": "taksit_olustur",
  "UID": "KULLANICI_UID",
  "Ana": [
    {
      "Modul_Id": "1054",
      "Modul_Ref_Id": "17846",
      "Doviz_Id": "0",
      "Doviz_Kuru": "1",
      "Aciklama": ""
    }
  ],
  "Detay": [
    {
      "Taksit_Tarihi": "01.02.2025",
      "Taksit_Tutari": "25.00"
    },
    {
      "Taksit_Tarihi": "01.03.2025",
      "Taksit_Tutari": "25.00"
    },
    {
      "Taksit_Tarihi": "01.04.2025",
      "Taksit_Tutari": "50.00"
    }
  ]
}'
```

## Başarılı yanıt

```json
{
    status: "OK",
    veri: {
        mesaj: "Taksit Kaydı Başarıyla Oluşturuldu",
        ID: 162607
    }
}
```

## Başarısız yanıt

```json
{ status: "ERR", veri: {"mesaj": "Taksit detay satırları Belirtilmemiş."} }
{ status: "ERR", veri: {"mesaj": "Taksit detay satırları Tutar toplamı Evrak tutarı ile uyumsuz." }}


{
    "status": "ERR",
    "veri":  {"mesaj": "Onaysız Fatura belgesine taksit bağlanamaz."} 
}


{
    "status": "ERR",
    "veri":  {
            "mesaj": "Modul_Id ve Modul_Ref_Id Alanları boş bırakılamaz."
        }
    
}

{
    "status": "ERR",
    "veri": {
            "mesaj": "Doviz_Id değeri hatalı. Döviz Bulunamadı."
        }
    
}

{
    "status": "ERR",
    "veri": {
            "mesaj": "Doviz_Kuru Sıfırdan büyük olmalı."
        }
    
}
```