BusinessCom API Beschrijving voor product en prijs informatie
Via onze eigen API beiden wij u de mogelijkheid om verschillende data over ons assortiment geautomatiseerd op te halen. In dit artikel wordt beschreven hoe dit is opgebouwd. De data via die u via de API ophaalt is gelijk aan de data die u in de BusinessCom webshop ziet.
Bent u geïnteresseerd maar heeft u geen toegang? In het volgende artikel staan de mogelijkheden met de daarbij behorende prijzen https://support.televersal.com/entries/40631706. Voor vragen kunt u uiteraard contact opnemen met uw partnermanager of via roy.bramer@businesscom.nl
Niet geschikt voor de Edge Browser!
De api is opgedeeld in 2 onderdelen:
ICC format indien u gebruik maakt van het 2ba
Voor toegang wordt er gebruik gemaakt van basic http authenticatie. De inloggegevens zijn toegekend aan een persoon of personen binnen uw organisatie en zijn gelijk aan de account gegevens voor de shop.
8714252013214 7777 20160222 57521.1 Televersal
GS110TP-200EUS 8 Port Gigabit Ethernet PoE Smart Switch 1072320151013
Bestand opslaan om handmatig te importeren in uw ERP systeem? Klik dan op de witte ruimte met de rechtermuisknop. Er komt vervolgens een venster waarin staat dat je het bestand kan opslaan zoals te zien is in onderstaand screenshot (gebruikte browser = chrome).
Ter info: De bijbehorende artikeldata wordt door ons iedere nacht op de 2ba servers bijgewerkt en u kunt het ICC bestand maximaal 50x per dag bij ons ophalen.
BusinessCom API in JSON, XML of csv
Voor toegang wordt er gebruik gemaakt van basic http authenticatie. De inloggegevens zijn toegekend aan een persoon of personen binnen uw organisatie en zijn gelijk aan de account gegevens voor de shop.
1. https://www.businesscom.nl/api/v1/products
{
"product_id": "GS110TP-200EUS",
"manufacturer_id": "GS110TP-200EUS",
"brand_id": 21,
"brand": "Netgear",
"brand_logo": "logo_netgear.gif",
"name": "8 Port Gigabit Ethernet PoE Smart Switch",
"description_html": "<h2>Small, Yet Powerful Gigabit Smart Switch Packed with Advanced Features</h2><p>Joining the <span class=\"caps\">NETGEAR</span> ProSAFE® family of Smart Managed Switches with high performance and cost e ciency, this 10-port Gigabit Smart Managed Switch is packed with powerful L2 features capable of enhancing any type of business network. The GS110TP is designed for customers who need a low port density solution with the combination of Gigabit speed and PoE capability. The GS110TP comes with 8 dedicated 10/100/1000 Mbps copper ports to connect to your end devices and two additional Gigabit Fiber ports for uplinks with greater distance. With PoE capability on all 8 copper ports, the GS110TP can automatically detect PoE on the end devices ………………………… ",
"retail_price": 170.21,
"stock_status_code": 2,
"lead_time": 6,
"category_id": 20,
"category_name": "Routers en Switches",
"sub_category_id": 2013,
"sub_category_name": "Switches Smart",
"tags": "",
"remarks": "",
"image_id": 10748,
"my_shop_jn": "J",
"last_image_update": 20151201
"ean_code": "000123456789"
}
{
"product_id": "GS110TP-200EUS",
"related_product_id": "PMB0311-10000S"
},
{
"product_id": "GS110TP-200EUS",
"related_product_id": "PMB0331-10000S"
},
{
"product_id": "GS110TP-200EUS",
"related_product_id": "PMB0351-10000S"
}
{
"product_id": "GS110TP-200EUS",
"price": 107.23
}
Dit is uw inkoopsprijs
{
"product_id": "GS110TP-200EUS",
"stock_status_code": 2,
}
Exacte aantallen:
Stuurt u bij de stock ook een accept header mee dan krijgt u uitgebreidere informatie. U krijgt dan namelijk ook de exacte voorraad en de lead time van een artikel (deze is ook beschikbaar bij “products”). Een accept header dient er als volgt uit te zien:
application/vnd.businesscom.stock.v20160215+json
{
"product_id": "GS110TP-200EUS",
"stock_status_code": 2,
"stock_quantity": 21,
"lead_time": 6
}
De stock quantity kan ook de waarde “null” bevatten indien het bijvoorbeeld licenties betreft. De status code zal dan -1 zijn. Daarnaast worden artikelen met een stock voorraad van meer dan 100 stuks weergegeven als "stock_quantity": 100.
De toevoeging v20160215 is de aanduiding voor de versie van de API die gebruikt wordt en dient gelijk te blijven.
Per artikel de voorraad opvragen?
Wilt u per artikel de voorraad opvragen dan kan dat ook. Dit doet u eenvoudig door de artikelcode toe te voegen
https://www.businesscom.nl/api/v1/stock/GS110TP-200EUS
{
"product_id": "GS110TP-200EUS",
"stock_status_code": 2,
"stock_quantity": 20,
"lead_time": 6
}
Wat betekend de voorraad code (stock status code):
-1 = n.v.t. (voor bijvoorbeeld software licenties; deze zijn digitaal en worden gemaild, dus voorraad is niet van toepassing)
0 = geen voorraad (vaak in shops in het rood aangeduid)
1 = beperkte voorraad (vaak in het oranje)
2 = voldoende voorraad (groen)
Lead time :
De lead time is het aantal werkdagen na levertijd aan u, of uw klant. Deze leadtime wordt door ons automatisch bepaald aan de hand van leveringen uit het verleden. Tevens wordt er rekening gehouden met 1 dag voor verzending van het artikel vanuit ons magazijn naar u of uw klant.
Indien de leadtime -1 is dan is deze niet van toepassing, bijvoorbeeld voor artikelen die niet meer te verkrijgen zijn of licenties.
Welk formaat?
Standaard krijgt u de data in json formaat. Het formaat wijzigen kan door een extensie toe te voegen aan de URLs, zoals ".xml" of ".csv" of door een ACCEPT header mee te sturen met als waarde "application/xml" of "text/csv".
Wat is de URL van de afbeeldingen?
https://www.businesscom.nl/shop-product-images/image_id.jpg
Het "image_id" (nummer) van de afbeelding vindt u in de API call https://www.businesscom.nl/api/v1/products
Autorisatie?
Voor toegang wordt er gebruik gemaakt van basic http authenticatie. De inloggegevens zijn toegekend aan een persoon of personen binnen uw organisatie en zijn gelijk aan de account gegevens voor de shop.
Hoe vaak kan ik de data opvragen?
- products, 50 keer per dag
- product relations, 50 keer per dag
- prices, 50 keer per dag
- stock, 10 keer per uur
- stock per artikel, geen limiet
Wat betekend "my_shop_jn"
Wij hebben diverse producten en diensten speciaal voor u als reseller. Denk hierbij aan een demo koffer of een jump start. Deze producten hebben het kenmerk "my_shop_jn":"N". De "N" van Nee geeft aan dat het artikel betreft dat speciaal voor u is. U kunt het importeren in uw ERP omgeving maar het is niet geschikt voor gebruik op bijvoorbeeld een webwinkel voor eindklanten.
Wat betekenen de productlabels bij het product?
De volgende productlabels komen voor:
Als je op de link klikt worden de artikelen met de gekozen status weergeven in de shop.
Wat zijn de opmaakconventies in de memo tekst (textstyle).
Opmaaktekst |
Resultaat |
*vette tekst* |
vette tekst |
_schuine tekst_ (italics) |
schuine tekst (italics) |
"gelinkte tekst":http://www.televersal.com/ |
|
plaatje: !http://www.televersal.com/site/assets/img/icon_news.gif! |
plaatje: |
gelinkt plaatje: !http://.../icon_news.gif!:http://www.televersal.com |
|
h1. Titel 1 |
Titel 1 |
h2. Titel 2 |
Titel 2 |
h3. Titel 3 |
Titel 3 |
p>. Paragraaf rechts uitlijnen |
Paragraaf rechts uitlijnen |
(gebruik > om rechts uit te lijnen, < om links uit te lijnen en = om te centeren) |
(gebruik > om rechts uit te lijnen, < om links uit te lijnen en = om te centeren) |
Plaatje rechts uitlijnen |
|
Lijst: |
Lijst: |
* item 1 |
* item 1 |
* item 2 |
* item 2 |
** item 2.1 |
* item 2.1 |
** item 2.2 |
* item 2.2 |
* item 3 |
* item 3 |
|
|
Genummerde lijst: |
Genummerde lijst: |
# item 1 |
1. item 1 |
# item 2 |
2. item 2 |
# item 3 |
3. item 3 |
Het voorbeeld artikel ziet er in de BusinessCom shop als volgt uit:
Opmerkingen
6 opmerkingen
Onze API is uitgebreid met:
1. Mogelijkheid tot het opvragen van de exacte voorraad aantallen
2. Opvragen van de voorraad per artikel
De beschrijving is uitgebreid met de productlabels die voor kunnen komen bij een artikel. Wij kennen de volgende labels:
ENKEL_DEMO_UNIT
Wij hebben van dit product alleen nog producten voorradig die kort voor demonstratie doeleinden zijn gebruikt.
EOL
Product is End of Life
NEW
Het product is gedurende de laatste 2 weken aan onze catalogus toegevoegd
OOK_DEMO_UNIT
Van dit product hebben wij ook producten voorradig die kort voor demonstratie doeleinden zijn gebruikt
PROMO
Op dit product is een promotie van toepassing
REF Refurbished
het betreft een artikel dat gebruikt is maar gereviseerd.
STOCKPROMO
Op de huidige voorraad is een promotie van toepassing
VOLUME
Op dit artikel is een volume korting beschikbaar. De prijs die getoond wordt is de prijs van een enkel exemplaar
2ba gebruiker? Per heden wordt de artikeldata behorende bij het ICC bestand door ons iedere nacht op de 2ba servers bijgewerkt.
Bij de call voor de products is de EAN code toegevoegd (Indien beschikbaar).
Het aantal keer dat de voorraad opgevraagd kan worden is verhoogd van 3 naar 10 keer per uur en de producten kunnen vanaf nu 50 keer per dag worden opgevraagd.
URL's aangepast van HTTP naar het versleutelde protocol HTTPS. HTTP zal over enkele weken niet meer mogelijk zijn.
U moet u aanmelden om een opmerking te plaatsen.