Tytuły | Dokumentacja API

W dokumencie XML mogą pojawić się 3 typy tytułu: pełen tytuł produktu, tytuł w języku oryginału (jeśli jest tłumaczeniem) oraz roboczy tytuł nadany przez wydawcę.

Przykład

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
    </Sender>
    <SentDateTime>20210621</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa
          ZJ - puzzle
          ZB - figurka
          ZC - zabawka - pluszak
          ZD - zabawka (również edukacyjna)
          PODH - POD - okładka twarda
          PODS - POD - okładka miękka
          OPEN_ACCESS - e-book open access -->
      <ProductForm>BA</ProductForm>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText language="pol">Światu nie mamy czego zazdrościć.</TitleText>
          <Subtitle language="pol">Zwyczajne losy mieszkańców Korei Północnej.</Subtitle>
        </TitleElement>
      </TitleDetail>
      <TitleDetail>
        <!-- $onix_titles$ Tytuł w języku oryginału - 03 -->
        <TitleType>03</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Nothing to Envy: Ordinary Lives in North Korea</TitleText>
        </TitleElement>
      </TitleDetail>
      <TitleDetail>
        <!-- $onix_titles$ Tytuł handlowy używany przez wydawnictwo - 10 -->
        <TitleType>10</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>ŚWIATU NIE MAMY CZEGO ZAZDROŚCIĆ.</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <ProductSupply>
      <SupplyDetail>
        <Supplier>
          <!-- Rola dostawcy
            01 - sprzedaż wydawnictwa do detalu
            02 - wyłączny dystrybutor wydawnictwa
            03 - dystrybutor wydawnictwa bez prawa wyłączności
            04 - hurtownia książek
            11 - Dystrybutor do klientów końcowych -->
          <SupplierRole>01</SupplierRole>
          <SupplierIdentifier>
            <!-- Zawsze 02 - Proprietary. Identyfikujemy dostawcę po NIP -->
            <SupplierIDType>23</SupplierIDType>
            <IDValue>PL6782821670</IDValue>
          </SupplierIdentifier>
          <SupplierName>GREG</SupplierName>
        </Supplier>
        <!-- Typ dostępności
          20 - dostępny
          21 - na stanie
          40 - niedostępne
          99 - skontaktuj się z dostawcą -->
        <ProductAvailability>99</ProductAvailability>
        <Price>
          <!-- Typ ceny
            02 - sugerowana cena detaliczna brutto
            01 - sugerowana cena detaliczna netto -->
          <PriceType>02</PriceType>
          <PriceAmount>12.99</PriceAmount>
          <Tax>
            <!-- VAT -->
            <TaxType>01</TaxType>
            <TaxRatePercent>5</TaxRatePercent>
          </Tax>
          <CurrencyCode>PLN</CurrencyCode>
        </Price>
      </SupplyDetail>
    </ProductSupply>
    <!-- Cena na okładce -->
    <elibri:CoverPrice>12.99</elibri:CoverPrice>
    <!-- Vat w procentach -->
    <elibri:Vat>5</elibri:Vat>
    <elibri:preview_exists>false</elibri:preview_exists>
  </Product>
</ONIXMessage>

Tytuł może być też kaskadowy. Dobrym przykładem jest na przykład Thorgal, komiks, który ma wiele tomów, każdy tom ma swój numer, jak i tytuł. W kategoriach ONIX-a Thorgal jest kolekcją. Od serii odróżnia go to, że jest częścią tytułu. Innym dobrym przykładem jest książka "Gra o Tron", która należy do kolekcji "Pieśń Lodu i Ognia" - ponieważ jest to częścią tytułu.

Przykład

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
    </Sender>
    <SentDateTime>20210621</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa
          ZJ - puzzle
          ZB - figurka
          ZC - zabawka - pluszak
          ZD - zabawka (również edukacyjna)
          PODH - POD - okładka twarda
          PODS - POD - okładka miękka
          OPEN_ACCESS - e-book open access -->
      <ProductForm>BA</ProductForm>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie kolekcji - 02 -->
          <TitleElementLevel>02</TitleElementLevel>
          <PartNumber>33</PartNumber>
          <TitleText language="pol">Thorgal</TitleText>
        </TitleElement>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText language="pol">Statek-Miecz</TitleText>
        </TitleElement>
      </TitleDetail>
      <TitleDetail>
        <!-- $onix_titles$ Tytuł w języku oryginału - 03 -->
        <TitleType>03</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Thorgal: Le Bateau-Sabre</TitleText>
        </TitleElement>
      </TitleDetail>
      <TitleDetail>
        <!-- $onix_titles$ Tytuł handlowy używany przez wydawnictwo - 10 -->
        <TitleType>10</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>THORGAL 33 STATEK-MIECZ TWARDA</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <ProductSupply>
      <SupplyDetail>
        <Supplier>
          <!-- Rola dostawcy
            01 - sprzedaż wydawnictwa do detalu
            02 - wyłączny dystrybutor wydawnictwa
            03 - dystrybutor wydawnictwa bez prawa wyłączności
            04 - hurtownia książek
            11 - Dystrybutor do klientów końcowych -->
          <SupplierRole>01</SupplierRole>
          <SupplierIdentifier>
            <!-- Zawsze 02 - Proprietary. Identyfikujemy dostawcę po NIP -->
            <SupplierIDType>23</SupplierIDType>
            <IDValue>PL6782821670</IDValue>
          </SupplierIdentifier>
          <SupplierName>GREG</SupplierName>
        </Supplier>
        <!-- Typ dostępności
          20 - dostępny
          21 - na stanie
          40 - niedostępne
          99 - skontaktuj się z dostawcą -->
        <ProductAvailability>99</ProductAvailability>
        <Price>
          <!-- Typ ceny
            02 - sugerowana cena detaliczna brutto
            01 - sugerowana cena detaliczna netto -->
          <PriceType>02</PriceType>
          <PriceAmount>12.99</PriceAmount>
          <Tax>
            <!-- VAT -->
            <TaxType>01</TaxType>
            <TaxRatePercent>5</TaxRatePercent>
          </Tax>
          <CurrencyCode>PLN</CurrencyCode>
        </Price>
      </SupplyDetail>
    </ProductSupply>
    <!-- Cena na okładce -->
    <elibri:CoverPrice>12.99</elibri:CoverPrice>
    <!-- Vat w procentach -->
    <elibri:Vat>5</elibri:Vat>
    <elibri:preview_exists>false</elibri:preview_exists>
  </Product>
</ONIXMessage>

Elibri

Dystrybucja informacji o książkach

API systemu Elibri

ONIX

Podglądy

Wydrukuj dokumentację

kontakt