bitki koruma Ürünleri takip sistemi xml standardı kılavuzu ... · receiver: mal alımı veya...

19
GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ (Bitki Koruma Ürünleri Daire Başkanlığı) Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu Versiyon 1.4 2018

Upload: hadan

Post on 07-May-2019

230 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

Bitki Koruma Ürünleri Takip Sistemi

XML Standardı Kılavuzu

Versiyon 1.4

2018

Page 2: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

1

İçindekiler

XML İŞLEMLERİ ........................................................................................................................................ 2

XSD Tanımı ve Kullanımı ...................................................................................................................... 2

Elementler ........................................................................................................................................... 3

Web Servis Bilgileri .............................................................................................................................. 7

ÖRNEK XML-1 (Üretim Bildirimi) ........................................................................................................... 16

ÖRNEK XML-2 (Üretici Firmadan Toptancıya Satış Bildirimi) ................................................................ 17

Page 3: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

2

XML İŞLEMLERİ

XSD Tanımı ve Kullanımı Bitki Koruma Ürünü Takip Sistemi için kullanılacak XML standartları Şekil 1 de yer alan XSD ile

tanımlanmaktadır. XML’in oluşturulmasında bu XSD dokümanı kullanılmalıdır.

<?xml version="1.0" encoding="utf-16" ?> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="transfer"> <xs:complexType> <xs:sequence> <xs:element name="sender" type="xs:string" minOccurs="1" maxOccurs="1" /> <xs:element name="receiver" type="xs:string" minOccurs="1" maxOccurs="1" /> <xs:element name="key" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="actionType" minOccurs="1" maxOccurs="1"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:enumeration value="P" /> <!--Mal Alim (Purchase) --> <xs:enumeration value="S" /> <!--Satis (Sale) --> <xs:enumeration value="C" /> <!--Satis İptali (Cancel Sale) --> <xs:enumeration value="R" /> <!-- Iade (Return) --> <xs:enumeration value="M" /> <!-- Uretim (Manufacture) --> <xs:enumeration value="I" /> <!-- Ithalat (Import) --> <xs:enumeration value="X" /> <!-- Ihrac (eXport) --> <xs:enumeration value="D" /> <!-- Deaktivasyon (Deactivate) --> <xs:enumeration value="T" /> <!—Depolar Arası Transfer(Transfer) --> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="documentNumber" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="documentDate" type="xs:date" minOccurs="0" maxOccurs="1" /> <xs:element name="note" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="deactivationNote" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="exportReceiverNote" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="exportCountry" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="importSenderNote" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="importCountry" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="returnNote" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="destructionNote" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="idTaxNo" type="xs:string" minOccurs="0" maxOccurs="1" /> <xs:element name="carrier" type="carrierType" minOccurs="1" maxOccurs="unbounded" /> </xs:sequence> </xs:complexType> </xs:element> <xs:complexType name="carrierType"> <xs:sequence minOccurs="1" maxOccurs="unbounded"> <xs:choice minOccurs="1" maxOccurs="1">

Page 4: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

3

<xs:element name="productList" type="productListType" minOccurs="1" maxOccurs="1" /> <xs:element name="carrier" type="carrierType" minOccurs="1" maxOccurs="1" /> </xs:choice> </xs:sequence> <xs:attribute name="carrierLabel" use="required"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:length value="20" /> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="containerType" type="xs:string" use="optional" /> </xs:complexType> <xs:complexType name="productListType"> <xs:sequence> <xs:element name="serialNumber" type="xs:string" minOccurs="1" maxOccurs="unbounded" /> </xs:sequence> <xs:attribute name="GTIN" type="xs:string" use="required" /> <xs:attribute name="lotNumber" type="xs:string" use="required" /> <xs:attribute name="productionDate" type="xs:date" use="optional" /> <xs:attribute name="expirationDate" type="xs:date" use="required" /> <xs:attribute name="productNote" type="xs:string" use="optional" /> </xs:complexType> </xs:schema>

Şekil 1

Elementler sender : Mal alımını veya transferini yapan kaynak paydaşın (mal giriş veya çıkış bildirimini

yapan firmanın) GLN Numarası bilgisini içerir. Bu alan 13 karakter ve rakamlardan oluşan

zorunlu bir alandır.

receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı)

/GLN Numarası(firma) bilgisini içerir. Bu alan 13 karakter uzunlukta ve rakamlardan oluşan

bir alandır.

key: Bildirim yapan kaynak paydaşın doğrulama kodudur. Bu alan 36 karakter uzunluktadır

ve alfa numerik zorunlu bir alandır. Herbir paydaş TBS üzerinden kendi key bilgisine

ulaşabilecektir.

actionType: Bildirim tipini ifade eder. Sadece Şekil 1 de verilen karakterleri içerebilir,

karakterlerin ifade ettiği aksiyon tipleri açıklamalarıyla verilmiştir.

“P” - Mal Alım (Purchase) : Paketin gönderildiği paydaşın mal alım bildirimi

ile ürünleri alması gerektiğini ifade eder. Örneğin, bir üretici firma bir

toptancıya satış bildirimi ile ürün sattığında, bu aksiyon tipi kullanılarak

toptancının mal alım bildirimi yapması gerekir.

Page 5: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

4

“S” - Satış(Sale) : Paketi gönderen paydaşın satış bildirimi yaparak satış

işlemini gerçekleştirdiğini ifade eder.

“C” – Satış İptal (Cancel sale) : Paketin gönderildiği paydaşın satış iptal

bildirimi ile ürünleri alması gerektiğini ifade eder. Örneği bir bayi mal iade

servisini kullanarak firmaya ürünü iade ettiğinde, bu aksiyon tipini kullanarak

firmanın işlem servisini çağırarak iadeyi alması gerektiğini belirtir.

“R” – İade (Return) : Paketin gönderildiği paydaşın iade bildirimi ile ürünleri

iade etmesi gerektiğini ifade eder. Örneğin bir firma, bir bayiye sattığı bir

palet ürünün bilgisi yerine başka bir paletin ürün bilgilerini gönderdi ve bayi

bu yanlış paket ile bildirim yaptı. Bu ürünlerin firmaya sistem üzerinden iadesi

yapılabilmesi için bayi bu paketi bu aksiyon tipi ile gönderebilir.

"M" - Üretim (Manufacture): Paketin gönderildiği paydaşın üretim bildirimi

ile ürünleri üretmesi gerektiğini ifade eder.

"I" - İthalat (Import): Paketin gönderildiği paydaşın ithalat bildirimi ile ithal

edilen ürünlerin üretilmesi gerektiğini ifade eder.

"X" - İhracat (eXport): Paketin gönderildiği paydaşın ihracat bildirimi ile

ürünleri ihraç etmesi gerektiğini ifade eder.

"D" - Deaktivasyon (Deactivate): Paketin gönderildiği paydaşın deaktivasyon

bildirimi ile ürünleri deaktive etmesi gerektiğini ifade eder. Örneğin üretici

firmanın ürünleri imha durumu olduğunda bu aksiyon tipi kullanılır.

"T" – Depolar Arası Transfer (Transfer): Paketi gönderen paydaşın transfer

bildirimi yaparak başka bir deposuna ürünlerin çıkışını yapacağını ifade eder.

documentNumber : Belge numarasını içerir. En fazla 50 karakter uzunlığunda alfa numerik bir

alandır. Kullanımı isteğe bağlıdır.

documentDate : Belge ile ilgili tarih bilgisini içerir. XML Date tipindedir. Kullanımı isteğe bağlıdır.

XML Date tipinde olmayan tarih bilgisi XML’in validasyonunda hata verilmesine yol açar.

note : En fazla 100 karakterlik not alanıdır. Kullanımı isteğe bağlıdır.

deactivationNote: Deaktivasyon bildirimlerinde deaktivasyon sebebi belirtilir. 2 karakterlik kod

alanıdır. Sebebe ait kodlar aşağıdaki gibidir.

Kod Açıklaması

10 Üretim Fireleri

20 Geri Çekme Sebebi İle İmha

30 Miat Sebebi İle İmha

40 Numune Alma

50 Sistemden Çıkarma

destructionNote: Deaktivasyon bildirimlerinde deaktivasyon sebebi imha seçilmiş ise imha

referans numarası belirtilmesi zorunludur. En fazla 20 karakterlik alandır.

returnNote: İade bildirimlerinde iade sebebinin belirtilmesi zorunludur. 2 karakterlik kod

alanıdır. Sebebe ait kodlar aşağıdaki gibidir.

Page 6: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

5

Kod Açıklaması

10 Anlaşmazlık

20 Sarj İptali

30 Miat Sebebi İle İade

exportReceiverNote: İhracat bildirimlerinde ihracat yapılan firma adı belirtilir. En fazla 100

karakterlik zorunlu not alanıdır.

exportCountry: İhracat bildirimlerinde ihracat yapılan ülke ID belirtilir ve alfa numerik bir

alandır. GetCountryName servisinden gelen ülke listesinden seçim yapılacaktır. İhracat

bildirimlerinde zorunlu alandır.

importSenderNote: İthalat bildirimlerinde ithalat yapılan firma adı belirtilir. En fazla 100

karakterlik zorunlu not alanıdır.

importCountry: İthalat bildirimlerinde ithalat yapılan ülke ID belirtilir ve alfa numerik bir

alandır. GetCountryName servisinden gelen ülke listesinden seçim yapılacaktır. İthalat

bildirimlerinde zorunlu alandır.

idTaxNo : Firma, toptancı,bayi ve çiftçi hariç bir son kullanıcıya(ihale yoluyla işlem yapan

işletmelere) satış işlemi yapılacak ise satış yapılan işletmenin Vergi Numarası bilgisini içerir.

carrier : carrierType tipindedir. Ürün listesini ve taşıyıcı etiketini içerir.

carrierLabel : Taşıma birimleri için tanımlanan numaradır. Tam olarak 20 karakter uzunlukta

alfa numerik bir alandır. Doldurma Karakterleri içermemelidir. Zorunlu alandır.

Taşıma birimleri SSCC (Serial Shipping Container Code=Serilestirilmis tasıma birimi

kodu) koduna göre numaralandırılacaktır. Her bir taşıma birimine, taşıma biriminin

bütün ömrü boyunca (üretildiği ilk andan başlayarak, artık kullanılmaz hale gelinceye

dek) tanınmasını sağlayan bir seri numarası verilir.Her bir taşıma birimi farklı bir seri

numarası içerir. Birden çok taşıma birimi hep aynı çeşit ürün içerse de her bir taşıma

birimine farklı bir numara, dolayısıyla seri numarası verilir. Örneğin;

00868000100000000011 kodlu taşıma birimi numarasında ; (00) uygulama

tanımlayıcısı, GS1 Numaralama Organizasyonunun verdiği firma numarası, taşıma

birimi seri numarası ve kontrol basamağı bilgisi yer almaktadır. Firmalar uygulama

tanımlayıcısı bölümünde bu alanı kendi taşıma paketi ayrımını yapmak için farklı

şekilde kodlayabilirler.

containerType : Ürün listesinin veya taşıyıcının tipinin belirtilmesi için kullanılan bir alandır.

Bir karakterden oluşur : “P”: Palet, “C”: Koli simgeleyen karakterlerdir.

productList : productListType tipindedir ve ürünler listesidir

Page 7: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

6

GTIN – 14 karakter uzunluğunda Küresel Ticari Ürün Numarası - Barkod.

Zorunlu alandır.

serialNumber – En fazla 20 karakter uzunluğunda seri numarası. Zorunlu

alandır. Bir ürün listesine en azından bir adet seri numarası girilmelidir.

lotNumber – En fazla 20 karakter uzunluğunda parti numarası. Zorunlu

alandır.

expirationDate – Ürünün son kullanma tarihi XML date tipinde. Zorunlu

alandır. XML Date tipinde olmayan tarih bilgisi XML’in validasyonunda hata

verilmesine yol açar. Son kullanım tarihi üretim tarihinden sonra olacak

şekilde belirtilmelidir.

productionDate – Üretim Tarihi XML-Date tipindedir. Kullanımı isteğe

bağlıdır. XML Date tipinde olmayan tarih bilgisi XML’in validasyonunda hata

verilmesine yol açar.

productNote – Alfa numerik alandır. Kullanımı isteğe bağlıdır. En fazla 50

karakter uzunluğundadır.

Page 8: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

7

Web Servis Bilgileri

SendXMLNotificationInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

XMLText string Zorunlu max

Bildirimlerde oluşturulan XML

bilgisi string olarak

gönderilecektir.

SendXMLNotificationOutput

NotificationResultGlobal

Parametre Veri Tipi Açıklama

GLOBAL_ERROR_CODE string Hata Bildirim Kodu

GLOBAL_ERROR_MSG string Hata Bildirim Açıklaması

NotificationResultSerial

ID_TRANSACTION uniqueidentifier Bildirim Id

TRANSACTION_CODE string Cevap Bildirim Kodu

TRANSACTION_MESSAGE string Cevap Bildirim Mesajı

SERIAL_NUMBER string Seri Numarası

GTIN string GTIN Bilgisi

Page 9: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

8

LOT NUMBER string Lot Numarası

T.C Kimlik Numarası/Vergi Numarası ile sorgulama yapılarak sorgulanan işletmenin unvan

bilgisine ulaşılmaktadır.

GetCompanyNameInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

IdTaxNo string Zorunlu 11

T.C Kimlik Numarası/Vergi

Numarası

GetCompanyNameOutput

Parametre Veri Tipi Açıklama

COMPANY_NAME string İşletmenin Unvanı

GLN yada İzin Numarası ile sorgulama yapılarak sorgulanan işletmenin unvan bilgisine

ulaşılmaktadır.

GetCompanyNameByGLN_PNInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

Page 10: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

9

GLN_PN string Zorunlu 13

GLN(firma) veya İzin Numarası(bayi,toptancı)

GetCompanyNameOutput

Parametre Veri Tipi Açıklama

COMPANY_NAME string İşletmenin Unvanı

Bildirim yapılan Key bilgisinin geçerlilik durumuna ulaşılmaktadır.

KeyStatusCheckInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

Key uniqueidentifier Zorunlu 36 Key Bilgisi

KeyStatusCheckOutput

Parametre Veri Tipi Açıklama

KEY_STATUS int

1: GEÇERLİ 2:GEÇERSİZ

Page 11: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

10

Bitki Koruma Ürününün(BKÜ) adı bilgisine ulaşılmaktadır.

GetProductNameInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

GTIN string Zorunlu 14 Ürünün GTIN

Bilgisi

GetProductNameOutput

Parametre Veri Tipi Açıklama

PRODUCT_NAME string BKÜ Adı

Ülke listesine ulaşılmaktadır.

GetCountryNameOutput

Parametre Veri Tipi Açıklama

ID_COUNTRY uniqueidentifier Ülke ID

COUNTRY_NAME String Ülke Adı

GTIN, Seri numarası ve parti numarası bilgileri ile sorgulama yapılarak ürüne ait yapılan

bildirim listesine ulaşılabilmektedir.

GetHistoryInput

Page 12: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

11

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

GTIN string Zorunlu 14 GTIN Numarası

SerialNumber string Zorunlu 20 Seri Numarası

LotNumber string Zorunlu 20 Lot Numarası

GetHistoryOutput

Parametre Veri Tipi Açıklama

BARKOD string GTIN Numarası

SERIAL_NUMBER string Seri Numarası

LOT_NUMBER string Lot Numarası

KAREKOD string Karekod

CARRIER_LABEL1 string Palet SSCC Barkod Numarası

CARRIER_LABEL2 string Koli SSCC Barkod Numarası

PRODUCTTION_DATE string Üretim Tarihi

EXPIRATION_DATE string Son Kullanma Tarihi

DOCUMENT_NUMBER string Belge Numarası

DOCUMENT_DATE string Belge Tarihi

Page 13: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

12

SENDER string Gönderen Firma

RECEIVER string Alıcı İşletme

EXPORT_COMPANY_NAME string İhracat Yapılan Firma

EXPORT_COUNTRY_NAME string İhracat Yapılan Ülke

IMPORT_COMPANY_NAME string İthalat Yapılan Firma

IMPORT_COUNTRY_NAME string İthalat Yapılan Ülke

OPERATION_DATE string İşlem Tarihi

ACTION_TYPE string Bildirim Tipi

DEACTIVATION_CODE string Dekaktivasyon Sebebi

Kriterlere göre sorgulama yapılarak işletmeye yapılan bildirimlerin listesine ulaşılır.

TransactionListInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

GLN_PN string Zorunlu 13

Sorgulama yapan işletmenin GLN(firma)/PN(bayi,toptancı)

numarası

StartDate string Zorunlu İrsaliye Tarihi- Başlangıç

EndDate string Zorunlu İrsaliye Tarihi-Bitiş

DocumentNumber string Zorunlu Değil İrsaliye Numarası

Page 14: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

13

TransactionListOutput

Parametre Veri Tipi Açıklama

ID_TRANSACTION uniqueidentifier Bildirim Id

DOCUMENT_NUMBER string Belge Numarası

DOCUMENT_DATE string Belge Tarihi

SENDER string Gönderici Firma

RECEIVER string Alıcı İşletme

RETURN_NOTE string İade Sebebi

ACTION_TYPE string Bildirim Tipi

Seçilen bildirime ait ürün detayına ulaşılır.

TransactionDetailListInput

Parametre Veri Tipi Zorunluluk Açıklama

IdTransaction uniqueidentifier Zorunlu Bildirim Id

TransactionDetailListOutput

Parametre Veri Tipi Açıklama

Page 15: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

14

BARKOD string GTIN Numarası

SERIAL_NUMBER string Seri Numarası

LOT_NUMBER string Lot Numarası

KAREKOD string Karekod

CARRIER_LABEL1 string Palet SSCC Barkod Numarası

CARRIER_LABEL2 string Koli SSCC Barkod Numarası

PRODUCTTION_DATE string Üretim Tarihi

EXPIRATION_DATE string Son Kullanma Tarihi

Firma bilgisi ve paket bilgileri ile sorgulama yapılarak paketin içerisinde yer alan ürün

bilgilerine ulaşılmaktadır.

CarrierDetailListInput

Parametre Veri Tipi Zorunluluk Veri Uzunluğu Açıklama

Key uniqueidentifier Zorunlu Firmanın aktif key bilgisi

GLN_PN string Zorunlu 13 Sorgulama yapan işletmenin GLN(firma)/PN(bayi,toptancı)

numarası

CarrierType string Zorunlu 1 Paket Tipi P Palet ise P C Koli ise C

CarrierLabel string Zorunlu 66 Palet / Koli SSCC Barkod Numarası

CarrierDetailListOutput

Parametre Veri Tipi Açıklama

CARRIER_LABEL1 string Palet SSCC Barkod Numarası

CARRIER_LABEL2 string Koli SSCC Barkod Numarası

Page 16: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

15

GTIN string GTIN Numarası

LOT_NUMBER string Lot Numarası

PRODUCTTION_DATE string Üretim Tarihi

EXPIRATION_DATE string Son Kullanma Tarihi

PRODUCT_NOTE String Ürün Açıklaması

SERIAL_NUMBER string Seri Numarası

Firma bilgisi ve paket bilgileri ile sorgulama yapılarak paketin stokta bulunma durumuna

ulaşılır.

StockCheckInput

Parametre Veri Tipi Zorunluluk Veri

Uzunluğu Açıklama

Key uniqueidentifier Zorunlu Firmanın aktif key bilgisi

GLN_PN string Zorunlu 13 Sorgulama yapan işletmenin GLN(firma)/PN(bayi,toptancı)

numarası

CompanyType smallint Zorunlu

İşletme Tİpi 1: FİRMA 2: TOPTANCI 3: BAYİ

CarrierType string Zorunlu 1

Paket Tipi P Palet ise P C Koli ise C K Kutu ise K

CarrierLabel string Zorunlu 66 Palet ve Kolide SSCC Barkod Kutuda Karekod Numarası

StockCheckOutput

Parametre Veri Tipi Açıklama

Page 17: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

16

ResultCode int

1: Stokta Mevcut 2:Stokta Mevcut Değil

ÖRNEK XML-1 (Üretim Bildirimi) <?xml version="1.0" encoding="utf-16"?> <transfer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <sender>59857071771</ sender > <key>A21B054C-9300-4A46-8670-DFD72F5224B5</ key > <actionType>M</actionType> <documentNumber>S8314</documentNumber> <documentDate>2017-08-18</documentDate> <note>Üretim Bildirimi.</note> <carrier carrierLabel="00869000100000000001" containerType="P"> <carrier carrierLabel="00869000100000000002" containerType="C"> <productList GTIN="07360001000001" lotNumber="P0000001" productionDate="2017-08-18" expirationDate="2019-08-18" > <serialNumber>00000000000000000001</serialNumber> <serialNumber>00000000000000000002</serialNumber> <serialNumber>00000000000000000003</serialNumber> <serialNumber>00000000000000000004</serialNumber> <serialNumber>00000000000000000005</serialNumber> </productList> <productList GTIN="07360001000001" lotNumber="P0000001" productionDate="2017-08-18" expirationDate="2019-08-18" > <serialNumber>00000000000000000006</serialNumber> <serialNumber>00000000000000000007</serialNumber> <serialNumber>00000000000000000008</serialNumber> <serialNumber>00000000000000000009</serialNumber> <serialNumber>00000000000000000010</serialNumber> </productList> <productList GTIN="07360001000001" lotNumber="P0000001" productionDate="2017-08-18" expirationDate="2019-08-18" > <serialNumber>00000000000000000011</serialNumber> <serialNumber>00000000000000000012</serialNumber> <serialNumber>00000000000000000013</serialNumber> <serialNumber>00000000000000000014</serialNumber> <serialNumber>00000000000000000015</serialNumber> </productList> <productList GTIN="07360001000001" lotNumber="P0000001" productionDate="2017-08-18" expirationDate="2019-08-18" > <serialNumber>00000000000000000016</serialNumber> <serialNumber>00000000000000000017</serialNumber>

Page 18: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

17

<serialNumber>00000000000000000018</serialNumber> <serialNumber>00000000000000000019</serialNumber> </productList> </carrier> </carrier> </transfer>

ÖRNEK XML-2 (Üretici Firmadan Toptancıya Satış Bildirimi)

<?xml version="1.0" encoding="utf-16"?> <transfer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" > <sender>59857071771</sender> <receiver>5207227896</receiver> <key>A21B054C-9300-4A46-8670-DFD72F5224B5</ key > <actionType>S</actionType> <documentNumber>D475980</documentNumber> <documentDate>2017-06-14</documentDate> <note>Bayiye satış</note> <carrier carrierLabel="00486902090170116803" containerType="P" > <carrier carrierLabel="00186965400055863378" containerType="C" > <productList GTIN="08690000000001" lotNumber="9ML0002A" productionDate="2017-08-18" expirationDate="2019-02-28"> <serialNumber>10000000000001</serialNumber> <serialNumber>10000000000002</serialNumber> <serialNumber>10000000000003</serialNumber> <serialNumber>10000000000004</serialNumber> <serialNumber>10000000000005</serialNumber> <serialNumber>10000000000006</serialNumber> <serialNumber>10000000000007</serialNumber> </productList> </carrier> <carrier carrierLabel="00186995400055865089" containerType="C" > <productList GTIN="08690000000001" lotNumber="9ML0002A" productionDate="2017-08-18" expirationDate="2019-02-28"> <serialNumber>10000000000008</serialNumber> <serialNumber>10000000000009</serialNumber> <serialNumber>10000000000010</serialNumber> <serialNumber>10000000000011</serialNumber> <serialNumber>10000000000012</serialNumber> <serialNumber>10000000000013</serialNumber> <serialNumber>10000000000014</serialNumber> <serialNumber>10000000000015</serialNumber> <serialNumber>10000000000016</serialNumber> </productList> </carrier> </carrier>

Page 19: Bitki Koruma Ürünleri Takip Sistemi XML Standardı Kılavuzu ... · receiver: Mal alımı veya transferi yapılan kaynak paydaşın Depo İzin Numarası(bayi,toptancı) /GLN Numarası(firma)

T.C.

GIDA TARIM VE HAYVANCILIK BAKANLIĞI

GIDA VE KONTROL GENEL MÜDÜRLÜĞÜ

(Bitki Koruma Ürünleri Daire Başkanlığı)

18

<carrier carrierLabel="00486802090170116610" containerType="P" > <carrier carrierLabel="00186995400055862361" containerType="C" > <productList GTIN="08690000000001" lotNumber="9ML0002A" productionDate="2017-08-18" expirationDate="2019-02-28"> <serialNumber>10000000000017</serialNumber> <serialNumber>10000000000018</serialNumber> <serialNumber>10000000000019</serialNumber> <serialNumber>10000000000020</serialNumber> <serialNumber>10000000000021</serialNumber> <serialNumber>10000000000022</serialNumber> <serialNumber>10000000000023</serialNumber> <serialNumber>10000000000024</serialNumber> </productList> </carrier> <carrier carrierLabel="00186995400055865355" containerType="C" > <productList GTIN="08690000000001" lotNumber="9ML0002A" productionDate="2017-08-18" expirationDate="2019-02-28"> <serialNumber>10000000000025</serialNumber> <serialNumber>10000000000026</serialNumber> <serialNumber>10000000000027</serialNumber> <serialNumber>10000000000028</serialNumber> <serialNumber>10000000000029</serialNumber> <serialNumber>10000000000030</serialNumber> </productList> </carrier> <carrier carrierLabel="00186995400055862422" containerType="C" > <productList GTIN="08690000000001" lotNumber="9ML0002A" productionDate="2017-08-18" expirationDate="2019-02-28"> <serialNumber>10000000000031</serialNumber> <serialNumber>10000000000032</serialNumber> <serialNumber>10000000000033</serialNumber> <serialNumber>10000000000034</serialNumber> <serialNumber>10000000000035</serialNumber> <serialNumber>10000000000036</serialNumber> <serialNumber>10000000000037</serialNumber> </productList> </carrier> </carrier> </transfer>