Merge pull request #40 from trafiklab/TLAB-448_add_page_for_sales_api

Tlab 448 add page for sales api

content/api/netex-datasets/overview.md

@@ -7,11 +7,11 @@ sidebar: true
 
 ## NeTEx at Trafiklab
 
-At Trafiklab, we offer three different NeTEx datasets. NeTEx regional and NeTEx Sweden offer the same coverage as
+At Trafiklab, we offer four different NeTEx datasets. NeTEx regional and NeTEx Sweden offer the same coverage as
 GTFS regional and GTFS Sweden, which is not full coverage. If you are looking for 100% coverage we recommend
 GTFS Sverige 2, which is much less detailed but does contain all the public transport data of Sweden.
 
-Our three datasets:
+Our four datasets:
 
 [**NeTEx Regional**](/api/netex-datasets/netex-regional/) which consists of multiple NeTEx feeds, each feed containing data
   for a specific region or operator. This data contains all details present in GTFS Regional, as well as additional data
@@ -26,6 +26,11 @@ Our three datasets:
   and [Netex Regional](/api/netex-datasets/netex-regional/) APIs. This dataset contains all of
   Sweden's stops in the NeTEx format.
 
+[**Samtrafiken sales data**](/api/netex-datasets/samtrafiken-sales-data/) which is a filtered dataset containing sellable data. This
+API contains data intended for those selling public transport tickets through the Samtrafiken Access platform.
+Note that the Samtrafiken Sales data API only contains traffic data, to actually sell tickets you need to use the
+Samtrafiken Access platform.
+
 You can see the general difference between GTFS Regional and NeTEx Regional data below.
 <div class="wide">
 

content/api/netex-datasets/samtrafiken-sales-data.md

@@ -0,0 +1,107 @@
+---
+title: Samtrafiken Sales data
+layout: "single"
+weight: 40
+date: 2025-01-16
+aliases:
+  - /api/trafiklab-apis/samtrafiken-sales-data/
+---
+
+Samtrafiken Sales data is a NeTEx feed with sellable data.
+This API differ from the NeTEx Sweden API, the main difference is that only data for trips sellable through Samtrafiken access is included. 
+More details about additional, removed or changed fields can be found through the following url:
+[Samtrafiken sales export](https://samtrafiken.atlassian.net/wiki/spaces/SamA/pages/3448668185/NeTEx+format+adjustments+-+Samtrafiken+sales+export)
+
+## What does this dataset contain?
+
+This API contains data intended for those selling public transport tickets through the Samtrafiken Access platform. 
+It contains only traffic present in the Samtrafiken Access platform, including additional attributes which may be of interest for ticket resellers. 
+Note that the Samtrafiken Sales data API only contains traffic data, to actually sell tickets you need to use the Samtrafiken Access platform.
+
+Are you looking for an unfiltered dataset including quays and platforms we recommend the [NeTEx Sweden](https://trafiklab.se/api/netex-datasets/netex-sweden/) or [NeTEx Regional](https://trafiklab.se/api/netex-datasets/netex-regional/) API.
+
+
+### Data format
+
+The data is in the NeTEx (**Ne**twork and **T**imetable **Ex**change) format. This is a format in which all European
+operators have to publish their data. The data is aimed at both operator-to-traveller communication and internal
+communication between different organizations.
+
+### Updates
+
+There will be new datasets available daily, usually between 22.00 and 00.00.
+
+## Latest dataset
+
+{{% note %}}
+**Where to download**
+
+You can access the latest dataset through the following URL:
+[https://opendata.samtrafiken.se/netex-access/samtrafikensales_latest.zip?key={apikey}]()
+
+Replace `{apikey}` with your own API key. If you don´t have a key yet, read [here](/docs/using-trafiklab/getting-api-keys) on how to get one.
+{{% /note %}}
+
+## Historical data
+
+{{% note %}}
+**Where to download**
+You can also access historical data for specific dates by following this URL:
+[https://opendata.samtrafiken.se/netex-access/samtrafikensales_{date}.zip?key={apikey}]()
+
+Replace `{date}` with a specified date in the format YYYYMMDD.
+
+Replace `{apikey}` with your own API key. If you don´t have a key yet, read [here](/docs/using-trafiklab/getting-api-keys) on how to get one.
+
+The earliest available historical data is from 2025-01-01.
+{{% /note %}}
+
+<div style="max-width: 270px">
+
+#### API key levels
+
+| Level  | Maximum calls per minute | Maximum calls per month |
+|:-------|:------------------------:|:-----------------------:|
+| Bronze |            10            |           50            |
+| Silver |            10            |           180           |
+
+</div>
+
+For more information about Samtrafiken NeTEx exports, see [Samtrafiken NeTEx export](https://samtrafiken.atlassian.net/wiki/spaces/SamtrafikenOpenData/pages/989233182/Samtrafiken+NeTEx+export)
+
+## Extra files
+
+Additional files detecting changes are included in the dataset. 
+
+#### changes.csv
+This file contains a list of the changed carriers/producers compared to the previously published NeTEx dataset.
+
+#### changeslines.csv 
+This file contains a list of the changed lines compared the previously published NeTEx dataset, so it gives a more detailed view of the changes than the changes.csv file that only shows changes on the producer level.
+
+If you want to make use of the information in the changes files, it is necessary to read the datasets every day. 
+
+## Licence
+
+Data from the Samtrafiken Sales data API is available under the CC0 1.0 Universal (CC0 1.0) Public Domain Dedication license.
+
+#### Summary
+
+The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her
+rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by
+law.
+
+#### Other Information
+
+In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may
+have in the work or in how the work is used, such as publicity or privacy rights.
+
+Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work,
+and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law.
+
+When using or citing the work, you should not imply endorsement by the author or the affirmer.
+
+{{% info %}}
+More information, as well as the complete license text, can be found at
+[the creative commons website](https://creativecommons.org/publicdomain/zero/1.0/deed.en).
+{{% /info %}}