Sipariş / Fatura Ekleme

Alış veya satış sipariş / faturası ekleyen metottur. Gönderilen datadaki müşteri ve ürün bilgileri bizimhesap üzerinde mevcut değilse otomatik olarak oluşturulurlar ve ardından fatura kaydedilir.

https://bizimhesap.com/api/b2b/addinvoice

İ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ı

Request

{  
   "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":"[e-mail]",
      "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"
      }
   ]
}

Response

Başarılı

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

Hatalı

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