> For the complete documentation index, see [llms.txt](https://docs-it.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-it.docbits.com/administration-and-setup/settings/supplier-setting/export-configuration-for-supplier-portal-for-m3.md). # Configurazione dell'esportazione per il Portale fornitori per M3 ### Panoramica Il file di configurazione per l'esportazione è un componente cruciale nel portale fornitori, che definisce come i dati vengono mappati tra il portale fornitori e il sistema ERP. Questa configurazione garantisce che i dati vengano trasferiti e sincronizzati accuratamente tra i sistemi, consentendo operazioni fluide ed efficienti. ### Struttura del File di Configurazione Il file di configurazione per l'esportazione è strutturato come un oggetto JSON che contiene più mappature. Ogni mappatura è associata a un programma specifico nel sistema ERP e definisce le azioni da eseguire, i campi da mappare e eventuali condizioni da applicare. ### Componenti Chiave #### 1. Programma * **Definizione**: Specifica il programma ERP a cui si applica la mappatura. * **Esempio**: `"program": "CRS620MI"` #### 2. Azioni * **Definizione**: Definisce le azioni che possono essere eseguite, come aggiungere o aggiornare record. * **Esempio**: ```json "actions": { "add": "AddSupplier", "update": "UpdSupplier" } ``` #### 3. Mappatura • Definizione: Specifica la mappatura tra i campi nel sistema ERP e i campi nel portale fornitori. • Componenti: • erp\_field\_name: Il nome del campo nel sistema ERP. • value\_field\_name: Il nome del campo corrispondente nel portale fornitori. • value: Un valore statico da utilizzare se non esiste un campo corrispondente nel portale fornitori. • if\_conditions: Condizioni opzionali che determinano il valore in base a determinati criteri. • Esempio: ```json { "erp_field_name": "SUNO", "value_field_name": "supplier_number" } ``` #### 4. Logica Condizionale (if\_conditions) • Definizione: Specifica le condizioni che devono essere soddisfatte affinché venga utilizzato un particolare valore. • Componenti: • field\_name: Il nome del campo nel portale fornitori che viene valutato. • field\_value: Il valore che attiva la condizione. • then\_value: Il valore da utilizzare se la condizione è soddisfatta. • Esempio: ```json { "erp_field_name": "SUTY", "value": "0", "if_conditions": [{ "field_name": "supplier_group", "field_value": "FRT", "then_value": "5" }] } ``` #### 5. Cicli (loop\_on) • Definizione: Definisce le sezioni in cui la configurazione deve iterare su un elenco di elementi, come dettagli di indirizzo o di riferimento. • Esempio: ```json "loop_on": "address_details" ``` #### 6. Campi Calcolati (value\_field\_calculated) • Definizione: Specifica i campi che devono essere calcolati durante l'esecuzione, come la generazione della data corrente. • Esempio: ```json { "erp_field_name": "STDT", "value_field_calculated": "now()" } ``` #### 7. Mappature di Campo con Liste (mapping\_field\_name e mapping\_list) • Definizione: Mappa valori specifici dal portale fornitori ai valori corrispondenti nel sistema ERP in base a un elenco predefinito. • Componenti: • mapping\_field\_name: Il campo che determina la mappatura. • mapping\_list: Un dizionario che traduce i valori dal portale fornitori al sistema ERP. • Esempio: ```json { "erp_field_name": "RFID", "mapping_field_name": "reference_type", "mapping_list": { "10": "PURCHASING", "15": "DLVRY PHN#", "20": "COA", "25": "QA", "30": "FINANCE", "35": "SALES" } } ``` ### Esempio di Analisi della Configurazione #### Aggiunta e Aggiornamento Fornitori (CRS620MI) • Programma: CRS620MI • Azioni: • Aggiungi Fornitore: AddSupplier • Aggiorna Fornitore: UpdSupplier • Campi di Mappatura: • SUNO → supplier\_number • SUNM → name • CSCD → supplier\_country • TINO → tax\_id • I campi aggiuntivi includono valori statici e mappature condizionali. #### Dettagli Indirizzo (CRS620MI) • Ciclo Su: ***address\_details*** • Azioni: • Aggiungi Indirizzo: AddAddress • Aggiorna Indirizzo: AddAddress • Campi di Mappatura: • SUNO → supplier\_number • ADR1 → address • TOWN → city • I campi aggiuntivi includono campi calcolati come now() per la data corrente. #### Dettagli di Riferimento (CRS620MI) • Ciclo Su: ***reference\_details*** • Azioni: • Aggiungi Riferimento Fornitore: AddSupplierRef • Aggiorna Riferimento Fornitore: AddSupplierRef • Campi di Mappatura: • SUNO → supplier\_number • RFTY → reference\_type • RFID è mappato utilizzando un elenco per tradurre tipi come “PURCHASING”, “QA” e “FINANCE”. ### Utilizzo della Configurazione per l'Esportazione #### 1. Caricamento del File di Configurazione **1. Navigare alla Configurazione per l'Esportazione:** • Vai alla sezione Configurazione per l'Esportazione dal menu principale. **2. Caricare il File di Configurazione:** • Clicca sulle sezioni ION-Mapping File o IDM Mapping File per caricare il rispettivo file di configurazione. **3. Salvare la Configurazione:** • Dopo aver caricato, clicca sul pulsante Salva per applicare la configurazione. #### 2. Utilizzo dei Modelli Predefiniti • Clicca sul pulsante Usa Modello Predefinito se desideri tornare al modello di configurazione predefinito fornito dal sistema. #### 3. Formattazione del JSON • Usa il pulsante Format per formattare automaticamente il codice JSON per una migliore leggibilità. ### Conclusione Questo file di configurazione è essenziale per garantire che i dati tra il portale fornitori e il sistema ERP siano correttamente mappati e sincronizzati. Comprendendo la struttura e i componenti chiave, gli amministratori possono gestire e personalizzare efficacemente il processo di esportazione per soddisfare le proprie esigenze aziendali specifiche. ### Esempio Completo ```json [{ "program": "CRS620MI", "actions": { "add": "AddSupplier", "update": "UpdSupplier" }, "mapping": [{ "erp_field_name": "SUNO", "value_field_name": "supplier_number" }, { "erp_field_name": "SUNM", "value_field_name": "name" }, { "erp_field_name": "SUTY", "value": "0", "if_conditions": [{ "field_name": "supplier_group", "field_value": "FRT", "then_value": "5" }] }, { "erp_field_name": "CSCD", "value_field_name": "supplier_country" }, { "erp_field_name": "DTFM", "value_field_name": "date_format" }, { "erp_field_name": "ORTY", "value": "F20" }, { "erp_field_name": "DT4T", "value": "1" }, { "erp_field_name": "DTCD", "value": "2" }, { "erp_field_name": "CUCD", "value_field_name": "currency" }, { "erp_field_name": "TINO", "value_field_name": "tax_id" }, { "erp_field_name": "PHNO", "value_field_name": "supplier_phone" }, { "erp_field_name": "CRTP", "value": "1" }, { "erp_field_name": "ATPR", "value": "1" }, { "erp_field_name": "SUCL", "value_field_name": "supplier_group" }, { "erp_field_name": "LNCD", "value_field_name": "language" }, { "erp_field_name": "CONO", "value": "781_DDD" }, { "erp_field_name": "TEDL", "value": "FOB" }, { "erp_field_name": "TEPY", "value_field_name": "payment_term" }, { "erp_field_name": "TEPA", "value": "001" }, { "erp_field_name": "PYME", "value": "CRP" }] }, { "program": "CRS620MI", "loop_on": "address_details", "actions": { "add": "AddAddress", "update": "AddAddress" }, "mapping": [{ "erp_field_name": "SUNO", "main_value_field": "supplier_number" }, { "erp_field_name": "ADTE", "value_field_name": "address_type" }, { "erp_field_name": "ADID", "value_field_name": "address_type", "if_conditions": [{ "field_name": "address_type", "field_value": "10", "then_value": "" }] }, { "erp_field_name": "STDT", "value_field_calculated": "now()" }, { "erp_field_name": "ADR1", "value_field_name": "address" }, { "erp_field_name": "TOWN", "value_field_name": "city" }, { "erp_field_name": "ECAR", "value_field_name": "state" }, { "erp_field_name": "PONO", "value_field_name": "postal_code" }, { "erp_field_name": "CSCD", "value_field_name": "supplier_country" }] }, { "program": "CRS620MI", "loop_on": "reference_details", "actions": { "add": "AddSupplierRef", "update": "AddSupplierRef" }, "mapping": [{ "erp_field_name": "SUNO", "main_value_field": "supplier_number" }, { "erp_field_name": "RFTY", "value_field_name": "reference_type" }, { "erp_field_name": "RFID", "mapping_field_name": "reference_type", "mapping_list": { "10": "PURCHASING", "15": "DLVRY PHN#", "20": "COA", "25": "QA", "30": "FINANCE", "35": "SALES" } }, { "erp_field_name": "YRE1", "value_field_name": "reference_name" }, { "erp_field_name": "PHNO", "value_field_name": "telephone_no" }, { "erp_field_name": "EMAL", "value_field_name": "email_address" }] }] ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-it.docbits.com/administration-and-setup/settings/supplier-setting/export-configuration-for-supplier-portal-for-m3.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.