Savienojumi

Finpilo var nosūtīt validētus dokumentus tieši uz jūsu grāmatvedības sistēmu. Tā vietā, lai eksportētu failus manuāli, dokumenta dati tiek nodoti automātiski, kad nosūtāt dokumentu. Savienojums pasaka Finpilo, kur dokumentu sūtīt un kā autentificēties.

Savienojumi tiek pārvaldīti vienuviet — Connections cilnē sadaļā Workspace Settings — un pēc tam izvēlēti tur, kur tie ir vajadzīgi. Katra entītija var izvēlēties savu savienojumu, un vienu savienojumu var atzīmēt kā noklusējumu visai darbvietai.

Kas ir savienojums

Savienojums apraksta vienu ārējo sistēmu:

• Name — kā savienojums parādās sarakstos (piemēram, "Grāmatvedības sistēma").
• Base URL — ārējās sistēmas adrese.
• Auth — kā Finpilo autentificējas: No auth, Bearer token, Basic (user:password) vai Custom header.
• Secret — token, parole vai galvenes vērtība, ko sistēma sagaida.

Noslēpums tiek glabāts šifrētā veidā. Pēc saglabāšanas Finpilo to vairs nekad nerāda — savienojumam vienkārši ir redzama nozīmīte Secret set. Lai to aizstātu, ievadiet jaunu vērtību. Rediģējot atstājiet lauku tukšu, lai saglabātu esošo noslēpumu.

Savienojuma izveide

Nepieciešama Admin vai Owner loma.

1. Navigējiet uz Workspace Settings → Connections cilni.
2. Noklikšķiniet New Connection.
3. Ievadiet Name un ārējās sistēmas Base URL.
4. Izvēlieties Auth veidu. Veidam Custom header ievadiet arī Header name (piemēram, X-Api-Key).
5. Ievadiet Secret. Basic autentifikācijai izmantojiet formātu user:password.
6. Noklikšķiniet Save.

Izmantojiet rediģēšanas un dzēšanas ikonas savienojuma rindā, lai to vēlāk mainītu vai noņemtu. Savienojuma dzēšana aptur visu sūtīšanu, kas uz to balstījās, tāpēc vispirms norādiet skartajām entītijām citu savienojumu.

Darbvietas noklusējums

Connections cilnē zvaigznes ikona atzīmē savienojumu kā darbvietas noklusējumu — sistēmu, uz kuru dokumenti tiek sūtīti, kad entītijai nav sava savienojuma. Noklusējuma savienojumam ir redzama nozīmīte Workspace default.

Noklikšķinot zvaigzni uz pašreizējā noklusējuma, tas tiek noņemts, un darbvieta paliek bez noklusējuma.

Savienojuma izvēle entītijai

Nepieciešama Admin vai Owner loma.

Izmantojiet entītijas līmeņa izvēli, kad konkrētai entītijai jāsūta uz citu sistēmu nekā pārējai darbvietai:

1. Navigējiet uz Entity Management un atveriet entītiju.
2. Atlasiet cilni Connection.
3. Izvēlieties savienojumu nolaižamajā sarakstā Connection. Tukšā izvēle Workspace default nozīmē, ka entītija izmanto darbvietas noklusējuma savienojumu.
4. Noklikšķiniet Save.

Kā nosūtīšana izmanto savienojumus

Kad nosūtāt validētu dokumentu (skatiet Document View), Finpilo palaiž darbplūsmu Send to Accounting. Tā nosūta dokumenta datus uz:

1. Entītijas savienojumu, ja entītija tādu ir izvēlējusies.
2. Darbvietas noklusējuma savienojumu pretējā gadījumā.

Ja nav ne viena, ne otra, dokumentu nosūtīt nevar — vispirms izveidojiet savienojumu.

Kad ārējā sistēma dokumentu pieņem, statuss mainās uz Sent. Ja sistēmas atbilde satur grāmatvedības atsauci, Finpilo to saglabā dokumenta laukā Accounting Reference. Ja atsauce netiek atgriezta, nekas netiek saglabāts — tas ir pieņemami. Nosūtīšanas laiks un sistēmas atbilde tiek reģistrēti dokumenta cilnē History.

Ja nosūtīšana neizdodas, dokuments pāriet statusā Send Failed, un kļūda tiek reģistrēta vēsturē. Izlabojiet savienojumu vai dokumentu un nosūtiet vēlreiz.

Nosūtāmā satura maiņa

Nepieciešama Admin vai Owner loma.

Pati nosūtīšana ir parasta darbplūsma, ko varat atvērt un pielāgot:

1. Navigējiet uz Workspace Settings → Workflows cilni un atveriet Send to Accounting.
2. Solis Send HTTP Request satur nosūtāmos datus — rediģējamu JSON saturu, kurā {{field}} atsauces nosūtīšanas brīdī ievieto vērtības no dokumenta. Rakstiet @ redaktorā, lai izvēlētos lauku. Noklusējuma datu formāts ir aprakstīts sadaļā External API.
3. Solis Update Field saglabā jūsu sistēmas atgriezto grāmatvedības atsauci dokumenta laukā Accounting Reference.

Ja iepriekš izmantojāt webhook

Savienojumi aizstāj vecos webhook iestatījumus. Jūsu esošā webhook konfigurācija — gan darbvietas, gan entītiju — tika automātiski pārnesta uz savienojumiem, tāpēc sūtīšana turpināja darboties bez jebkādas pārkonfigurēšanas. Katrs webhook URL un API atslēga kļuva par savienojumu, un entītijai, kurai bija savs webhook, tagad šis savienojums ir izvēlēts tās Connection cilnē.