Hvad er PortalData Export?
PortalData er en webhook, som kan sættes op til at starte en eksport, når der tilføjes en hændelse til en pakke eller forsendelse.
Bag scenen bliver alle hændelser gennemgået, og hvis en af dem passer til en Eksportprofil, sendes de ønskede data videre til den tilknyttede Gateway.
Match-kriterierne kan være alt, der findes på en forsendelse, for eksempel InstallationId, typer af hændelser eller specifikke oplysninger om forsendelsen.
En eksport kan enten startes, når en hændelse tilføjes, eller med faste intervaller.
Intervaller bruges typisk, hvis man ønsker at samle information over en bestemt periode, op til maksimalt 24 timer.
Hændelseskilder
-
On-premises / Ship Cloud/ Shipment Server
Eksempel: "Print" eller "Transmit" -
nShift Portal
Hændelser tilføjet via Forsendelsesvisningen -
ScanApp
Signatur og billede kan også eksporteres -
Transportør
ReturnData-hændelser som f.eks. "leveret" -
Kundedata
Filer fra kunden
Eksport Gateways
-
Email
Kun klar tekst -
SMS
Hvis mere end 160 tegn, håndteres det som en ekstra SMS -
FTP
Både FTP og SFTP understøttes. Vi kan sende vores standardformat, en tilpasset fil eller en ubehandlet fil med alle data, vi har på hver hændelse, hvis du ønsker at behandle dataene på din side. -
HTTP
Understøtter POST-forespørgsler mod et enkelt endepunkt.
API-header-autentificering understøttes ved brug af basic authentication, bearer (token) baseret autentificering og brugerdefineret header (nøgle+værdi).
Oversigt over PortalData Export
Eksportprofiler
Kun nShift-medarbejdere kan i øjeblikket oprette og redigere profiler.
Sådan kommer du i gang
Indsend en anmodning til kundeservice.
Ticketen bør indeholde følgende oplysninger:
- Hvilken type Gateway(s) du ønsker (email, SMS, FTP eller HTTP)
- Hvilke hændelser vi skal udløse en eksport på
- Eksempel på den skabelon, vi skal oprette ved brug af Email/SMS/Fil
-
Dokumentation af API’en, hvis du ønsker at bruge HTTP-gatewayen
Et eksempel på en POST-forespørgsel, inklusive headers og payload.
Angiv HTTP-endpoint. nShift kan understøtte:
- API-nøgle/token: En unik identifikator (streng)
- OAuth: token-baseret autentificering (client id og secret - JSON Web Token)
- Basic authentication: brugernavne og adgangskoder.
For mere information om standardformatet og eksempler, se
Standard Portal Export opsætning