Import z Infor M3 do DocBits przez API

Krok 1: Utwórz API

1. Otwórz Infor OS i przejdź do API Gateway > Available APIs.

2. Kliknij Add, następnie wybierz Create New.

3. Wypełnij szczegóły API:

   • Application Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod lub DocBits-Demo (w zależności od środowiska).

   • Suite Name: To samo co nazwa aplikacji.

   • API Context: To samo co nazwa aplikacji.

   • Description: To samo co nazwa aplikacji.

   • Icon: Wybierz niebieską ikonę dokumentu.

1. Dodaj Target Endpoint:

• Target Endpoint URL: Użyj odpowiedniego adresu URL dla swojego środowiska:

  • 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 lub Demo (zgodnie ze środowiskiem).

• Proxy Context: To samo co środowisko (Stage, Sandbox, Prod lub Demo).

• Proxy Security: Wybierz OAuth 2.0.

• Target Endpoint Security:

  • Authentication Type: API Key

  • Key Mode: Header

  • Key Name: X-API-KEY

  • Key Value: Pobierz klucz API z DocBits, przechodząc do Settings > Global Settings > Integration, następnie skopiuj klucz API i wklej go jako wartość klucza.

• Zapisz konfigurację target endpoint.

1. Dodaj dokumentację API:

• Wróć do sekcji dokumentacji API, klikając Documentation Icon w utworzonym Endpoint.

• Przewiń w dół do sekcji Documentation i kliknij + Add Documentation.

  • Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod lub DocBits-Demo (zgodnie ze środowiskiem).

  • Type: Swagger

  • Enter URL or Upload Swagger JSON/YAML: Użyj odpowiedniego adresu URL pliku Swagger dla swojego środowiska:

    • 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

  • Upewnij się, że na końcu adresu URL nie ma spacji.

• Dokumentacja API zostanie automatycznie dodana, a odświeżenie metadanych zostanie uruchomione.

Krok 2: Utwórz API Connection Point

1. Przejdź do OS > ION > Connect > Connection Point.

2. Kliknij Add i wybierz API jako typ połączenia.

3. Wypełnij wymagane szczegóły:

   • Name: DocBits_Import

   • Description: DocBits_Import

   • Service Account: Prześlij plik konta usługi, który został utworzony wcześniej.

Krok 2.1: Dodaj i skonfiguruj dokumenty

• Nie musisz dodawać wszystkich dokumentów—tylko niezbędne.

• Dokumenty Sync.ChartOfAccounts i Sync.CodeDefinition są wymagane do automatycznego księgowania.

Sync.SupplierPartyMaster

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.SupplierPartyMaster

1. Skonfiguruj ION API:

   • API Call Name: Sync.SupplierPartyMaster

   • Click on Select

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

     CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

   • Kliknij OK, aby potwierdzić wybór.

1. Skonfiguruj Request Body:

   • Dla File wybierz Input Document = No Compression.

Sync.RemitToPartyMaster

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.RemitToPartyMaster

1. Skonfiguruj ION API:

   • API Call Name: Sync.RemitToPartyMaster

   • Click on Select

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

     CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla File wybierz Input Document = No Compression.

Acknowledge.SupplierInvoice

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Acknowledge.SupplierInvoice

2. Skonfiguruj ION API:

   • API Call Name: Acknowledge.SupplierInvoice

   • Click on Select

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

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

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body: Dodaj następujące wartości w sekcji Request Body:

   • Dla idm_doc_type ustaw Value = M3_SupplierInvoice

   • Dla idm_bod_id_field_name ustaw Value = BOD_AlternateDocumentID_1

   • Dla attributes_map ustaw Value =

     {"Export": "Success"}

   • Dla acl_from ustaw Value = Public

   • Dla acl_to ustaw Value = Private

   • Dla set_to_error_on_rejected ustaw Value = True

   • Dla delete_from_idm_on_rejected ustaw Value = True

   • Dla File ustaw Input Document = No Compression.

   • Dla ionapi_json: Dodaj zawartość pliku ionapi.

Sync.PurchaseOrder

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.PurchaseOrder

1. Skonfiguruj ION API:

   • API Call Name: Sync.PurchaseOrder

   • Click on Select

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

     CustomerApi/DocBits-Sandbox/Sandbox/import/purchase_order_bod

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla File ustaw Input Document = No Compression.

Sync.ReceiveDelivery

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.ReceiveDelivery

1. Skonfiguruj ION API:

   • API Call Name: Sync.ReceiveDelivery

   • Click on Select

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

     CustomerApi/DocBits-Sandbox/Sandbox/import/receive_delivery_bod

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla File ustaw Input Document = No Compression.

Sync.AdvanceShipNotice

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.AdvanceShipNotice

1. Skonfiguruj ION API:

   • API Call Name: Sync.AdvanceShipNotice

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

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

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla data_type ustaw Value = AdvanceShipNotice

   • Dla field_mappings ustaw Value =

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

   • Dla File ustaw Input Document = No Compression.

Sync.ChartOfAccounts

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.ChartOfAccounts

1. Skonfiguruj ION API:

   • API Call Name: Sync.ChartOfAccounts

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

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

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla data_type ustaw Value = ChartOfAccounts

   • Dla field_mappings ustaw 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"
     }

   • Dla File ustaw Input Document = No Compression.

Sync.CodeDefinition-AccountingDimension

1. Przejdź do zakładki Documents w API Connection Point.

1. Kliknij Add New Document i wypełnij następujące szczegóły:

   • Scenario: Send to API

   • Documents: Sync.CodeDefinition

1. Skonfiguruj ION API:

   • API Call Name: Sync.CodeDefinition-AccountingDimension

   • Dla Product wybierz endpoint API utworzony w Krok 1: Utwórz API.

   • Znajdź i wybierz:

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

   • Kliknij OK, aby potwierdzić konfigurację.

1. Skonfiguruj Request Body:

   • Dla data_type ustaw Value = M3Dimension

   • Dla field_mappings ustaw 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"
     }

   • Dla File ustaw Input Document = No Compression

Krok 3: Utwórz Document Flow

1. Przejdź do OS > ION > Connect > Data Flows.

2. Kliknij Add i wybierz Document Flow.

3. Wypełnij wymagane pola:

   • Name: Użyj nazwy specyficznej dla środowiska, takiej jak M3-to-DocBits-Stage-Import-API

   • dla stage, M3-to-DocBits-Sandbox-Import-API dla sandbox lub M3-to-DocBits-Prod-Import-API dla produkcji.

   • Description: To samo co nazwa powyżej.

4. Skonfiguruj Application Node:

   • W Application ustaw Name na M3.

• Kliknij przycisk + i wybierz connection point klienta.

• Kliknij ikonę Document obok application node.

  • Wybierz wszystkie dokumenty, które chcesz eksportować/synchronizować z LN do DocBits.

  • Upewnij się, że te dokumenty pasują do wybranych w Krok 2: Utwórz API Connection Point.

  • Jeśli brakuje jakichkolwiek dokumentów, należy je dodać do connection point klienta.

1. Skonfiguruj API Node:

   • Dodaj węzeł API i umieść go po prawej stronie application node.

   • Wypełnij wymagane pola:

     • Name: DocBits-API

     • Description: DocBits-API

     • ION API Connector: Użyj connection point utworzonego w Krok 2: Utwórz API Connection Point.

   • Kliknij ikonę Document obok stream node. Powinien być pusty.

1. Sfinalizuj konfigurację:

   • Zapisz konfigurację.

   • Kliknij Activate, aby zakończyć konfigurację.