ASP.NET & ASP Web API ile Paraşüt API v4 Kullanımı Part 1

Hakan Ünal
Jul 28, 2017 · 2 min read

destek@parasut.com

Api bilgilerini almak istiyorum diye mail attığınız zaman Client ID & Client Secret bilgileri geliyor.

API v4:

https://apidocs.parasut.com/

Firma Numarasını Öğrenme:

Postman:

https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop?hl=tr

Api de 2. grant_type=password yöntemi ile token alınabilir.

Kullanıcı Bilgisi Getirme:

https://api.parasut.com/v4/me

Satış Faturası Oluşturma:

Ürün Listesi ve Oluşturma linkleri yanlış verilmiş:

Ürün Listesi: https://apidocs.parasut.com/#operation/listProducts

Ürün Oluşturma: https://apidocs.parasut.com/#operation/createProduct

Ben Ürünleri Elle Paraşüt’ün sitesinden oluşturmayı tercih ediyorum.

Product ID Contact ID gibi değerleri alttaki gibi bulabilirsiniz.

https://api.parasut.com/v4/{company_id}/contacts

https://api.parasut.com/v4/{company_id}/products

Bunlar site de de veriliyor.

Satış Faturası Oluşturma Örnek JSON:

Sitede verilen örneği kopyalayıp yapıştırdığınızda değişik hatalar veriyor alttaki eğer ID leri kendinize göre değiştirdiyseniz hata vermez.

https://paste.laravel.io/Zo0M8

Herhangi bir Tag eklenmesi istenmiyorsa bu:

https://paste.laravel.io/YAgrQ

Not: Fatura Sıra No dediği:

invoice_id oluyor. Aynı id ile kayıt ettirmiyor. Ve 0 dan büyük olmalı.

Tahsil Edildi şeklinde yapmak için:

https://api.parasut.com/v4/{company_id}/sales_invoices/{id}/payments

Tahsil edilen değer (amount (meblağ)) 5 TL den büyük olmalı.

Müşteri ekleme:

Müşteri eklenince aynı zamanda Tedarikçi de ekliyor. Tedarikçiyi silince müşteriyi de siliyor. Sorunu çözebilirsem güncelleme atarım.

https://paste.laravel.io/BNYz3

Buraya kadar ki kısım da Paraşüt API v4’ü inceledik. Sonraki partta Postman da yapılanların ASP.NET ve ASP Web API de yapımını inceleyeceğiz.

— — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — —

Skype dan gelen özel istek üzerine. Fatura oluşturma tahsil etme ve gönderme.

Daha gerçekci bir satış faturası:

https://paste.laravel.io/22e2a9de-9285-4b91-8ec0-f93615859e83

Daha gerçekci bir tahsilat ekleme:

https://paste.laravel.io/50f6f33d-3a92-44a4-9552-54b851db6ec2

Faturayı Resmileştirme:

E-Fatura kullanıcı olup olmadığının kontrolü: Alttaki TC NO benimki o yüzden e-fatura çıkar.

https://api.parasut.com/v4/FirmaNo/e_invoice_inboxes?filter%5Bvkn%5D=56350555622

Gelen veriler içindeki e_invoice_address kısmını alın.

E-Fatura Yollama:

https://api.parasut.com/v4/FirmaNo/e_invoices

https://paste.laravel.io/8e4e4d6d-ef0e-4b04-ab5e-7fa13aaff515

Links kısmındaki self e istek atınca status kısmında done yazıyorsa tamamdır.

NOT:

Paraşütün sitesinde verilen JSON örneğinde relationships sales_invoice değeri yanlış girilmiş. sales_invoice yerine invoice olucak. Üstteki linkteki JSON daki gibi olucak. Bunu da destek kısmına yazarım ama satış faturası oluşturma linklerinin yanlış olduğunu söyleyeli baya oldu hala yanlış. Büyük ihtimalle düzeltmeyeceklerdir. Başka hatalar alan yorum atabilir.

vat_withholding_code yazan kısım Tevkifat oranına ait vergi kodu. — Bu dosyada ilgili kodları bulabilirsiniz: https://www.efatura.gov.tr/dosyalar/kilavuzlar/UBLTR_1.2_Kilavuzlar.zip

Bilgisayarla ilgili bir şey olmadığı için 650 yazdım. Diğer parametlere de alttaki linkten bakıp kendinize göre ayarlayın kdv muafiyeti ile ilgili diğerleri.

https://apidocs.parasut.com/#operation/createEInvoice

E-Arşiv Yollama:

https://api.parasut.com/v4/FirmaNo/e_archives

Shipment kısmını kargo yollamayacağım için sildim o kısmı kendinize göre değiştirirsiniz.

https://paste.laravel.io/52f5c952-339b-4233-bb0a-904bb523ff91

Links kısmındaki self e istek atınca status kısmında done yazıyorsa tamamdır.

PDF Olarak İndirme:

https://api.parasut.com/v4/FirmaNo/sales_invoices/5135439?include=active_e_document

Satış Faturası getirme linkinin sonuna ?include=active_e_document eklendiğinde pdf urlsi geliyor oraya gidince ordaki url kısmında pdf indirme linki geliyor.

Link 1 saat aktifmiş. O linkten pdf’i indirip mail atan bir kod hazırlaması gerek. Part 2 ye sonra eklerim.


Originally published at teknoseyir.com on July 28, 2017.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade