FORS24 - Collegamento a Soprasteria¶
Posizione nel menu Programma non a menu Linkage section UTIL-FORS24
| Tipo | Dato | Formato | Contenuto |
|---|---|---|---|
| INPUT | FORS24-OPE | x(20) | Operazione da eseguire |
| FORS24-FILE-NAME | x(256) | Nome del file da inviare | |
| FORS24-FILE-LOCATION | x(01) | Location del file: |
|
| OUTPUT | FORS24-ESITO | x(01) | Esito dell'operazione |
| FORS24-O-MSG | x(150) | Messaggio restituito | |
| FILLER | x(2000) |
Logica generale Lo scopo di questo programma è inviare a Soprasteria un file contenente delle informazioni come previsto dalla loro documentazione. Configurazioni
| Pacchetto | Gruppo | Parametro | Note |
|---|---|---|---|
| F | connect | soprasteria-username | |
| F | connect | soprasteria-password | |
| F | connect | soprasteria-client-id | |
| F | connect | soprasteria-grant-type | |
| F | connect | soprasteria-fonte | |
| F | connect | soprasteria-path |
Elaborazione L'elaborazione cambia a seconda dell'operazione richiesta.
Operazione: INVIA¶
Descrizione Riceve in input un file da inviare a SOPRASTERIA Chiamata standard
| Dato | Contenuto |
|---|---|
| FORS24-OPE | "INVIA" |
| FORS24-TIPO-FILE | Tipo di file da inviare |
| FORS24-FILE-NAME | Il nome del file da inviare |
| FORS24-FILE-LOCATION | Location del file da inviare |
Elaborazione D.1 - Trasformazione del csv in "base64" Effettuare la trasformazione del file in "base64" (vedi COGSA3X) - Chiedere delucidazioni a Giovanni D.2 - Chiamata a CURL per il passaggio dei dati D.2.1 Autenticazione Il nome del file restituito dovrà essere rinominato in "FORS24-FILE-NAME" D.2.2 Invio dati STEP 1: E’ necessario chiamare questa api: https://api-stg.inventorychainplatform.com/auth/realms/InventoryChain/protocol/openid-connect/token passando nel body della chiamata i seguenti parametri: * usernamea a * password * client_id * grant_type
Username e Password devono essere valorizzati con le credenziali che vi comunicheremo mediante email. client_id dovrà essere valorizzato con il seguente valore: inventory-chain. grant_type dovrà essere valorizzato con il seguente valore: password.
STEP 2:
Il servizio risponderà restituendo un access_token, questo access token dovrà essere utilizzato negli header di autorizzazione come bearer token, per autenticarsi durante la chiamata alla seguente api: https://api-stg.inventorychainplatform.com/gateway/magazzini/upload/file/ext Questa API prevede che in input debbano essere passati nel body i seguenti parametri { "base64": "lkfhSAJDKJkdlajsdkljslkdjklsadjòaSJD ALSKJD òLA" "fileName": "fonte_CAUSALE_20221207120000.csv" }
Base64 che è la codifica del contenuto del file. FileName che corrisponde al nome del file e deve rispettare gli standard predefiniti (Esempio: FONTE_CAUSALE_YYYYMMDDHHmmSS.csv") 1° chiamata curl -X POST \ --url https://api-stg.inventorychainplatform.com/auth/realms/InventoryChain/protocol/openid-connect/token \ --data username=username \ --data password=password \ --data client_id=inventory-chain \ --data grant_type=password curl -X POST -d "@/path/file" "https://api-stg.inventorychainplatform.com/auth/realms/InventoryChain/protocol/openid-connect/token" contenuto /path/file: username=username&password=password&client_id=inventory-chain&grant_type=password 2° chiamata curl -X POST -H "Authorization: Bearer kndsfondsfoi" -d "@/path/file" "https://api-stg.inventorychainplatform.com/gateway/magazzini/upload/file/ext" contenuto /path/file: fileName=nomefile&base64=contenutofile Accesso su browser https://home.inventorychainplatform.com
Estratto da documentazione interna ClickUp