HomeAppStatusAPI
Edit

Importazione da Infor M3 a DocBits tramite API

Passo 1: Creare un'API

  1. Apri Infor OS e naviga su API Gateway > Available APIs.

  2. Fai clic su Add, quindi seleziona Create New.

  3. Compila i dettagli dell'API:

    • Application Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod o DocBits-Demo (in base al tuo ambiente).

    • Suite Name: Uguale al nome dell'applicazione.

    • API Context: Uguale al nome dell'applicazione.

    • Description: Uguale al nome dell'applicazione.

    • Icon: Seleziona un'icona documento blu.

  1. Aggiungi un Target Endpoint:

  • Target Endpoint URL: Utilizza l'URL appropriato per il tuo ambiente:

    • https://stage.api.docbits.com

    • https://sandbox.api.docbits.com

    • https://api.docbits.com

    • https://demo.api.docbits.com

  • Target Endpoint Description: Stage, Sandbox, Prod o Demo (corrispondente all'ambiente).

  • Proxy Context: Uguale all'ambiente (Stage, Sandbox, Prod o Demo).

  • Proxy Security: Seleziona OAuth 2.0.

  • Target Endpoint Security:

    • Authentication Type: API Key

    • Key Mode: Header

    • Key Name: X-API-KEY

    • Key Value: Recupera la chiave API da DocBits navigando su Settings > Global Settings > Integration, quindi copia la chiave API e incollala come valore della chiave.

  • Salva la configurazione del Target Endpoint.

  1. Aggiungi la documentazione API:

  • Torna alla sezione della documentazione API facendo clic su Documentation Icon nell'Endpoint creato.

  • Scorri verso il basso fino alla sezione Documentation e fai clic su + Add Documentation.

    • Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod o DocBits-Demo (corrispondente all'ambiente).

    • Type: Swagger

    • Enter URL or Upload Swagger JSON/YAML: Utilizza l'URL appropriato del file Swagger per il tuo ambiente:

      • https://stage.api.docbits.com/openapi.json

      • https://sandbox.api.docbits.com/openapi.json

      • https://api.docbits.com/openapi.json

      • https://demo.api.docbits.com/openapi.json

    • Assicurati che non ci siano spazi alla fine dell'URL.

  • La documentazione API verrà aggiunta automaticamente e verrà attivato l'aggiornamento dei metadati.

Passo 2: Creare un API Connection Point

  1. Naviga su OS > ION > Connect > Connection Point.

  2. Fai clic su Add e seleziona API come tipo di connessione.

  3. Compila i dettagli richiesti:

    • Name: DocBits_Import

    • Description: DocBits_Import

    • Service Account: Carica il file dell'account di servizio creato in precedenza.

Passo 2.1: Aggiungere e configurare i documenti

  • Non è necessario aggiungere tutti i documenti, solo quelli necessari.

  • I documenti Sync.ChartOfAccounts e Sync.CodeDefinition sono richiesti per la contabilità automatica.

Sync.SupplierPartyMaster

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Fai clic su Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.SupplierPartyMaster

  1. Configura l'ION API:

    • API Call Name: Sync.SupplierPartyMaster

    • Click on Select

    • Per Product, scegli l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

    • Fai clic su OK per confermare la selezione.

  1. Imposta il Request Body:

    • Per File, seleziona Input Document = No Compression.

Sync.RemitToPartyMaster

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.RemitToPartyMaster

  1. Configura l'ION API:

    • API Call Name: Sync.RemitToPartyMaster

    • Click on Select

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per File, seleziona Input Document = No Compression.

Acknowledge.SupplierInvoice

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Acknowledge.SupplierInvoice

  2. Configura l'ION API:

    • API Call Name: Acknowledge.SupplierInvoice

    • Click on Select

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/infor/idm/handle_ack_bod

    • Click OK per confermare la configurazione.

  1. Configura il Request Body: Aggiungi i seguenti valori nella sezione Request Body:

    • Per idm_doc_type, imposta Value = M3_SupplierInvoice

    • Per idm_bod_id_field_name, imposta Value = BOD_AlternateDocumentID_1

    • Per attributes_map, imposta Value =

      {"Export": "Success"}

    • Per acl_from, imposta Value = Public

    • Per acl_to, imposta Value = Private

    • Per set_to_error_on_rejected, imposta Value = True

    • Per delete_from_idm_on_rejected, imposta Value = True

    • Per File, imposta Input Document = No Compression.

    • Per ionapi_json: Aggiungi il contenuto del file ionapi.

Sync.PurchaseOrder

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.PurchaseOrder

  1. Configura l'ION API:

    • API Call Name: Sync.PurchaseOrder

    • Click on Select

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/import/purchase_order_bod

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per File, imposta Input Document = No Compression.

Sync.ReceiveDelivery

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.ReceiveDelivery

  1. Configura l'ION API:

    • API Call Name: Sync.ReceiveDelivery

    • Click on Select

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/import/receive_delivery_bod

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per File, imposta Input Document = No Compression.

Sync.AdvanceShipNotice

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.AdvanceShipNotice

  1. Configura l'ION API:

    • API Call Name: Sync.AdvanceShipNotice

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/master_data_lookup/xml/import_xml_file

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per data_type, imposta Value = AdvanceShipNotice

    • Per field_mappings, imposta Value =

      { "ID": "//DataArea/LnTaxCode/DocumentID/ID" }

    • Per File, imposta Input Document = No Compression.

Sync.ChartOfAccounts

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.ChartOfAccounts

  1. Configura l'ION API:

    • API Call Name: Sync.ChartOfAccounts

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/master_data_lookup/xml/import_xml_file

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per data_type, imposta Value = ChartOfAccounts

    • Per field_mappings, imposta Value =

      {
    "ID": "//DataArea/ChartOfAccounts/IDs/ID",
    "NominalAccount": "//DataArea/ChartOfAccounts/BaseChartOfAccounts/GLNominalAccount",
    "AccountType": "//DataArea/ChartOfAccounts/BaseChartOfAccounts/AccountType",
    "Description": "//DataArea/ChartOfAccounts/BaseChartOfAccounts/Description",
    "DimensionProfile": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/ID",
    "Dimension1": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[0]/ListID",
    "Usage1": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[0]/Usage",
    "Dimension2": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[1]/ListID",
    "Usage2": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[1]/Usage",
    "Dimension3": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[2]/ListID",
    "Usage3": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[2]/Usage",
    "Dimension4": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[3]/ListID",
    "Usage4": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[3]/Usage",
    "Dimension5": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[4]/ListID",
    "Usage5": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[4]/Usage",
    "Dimension6": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[5]/ListID",
    "Usage6": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[5]/Usage",
    "Dimension7": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[6]/ListID",
    "Usage7": "//DataArea/ChartOfAccounts/DimensionProfileSet/DimensionProfile/DimensionUsage[6]/Usage"
}

    • Per File, imposta Input Document = No Compression.

Sync.CodeDefinition-AccountingDimension

  1. Naviga sulla scheda Documents nell'API Connection Point.

  1. Click Add New Document e compila i seguenti dettagli:

    • Scenario: Send to API

    • Documents: Sync.CodeDefinition

  1. Configura l'ION API:

    • API Call Name: Sync.CodeDefinition-AccountingDimension

    • Per Product, seleziona l'endpoint API creato nel Passo 1: Creare un'API.

    • Trova e seleziona:

      CustomerApi/DocBits-Sandbox/Sandbox/master_data_lookup/xml/import_xml_file

    • Click OK per confermare la configurazione.

  1. Configura il Request Body:

    • Per data_type, imposta Value = M3Dimension

    • Per field_mappings, imposta Value =

      {
    "ID": "//DataArea/CodeDefinition/DocumentID/ID",
    "Dimension": "substring(//DataArea/CodeDefinition/CodeValue/@listID,21)",
    "ListID": "//DataArea/CodeDefinition/ListID",
    "CodeValue": "//DataArea/CodeDefinition/CodeValue",
    "Description": "//DataArea/CodeDefinition/Description"
}

    • Per File, imposta Input Document = No Compression

Passo 3: Creare il Document Flow

  1. Naviga su OS > ION > Connect > Data Flows.

  2. Fai clic su Add e seleziona Document Flow.

  3. Compila i campi richiesti:

    • Name: Utilizza un nome specifico per il tuo ambiente, come M3-to-DocBits-Stage-Import-API

    • per stage, M3-to-DocBits-Sandbox-Import-API per sandbox, o M3-to-DocBits-Prod-Import-API per production.

    • Description: Uguale al nome sopra.

  4. Configura l'Application Node:

    • In Application, imposta il Name su M3.

  • Fai clic sul pulsante + e seleziona il Connection Point del cliente.

  • Fai clic sull'icona Document accanto all'Application Node.

    • Seleziona tutti i documenti che desideri esportare/sincronizzare da LN a DocBits.

    • Assicurati che questi documenti corrispondano a quelli selezionati nel Passo 2: Creare un API Connection Point.

    • Se mancano documenti, devono essere aggiunti al Connection Point del cliente.

  1. Configura l'API Node:

    • Aggiungi un API Node e posizionalo a destra dell'Application Node.

    • Compila i campi richiesti:

      • Name: DocBits-API

      • Description: DocBits-API

      • ION API Connector: Utilizza il Connection Point creato nel Passo 2: Creare un API Connection Point.

    • Fai clic sull'icona Document accanto allo Stream Node. Questo dovrebbe essere vuoto.

  1. Finalizza la configurazione:

    • Salva la configurazione.

    • Fai clic su Activate per completare la configurazione.

PreviousM3NextBOD-Mappings

Last updated

Was this helpful?