Documentação Integração API para ERPs

A API irá automatizar o envio de XML ao escritório de Contabilidade, não tendo mais a necessidade do lojista/cliente do ERP estar tendo que enviar os Documentos Fiscais para a Contabilidade.
 
Como faço para iniciar a Integração?
Para iniciar a integração é necessário encaminhar e-mail com Nome e E-mail do sistema no endereço api.dominio@tr.com para que em até 1 dia útil possamos liberar as chaves de acesso de nossa API. O cadastro também pode ser realizado em nosso site: Integração online com qualquer ERP | Thomson Reuters - Soluções Domínio (dominiosistemas.com.br) Lembrando que as chaves liberadas são de uso EXCLUSIVO do ERP.
 
A Domínio Sistemas - Thomson Reuters irá demonstrar como é a programação na API?
Sim, iremos demonstrar o funcionamento da API através do aplicativo “Postman”. Este aplicativo é gratuito e pode ser baixado pelo próprio site do Postman.
 
Fluxo da Integração API
  • Criação do Token;
  • Confirmar se a Key disponibilizada é do seu cliente com os seus dados, Nome da Contabilidade, CNPJ do cliente e nome do Cliente;
  • Com a Key do cliente será gerada uma nova Key, Integration Key. Está nova chave será utilizada para envio de nota junto ao Token;
  • Envio do XML para API;
  • Consulta do Envio para avaliar se o XML foi armazenado corretamente na API.
As chaves como Key do cliente, Integration Key e Token de envio do XML são fixos e não possui vencimento, uso exclusivo para o referido cliente.
Cada cliente terá a sua Key e o Integration Key já o Token será fixo do sistema ERP com necessidade de renovação a cada 24 horas.
 
Como faço para criar o Token?
1 - Acesse o Endpoint: POST : https://auth.thomsonreuters.com/oauth/token;
- Na guia Params não é necessário nenhuma alteração;
 
 
- Clique na guia “Authorization”, no campo Type informe “Basic Auth”, no campo ao lado em Username você deverá informar o “Client ID” já no campo Password informe o “Client Secret”. Esses IDs serão fornecidos pela Domínio Sistemas e são exclusivos do sistema ERP;
 
 
4 - Clique na guia “Headers” e Insira a seguinte Key: “Content-Type” no campo value informe “application/x-www-form-urlencoded”;
 
5 - Adicione também abaixo a key “Cookie” com o value“did=s%3Av0%3A145b8a90-ea57-11eb-ae8a-877f15a4a518.QhUcTCGsMP28yWAB%2BYsUUZ5Gw4Srxf%2F0IDRkKPUQQHs; did_compat=s%3Av0%3A145b8a90-ea57-11eb-ae8a-877f15a4a518.QhUcTCGsMP28yWAB%2BYsUUZ5Gw4Srxf%2F0IDRkKPUQQHs”;
 
 
6 - Clique na guia “Body”, marque a opção “X-WWW-FORM-URLENCODED”, após adicione as seguintes KEYs:
  • grant_type - client_credentials;
  • client_id – Este ID será uso exclusivo fornecido pela Domínio;
  • client_secret – Este ID será uso exclusivo fornecido pela Domínio;
  • audience - 409f91f6-dc17-44c8-a5d8-e0a1bafd8b67;
7 - Após o preenchimento da guia Body, o restante das guias não é necessário nenhuma alteração;
8 - Clique em “Send” para efetuar a criação do Token.
 
OBS: O Access Token, é o Token utilizado para efetuar o envio do XML para a API, possui validade 24 horas, após 24 horas necessários realizar o mesmo processo para gerar um novo token "renovação do mesmo". Somente relembrando que o token será Fixo do ERP.
 
IMPORTANTE! A requisição do TOKEN deve ser realizada somente 1x ao dia. Em casos que o ERP estiver realizando o consumo excessivo de requisições será feito contato com o mesmo para ajuste da situação e caso situação ser frequente ou não ajustada será avaliado desativação das chaves.
 
 
 
Confirmar a Key do Cliente
O contador do cliente do sistema irá fornecer a Key dos seus clientes que emitem a nota no ERP integrado, onde é necessário antes de gerar a Integration Key, confirmar se essa Key é realmente do cliente que está fazendo a integração. Para confirmar a empresa segue abaixo as requisições:
2 - Nas guias Params e Authorization não é necessário preenchimento;
3 - Na guia Headers adicione as seguintes Keys:
  • Authorization -  Bearer após a palavra Bearer deverá ser informado o access Token que foi gerado no tópico anterior conforme imagem abaixo;
  • x-integration-key – Inserir a chave que o contador do cliente fornecer;
 
4 - Após clicando em Send teremos o resultado Nome do Escritório de Contabilidade, Nome do Cliente do escritório e CNPJ do cliente do escritório.
 
 
Gerar a Key de Integração “integrationKey”:
- As guias Params e Authorization não é necessário preenchimento;
- Na guia Headers adicionar as seguintes Keys:
 
  • Authorization -  Bearer após a palavra Bearer deverá ser informado o Access Token que foi gerado no tópico anterior conforme imagem abaixo;
  • x-integration-key – Inserir a chave que o contador do cliente fornecer;
 
4 - Após clicando em Send teremos a “integrationKey”, onde será utilizada junto ao token para o envio do XML.
 
 
Envio do XML:
-  Acesse o Endpoint: POST - https://api.onvio.com.br/dominio/invoice/v3/batches;
- As guias Params e Authorization não é necessário preenchimento;
- Na guia Headers adicionar as seguintes Keys:
 
Importante! Nessa requisição não deve ser informada a Key que veio do Contador.