SIEG API
Olá, Desenvolvedor(a)! Seja bem-vindo(a) ao Portal de Integrações SIEG. Este ambiente é dedicado à toda documentação para consumo da nossa API. Se você deseja tornar o seu software um sistema parceiro da SIEG através de uma integração externa, continue nesta página para conferir o passo a passo completo de autenticação via OAuth.
Se você é cliente SIEG e precisa utilizar a API para controle e uso próprio, o seu ponto de partida é a nossa documentação exclusiva através do link: API SIEG para Clientes SIEG.
Deseja obter um SDK com o CÓDIGO PRONTO na linguagem utilizada pelo seu sistema, ou precisa de auxílio no desenvolvimento? Entre em contato com nosso time de Integrações, clicando aqui.
O que é a SIEG?
A SIEG é uma empresa de tecnologia de solução contábil que, por meio da captura, armazenamento, gestão de notas fiscais e demais funcionalidades estratégicas, transforma e automatiza a rotina de milhares de contadores espalhados pelo Brasil. Apesar da paixão por tecnologia, a SIEG é movida por pessoas e por isso, nosso objetivo está centrado em trazer uma solução eficaz que garanta ao nosso contador a sua relevância no mercado.
O que é API?
A API, ou Application Programming Interface, é um conjunto de regras que permite a troca de dados entre diferentes sistemas. A API da SIEG disponibiliza de vários endpoints voltados para a Gestão Fiscal, com a possibilidade de envio, captura e contagem de XMLs.
Objetivo da documentação
A presente documentação é um ambiente dedicado ao desenvolvedor da Software House que deseja se tornar um parceiro SIEG. O objetivo dessa integração é trazer mais praticidade para nossos clientes, facilitando a comunicação entre nossas soluções, e destaque, no mercado, para os sistemas integrados. Para o bom funcionamento da integração, é importante que todas as etapas sejam seguidas e que a documentação seja lida com atenção.
Como funciona a integração API da SIEG?
Para melhor compreensão, a documentação foi subdividida em pequenas etapas:
Iniciando com o processo de Cadastro, que consiste no preenchimento do formulário para análise da nossa equipe.
Após a Aprovação do formulário, o desenvolvedor irá receber, no endereço adicionado ao formulário, um e-mail com link para as credenciais que serão fundamentais para o próximo passo: a Autenticação do sistema, através da geração do JWT Token. Lembre-se: Esse Token terá 24hs de validade, por isso, será necessário que suas credenciais sejam consumidas diariamente.
Paralela à essa Autenticação, é necessário atrelar a integração ao cliente desejado. Para a autenticar esse cliente, o método utilizado será o OAuth 2.0.
Sendo assim, é essencial lembrar de preencher o campo "URL de redirecionamento" na etapa de Cadastro. Caso tenha esquecido, ou criado a URL após o envio do formulário, entre em contato conosco clicando aqui e informe a URL de Callback com o protocolo do seu formulário ou o CNPJ adicionado no preenchimento. Dessa forma, você poderá dar continuidade ao processo de desenvolvimento.
Ao clicar para logar com a SIEG, seu cliente abrirá nossa página de Autorização de Acesso. Essa página já foi providenciada pelos nossos desenvolvedores, mas há alguns parâmetros que você irá utilizar, para identificar o seu sistema e cliente, na URL de autenticação. Os parâmetros são: ClientID, State do cliente e Nível de Acesso. Selecionando o botão, "Autorizar acesso", você receberá um Token Temporário que precisa ser convertido em um Token Definitivo, em até 10 minutos. Também é fundamental que esse Token Definitivo receba um "Refresh" a cada 30 dias.
Finalizado o processo de autenticação, o JWT Token e o Token Definitivo serão utilizados no endpoint desejado para o envio ou recebimento de notas.