Importazione da Infor M3 a DocBits tramite API

Passo 1: Criar uma API

1. Abra o Infor OS e navegue até API Gateway > Available APIs.

2. Click em Add, depois selecione Create New.

3. Preencha os detalhes da API:

   • Application Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod, ou DocBits-Demo (baseado no seu ambiente).

   • Suite Name: O mesmo que o nome da aplicação.

   • API Context: O mesmo que o nome da aplicação.

   • Description: O mesmo que o nome da aplicação.

   • Icon: Selecione um ícone de documento azul.

1. Adicione um Target Endpoint:

• Target Endpoint URL: Use a URL apropriada para seu 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, ou Demo (correspondente ao ambiente).

• Proxy Context: O mesmo que o ambiente (Stage, Sandbox, Prod, ou Demo).

• Proxy Security: Selecione OAuth 2.0.

• Target Endpoint Security:

  • Authentication Type: API Key

  • Key Mode: Header

  • Key Name: X-API-KEY

  • Key Value: Recupere a API key do DocBits navegando até Settings > Global Settings > Integration, depois copie a API key e cole-a como o valor da chave.

• Salve a configuração do target endpoint.

1. Adicione Documentação da API:

• Retorne à seção de documentação da API clicando no Documentation Icon no Endpoint criado.

• Role para baixo até a seção Documentation e click em + Add Documentation.

  • Name: DocBits-Stage, DocBits-Sandbox, DocBits-Prod, ou DocBits-Demo (correspondente ao ambiente).

  • Type: Swagger

  • Enter URL or Upload Swagger JSON/YAML: Use a URL do arquivo Swagger apropriado para seu 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

  • Certifique-se de que não há espaço no final da URL.

• A documentação da API será automaticamente adicionada, e a atualização dos metadados será acionada.

Passo 2: Criar um API Connection Point

1. Navegue até OS > ION > Connect > Connection Point.

2. Click em Add e selecione API como o tipo de conexão.

3. Preencha os detalhes necessários:

   • Name: DocBits_Import

   • Description: DocBits_Import

   • Service Account: Faça upload do arquivo de conta de serviço que foi criado anteriormente.

Passo 2.1: Adicionar e Configurar Documentos

• Você não precisa adicionar todos os documentos—apenas os necessários.

• Os documentos Sync.ChartOfAccounts e Sync.CodeDefinition são necessários para contabilização automática.

Sync.SupplierPartyMaster

1. Navegue até a aba Documents no API Connection Point.

1. Click em Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.SupplierPartyMaster

1. Configure a ION API:

   • API Call Name: Sync.SupplierPartyMaster

   • Click on Select

   • Para Product, escolha o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

     CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

   • Click em OK para confirmar a seleção.

1. Configure o Request Body:

   • Para File, selecione Input Document = No Compression.

Sync.RemitToPartyMaster

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.RemitToPartyMaster

1. Configure a ION API:

   • API Call Name: Sync.RemitToPartyMaster

   • Click on Select

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

     CustomerApi/DocBits-Sandbox/Sandbox/import/supplier_bod

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para File, selecione Input Document = No Compression.

Acknowledge.SupplierInvoice

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Acknowledge.SupplierInvoice

2. Configure a ION API:

   • API Call Name: Acknowledge.SupplierInvoice

   • Click on Select

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

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

   • Click OK para confirmar a configuração.

1. Configure o Request Body: Adicione os seguintes valores na seção Request Body:

   • Para idm_doc_type, defina Value = M3_SupplierInvoice

   • Para idm_bod_id_field_name, defina Value = BOD_AlternateDocumentID_1

   • Para attributes_map, defina Value =

     {"Export": "Success"}

   • Para acl_from, defina Value = Public

   • Para acl_to, defina Value = Private

   • Para set_to_error_on_rejected, defina Value = True

   • Para delete_from_idm_on_rejected, defina Value = True

   • Para File, defina Input Document = No Compression.

   • Para ionapi_json: Adicione o conteúdo do arquivo ionapi.

Sync.PurchaseOrder

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.PurchaseOrder

1. Configure a ION API:

   • API Call Name: Sync.PurchaseOrder

   • Click on Select

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

     CustomerApi/DocBits-Sandbox/Sandbox/import/purchase_order_bod

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para File, defina Input Document = No Compression.

Sync.ReceiveDelivery

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.ReceiveDelivery

1. Configure a ION API:

   • API Call Name: Sync.ReceiveDelivery

   • Click on Select

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

     CustomerApi/DocBits-Sandbox/Sandbox/import/receive_delivery_bod

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para File, defina Input Document = No Compression.

Sync.AdvanceShipNotice

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.AdvanceShipNotice

1. Configure a ION API:

   • API Call Name: Sync.AdvanceShipNotice

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

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

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para data_type, defina Value = AdvanceShipNotice

   • Para field_mappings, defina Value =

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

   • Para File, defina Input Document = No Compression.

Sync.ChartOfAccounts

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.ChartOfAccounts

1. Configure a ION API:

   • API Call Name: Sync.ChartOfAccounts

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

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

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para data_type, defina Value = ChartOfAccounts

   • Para field_mappings, defina 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"
     }

   • Para File, defina Input Document = No Compression.

Sync.CodeDefinition-AccountingDimension

1. Navegue até a aba Documents no API Connection Point.

1. Click Add New Document e preencha os seguintes detalhes:

   • Scenario: Send to API

   • Documents: Sync.CodeDefinition

1. Configure a ION API:

   • API Call Name: Sync.CodeDefinition-AccountingDimension

   • Para Product, selecione o endpoint de API criado no Passo 1: Criar uma API.

   • Localize e selecione:

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

   • Click OK para confirmar a configuração.

1. Configure o Request Body:

   • Para data_type, defina Value = M3Dimension

   • Para field_mappings, defina 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"
     }

   • Para File, defina Input Document = No Compression

Passo 3: Criar o Document Flow

1. Navegue até OS > ION > Connect > Data Flows.

2. Click em Add e selecione Document Flow.

3. Preencha os campos necessários:

   • Name: Use um nome específico para seu ambiente, como M3-to-DocBits-Stage-Import-API

   • para stage, M3-to-DocBits-Sandbox-Import-API para sandbox, ou M3-to-DocBits-Prod-Import-API para produção.

   • Description: O mesmo que o nome acima.

4. Configure o Application Node:

   • Em Application, defina o Name como M3.

• Click no botão + e selecione o connection point do cliente.

• Click no ícone Document ao lado do application node.

  • Selecione todos os documentos que você deseja exportar/sincronizar do LN para o DocBits.

  • Certifique-se de que esses documentos correspondem aos selecionados no Passo 2: Criar um API Connection Point.

  • Se algum documento estiver faltando, ele deve ser adicionado ao connection point do cliente.

1. Configure o API Node:

   • Adicione um node API e posicione-o à direita do application node.

   • Preencha os campos necessários:

     • Name: DocBits-API

     • Description: DocBits-API

     • ION API Connector: Use o connection point criado no Passo 2: Criar um API Connection Point.

   • Click no ícone Document ao lado do stream node. Este deve estar vazio.

1. Finalize a Configuração:

   • Salve a configuração.

   • Click em Activate para completar a configuração.