Sabitler (Enum) referansı
API gövdelerinde ve yanıtlarda kullanılan string / sayısal sabitlerin özeti. Geçersiz değerler doğrulama hatasına yol açar.
type — Fatura tipi
Kullanıldığı yer: Fatura oluşturma (type).
| Değer | Kısa açıklama |
|---|---|
SATIS | Satış faturası |
IADE | İade |
TEVKIFAT | Tevkifat |
TEVKIFATIADE | Tevkifat iadesi |
ISTISNA | İstisna |
OZELMATRAH | Özel matrah |
IHRACKAYITLI | İhracat kayıtlı |
KONAKLAMAVERGISI | Konaklama vergisi |
customer.type — Müşteri türü
Kullanıldığı yerler: Müşteri oluşturma, Fatura oluşturma (customer.type).
| Değer | Anlamı |
|---|---|
person | Gerçek kişi — name, surname zorunlu; title isteğe bağlı. |
company | Tüzel kişi — title, tax_office zorunlu; name / surname isteğe bağlı. |
lines.*.tax_rate — KDV oranı (fatura satırı)
Kullanıldığı yer: Fatura oluşturma. Değerler string olarak gönderilir.
| Değer | Oran |
|---|---|
0 | %0 |
1 | %1 |
2 | %2 |
8 | %8 |
10 | %10 |
18 | %18 |
20 | %20 |
Ürün oluşturma (POST /api/products) için tax_rate alanı sayısal olarak aynı oranlardan birini kabul eder (0, 1, 8, 10, 18, 20).
lines.*.discount_type — Satır indirim türü
| Değer | Anlamı |
|---|---|
amount | Tutar indirimi |
percentage | Yüzde indirimi |
internet_sale.payment_method — İnternet satışı ödeme yöntemi
| Değer | Açıklama |
|---|---|
credit_or_debit | Kredi/banka kartı |
direct_transfer | EFT/havale |
cash_on_delivery | Kapıda ödeme |
payment_agent | Ödeme aracısı |
other | Diğer |
workflow_status — Fatura iş akışı durumu
Yanıtta okunur alan olarak döner; taslak senaryolarında isteğe bağlı olarak gönderilebilir.
| Değer | Anlamı |
|---|---|
processing | İşleniyor |
failed | Hatalı |
completed | Tamamlandı |
predraft | Taslak |
formal_status — Resmileştirme durumu
Yanıtta ve filtrelerde kullanılır.
| Değer | Anlamı |
|---|---|
pending | Bekleniyor |
running | İşleniyor |
completed | Tamamlandı |
not_required | İşlem gerekmiyor |
failed | Hatalı |
canceled | İptal |
stopped | Beklemede |
queued | Kuyrukta |
currency — Para birimi
ISO 4217 formatında gönderilir. Yaygın değerler:
| Değer | Para birimi |
|---|---|
TRY | Türk Lirası |
USD | ABD Doları |
EUR | Euro |
GBP | İngiliz Sterlini |
lines.*.unit — Birim kodu
UBL/UN/ECE standardına dayalı üç–dört karakterlik kodlar kullanılır. Yaygın değerler:
| Kod | Birim |
|---|---|
C62 | Adet |
KGM | Kilogram |
GRM | Gram |
LTR | Litre |
MTR | Metre |
CMT | Santimetre |
MTK | Metrekare |
MTQ | Metreküp |
PA | Paket |
BX | Kutu |
SET | Set |
PR | Çift |
DZN | Düzine |
HUR | Saat |
DAY | Gün |
MON | Ay |
ANN | Yıl |
KWH | Kilowatt-saat |
TNE | Ton |
lines.*.extra_taxes.*.tax_code — Ek vergi kodu
GİB tarafından tanımlanan dört haneli vergi kodu. İlgili vergi türüne göre doğru kodu kullanmanız gerekir. Örnek: 0059 (Özel İletişim Vergisi). Kodu doğrulamak için GİB e-belge teknik kılavuzuna veya muhasebe danışmanınıza başvurun.