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?
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?
2 - Na guia Params não é necessário nenhuma alteração;
3 - 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”:
2 - As guias Params e Authorization não é necessário preenchimento;
3 - 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:
2 - As guias Params e Authorization não é necessário preenchimento;
3 - Na guia Headers adicionar as seguintes Keys:
Importante! Nessa requisição não deve ser informada a Key que veio do Co