Sandbox
Sandbox, üretimden tamamen ayrı bir sistemdir — ayrı veritabanı, ayrı mükellef kayıtları, ayrı OAuth istemcileri. Geliştirmenin tamamını burada yapın; üretime geçiş Üretim vs Sandbox sayfasında.
| Adres | |
|---|---|
| API | https://sandbox-api.finansfatura.com |
| Panel | https://sandbox-app.finansfatura.com |
Mükellef hesabı ve API anahtarı
Sandbox panelinde bir mükellef hesabıyla oturum açıp Ayarlar → API Anahtarları'ndan anahtar üretirsiniz — Hızlı Başlangıç bunu adım adım gösteriyor. Sandbox hesabı yoksa ya da OAuth istemcisi kaydettirmeniz gerekiyorsa [email protected] adresine yazın.
Ne gerçek, ne simüle
Sandbox'ta kestiğiniz belge gerçek bir GİB belgesi değildir — gerçek bir mükellefin ciro/stok/kontör dengesini etkilemeden uçtan uca akışı test edersiniz: satış oluşturma, fatura kesme, durum sorgulama, iptal, iade, indirme — hepsi gerçek davranışıyla çalışır. Kontör sandbox'ta da düşer ama sandbox kontörü üretimle paylaşılmaz.
A-Fatura mükellefi olan ve olmayan onaylı test alıcı VKN/unvan/vergi dairesi bilgileri ayrı bir kanaldan paylaşılır — buraya tahmini bir VKN yazmıyoruz. Elinizde test alıcı setiyoksa [email protected] adresinden isteyin.
Sandbox ile sınırlı davranış farkları
- Kontör iadesi yoktur — üretimde de yoktur, bkz.
Fatura İptal. Sandbox'ta kontör
bitince gerçek üretim hesabınız gibi
402 ERROR_INSUFFICIENT_KONTORalırsınız; panelden sandbox kontörü yükleyin. - Sandbox'ta oluşturduğunuz OAuth istemcisi yalnız sandbox'ta çalışır. Üretim için ayrı bir istemci kaydı gerekir — bkz. Üretim vs Sandbox.
İstemci kütüphaneleri ile sandbox
Python/Node/PHP kütüphanelerini kullanıyorsanız sandbox'a geçiş tek bir temel URL değişimidir — bkz. İstemci Kütüphaneleri → Sandbox.