Guia Geral - PlugStorage – Central de Atendimento
3 de dezembro de 2021 13:53
Neste post, vamos explicar quais são os primeiros passos para começar a utilizar essa API e posteriormente o fluxo principal para utilizar o PlugStorage.
Personalizando o PlugStorage
Personalizando o Cliente
Configurando certificado digital para busca de destinadas e manifesto de notas
Vinculando o contador do cliente
Integrando via API
1º Passo - Criando a conta de parceiro
Para realizar seu cadastro como parceiro no Plug Storage você precisa criar a sua conta em nossa página de login e clicar em CRIAR UMA CONTA.
Após finalizar o cadastro, é necessário acessar e-mail que foi informado e ativar a conta, basta clicar no link que foi enviado para o e-mail.
Feito isso, você poderá realizar o login em seu usuário. Umas das principais informações que você deve verificar é o Token de integração, ele será usado para autenticar todos os envios de notas para o Plug Storage.
Para visualiza-lo você deve ir em: Configurações > Dados da Conta e verificar o campo Token de Integração.
2º Passo - Personalizando o PlugStorage
No Plug Storage, existem diversas configurações, algumas delas estão diretamente relacionadas ao visual e configurações de e-mail como o White Label e as configurações de SMTP. Com essas configurações você pode deixar o PlugStorage com a cara da sua empresa e passar ao seu cliente a sensação de não sair do seu meio.
Com as configurações do Servidor SMTP seu cliente irá receber os e-mail's do PlugStorage como se você estivesse enviando, para isso basta realizar a configuração do seu e-mail em nossa Interface e pronto, todos os e-mail enviados terão como emitente o e-mail configurado. Em nosso post sobre as configurações da Software House existem mais detalhes de como fazer essas configurações.
3º Passo - Cadastrando o Cliente
4º Passo - Personalizando o Cliente
5º Passo - Configurando certificado digital para busca de destinadas e manifesto de notas
No Plug Storage é possível realizar o cadastro de um certificado do tipo A1, para que o mesmo possa ser utilizado na busca das notas destinadas, do modelo NFe e CTe, e também para manifesto de notas.
Para isso você deve acessar a opção Configurações > Destinadas - DFe (No portal do cliente) ou em Clientes > Configurações DFe (No portal do parceiro), após isso, basta preencher os dados solicitados.
A verificação automática é utilizada para constantemente fazer a consulta das destinadas na receita de acordo com o tempo escolhido na opção, dessa forma, o cliente irá receber e-mail's informando que as destinadas foram consultadas, caso o cliente não queira receber notificação por e-mail, é necessário desmarcar a opção de permitir notificação por e-mail.
O Tipos de Documentos é utilizado para especificar quais documentos devem ser buscados no sefaz, podendo selecionar NFe, CTe ou Ambos.
6º Passo - Vinculando o contador do cliente
Pensando em facilitar a transferência de dados entre clientes e contador e possível vincular um e-mail de contador no cliente Configurações > Contador (no painel do cliente), Clientes > Vincular Contador (no painel do parceiro), para isso basta cadastrar o e-mail do contador, como na imagem:
É possível também escolher a forma de envio das notas para o contador. Existem dois tipos de envio, o Singular, Recorrente e Não enviar e-mail.
No envio singular, uma vez por mês, na data que você selecionar será enviado para o contador todos os XML's do mês anterior.
7º Passo - Integrando via API
8º Passo - Montando uma Requisição
Na API do Plug Storage, vamos utilizar 3 tipos de requisições, as do tipo POST, as do tipo GET e as do tipo PUT.
As requisições do tipo POST servem, nesse caso, para o envio das informações para nossa api, para que possamos realizar os tratamentos necessários e inclusão de notas, clientes, contadores e etc.
As requisições do tipo GET servem, nesse caso, para a consulta de informações, que no nosso caso será referente as notas e manifestos.]
Já as requisições do tipo PUT servem, nesse caso, para a alteração de registros já existentes em nossa base, como a alteração dos dados de um usuário já cadastrado.