Home :: Spesifikasi

Catalog

Dokumen ini menjelaskan format XML standar untuk katalog produk Voucha.

Catalog terdiri dari satu file XML dengan encoding UTF-8 dan terdiri dari tag-tag XML. Aturan yang berlaku:

  1. Catalog harus berisi satu tag <products> dan ditutup oleh tag </products>
  2. Tag <products> harus mencantumkan namespace berisi XML schema yang digunakan.
  3. Tiap item produk dimasukkan dalam tag <product> sebagai tag induk
  4. Mencantumkan tag <id>, <group>, <description>, <price>, <network>, <available> di bawah tag <product>
  5. Selain tag di atas bersifat opsional.

Contoh XML Catalog

<?xml version="1.0" encoding="UTF-8"?>
<products
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  generated="2001-12-17T09:30:47.0Z"
  urlTopup="http://server.voucha.org:9000/topup"
  xsi:noNamespaceSchemaLocation="http://voucha.org/schemas/catalog/0.1/catalog.xsd">
  <product>
    <id>S20</id>
    <group>SIMPATI</group>
    <description>SIMPATI 20000</description>
    <price>20500</price>
    <available>true</available>
    <network>TELKOMSEL</network>
    <lastUpdate>2007-12-17T09:30:47.7Z</lastUpdate>
    <url>http://pulsa.web.id/product/simpati</url>
  </product>
</products>

Keterangan

Berikut penjelasan dari tag-tag yang digunakan.

Atribut   Keterangan
<products> required Elemen induk dan menjelaskan standar yang digunakan
<generated> optional Atribut untuk tag <products >, menjelaskan tanggal dan waktu file digenerate.
<urlTopup> optional Atribut untuk tag <products >, menjelaskan url untuk melakukan topup.
<product> required Tag induk untuk masing-masing produk. Elemen berikutnya adalah tag anak dari tag ini.
<id> required Kode produk atau ID produk. Nilai bertipe string dan memiliki panjang maksimum 15 karakter.
<group> required Kelompok produk. Nilai bertipe string dengan panjang maksimum 15 karakter.
<description> required Keterangan atau nama produk. Nilai bertipe string dengan panjang maksimum 50 karakter.
<price> required Harga jual produk. Nilai bertipe float/real.
<network> required Network provider atau operator GSM/CDMA. Nilai bertipe string dengan panjang maksimum 20 karakter.
<lastUpdate> required Tanggal/waktu diupdate/diubah. Nilai bertipe dateTime.
<url> optional URL ke halaman web yang berisi informasi produk. Nilai bertipe string dengan panjan maksimum 64 karakter.