Software

API & CSV - effective business tools

High-speed data exchange

Visualization of two people cooperating with each other.

API - instant data exchange

The API is a 'plug-in' to our system that allows for instant data exchange between the customer's system and Inter Cars. It is a set of services that allows you to automate your work and update your data continuously.

A person working on a laptop with an icon in the background representing an API service.

Why should you use an API?

Immediate availability of data
The customer can immediately check the current product price and stock availability at a given location, without having to wait for manual updates or search multiple sources of information.
Convenient ordering
The customer can place an order directly at a time that is convenient for them, eliminating the delays associated with contacting customer service or processing an order in the traditional way.
Secure access to financial information
With a properly secured solution, customers can access their financial information in a secure and private manner.
Fast retrieval of detailed data
The API allows the customer to quickly retrieve detailed invoice data, making it easier to track purchase history and manage finances
Tracking deliveries
Using the API, the customer can check the status of deliveries within a specific time frame and obtain detailed information about deliveries, which allows for effective planning and management of deliveries.
New feature - provisional data download from CSV
Using the API, the customer can check the status of deliveries from a specific time period and obtain detailed information about...

Up to date and detailed documentation

Detailed description of Inter Cars API functionalities

Technical documentation Business documentation

CSV files - ease of writing and reading data

CSV files are the channel through which we pass data about our products to the companies we work with. They are tabular summaries of data containing information on stock levels at individual warehouses, prices including individual discounts and detailed descriptions of all products on offer. Because they are easy to write and read, they are a commonly used method of data transfer and collection.

The files are configured for the customer on a case-by-case basis, depending on their needs.

We can limit them to products of interest to the customer, for example:

by market: e.g. truck market
by segment: e.g. passenger segment
by category tree in the Inter Cars e-catalogue: e.g. industrial and agricultural tyres only (2411)

The files containing product and price information are generated daily and the stock file can be updated more frequently.

The customer downloads the files from https://data.webapi.intercars.eu/customer after receiving the access password. On request, the files can be uploaded to customer’s server.

Visualization of ease of writing and reading data

CSV file structure

By default, the customer receives three files which include

ProductInformation - product information (towkod, index, TecDoc identifier, manufacturer name, product description, EAN - barcodes and size data)
WholesalePricing - net price information
Stock – information on the quantity of products available per stock

Two people with the icon of envelope and a letter in the background

Client activation - How to start working with API and CSV?

Remember to ask the Customer what software they use in their company.
Integration with the Client's software is required to use the features of the Inter Cars API.

Software Already Integrated with Inter Cars API

If the Client uses software that is already integrated with the Inter Cars API, activation is quick and simple. The software provider has already completed all necessary work. You only need to submit a request via the Help Center platform to activate access.

A person with an icon in the background representing an API and CSV.

Custom Software or no Integration

If the Client uses custom software, their team will need to develop the integration themselves.
If the Client uses market software that is not integrated with the API, it’s up to the software provider to decide whether to proceed with integration. This may take more time or involve extra costs.

Two people struggling with adding integration to their software

A person working on a mobile device with API and CSV icons in the background

FAQ - Frequently Asked Questions

How do I complete the new customer api activation form in the help centre?

In the application, enter the number and name of the customer in SAFO, its branch, the e-mail address to which we will send the credentials.

In the field 'Programme the customer uses' select the company the customer works with. If it is not listed - select 'Other' and enter its name in the description.

In the 'Scope' field, select:

„CSV” – if you want to provide CSV files to the customer,
„IC API PROD (production base)” – if you want to make the API available to the customer,
„IC API SANDBOX (baza testowa)” - if you want to make the API test base available to the customer,
„IC API and CSV” – if you want to provide the API and CSV files to the customer,

What is the format of the data provided by the IC API?

The IC API is an interface that allows communication over HTTP and the data received by the IC API is in JSON format. This means that the customer does not 'download' the data in .xml format or any other readable format in an .xls or .xlsx (MS Excel).

Can a customer download an invoice via the API?

The customer will not download the invoice as a tax document (e.g. PDF). The API allows them to see details of what is on a particular invoice, i.e.: order date, products, amount, etc.

Is there a fee for using the API?

The use of the API is free, but the customer will have to bear the cost of the implementation, i.e. the IT service, unless they have their own programming background or are able to integrate their system with our API themselves.  If the customer uses one of the software providers listed below, no new programming work is required to connect it, as Inter Cars already has a working integration with these companies:
- asco 
- integra 
- motowarsztat 
- nextis 
- falcon cairo 
- warsztat24 
- motoFirma

Why do customers have a query limit and can it be increased?

The API query limit is in place to ensure the stability and security of the service and to protect against abuse and attacks. By default, the API query limit is 600 queries per minute for each customer.

A customer cannot place an order via the API, he receives error 400, why?

The most common reason why a customer cannot place an order and receives error 400 is overdue payments. We recommend that you check the customer's financial status before reporting a technical problem.

If a customer does not have any overdue payments and receives an error in response, they should send an email to [email protected] describing the problem. The request will be forwarded to our support department and will be resolved as soon as possible.

Why does a customer only see 10 items of a particular product when they see more in ICKO/E-Catalogue?

Currently in the API the status display for a given product is limited to 10 items. This means that if there are 10 or more items in stock, the API will return a value of 10 items when asked for the quantity available for an order. Upon request, the maximum number of items that will display the status of a product in its logistics path can be increased.

Client activation - Ready to cooperation?

To activate a Client, submit a request using the Help Center platform. We’ve created an easy-to-use form to help you quickly register a new Client.

If you need help, check the FAQ section above for instructions on filling out the form.