HomeAppStatusAPI
Edit

Importar do Infor M3 para o DocBits via 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.

PreviousM3NextBOD-Mappings

Last updated

Was this helpful?