Ana içeriğe geç

ID'ye Göre Beyanname Güncelleme

Sistemdeki mevcut bir beyannameyi verilen bilgilerle günceller.

İstek​

PUT /api/v1/declarations/{declaration_id}

Parametreler​

İsimTipYerAçıklama
declaration_idstringpathGerekli. Güncellenecek beyannamenin ID'si

Başlıklar​

İsimAçıklama
AuthorizationGerekli. Kimlik doğrulama için Bearer token
Content-TypeGerekli. application/json olmalıdır
X-Target-ServerGerekli. Hedef sunucu tanımlayıcısı

Kod Tipleri​

Temsilci Tipleri​

KodAçıklama
1Beyanname Sahibi
2Şirket ve Yasal Temsilci
3Yasal Temsilci

Mali Müşavir Tipleri​

KodAçıklama
1SMMM
2YMM
3Bağımsız Denetçi

İşlem Tipleri​

KodAçıklama
EUTransit
ANAntrepo
EXİhracat
IMİthalat

Yetkili Tipleri​

KodAçıklama
1Şirket
2Kişi

Incoterms Kodları​

KodAçıklama
CFMaliyet ve Navlun
CFRMaliyet ve Navlun
CIMaliyet ve Sigorta
CIFMaliyet, Sigorta ve Navlun
CIPTaşıma ve Sigorta Ödenmiş Olarak
CPTTaşıma Ödenmiş Olarak
DAFSınırda Teslim
DAPBelirtilen Yerde Teslim
DATTerminalde Teslim
DDPGümrük Resmi Ödenmiş Olarak Teslim
DDUGümrük Resmi Ödenmemiş Olarak Teslim
DEQRıhtımda Teslim
DESGemide Teslim
DPUBoşaltılmış Olarak Teslim
EXQRıhtımda Teslim
EXSGemide Teslim
EXWİşyerinde Teslim
FASGemi Doğrultusunda Teslim
FCATaşıyıcıya Teslim
FOAUçakta Teslim
FOBGemide Teslim
FORTrende Teslim
FOTKamyonda Teslim
XXXDiğer

İşlem Özellik Kodları​

KodAçıklama
7Normal
8İade
9Farklı Beyanname ile İade
11Normal
12İade
13Farklı Beyanname ile İade
14Normal
15İade
21Normal
22İade
23Farklı Beyanname ile İade
31Normal
32İade
33Farklı Beyanname ile İade
34Normal
41Normal
42İade
43Farklı Beyanname ile İade
51Normal
52İade
53Farklı Beyanname ile İade
61Normal
62İade

Onaylayıcı Tipleri​

KodAçıklama
1Temsilci
2Tüzel Kişi
3Gümrük Müşaviri

Araç Bilgi Tipleri​

KodAçıklama
registration_numberRuhsat Numarası
nameİsim
platePlaka

Araç Tipleri​

KodAçıklama
vehicleAraç
trainTren
planeUçak
shipGemi

Taşıma Belgesi Girişi​

KodAçıklama
singleTekli
multipleÇoklu

Taşıma Belgesi Bütünlüğü​

KodAçıklama
entireTam
partialKısmi

Taşıma Tipi Kodları​

KodAçıklama
10Karayolu Taşımacılığı
12Karayolu Taşımacılığı
16Karayolu Taşımacılığı
17Karayolu Taşımacılığı
18Karayolu Taşımacılığı
20Demiryolu Taşımacılığı
23Demiryolu Taşımacılığı
30Havayolu Taşımacılığı
31Havayolu Taşımacılığı
40Denizyolu Taşımacılığı
50Denizyolu Taşımacılığı
70Denizyolu Taşımacılığı
80Denizyolu Taşımacılığı
90Denizyolu Taşımacılığı

İstek Gövdesi​

İstek gövdesi aşağıdaki yapıyı içermelidir:

{
  "senders": [
    {
      "id": "string",
      "name": "string",
      "tax_identification_number": "string",
      "address": "string",
      "country": {
        "code": "string",
        "name": "string"
      },
      "type": "number",
      "is_default": "boolean"
    }
  ],
  "receiver": {
    "name": "string",
    "tax_identification_number": "string",
    "address": "string",
    "country": {
      "code": "string",
      "name": "string"
    },
    "type": "number",
    "is_auto_generated": "boolean"
  },
  "financial_officer": {
    "name": "string",
    "surname": "string",
    "tax_identification_number": "string",
    "type": "number"
  },
  "representative": {
    "name": "string",
    "surname": "string",
    "address": "string",
    "tax_identification_number": "string",
    "type": "number"
  },
  "operation_type": "string",
  "incoterms": {
    "code": "string",
    "delivery_place": "string"
  },
  "insurance": {
    "insurance_documents": [
      {
        "id": "string",
        "name": "string",
        "url": "string",
        "type": "string",
        "hash": "string",
        "size": "number",
        "created_at": "string"
      }
    ],
    "policy_documents": [
      {
        "id": "string",
        "name": "string",
        "url": "string",
        "type": "string",
        "hash": "string",
        "size": "number",
        "created_at": "string"
      }
    ]
  },
  "invoices": {
    "other_invoices": [
      {
        "id": "string",
        "name": "string",
        "url": "string",
        "type": "string",
        "hash": "string",
        "size": "number",
        "created_at": "string"
      }
    ],
    "e_invoices": [
      {
        "file": {
          "id": "string",
          "name": "string",
          "url": "string",
          "type": "string",
          "hash": "string",
          "size": "number",
          "created_at": "string"
        },
        "invoice_no": "string",
        "date": "string",
        "amount": "number",
        "currency": "string",
        "type": "number",
        "company": "string",
        "vkn": "string"
      }
    ]
  },
  "transaction_attribute_code": "number",
  "shipment_reference_number": "string",
  "approver": {
    "type": "number",
    "name": "string",
    "surname": "string",
    "title": "string",
    "registration_number": "string",
    "address": "string"
  },
  "previous_declaration": {
    "is_regime_applied": "boolean",
    "date": "string",
    "reference_code": "string",
    "entire_transport_document": "string",
    "is_item_in_package": "boolean",
    "is_any_other_regime_will_open": "boolean",
    "entry_of_transport_document": "string",
    "transport_document_no": "string"
  },
  "logistic": {
    "is_container": "boolean",
    "in_border_carrier_type": {
      "code": "number",
      "name": "string"
    },
    "internal_carrier_type": {
      "code": "number",
      "name": "string"
    },
    "loading_or_unloading_area": "string",
    "customs_administration_name": "string",
    "product_control_area_name": "string",
    "antrepo_code": "string",
    "first_arrival_or_last_shipment_country": {
      "code": "string",
      "name": "string"
    }
  },
  "transport_vehicle_information": {
    "vehicle_information_type": "string",
    "vehicle_information": "string",
    "vehicle_information_country": {
      "code": "string",
      "name": "string"
    }
  },
  "border_crossing_vehicle_information": {
    "vehicle_type": "string",
    "vehicle_information_type": "string",
    "vehicle_information": "string",
    "vehicle_registration_country": {
      "code": "string",
      "name": "string"
    }
  },
  "source_country": {
    "code": "string",
    "name": "string"
  },
  "shipment_or_export_country": {
    "code": "string",
    "name": "string"
  },
  "target_country": {
    "code": "string",
    "name": "string"
  }
}

Örnek​

curl --request PUT \
  --url '{{HOST}}/api/v1/declarations/682735a3b702ddb736a9b9f3' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --header 'X-Target-Server: declaration' \
  --data '{
    "senders": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "ABC Şirketi Ltd.",
        "tax_identification_number": "1234567890",
        "address": "123 İş Caddesi, İstanbul, Türkiye",
        "country": {
          "code": "F01",
          "name": "Türkiye"
        },
        "type": 1,
        "is_default": true
      }
    ],
    "receiver": {
      "name": "XYZ Ticaret A.Ş.",
      "tax_identification_number": "9876543210",
      "address": "456 Ticaret Caddesi, Londra, İngiltere",
      "country": {
        "code": "F01",
        "name": "İngiltere"
      },
      "type": 1,
      "is_auto_generated": false
    },
    "financial_officer": {
      "name": "Ahmet",
      "surname": "Yılmaz",
      "tax_identification_number": "12345678901",
      "type": 1
    },
    "representative": {
      "name": "Ayşe",
      "surname": "Demir",
      "address": "789 Temsilci Sokak, İstanbul, Türkiye",
      "tax_identification_number": "98765432101",
      "type": 1
    },
    "operation_type": "EX",
    "incoterms": {
      "code": "FOB",
      "delivery_place": "İstanbul Limanı"
    },
    "insurance": {
      "insurance_documents": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174001",
          "name": "sigorta_policesi.pdf",
          "url": "https://example.com/sigorta_policesi.pdf",
          "type": "application/pdf",
          "hash": "abc123def456",
          "size": 1024.5,
          "created_at": "2024-03-20T10:00:00Z"
        }
      ],
      "policy_documents": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174002",
          "name": "politika_belgesi.pdf",
          "url": "https://example.com/politika_belgesi.pdf",
          "type": "application/pdf",
          "hash": "def456abc789",
          "size": 2048.0,
          "created_at": "2024-03-20T10:00:00Z"
        }
      ]
    },
    "invoices": {
      "other_invoices": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174003",
          "name": "fatura.pdf",
          "url": "https://example.com/fatura.pdf",
          "type": "application/pdf",
          "hash": "ghi789jkl012",
          "size": 1536.0,
          "created_at": "2024-03-20T10:00:00Z"
        }
      ],
      "e_invoices": [
        {
          "file": {
            "id": "123e4567-e89b-12d3-a456-426614174005",
            "name": "e_fatura.pdf",
            "url": "https://example.com/e_fatura.pdf",
            "type": "application/pdf",
            "hash": "mno345pqr678",
            "size": 1024.0,
            "created_at": "2024-03-20T10:00:00Z"
          },
          "invoice_no": "FTR-2024-001",
          "date": "2024-03-20",
          "amount": 1000.00,
          "currency": "USD",
          "type": 1,
          "company": "ABC Şirketi Ltd.",
          "vkn": "1234567890"
        }
      ]
    },
    "transaction_attribute_code": 11,
    "shipment_reference_number": "REF-2024-001",
    "approver": {
      "type": 1,
      "name": "Mehmet",
      "surname": "Kaya",
      "title": "Kıdemli Gümrük Müşaviri",
      "registration_number": "GM123456",
      "address": "101 Onaylayıcı Sokak, İstanbul, Türkiye"
    },
    "previous_declaration": {
      "is_regime_applied": true,
      "date": "2024-03-19",
      "reference_code": "PD-2024-001",
      "entire_transport_document": "entire",
      "is_item_in_package": true,
      "is_any_other_regime_will_open": false,
      "entry_of_transport_document": "single",
      "transport_document_no": "TD-2024-001"
    },
    "logistic": {
      "is_container": true,
      "in_border_carrier_type": {
        "code": 10,
        "name": "Karayolu Taşımacılığı"
      },
      "internal_carrier_type": {
        "code": 10,
        "name": "Demiryolu Taşımacılığı"
      },
      "loading_or_unloading_area": "İstanbul Limanı A Bölgesi",
      "customs_administration_name": "İstanbul Gümrük",
      "product_control_area_name": "İstanbul Kontrol Bölgesi",
      "antrepo_code": "ANT-001",
      "first_arrival_or_last_shipment_country": {
        "code": "F01",
        "name": "Türkiye"
      }
    },
    "transport_vehicle_information": {
      "vehicle_information_type": "name",
      "vehicle_information": "34ABC123",
      "vehicle_information_country": {
        "code": "F01",
        "name": "Türkiye"
      }
    },
    "border_crossing_vehicle_information": {
      "vehicle_type": "vehicle",
      "vehicle_information_type": "name",
      "vehicle_information": "34XYZ789",
      "vehicle_registration_country": {
        "code": "F01",
        "name": "Türkiye"
      }
    },
    "source_country": {
      "code": "F01",
      "name": "Türkiye"
    },
    "shipment_or_export_country": {
      "code": "F01",
      "name": "Türkiye"
    },
    "target_country": {
      "code": "F01",
      "name": "İngiltere"
    }
  }'

Yanıt​

Başarılı bir istek, güncellenmiş beyanname verileriyle birlikte HTTP 200 durum kodu döndürür.

Durum Kodları​

Durum KoduAçıklama
204Başarılı - Beyanname başarıyla güncellendi
400Geçersiz İstek - Geçersiz parametreler
401Yetkisiz - Geçersiz veya eksik kimlik doğrulama token'ı
404Bulunamadı - Beyanname ID'si mevcut değil
500Sunucu Hatası

Notlar​

  • İstek gövdesindeki tüm alanlar isteğe bağlıdır. Sadece güncellenmesi gereken alanlar istekte belirtilmelidir.
  • URL'deki beyanname ID'si geçerli olmalı ve sistemde mevcut olmalıdır.
  • İstek geçerli kimlik doğrulama ve yetkilendirme başlıklarını içermelidir.