DTO Flow centar za pomoć

DTO Flow je gateway za redovite razmjene poslovnih datoteka. Partnerima daje kontrolirano mjesto za predaju ili preuzimanje datoteka, provjerava tablične Excel i CSV podatke prema vašim dogovorenim pravilima, čuva kontekst svake predaje i prihvaćene datoteke čini dostupnima ovlaštenim ljudima i sustavima.

DTO Flow namijenjen je timovima koji ovise o redovitim partnerskim predajama datoteka: tablicama, dobavljačkim datotekama, distributerskim izvještajima, ZIP paketima ili kontroliranim partnerskim preuzimanjima. Posebno je koristan kada ista datoteka stiže svaki tjedan ili mjesec, a male promjene formata mogu zaustaviti sljedeći poslovni proces.

DTO Flow namjenski je izgrađen za redovite razmjene partnerskih datoteka. Povezuje kontrolirani pristup partnera, validaciju tablica, jasan status, sljedivu povijest i pouzdanu dostupnost prihvaćenih rezultata u jednom jasnom procesu.

Najbolje rade ravne tablične CSV datoteke i Excel listovi. Dobra datoteka ima jedan jasan redak zaglavlja, predvidljive stupce i retke koji predstavljaju zapise koje očekuje vaš proces primanja.

Za najjasniju samoposlužnu validaciju izvezite složene izvještaje i radne knjige kao ravnu Excel ili CSV tablicu s jednim retkom zaglavlja i predvidljivim stupcima. DTO Flow tada partnerima daje precizne i razumljive upute za ispravak.

Da. DTO Flow prati ZIP pakete i druge očekivane datoteke u istom feedu, prikazuje njihov status i povijest te ih čini dostupnima kroz kontrolirani portal ili integraciju. Provjere tabličnih podataka primjenjuju se na odgovarajuće Excel i CSV datoteke.

Feed je redovita razmjena definirana smjerom, partnerskim pristupom, rasporedom, očekivanim datotekama, pravilima validacije, obavijestima i poviješću. Primjerice, tjedni CSV s računima jednog dobavljača obično treba biti jedan feed.

Zajedničko praćenje koristite za jednu zajedničku razmjenu, primjerice istu izlaznu datoteku za više primatelja. Podijeljeni feed sa zasebnim Subfeedovima koristite kada razmjene trebaju neovisne predaje i rezultate po razdoblju, uz zajedničke postavke. Zasebne feedove koristite za različite rasporede, očekivane datoteke, pravila validacije ili isporuku. Opseg birate pri izradi feeda; kasnija promjena zahtijeva zamjenski feed.

Datoteka feeda je jedna očekivana fizička datoteka unutar feeda. Predaja može sadržavati jednu ili više datoteka feeda, a svaka može definirati je li obvezna, koji format očekuje, kako se nazivi podudaraju i treba li pokrenuti validaciju.

Verzija validacije je verzionirani skup determinističkih provjera za datoteku feeda: ciljni list ili dio, pravila zaglavlja, obvezni stupci, dopušteni nazivi stupaca (aliasi), tipovi podataka, dopuštene vrijednosti, provjere duplikata i očekivanja broja redaka.

Da. Feedovi s više datoteka mogu zahtijevati nekoliko datoteka u istoj predaji, primjerice datoteku zaglavlja i datoteku stavki. Sve obvezne datoteke moraju biti prisutne kako bi predaja zadovoljila feed za to razdoblje.

Slugovi su stabilni i čitljivi nazivi koje koriste integracije i podrška. Svakom feedu i očekivanoj datoteci daju dosljednu referencu kroz vrijeme.

Feedovi u nacrtu još se postavljaju. Aktivni feedovi omogućuju rad s razmjenom prema ovlastima i smjeru. U podijeljenom feedu svaki Subfeed također može biti u nacrtu, aktivan ili arhiviran; za novu sesiju prijenosa trebaju biti aktivni i feed i Subfeed.

Vidljivost ovisi o pristupu feedu i opsegu praćenja. U podijeljenom feedu partner treba trenutačnu dodjelu Subfeedu te vidi njegove dopuštene datoteke i sačuvanu povijest, uključujući ranije datoteke. Partneri na istom Subfeedu dijele tu povijest. Za razmjene koje trebaju ostati odvojene koristite zasebne Subfeedove; zajednički feed može istu dopuštenu razmjenu prikazati većem broju partnera.

Partnerski operateri mogu prenositi datoteke kada to smjer feeda dopušta, pregledavati rezultate validacije i preuzimati dopuštene datoteke. Partnerski promatrači mogu pregledavati i preuzimati, ali ne mogu prenositi. Upravitelji partnerskog feeda mogu i upravljati pravilima validacije. U podijeljenom feedu za rad s razmjenom potrebna je dodjela Subfeedu, dok su pravila validacije zajednička za nadređeni feed.

Vlasnici i administratori organizacije upravljaju feedovima, partnerskim pristupom, postavkama organizacije i webhookovima. Operateri i promatrači rade s operativnim podacima prema svojim ovlastima.

Odaberite partnera, dodijelite odgovarajuću ulogu u feedu i uredite pozivnicu za portal. Za podijeljeni feed dodijelite i odgovarajući Subfeed. Prihvaćanje pozivnice omogućuje pristup portalu, ali ne zamjenjuje ovlasti u feedu ni dodjelu Subfeedu.

Za podijeljeni feed prvo uklonite dodjelu partnera Subfeedu, a zatim prema potrebi i pristup feedu. Uklanjanje dodjele ukida trenutačni pristup razmjeni, ali čuva račun, ulogu u feedu i podatke o ranijim radnjama. Ne arhivira Subfeed i ne utječe na druge primatelje. Arhiviranje je zasebna radnja koja čuva dodjele i dostupnu sačuvanu povijest.

Partneri mogu izraditi privatne pristupne tokene za feedove kojima mogu pristupiti kada njihova uloga to dopušta. Upravitelji partnerskog feeda mogu upravljati webhookovima dodijeljenih feedova, a webhookovima cijele organizacije upravljaju vlasnici i administratori organizacije.

DTO Flow povezuje predanu datoteku s partnerom, feedom i razdobljem, provodi dogovorene provjere te na stranici predaje prikazuje put od zaprimanja do konačnog ishoda.

Validacija može provjeriti dolazak datoteke, ekstenziju, veličinu, čitljivost, ciljne listove, zaglavlja, obvezne stupce, dopuštene nazive stupaca, formate datuma i brojeva, dopuštene vrijednosti, duplikate, anomalije broja redaka i druga deterministička pravila konfigurirana u verziji validacije.

Trenutačno prihvaćena predaja jest prihvaćena verzija koja vrijedi za razdoblje u odabranom opsegu: cijelom zajedničkom feedu ili jednom Subfeedu. Kasnija prihvaćena predaja u istom opsegu i razdoblju postaje trenutačna. Ranije predaje ostaju u sačuvanoj povijesti, a rezultati drugih Subfeedova ne mijenjaju se.

Da. Neuspjela validacija treba dati sigurnu povratnu informaciju pošiljatelju s pogođenim redcima, stupcima, listovima ili datotekama gdje je moguće. Partner može ispraviti datoteku i prenijeti novu predaju za isto razdoblje.

Ako je promjena namjerna, ovlašteni interni korisnik ili upravitelj feeda može dodati novi dopušteni naziv stupca u spremljena pravila validacije. Ako je promjena slučajna, partner treba ponovno poslati datoteku prema dogovorenom predlošku.

Dodatni listovi mogu ostati izvan provjere kada je feed usmjeren na odgovarajući list ili raspon. Validacija se tada usredotočuje na dogovorenu tablicu, primjerice list naziva „Data”, umjesto na svaku karticu radne knjige.

Da. Kada se spremljena pravila validacije ažuriraju, ovlašteni korisnici mogu ponovno provjeriti datoteke validirane ranijom verzijom. Svaki rezultat ostaje povezan s poviješću predaje.

Taj status koristi se za praćene datoteke prihvaćene prema pravilima paketa umjesto provjera tabličnog sadržaja, primjerice za izlazna partnerska preuzimanja i referentne datoteke. DTO Flow datoteku i dalje arhivira, povezuje s razmjenom i čini dostupnom kroz ovlaštene putove.

Planirano razdoblje predstavlja dnevnu, tjednu ili mjesečnu razmjenu. Zajednički feed ima jedan rezultat po razdoblju, a podijeljeni feed po jedan za svaki očekivani Subfeed. Subfeed se očekuje samo kada rok razdoblja pripada intervalu njegove aktivnosti. Feedovi na zahtjev ne stvaraju ponavljajuća očekivana razdoblja.

Nadzorna ploča ističe feedove koji traže pažnju, nadolazeće rokove, sažetke i nedavne prihvaćene predaje kako bi tim brzo odredio sljedeću radnju.

Propušteno, zakašnjelo, validacija neuspjela, obrada neuspjela i predaje u tijeku obično zahtijevaju pažnju. Prihvaćeno i prihvaćeno bez validacije znače da razdoblje ima upotrebljivu trenutačnu predaju prema postavkama tog feeda.

Ovlašteni interni korisnici mogu preuzeti prihvaćene predane datoteke, a svaka ostaje povezana sa svojim partnerom, razdobljem i poviješću predaje.

Vaš tim objavljuje prihvaćene datoteke za ovlaštene primatelje. Zajedničko praćenje objavljuje jednu zajedničku razmjenu, a podijeljeno praćenje zasebne izvještaje u pripadajućim Subfeedovima. Više partnera na istom Subfeedu može preuzeti isti izvještaj. Aktivnost preuzimanja bilježi izdavanje poveznica, a ne dokaz dovršenog prijenosa datoteke primatelju.

Svaka nova predaja nadopunjuje povijest. Kasnija prihvaćena predaja može postati aktualna verzija za razdoblje, a ranije predaje ostaju dostupne prema dogovorenom načinu čuvanja.

Koristite portal za ručne partnerske predaje, postavljanje i pregled. API za automatizaciju koristite za planirane zadatke, partnerske sustave, CLI alate, provjere spremnosti, predaju redovitih datoteka i preuzimanje prihvaćenih predanih datoteka prije uvoza u odredišni sustav.

Privatni pristupni tokeni daju skriptama i povezanim sustavima usmjeren pristup odabranim feedovima i radnjama. Tajna se prikazuje jednom, treba je sigurno pohraniti, a token se može opozvati dok ranija aktivnost ostaje vidljiva.

Da. Automatizacija s više datoteka izrađuje jednu sesiju prijenosa za predaju, prenosi svaku očekivanu datoteku na odredište koje API vrati, jednom dovršava predaju i zatim preuzima svaku prihvaćenu predanu datoteku nakon prihvaćanja predaje.

OpenAPI specifikacija za automatizaciju dostupna je na produkcijskoj API adresi: https://api.dtoflow.com/api/automation/v1/openapi.json.

Upozorenja e-poštom obavještavaju ljude, a webhookovi sustave. Koristite webhookove kada druga usluga treba potpisani događaj nakon što predaja postane dostupna, dosegne odabrani završni status ili propusti rok.

Za uvoz u odredišni sustav počnite s događajem feed.submission.available. Aktivira se samo kada je trenutačna predaja za razdoblje prihvaćena i spremna za daljnju upotrebu.

DTO Flow ponavlja privremene webhook neuspjehe i bilježi povijest isporuke. Primatelji trebaju provjeriti potpise, brzo vratiti 2xx odgovor i koristiti ID-jeve događaja i isporuke za idempotentnost.

Spremljena deterministička pravila odlučuju zadovoljava li datoteka dogovorena očekivanja. Cijele partnerske datoteke ne šalju se AI usluzi radi validacije.

Neuspjeh prije validacije obično znači da datoteka nedostaje, prazna je, premašuje ograničenje veličine iz plana, ima neočekivanu ekstenziju, nije čitljiva ili je povezana s pogrešnom očekivanom datotekom. Otvorite detalje predaje za konkretan razlog i sljedeći korak.

Provjerite prijavljeni račun, ulogu u feedu i ovlasti za radnju. U podijeljenom feedu provjerite i trenutačnu dodjelu Subfeedu. Za prijenos provjerite smjer, aktivan status feeda i Subfeeda te ograničenja organizacije ili partnera. Pozivnica ili uloga u feedu same po sebi možda ne omogućuju pristup razmjeni.

Vratite se na predaju ili izlazni feed i ponovno zatražite preuzimanje. Poveznice za preuzimanje namjerno su kratkotrajne, a prihvaćena datoteka ostaje praćena i dostupna prema pravima pristupa i pravilima čuvanja.

Uključite naziv organizacije, naziv feeda, naziv partnera ako je relevantno, ID predaje ili razdoblje te navedite odnosi li se pitanje na predaju, validaciju, preuzimanje, automatizaciju, webhookove, obavijesti ili pristup računu.

Ne šaljite tajne privatnih pristupnih tokena, tajne za potpisivanje webhookova, lozinke ili cijele osjetljive datoteke kroz poruke podršci. Podijelite ID-jeve, vremenske oznake, nazive feedova, snimke zaslona bez osjetljivih podataka i najmanji siguran uzorak potreban za objašnjenje problema.