Infoproff API-dokumentaatio - v3


Aloittaminen


Verkkopalvelun wsdl ja kaaviot sijaitsevat täällä.:

http://wsdfn.infoproff.com/v3/

Web service functions:

  • SimpleSearch - Etsi yritysten tietoja eri maista.
  • ChkFinance - Etsi saatavilla olevia tilinpäätöksiä.
  • Order - Luo order_id ja palauttaa kaksoiskappaleet. Kaksoiskappaleet valitaan seuraavien parametrien mukaan: country, product, reg_code.
  • OrderCancellation - Jos olet lähettänyt tilauspyynnön ja saanut order_id, sinulla on mahdollisuus peruuttaa tilaus (jos se ei ole mennyt tuotantoon).
  • OrderConfirmation - Kun olet saanut order_id, sinun on vahvistettava tilauksesi 1 tunnin kuluessa. Jos et vahvista tilausta 1 tunnin kuluessa, tilaus peruutetaan automaattisesti.
  • ChkStatus - Tarkista tilauksen tila.
  • GetReport - Hanki valmiit raportit.

  • GetClassifiersFinancialStatements - Hae kaikki rahoitusasiakirjat, joissa on kaikki elementit: row_number, row_formated_description, row_langing_key ja row_order.
  • GetLegalForms - Hanki kaikki oikeudelliset lomakkeet kaikista saatavilla olevista maista.
  • GetActivityClassificators - Hae kaikki tietyn toiminnan luokittelijan koodit ja kuvaukset.
  • GetDictionaryStandardPhrases - Saat kaikki vakiolausekkeet avaimilla ja kielellä.
  • GetAvailableProducts - Saat luettelon saatavilla olevista tuotteista.

  • CreditOpinionCalculator - Credit Opinion Calculator auttaa antamaan yritykselle luottoluokituksen.

API tarjoaa useita palveluja:

  1. Online-luottoraportit seuraavista maista: Suomen tasavalta (FIN), Ruotsin kuningaskunta (SWE), Belgian kuningaskunta (BEL), Alankomaiden kuningaskunta (NLD), Viron tasavalta (EST)
  2. Offline-raportit seuraavista maista: Kaikki maat
  3. Luottolausuntolaskuri

Miten etsiä yritystä?


Yrityshaku koostuu 2 vaihtoehdosta:

  1. Haku yrityksen nimen mukaan,
  2. Search by company code.
Luettelo käytettävissä olevista maista: Alankomaiden kuningaskunta (NLD), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Espanjan kuningaskunta (ESP), Georgia (GEO), Grönlanti (GRL), Irlanti (IRL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Kazakstanin tasavalta (KAZ), Kiinan kansantasavalta (CHN), Kirgisian tasavalta (KGZ), Kyproksen tasavalta (CYP), Moldovan tasavalta (MDA), Mongolia (MNG), Norjan kuningaskunta (NOR), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan tasavalta (FRA), Ruotsin kuningaskunta (SWE), Saksan liittotasavalta (DEU), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tanskan kuningaskunta (DNK), Uzbekistanin tasavalta (UZB), Valko-Venäjän tasavalta (BLR), Viron tasavalta (EST)
Tärkeää tietoa:

search_result_id can be acquired here for orders with delivery_term = "o".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

Norjan rekisteristä ei voi hakea poistettuja yrityksiä nimien perusteella. Näin ollen emme voi tarjota SimpleSearch -palvelua nimien perusteella Norjassa poistettujen yritysten sisällä.

Field's length:
company_name varchar(512)
company_code varchar(64)

Alla on esimerkki:


Toiminto SimpleSearch

Vaihtoehto 2: Haku rekisteröintikoodin perusteella

Toiminto SimpleSearch

Miten tilata luottotietoraportti?


List of available countries for online credit reports: Alankomaiden kuningaskunta (NLD), Belgian kuningaskunta (BEL), Kazakstanin tasavalta (KAZ), Kirgisian tasavalta (KGZ), Puolan tasavalta (POL), Ruotsin kuningaskunta (SWE), Suomen tasavalta (FIN), Viron tasavalta (EST)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

Toiminto SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Miten etsiä yritystä?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

Toiminto Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

Toiminto OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

Toiminto OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

Toiminto ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

Jos suoritustila on Finished tai Updated, voit saada toimeksiannon.

STEP 6: Get report (Online/Offline Order (with search_result_id))

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sv (Ruotsalainen), tr (Turkkilainen), uk (Ukrainan), zh (Kiinalainen)

STEP 1: Order a report (Offline Order (without search_result_id))

Toiminto Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

Toiminto OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

Toiminto OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

Toiminto ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

Jos suoritustila on Finished tai Updated, voit saada toimeksiannon.

STEP 5: Get report (Offline Order (without search_result_id))

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sv (Ruotsalainen), tr (Turkkilainen), uk (Ukrainan), zh (Kiinalainen)

Miten tilata tilinpäätöstiedot verkossa?


STEP 1: Find a company

Toiminto SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Miten etsiä yritystä?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Etsi saatavilla olevia tilinpäätöstietoja

Toiminto ChkFinance

Tätä toimintoa tarvitaan vain tuotetta tilattaessa: finances (Financial statements) ja delivery_term = 'o'.

Luettelo käytettävissä olevista maista: Viron tasavalta (EST), Ruotsin kuningaskunta (SWE)

STEP 3: Tilaa tilinpäätös

Toiminto Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

Toiminto OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

Toiminto OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

Toiminto ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sv (Ruotsalainen), tr (Turkkilainen), uk (Ukrainan), zh (Kiinalainen)
To see the examples of xml request/response, please follow the link: How to get finished order?

Miten ladata vakioraportteja (muissa muodoissa kuin XML-muodossa)?


Types of standard product: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

Pyyntö koostuu kolmesta osasta:

  1. Kiinteä osa https://www.infoproff.com/en/orders/files/
  2. Yksilöllinen hash-tunnuksesi, jonka annamme vastauksena.
  3. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sv, tr, uk, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Alkuperäinen (ei vaihtoa), EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

Miten ladata ei-standardituotteita?


Types of non-standard product: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

Pyyntö koostuu kolmesta osasta:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Yksilöllinen hash-tunnuksesi, jonka annamme vastauksena.
  3. Ja korjattu osa lopussa /download

Miten saada luottoa koskeva lausunto?


Toiminto CreditOpinionCalculator

Miten saada lisätietoja?


Toiminto GetClassifiersFinancialStatements
Toiminto GetActivityClassificators
Toiminto GetDictionaryStandardPhrases
Toiminto GetAvailableProducts

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

Mahdolliset virheet


Näitä virheitä voi esiintyä, kun teet pyynnön verkkopalveluumme..


Kaikki toiminnot
  • Incorrect username/password or you have no permissions.
    Syötät väärät tunnistetiedot tai API-käyttömahdollisuutesi on estetty.

Toiminto SimpleSearch
  1. You don't have permissions to search in this country.
    Luettelo käytettävissä olevista maista: Alankomaiden kuningaskunta (NLD), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Espanjan kuningaskunta (ESP), Georgia (GEO), Grönlanti (GRL), Irlanti (IRL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Kazakstanin tasavalta (KAZ), Kiinan kansantasavalta (CHN), Kirgisian tasavalta (KGZ), Kyproksen tasavalta (CYP), Moldovan tasavalta (MDA), Mongolia (MNG), Norjan kuningaskunta (NOR), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan tasavalta (FRA), Ruotsin kuningaskunta (SWE), Saksan liittotasavalta (DEU), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tanskan kuningaskunta (DNK), Uzbekistanin tasavalta (UZB), Valko-Venäjän tasavalta (BLR), Viron tasavalta (EST)
Toiminto Order
  1. This product is not available.
    Tällaista tuotetta ei löydy, eikä sitä voi tilata.
  2. You can't order report on company with legal form: "legal_form"
    Tämä virhe koskee vain: Ruotsin kuningaskunta (SWE)
    Ruotsissa ei ole mahdollista tilata online-raporttia (delivery_term = "o") seuraavien oikeudellisten lomakkeiden kanssa:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    Offline-raporttia tilattaessa (delivery_term = "n", "f" tai "s") vaaditaan "Business Name" tai "Reg Code".
  5. Reg Code is required when delivery term is Online
    Kun tilaat online-raportin (delivery_term = "o"), "Reg Code" vaaditaan.

Toiminto GetReport
  1. This language is not supported.
    Luettelo Online-raporttien käytettävissä olevista kielistä: bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sv (Ruotsalainen), tr (Turkkilainen), uk (Ukrainan), zh (Kiinalainen)

Toiminnot GetReport ChkStatus
  1. Incorrect order_id.
    Tilaustunnusta ei löydy. Saat tilauksen ID:n, kun käytät Order -toimintoa.

Toiminto OrderCancellation
  1. Your order is already canceled.
    Sinulla ei ole enää lupaa peruuttaa tilausta.

Toiminto OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2).


SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2). [Overview]

1) New function: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Function: SimpleSearch

- Changes in list of available countries: Alankomaiden kuningaskunta (NLD), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Espanjan kuningaskunta (ESP), Georgia (GEO), Grönlanti (GRL), Irlanti (IRL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Kazakstanin tasavalta (KAZ), Kiinan kansantasavalta (CHN), Kirgisian tasavalta (KGZ), Kyproksen tasavalta (CYP), Moldovan tasavalta (MDA), Mongolia (MNG), Norjan kuningaskunta (NOR), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan tasavalta (FRA), Ruotsin kuningaskunta (SWE), Saksan liittotasavalta (DEU), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tanskan kuningaskunta (DNK), Uzbekistanin tasavalta (UZB), Valko-Venäjän tasavalta (BLR), Viron tasavalta (EST)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) Function: Order
Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: Alankomaiden kuningaskunta (NLD), Belgian kuningaskunta (BEL), Kazakstanin tasavalta (KAZ), Kirgisian tasavalta (KGZ), Puolan tasavalta (POL), Ruotsin kuningaskunta (SWE), Suomen tasavalta (FIN), Viron tasavalta (EST)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sv (Ruotsalainen), tr (Turkkilainen), uk (Ukrainan), zh (Kiinalainen)


SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2). [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

New element:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Removed elements

- code

Uudet elementit:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form

Webhooks Settings


Yleiskatsaus

Webhook on tapa, jolla sovellus voi toimittaa muille sovelluksille reaaliaikaista tietoa. Webhook-ominaisuutemme toteuttaa HTTP-kutsut, jotka on määritetty URL-osoitteella. HTTP POST -hyötykuorma lähetetään tähän URL-osoitteeseen JSON-muodossa aina, kun tietty tapahtuma tapahtuu. Projektimme yhteydessä olemme suunnitelleet webhook-toiminnon käynnistämään tiettyjä tapahtumia.

Webhookin määrittäminen

Jos haluat määrittää webhookin sovellukseesi, siirry sovelluksen asetussivulle ja etsi kohta "Webhooks Settings". Anna seuraavat tiedot:

  1. "Webhook URL" on URL-osoite, johon palvelimesi vastaanottaa webhook POST-pyyntöjä.
  2. "Toimituksen enimmäisyritykset" on asetus, joka määrittelee webhook-tapahtuman toimittamiseksi tehtävien uusintayritysten enimmäismäärän, kun ensimmäinen toimitusyritys epäonnistuu.
  3. "Toimituksen uudelleenkokeilun aikakatkaisu" on asetus, jonka avulla voit määrittää uudelleenkokeilujen välisen ajanjakson, kun webhookin toimitusyritys epäonnistuu.

Kun olet antanut nämä tiedot, napsauta "Tallenna".

Webhook-tapahtumatyypit

  1. Tilauksen uusi tila

Webhookin hyötykuorma

Kun tapahtuma tapahtuu, lähetämme HTTP POST -pyynnön hyötyosoitteen URL-osoitteeseen, jossa on JSON-runko, joka sisältää tietoja tapahtumasta.

Tässä on esimerkki hyötykuormasta:
Esimerkki tilauksen uutta tilaa koskevasta hyötykuormasta
Kentän "new_status" mahdolliset arvot:
  • "Finished" - tilaus on valmis. Tilauksen voi noutaa;
  • "Updated" - päivitetty tilaus, valmiiseen tilaukseen lisättyjä tietoja;
  • "Canceled" - tilaus peruutetaan asiakkaan pyynnöstä (tai suostumuksella).;
  • "Rejected" - tilaus hylätään. Yleensä siksi, että yritystä on mahdotonta tunnistaa....

Webhookien suojaaminen

On tärkeää varmistaa, että hyötyosoitteen URL-osoitteeseen lähetetyt POST-pyynnöt ovat sovelluksestamme. Tämän helpottamiseksi jokainen webhook-pyyntö sisältää X-Signature-otsikon.

Allekirjoitus Kuvaus

Allekirjoittamiseen käytämme HMAC- ja SHA512-algoritmia.

Salaisuus on sovellustunnuksen ja webhooks-asetusten salaisen avaimen yhdistelmä.

Tarvittaessa on mahdollista lisätä omia get-parameja päätepisteeseen lähettäjän tunnistamiseksi.

Vianmääritys

Palvelimen on vastattava 10 sekunnin kuluessa ja palautettava 2XX HTTP-koodi; muussa tapauksessa webhookin toimitus katsotaan epäonnistuneeksi. Epäonnistumisen sattuessa toiminto yrittää lähettää pyynnön uudelleen toimituskäytännön mukaisesti.