Go İthalat REST API

Genel Bakış

Go İthalat REST API, pazaryeri siparişlerinizi otomatik olarak Go İthalat sistemine iletmenizi sağlar.

Base URL

Özellikler

• Sipariş oluşturma ve sorgulama
• Kargo durumu güncelleme
• Entegrasyon Bakiye ile ödeme
• Çoklu ürün desteği

API Limitleri

Kimlik Doğrulama

Her istekte Authorization header'i gönderilmelidir. Kimlik dogrulama Bearer Token ile yapılır. Token, Go İthalat admin panelinden otomatik oluşturulur.

Token Kullanımı

Python Örneği

 Kopyalaimport requests

API_TOKEN = "abc123def456..."  # Go Ithalat panelinden alinan md5(token)
BASE_URL = "https://www.goithalat.com/rest"

headers = {"Authorization": f"Bearer {API_TOKEN}"}

# Sipariş sorgula
resp = requests.get(
    f"{BASE_URL}/getOrder",
    params={"no": "TY-1234567890"},
    headers=headers,
    timeout=10
)
print(resp.text)

PHP Örneği

 Kopyala$token = "abc123def456..."; // Go Ithalat panelinden alinan md5(token)

$ch = curl_init("https://www.goithalat.com/rest/getOrder?no=TY-123");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $token
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Sipariş Oluştur

Python Örneği

 Kopyalaimport requests

payload = {
    "no": "TY-1234567890",
    "name": "Ahmet Yilmaz",
    "email": "bayi@firma.com",
    "ccode": "KARGO_TAKIP_NO",
    "odemeTipi": "Entegrasyon Bakiye",
    "kargoFirmaID": 5,
    "urunID_1": 44218,
    "urunAdet_1": 2,
    "urunID_2": 44350,
    "urunAdet_2": 1
}

headers = {"Authorization": "Bearer abc123def456..."}

resp = requests.post("https://www.goithalat.com/rest/setOrder",
                     data=payload, headers=headers, timeout=30)
print(resp.text)

PHP Örneği

 Kopyala$payload = [
    "no"         => "TY-1234567890",
    "name"       => "Ahmet Yilmaz",
    "email"      => "bayi@firma.com",
    "odemeTipi"  => "Entegrasyon Bakiye",
    "kargoFirmaID" => 5,
    "urunID_1"   => 44218,
    "urunAdet_1" => 2
];

$ch = curl_init("https://www.goithalat.com/rest/setOrder");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer abc123def456..."]);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Başarılı Yanıt

{ "Success": true, "SIPARIS_NO": "TY-1234567890" }

Sipariş Sorgula

Yanıt Ornegi

{
  "ID": 12345,
  "no": "TY-1234567890",
  "name": "Ahmet Yilmaz",
  "status": 10
}

Ürün Stok Sorgula

Sipariş oluşturmadan önce ürünün stok durumunu kontrol edin. Stokta olmayan ürünler için sipariş oluşturulmaz.

Yanıt Formatı (XML)

Yanıt XML formatındadır. Önemli alanlar aşağıda listelenmiştir:

 Kopyala<?xml version="1.0" encoding="utf-8"?>
<urunler>
  <urun>
    <urun_ID>44218</urun_ID>
    <urun_ad><![CDATA[Örnek Ürün Adı]]></urun_ad>
    <urun_stok>25</urun_stok>
    <urun_fiyat_bayi_ozel>129.90</urun_fiyat_bayi_ozel>
  </urun>
</urunler>

Önemli Alanlar

Python Örneği

 Kopyalaimport requests
import re

API_TOKEN = "abc123def456..."  # Bearer Token
BASE_URL = "https://www.goithalat.com/rest"

urun_id = 44218  # Kontrol edilecek Go Ithalat urun ID

headers = {"Authorization": f"Bearer {API_TOKEN}"}
resp = requests.post(f"{BASE_URL}/stockCheck/ID/{urun_id}",
                     headers=headers, timeout=10)

if resp.status_code == 200:
    stok_match = re.search(r'<urun_stok>(.*?)</urun_stok>', resp.text)
    if stok_match:
        stok = int(float(stok_match.group(1)))
        print(f"Mevcut stok: {stok}")
        if stok > 0:
            print("Siparis olusturulabilir.")
        else:
            print("Urun tukenmis, siparis olusturulamaz.")
    else:
        print("Urun bulunamadi.")

PHP Örneği

 Kopyala$token = "abc123def456...";
$urunID = 44218;

$ch = curl_init("https://www.goithalat.com/rest/stockCheck/ID/" . $urunID);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . $token]);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);

$xml = simplexml_load_string($response);
if ($xml && isset($xml->urun)) {
    $stok = (int)$xml->urun->urun_stok;
    echo "Mevcut stok: " . $stok . "\n";
    if ($stok > 0) {
        echo "Siparis olusturulabilir.";
    } else {
        echo "Urun tukenmis!";
    }
}

Sipariş Durumu Güncelle

Kargo Firma Kodları

Siparis olustururken kargoFirmaID degerini asagidaki tablodan secin.

Trendyol

Hepsiburada

Pazarama

N11

Ciceksepeti

Hata Kodları ve Yanıtlar

Sipariş Numarası Formatı

Mükerrer engeli için sipariş numarasının başına platform prefix'i eklemeniz önerilir: