# Sipariş / Fatura Ekleme

{% hint style="success" %}
<https://bizimhesap.com/api/b2b/addinvoice>
{% endhint %}

{% tabs %}
{% tab title="İstek Parametreleri" %}

| Parametre       | Tip          | Açıklama                                      |
| --------------- | ------------ | --------------------------------------------- |
| **FirmID**      | \[string]    | Bizimhesap tarafından verilecek özel tekil ID |
| **InvoiceNo**   | \[string]    | Faturanın belge numarası (isteğe bağlı)       |
| **InvoiceType** | \[string]    | Fatura tipi (3:Satış, 5:Alış)                 |
| **Note**        | \[string]    | Fatura açıklaması (isteğe bağlı)              |
| **Dates**       | \[object]    | **Tarih Bilgisi**                             |
| -> InvoiceDate  | \[Date]      | Fatura tarihi                                 |
| -> DeliveryData | \[Date]      | Teslimat tarihi (opsiyonel)                   |
| -> DueDate      | \[Date]      | Ödeme Vadesi                                  |
| **customers**   | \[object]    | **Müşteri Bilgisi**                           |
| -> CustomerId   | \[string]    | Müşterinin kaynak sistemdeki ID’si            |
| -> Title        | \[string]    | Müşterinin isim/ünvanı                        |
| -> Address      | \[string]    | Fatura adresi                                 |
| -> TaxOffice    | \[string]    | Müşteri vergi dairesi (opsiyonel)             |
| -> TaxNo        | \[string]    | Müşteri vergi veya TC kimlik no (opsiyonel)   |
| -> Email        | \[string]    | Müşteri e-posta adresi (opsiyonel)            |
| -> Phone        | \[string]    | Müşteri telefonu (opsiyonel)                  |
| **Details\[]**  | \[object\[]] | **Ürün Bilgisi**                              |
| -> ProductId    | \[string]    | Ürünün kaynak sistemdeki ID’si                |
| -> ProductName  | \[string]    | Ürün/hizmet adı                               |
| -> Note         | \[string]    | Satır açıklaması (opsiyonel)                  |
| -> Barcode      | \[string]    | Ürünün barkodu (opsiyonel)                    |
| -> TaxRate      | \[decimal]   | KDV oranı                                     |
| -> Quantity     | \[decimal]   | Miktar                                        |
| -> UnitPrice    | \[decimal]   | Birim fiyat                                   |
| -> GrossPrice   | \[decimal]   | Brüt tutar (miktar x birim fiyat)             |
| -> Discount     | \[string]    | İndirim tutarı                                |
| -> Net          | \[decimal]   | Net tutar (indirim sonrası, vergisiz)         |
| -> Tax          | \[decimal]   | Vergi tutarı                                  |
| -> Total        | \[decimal]   | Toplam (net + vergi)                          |
| **Amounts**     | \[object]    | **Tutar Bilgisi**                             |
| -> Currency     | \[string]    | Fatura para birimi (TL, USD, EUR, CHF, GBP)   |
| -> Gross        | \[decimal]   | Faturanın brüt toplamı                        |
| -> Discount     | \[decimal]   | Faturadaki toplam indirim tutarı              |
| -> Net          | \[decimal]   | Faturanın net toplamı (vergisiz)              |
| -> Tax          | \[decimal]   | Faturadaki toplam vergi tutarı                |
| -> Total        | \[decimal]   | Fatura dip toplamı                            |
| {% endtab %}    |              |                                               |

{% tab title="Request" %}

```markup
{  
   "firmId":"485E152158494BE590B5F72403398765",
   "invoiceNo":"A123121",
   "invoiceType":3,
   "note":"özel sipariş",
   "dates":{  
      "invoiceDate":"2017-07-08T18:45:52.516+03:00",
      "dueDate":"2017-07-08T18:45:52.516+03:00",
      "deliveryDate":"2017-07-08T18:45:52.516+03:00"
   },
   "customer":{  
      "customerId":6761,
      "title":"Deneme Müşterisi Ltd. Şti.",
      "taxOffice":"Koparan VD",
      "taxNo":"1234567890",
      "email":"deneme@hotmail.com",
      "phone":"5320000001",
      "address":"Örnek Mah. Deneme sok No1/2 İstanbul"
   },
   "amounts":{  
      "currency":"TL",
      "gross":"2,400.00",
      "discount":"0.00",
      "net":"2,400.00",
      "tax":"432.00",
      "total":"2,832.00"
   },
   "details":[  
      {  
         "productId":13372,
         "productName":"deneme ürünü",
         "note":"36 beden",
         "barcode":"8690123456789",
         "taxRate":"18.00",
         "quantity":2,
         "unitPrice":"1200.00",
         "grossPrice":"2,400.00",
         "discount":"0.00",
         "net":"2,400.00",
         "tax":"432.00",
         "total":"2,400.00"
      }
   ]
}
```

{% endtab %}

{% tab title="Response" %}
{% hint style="success" %}
Başarılı
{% endhint %}

```
{  
   "error":"",
   "guid":"AB13123123CD12323",
   "url":"https://bizimhesap.com/........"
}
```

{% hint style="danger" %}
Hatalı
{% endhint %}

```
{  
   "error":"Hatalı para birimi",
   "guid":"",
   "url":""
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.bizimhesap.com/addinvoice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.