Grāmatvedības sistēmas API testēšana

Administratora panelī: API → Grāmatvedības sistēmas API testēšana.

Kas tas ir

Smilšu kaste integrācijai ar jūsu uzskaites sistēmu. Šeit ir apkopoti visi punkti, caur kuriem mūsu sistēma pati sazinās ar grāmatvedības sistēmu: pieprasa cenas, pārbauda pieejamību noliktavā, ievelk materiāls↔mala saiknes utt. Lapā redzams, kuri endpoint ir jums nokonfigurēti, kuri nav; katru var dzīvi pārbaudīt ar reālu pieprasījumu un redzēt, ko grāmatvedības sistēma atgrieza.

Ko jūs redzat

Saraksts ar grāmatvedības sistēmas piezvanīšanas punktiem — kartiņas ar vienādu struktūru:

• Nosaukums un īss punkta apraksts.
• Ko tas dod — vienkāršiem vārdiem: kādu funkcionalitāti aktivizē šī endpoint iestatīšana.
• Iestatīšanas soļi — īsa instrukcija: ko prasīt jūsu grāmatvedības sistēmas programmētājam, kuru parametra atslēgu atrast administratora panelī, kur ielikt URL.
• Pašreizējais URL — ja jau ir nokonfigurēts. Tukšs — nozīmē, ka endpoint nedarbojas.
• Poga „Tests" — pāriet uz cilni ar reālā pieprasījuma veidlapu, rāda request/response.

Pieejamie integrācijas punkti

Pamatkomplekts (var tikt papildināts, attīstoties sistēmai):

• Materiālu cenu iegūšana — mūsu sistēma jautā grāmatvedības sistēmai aktuālās loksnes materiālu cenas. Bez šī iestatījuma cenas tiek ņemtas no vietējās datubāzes un var atšķirties no grāmatvedības sistēmas.
• Pakalpojumu cenu iegūšana — tas pats pakalpojumiem (apstrāde, furnitūra).
• Pieejamības noliktavā pārbaude — pirms pasūtījuma palaišanas ražošanā sistēma jautā grāmatvedības sistēmai, vai ir visi nepieciešamie materiāli. Bez tā pasūtījumi var aiziet ražošanā un krist ar „nav materiāla".
• Materiāla malas iegūšana — kura mala ietilpst komplektā ar konkrētu loksnes materiālu. Tiek izmantots nomenklatūras sinhronizācijā; citādi materiāls→mala atbilstība jāiestata manuāli.

Pieprasot materiālu un pakalpojumu cenas, platforma nosūta grāmatvedības sistēmai pasūtījuma reālo darījumu partneri — klients redz savas līguma cenas, nevis mazumtirdzniecības. Ja darījumu partneris nav izveidots vai nav saistīts ar grāmatvedības sistēmu, aprēķins nesabrūk: tiek atgrieztas mazumtirdzniecības cenas ar saprotamu skaidrojumu, kas jāpapildina datos. Tāpat izlabots gadījums, kad vienas firmas lietotājs strādā ar citas firmas katalogu: cenu pieprasījums tagad tiek nosūtīts strikti uz tās firmas grāmatvedības sistēmu, kuras katalogs tiek izmantots.

Kā iestatīt

Vispārējā recepte katram punktam ir vienāda:

1. Palūgt jūsu grāmatvedības sistēmas programmētājam izveidot HTTP servisu (endpoint) ar nepieciešamo pieprasījuma/atbildes formātu. Formāta apraksts — kartiņas iekšpusē testēšanas lapā.
2. Iegūt no programmētāja šī servisa URL (jāsākas ar https://; lokālā grāmatvedības sistēma var būt uz http://).
3. Ieiet Parametri → Firmas parametri, atrast parametru ar kartiņā norādīto atslēgu un ievietot URL.
4. Atgriezties testēšanas lapā un nospiest „Tests" — uzreiz redzams, vai grāmatvedības sistēma atbild un kādus datus atgriež.

Pieprasījuma tests

Izvēlētā punkta testa cilnē jūs redzat:

• Endpoint URL — kur lidos pieprasījums.
• HTTP metode (parasti POST).
• Galvenes (ieskaitot grāmatvedības sistēmas API-Key, ja iestatīts).
• Pieprasījuma ķermenis — tipisks piemērs, ko var uzreiz nosūtīt vai pielāgot (piemēram, ievietot reālu code1c esošai precei/pasūtījumam).
• Poga „Nosūtīt" — dod neapstrādātu atbildi no grāmatvedības sistēmas: atbildes kods, ķermenis, ilgums.

Kas ir svarīgi

• Testa pieprasījumi ir īsti: tie patiešām aiziet uz jūsu grāmatvedības sistēmu un var mainīt tā datus (piemēram, tests „Pieņemt pasūtījumu" izveidos grāmatvedības sistēmā ierakstu). Esiet uzmanīgi produkcijā — vispirms testējiet staging grāmatvedības sistēmā.
• Visi punktu iestatījumi tiek glabāti jūsu firmas ražošanas parametros — var mainīt bez atkārtotas izvietošanas.
• Vienā no atslēgām sistēmā ir vēsturiska drukas kļūda („avilable" vietā „available") — tā nav kļūme, atstāta saderībai ar vecām instalācijām. Norāde kartiņā brīdinās.
• Piekļuve — visi jūsu firmas administratori.