f/fatura

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

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.

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.

npm install fatura

Node.js 18 veya üzeri gereklidir (package.json içinde engines).

Tüm işlemler bir FaturaClient örneği üzerinden yapılır. Üretim (canlı GİB) için:

const { createFaturaClient } = require("fatura");
const client = createFaturaClient(); // varsayılan: PROD

Test ortamı (https://earsivportaltest.efatura.gov.tr):

const client = createFaturaClient("TEST");

ES modülü:

import { createFaturaClient } from "fatura";
const client = createFaturaClient();

Oldukça kolay bir kullanıma sahiptir:

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

const { createFaturaClient } = require("fatura");

const client = createFaturaClient();

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

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 { createFaturaClient } = require("fatura");

const client = createFaturaClient();

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

Aşağıdakilerin tümü const client = createFaturaClient(...) ile oluşturduğunuz istemci üzerinde çağrılır.

e-Arşiv Portal oturumu için token döner.

e-Arşiv’de önce taslak oluşturulur. Dönüş değerinde uuid, date ve GİB cevabı bulunur. invoiceDetails örnek şekli:

ℹ️ uuid vermezseniz yeni bir UUID atanı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: 20,
            VATAmount: 20,
        },
    ],
    totalVAT: 20,
    grandTotal: 100.0,
    grandTotalInclVAT: 120.0,
    paymentTotal: 120.0,
}

createDraftInvoice’ın döndürdüğü taslak nesnesi (date + uuid içeren) verilir; ilgili gündeki taslaklar arasından eşleşen kayıt döner. İmzalama için gereken bilgiler (ör. belge numarası) bu nesnede yer alır.

İki tarih arasındaki kesilen / taslak listesi (GİB komutuna göre).

İki tarih arasındaki adıma düzenlenen belgeler.

☢️ İmzalama kesilmiş sayılan mali işlem oluşturur; dikkatli kullanın.

findInvoice ile bulunan liste öğesi (draftInvoice formatı) verilmelidir.

İndirme URL’si döner (.zip içinde HTML/XML olabilir). signed: fatura onaylı mı (true / false).

Fatura HTML metni. signed imzalı/onaysız görünüm için kullanılır.

Taslak iptali.

VKN/TCKN ile alıcı bilgisi sorgusu.

İmzaya ilişkin SMS doğrulama akışı (GİB kurallarına tabi).

Portal kullanıcı bilgilerini okuma / güncelleme.

Token alır, taslak oluşturur, bulur; sign: true (varsayılan) ise imzalar. findInvoice sonuç vermezse imza atlanır.

Oturum kapatma; GİB cevabına göre dönüş tipi değişebilir.

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.