Giter VIP home page Giter VIP logo

fatura's Introduction

🧾 Fatura.js

eArşiv sistemi üzerinde fatura oluşturmanızı sağlar.

Alternatifler

Dil Repo Geliştirici
PHP https://github.com/AdemAliDurmus/fatura Adem Ali Durmuş
PHP https://github.com/furkankadioglu/efatura Furkan Kadıoğlu
PHP https://github.com/mlevent/fatura Mert Levent
C# https://github.com/BFYDigital/e-arsiv-fatura-dotnet BFY Digital

Bu sistem https://earsivportal.efatura.gov.tr/ adresini kullanarak bu sistem üzerinden fatura oluşturmanızı sağlar.

Bu sistem GİB'e tabi şahıs şirketi ya da şirket hesapları ile çalışır ve bu kişilikler adına resmi fatura oluşturur. Kesilen faturaları https://earsivportal.efatura.gov.tr/ adresinden görüntüleyebilir ya da bu kütüphane ile indirebilirsiniz.

Kullanıcı Adı ve Parola Bilgileri

https://earsivportal.efatura.gov.tr/intragiris.html adresindeki parola ekranında kullanılan kullanıcı kodu ve parola ile bu paketi kullanabilirsiniz. ℹ️ Bu kullanıcı kodu ve parola bilgilerini muhasebecinizden ya da GİB - İnteraktif Vergi Dairesi'nden edinebilirsiniz.

Yükleme

npm install fatura

Kullanım

Oldukça kolay bir kullanıma sahiptir:

createInvoiceAndGetDownloadURL(user, pass, invoice, { sign })

Bu method ile fatura oluşturulup imzalanır ve indirme adresi döner.

const fatura = require('fatura')

const faturaURL = await fatura.createInvoiceAndGetDownloadURL(
    'GIB Kullanıcı Adı', 
    'GIB Parolası', {
        ... faturaDetayları
    },
    // Varsayılan olarak sign: true gönderilir.
    { sign: false }
)

createInvoiceAndGetHTML(user, pass, invoice, { sign })

Bu method ile fatura oluşturulup imzalanır ve fatura HTML'i döner. Bu HTML'i iframe içerisinde gösterip yazdırılmasını sağlayabilirsiniz.

const fatura = require('fatura')

const faturaHTML = await fatura.createInvoiceAndGetHTML(
    'GIB Kullanıcı Adı', 
    'GIB Parolası', {
        ... faturaDetayları
    },
    // Varsayılan olarak sign: true gönderilir.
    { sign: false }
)

Diğer Fonksiyonlar

Muhtemelen pek gerekmeyecek diğer alt fonksiyonlar:

enableTestMode()

Bu fonksiyonu çağırdığınızda sistem https://earsivportaltest.efatura.gov.tr adresini kullanmaya geçer. Fakat burada sistem bazen dolu olabilir.

getToken(user, pass): String

eFatura Portal'ını kullanabileceğiniz token'ı döner.

createDraftInvoice(token, invoiceDetails): Object

eFatura.gov.tr'de fatura direkt oluşmaz. Önce Taslak fatura oluşturmak gerekir. createDraftInvoice size taslak bir fatura oluşturacaktır. invoiceDetails parametresi aşağıdaki şekilde bir JavaScript nesnesi kabul eder:

ℹ️ UUID vermezseniz yeni bir UUID atanır.

{
    // UUID vermezseniz yeni bir UUID yaratılacaktır.
    uuid: "4c72cb57-b72d-4812-ac48-0a0bce83e771",

    date: "08/02/2020",
    time: "09:07:48",
    taxIDOrTRID: "11111111111",
    taxOffice: "Beylikduzu",
    title: "FATIH AKIN",
    name: "",
    surname: "",
    fullAddress: "X Sok. Y Cad. No: 3 Z Istanbul",
    items: [
        {
        name: "Stickker",
        quantity: 1,
        unitPrice: 100,
        price: 100,
        VATRate: 18,
        VATAmount: 18
        }
    ],
    totalVAT: 18,
    grandTotal: 100.0,
    grandTotalInclVAT: 118.0,
    paymentTotal: 118.0
}

findInvoice(token, { date, uuid }): Object

Her fatura için bir uuid oluşturulur. Bu uuid kullanılarak faturanın oluşturulduğu tarih içerisindeki taslak fatura bulunur ve getirilir. Bu veri içerisinde imzalama esnasında gerekecek GIB Belge Numarası bulunur. Bu method ile diğer taslak faturalara da erişebilirsiniz.

getAllInvoicesByDateRange(token, { startDate, endDate }): Array

İki tarih arasındaki tüm faturaları döner.

getAllInvoicesIssuedToMeByDateRange(token, { startDate, endDate }): Array

İki tarih arasındaki gelen faturaları (GİB'deki adıyla Adıma Düzenlenen Belgeleri) döner.

signDraftInvoice(token, draftInvoice): void

☢️ Fatura imzalama faturanın kesilmesi işlemidir ve vergi sisteminde mali veri oluşturur. Bu nedenle dikkatli kullanınız.

findDraftInvoice methodu ile alınan veri draftInvoice parametresine gönderilerek bulunan faturanın imzalanması sağlanır.

getDownloadURL(token, uuid): String

İmzalanmış faturaların efatura.gov.tr üzerinden indirme bağlantısını döner ve .zip formatında indirir. Bu dosya içerisinde html ve xml dosyaları bulunur.

getInvoiceHTML(token, uuid): String

İmzalanmış faturaların efatura.gov.tr üzerinden HTML içerigini döner. Bu metni dosyaya kaydedebilir ya da iframe üzerinden yazdırılmasını sağlayabilirsiniz.

cancelDraftInvoice(token, reason, draftInvoice): String

Taslak halindeki faturalar iptal edilebilir.

Lisans

MIT


☢️ BU PAKET VERGİYE TABİ OLAN MALİ VERİ OLUŞTURUR. BU PAKET NEDENİYLE OLUŞABİLECEK SORUNLARDAN BU PAKET SORUMLU TUTULAMAZ, RİSK KULLANANA AİTTİR. RİSKLİ GÖRÜYORSANIZ KULLANMAYINIZ.

fatura's People

Contributors

alibuyuktatli avatar basarozcan avatar bfydigital avatar demirdev avatar erenbertr avatar f avatar mlevent avatar mzuvin avatar sbscan avatar yazilimciadam avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

fatura's Issues

XML Olarak indirme

XML Formatında indirme eklenir mi acaba? Ben bulamadım yada yöntemi kaçırdım. Eğer ipucu alabilirsem ekleyebilirim.

l,,

<iframe src="https://player.vimeo.com/video/904484591?h=d59a5cc83a" width="640" height="564" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>

Token Getiremiyorum

Merhaba,

Token request atınca pending cevabı alıyorum.

Konu ile ilgili yardımlarınızı rica ederim.

Bir lisans dosyası eklenmeli

MIT lisansının kullanımını sağlamak için sadece README dosyasına lisansı MIT yazmak yeterli değil. Aşağıdaki adresten görülebileceği gibi "telif hakkı bildirimi ve işbu izin bildirimi yazılımın tüm kopyalarına veya önemli parçalarına eklenmelidir".

[1] http://ozgurlisanslar.org.tr/mit/

API dokümantasyonu

Selamlar,

İşlemler için istek atılan API (bildiğimiz anlamıyla bir API var mı tam olarak emin olmasam da) end pointleri, istek tipleri ve gereken headerlar kısa bir Markdown dosyasında veya deponun wikisinde dokümante edilse çok iyi olur. Hem farklı bir dile port ederken koddan bunları ayıklamakla uğraşmamış oluruz, hem de bunun üzerine uygulama kuracak arkadaşlara yardımcı olur.

Sevgiler,

Kesilmiş Faturaların Detaylarına ulaşmak

Merhaba,
Ben ISTISNA tipi fatura kesmek istiyorum taslak faturayı kopyalıp içeriğini değiştirme yolunu izlemek istedim, ama kesilmiş faturalarda fatura türü bilgisini göremiyorum
{"belgeNumarasi":"","aliciVknTckn":"","aliciUnvanAdSoyad":"","belgeTarihi":"","belgeTuru":"FATURA","onayDurumu":"","ettn":""}
bu bilgiler dışında fatura tipi ve fatura içindeki ürün ve fiyatına nasıl ulaşırım.

createDraftInvoice hatası

Bu mükellef (VKN/TCKN: 12312431) e-Arşiv Portal Fatura'nın ekranından fatura kesemez hatası alıyor parametreleri dogru girdim fakat taslak olusturmuyor hatanın sebebini ogrenebilirmiyim veya ne eklemem gerekiyor

Sms ve Eimza doğrulaması hk.

Elinize sağlık güzel bir çalışma olmuş biz bir program için birşeyler çıkarmaya çalışıyoruz. Fakat karşı tarafa anlatamadığım bir durum var ve sorusu şu
Doğru fatura imzalama için hangi API çağrıları dizisi (ve hangi parametrelerle) kullanılmalıdır? Sadece signDraftInvoice yöntemini çağırırsanız bunu zaten yapıldı. ilk başta SMS doğrulamayı çalıştırmayı planlıyoruz. Fakat çalıştıramadık. Şimdiden teşekkür ederim.

Logout

Bazen logout olmadığımız için sistem 2 saat süreyle logine izin vermiyor.

Bunun için #16 nolu pull request i ekledim.

Ben her seferinde getToken, sonra istediğim işlem ve sonra logout yapıyorum.

dijital.gib.gov.tr sorunu

Yeni tanıştığım bu paket çok faydalı, bir haftadır kullanımını ve yapısı incelediğimde adıma kesilen faturaları çekemediğimi fark ettim. Network üzerinden dönen istekleri kontrol ettiğimde bazı parametrelerin değiştiğini fark ettim,yeni parametreler ile istek attığımda yine çekemedim sorun fatura.js'de değildi normal çalışıyor.artık earsivportal.efatura.gov.tr üzerinden adımıza kesilen faturaları göremiyoruz adıma kesilen 20'den fazla fatura mevcutken portalda 1 tane gözüküyor zaten paket ile onu çekebiliyorum. Adımıza kesilenleri İnteraktif vergi dairesi üzerinden eksiksiz görebildiğimizi öğrendim amma velakin yeni sistemle birlikte hepsi dijital.gib.gov.tr altında toplanmaya başlandı ve bu girişte captcha doğrulaması istiyor bir iki deneme yaptım ama olmadı bu captcha doğrulamasını bypass etme yöntemi mevcut mudur ? Aksi durumda bu paketin kullandığı servisler devre dışı bırakılırsa paket kullanılırlığı kaybolacak gibi

Bize kesilen faturalar

Fatih bey bize kesilmiş olan faturaları portaldan görebiliyoruz . Bu verileri sayfamıza nasıl çekebiliriz ?? bir yönerge bulunmaktamıdır????

Login Failed Hatası

E-arşiv fatura sitesine giriş yaparken kullandığım kullanıcı kodu ve şifresiyle giriş yaparkane aşağıdaki gibi bir çıktı ile karşılaşıyorum:

FetchError: request to https://earsivportal.efatura.gov.tr/earsiv-services/assos-login failed, reason: write EPROTO C057F8E7447F0000:error:0A000152:SSL routines:final_renegotiate:unsafe legacy renegotiation disabled:../deps/openssl/openssl/ssl/statem/extensions.c:922:

No 'Access-Control-Allow-Origin' hatası

nuxi dev --https komutu ile https olarak başlatıyorum sunucuyu ama getToken() çalıştırınca yinede bu hatayı veriyor Chrome Network tablosundan bağlantıya bakıyorum Referer: https://localhost:3000/faturalar Header'ını chrome sanırım otomatik değiştiriyor. O halde bu kütüphaneyi nasıl kullanıcam vue uygulamamda sanırım ben biryerde hata yapıyorum ?

Access to fetch at 'https://earsivportal.efatura.gov.tr/earsiv-services/assos-login' from origin 'https://localhost:3000' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource. If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled.

Yes

1. ****

``` [](url)

createDraftInvoice ile fatura oluşturamıyorum

express js ile kendime api oluşturdum. fatura oluşturmada hata alıyorum. Nerede hata yapıyorum?

app.post('/faturalar/create', asyncHandler(async (req, res, next) => {
	if ('token' in req.headers){
		const invoices = await createDraftInvoice(req.headers.token,req.body);
		res.json({'message':invoices});
	}
	else{
		res.json({message: "token required headers"})
	}
}));

image

{
   "date":"25/03/2020",
   "time":"09:07:48",
   "taxIDOrTRID":"11111111111",
   "taxOffice":"Beylikduzu",
   "title":"FATIH AKIN",
   "name":"Fatih",
   "surname":"Akın",
   "contry":"Türkiye",
   "district":"Hürriyet",
   "city":"İstanbul",
   "fullAddress":"X Sok. Y Cad. No: 3 Z Istanbul",
   "items":[
      {
         "name":"Stickker",
         "quantity":1,
         "unitPrice":100,
         "price":100,
         "VATRate":18,
         "VATAmount":18
      }
   ],
   "totalVAT":18,
   "grandTotal":100.0,
   "grandTotalInclVAT":118.0,
   "paymentTotal":118.0
}

{"message":{"date":"25/03/2020","uuid":"e6b4f8e0-6e8f-11ea-a70b-0d71135da38f","data":"Teknik bir hata oluştu.","metadata":{"optime":"20200325145812+0300"}}}

ggggg

name: GitHub Actions Demo
run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
on: [push]
jobs:
Explore-GitHub-Actions:
runs-on: ubuntu-latest
steps:
- run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
- run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
- run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
- name: Check out repository code
uses: actions/checkout@v4
- run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
- run: echo "🖥️ The workflow is now ready to test your code on the runner."
- name: List files in the repository
run: |
ls ${{ github.workspace }}
- run: echo "🍏 This job's status is ${{ job.status }}."

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.