Podrška

DTO Flow centar za pomoć

Praktične upute za pokretanje partnerskih razmjena, uspješan rad partnera, povezivanje sustava i dobivanje podrške kada je trebate.

Odgovori

Česta pitanja

Praktični odgovori za korisničke timove, partnerske korisnike i vlasnike integracija koji rade s redovitim razmjenama partnerskih datoteka u DTO Flowu.

Osnove

Primjena proizvoda i datoteke

Što je DTO Flow?

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.

Kome je DTO Flow namijenjen?

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.

Po čemu se DTO Flow razlikuje od općih platformi za podatke ili prijenos datoteka?

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.

Koji rasporedi datoteka najbolje rade?

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.

Kako pripremiti složene tablice za validaciju?

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.

Može li DTO Flow pratiti ZIP datoteke i druge očekivane datoteke?

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.

Postavljanje

Feedovi i postavljanje

Što je feed?

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.

Trebam li izraditi jedan feed po partneru ili jedan zajednički feed?

Za ulazne razmjene koristite jedan feed po partneru kada svaki partner treba neovisno praćenje. Za izlazne razmjene vaš tim može istu datoteku privatno objaviti za više dodijeljenih partnera.

Što je datoteka feeda?

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.

Što je verzija validacije?

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.

Može li jedna predaja sadržavati više obveznih datoteka?

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.

Čemu služe slugovi feeda i datoteke?

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

Koja je razlika između skice i aktivnog feeda?

Feed u statusu Skica još se postavlja. Aktivni feed dostupan je za stvarne predaje, partnerski pristup, rasporede, obavijesti i automatizaciju, ovisno o ovlastima korisnika.

Pristup

Partneri i dozvole

Mogu li partneri vidjeti datoteke drugih partnera?

Partnerski korisnici vide samo feedove i predaje koji su im dodijeljeni. Podaci cijele organizacije i predaje drugih partnera ostaju izvan njihova prikaza.

Koje partnerske uloge postoje?

Partnerski operateri mogu predavati datoteke, pregledavati izvještaje validacije i preuzimati dostupne datoteke feeda. Partnerski promatrači mogu pregledavati izvještaje, postavke i dostupne datoteke. Upravitelji partnerskog feeda mogu predavati datoteke i upravljati postavkama validacije za dodijeljene feedove.

Tko može izrađivati feedove i upravljati partnerima?

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

Kako rade partnerske pozivnice?

Pozovite partnera e-poštom i dodijelite mu feedove i ulogu povezanu s njegovim poslom. Nakon prihvaćanja partner vidi razmjene i radnje obuhvaćene tim pristupom.

Što se događa kada se ukloni partnerski pristup?

Uklanjanje pristupa feedu sprječava partnera da ga ubuduće vidi ili koristi. Povijesne predaje, preuzimanja, rezultati validacije i aktivnosti ostaju dostupni ovlaštenim internim korisnicima.

Mogu li partneri izrađivati privatne pristupne tokene ili webhookove?

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.

Validacija

Prijenosi i validacija

Što se događa nakon prijenosa datoteke?

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.

Što validacija provjerava?

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.

Što znači trenutačna prihvaćena predaja?

Trenutačna prihvaćena predaja je prihvaćena predaja koja se računa za razdoblje feeda. Ako se kasniji prijenos za isto razdoblje prihvati, on postaje trenutačan. Ranije predaje ostaju vidljive u povijesti, ali se više ne računaju kao trenutačna verzija.

Može li partner ispraviti neuspjeli prijenos?

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.

Što ako se promijeni naziv stupca?

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.

Što ako Excel radna knjiga ima dodatne listove?

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.

Može li se predana datoteka ponovno validirati?

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.

Zašto predaja kaže prihvaćeno bez validacije?

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.

Operacije

Razdoblja, nadzorne ploče i preuzimanja

Kako rade razdoblja i rokovi?

Razdoblje je ponavljajući vremenski prozor koji feed očekuje, primjerice tjedno razdoblje računa ili mjesečno razdoblje objave. Dnevni, tjedni, mjesečni i ad hoc rasporedi pomažu nadzornoj ploči prikazati što dospijeva, kasni, nedostaje, obrađuje se ili je prihvaćeno.

Što prikazuje nadzorna ploča?

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.

Na koje statuse trebam obratiti pažnju?

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.

Što interni korisnici mogu preuzeti?

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

Kako rade izlazna partnerska preuzimanja?

U izlaznom feedu vaš tim objavljuje datoteku za određeno razdoblje i dodjeljuje pristup za preuzimanje. Partneri je privatno preuzimaju kroz portal, a DTO Flow zadržava aktivnost preuzimanja vidljivom u povijesti razmjene.

Prepisuje li DTO Flow stare datoteke?

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.

Integracije

Automatizacija, tokeni i webhookovi

Kada trebam koristiti API umjesto portala?

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.

Što su privatni pristupni tokeni?

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.

Može li automatizacija prenijeti ili preuzeti više datoteka?

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.

Gdje je OpenAPI specifikacija za automatizaciju?

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

Kako se webhookovi razlikuju od upozorenja e-poštom?

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.

S kojim webhook događajem trebam početi?

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.

Što se događa ako moj webhook primatelj nije dostupan?

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.

Podrška

Sigurnost, privatnost i rješavanje problema

Šalju li se cijele datoteke AI-ju?

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

Zašto je moj prijenos neuspješan prije 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.

Zašto ne vidim feed, gumb, token ili webhook opciju?

Vidljivost prati vašu ulogu i dodijeljene feedove. Možda ste prijavljeni na pogrešan račun, imate pristup samo odabranim partnerskim feedovima ili trebate ovlast za postavljanje, predaju, privatne tokene, postavke organizacije ili webhookove.

Što trebam učiniti ako poveznica za preuzimanje istekne?

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.

Što trebam uključiti kada kontaktiram podršku?

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.

Trebam li podršci slati datoteke, privatne tokene ili webhook tajne?

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.