SFTP - Como integrar
Como automatizar a sincronização das dívidas entre minha carteira e a plataforma QueroQuitar por SFTP
Bruno
Última atualização há 6 meses
COMO FUNCIONA:
"SFTP" significa "SSH File Transfer Protocol". É uma maneira segura de transferir arquivos pela internet entre computadores ou servidores. É como uma espécie de "correio eletrônico" para arquivos, permitindo que você envie e receba arquivos de um lugar para outro.
Quando falamos sobre integrar o SFTP, estamos nos referindo a configurar o seu sistema ou software para que ele possa se comunicar com o servidor SFTP do sistema da QueroQuitar ou "SaaS". Dessa forma os arquivos com as dívidas a serem negociadas poderão ser enviados automaticamente em intervalos regulares, por exemplo: uma vez ao dia, ou sempre que surgir uma nova dívida.
Para integrar do lado do cliente, você geralmente precisa seguir algumas etapas simples:
1 - Configurar as informações de conexão: Isso inclui o endereço do servidor SFTP, nome de usuário, senha (essas informações serão fornecidas pela QueroQuitar na tela de configuração de SFTP).
2 - Programar a integração: Você pode configurar a integração para que ela ocorra automaticamente em intervalos regulares.
Os arquivos a serem enviados deverão ficar na pasta "Entrada" .
Caso haja algum problema no processamento do arquivo, será gerado um arquivo de resposta com o log de erros. Esse arquivo será colocado na pasta "Saida" .
PASSO-A-PASSO DE COMO CONFIGURAR:
1. Instale um Cliente SFTP
- Windows: Baixe e instale o WinSCP em www.winscp.net.
- Mac: Baixe e instale o Cyberduck em www.cyberduck.io.
- Abra o software SFTP (WinSCP ou Cyberduck).
- Clique em 'Nova Sessão' ou 'Novo Bookmark' (depende do software).
- Preencha os Detalhes da Conexão:
- Servidor: Informe o endereço do servidor SFTP fornecido na tela da QueroQuitar.
- Nome de Usuário: Informe o nome de usuário fornecido na tela da QueroQuitar..
- Senha: Informe a senha fornecida na tela da QueroQuitar.
- Porta: Use a porta padrão (22).
4. Clique em 'Salvar' ou 'Conectar'.
- Salve a configuração para uso futuro.
- Conecte-se ao Servidor:
- Clique em 'Conectar' usando a configuração salva.
- Navegue até a Pasta de Destino no Servidor:
- Normalmente, há uma pasta específica para uploads (ex.: /uploads/diario).
- Selecione o Arquivo Template Local:
- No painel local, navegue até a pasta onde o seu arquivo está salvo.
No WinSCP:
- Crie uma Tarefa Agendada:
- Vá em 'Tarefas' > 'Tarefas Agendadas' > 'Nova Tarefa'.
- Escolha 'Sincronizar' e configure o horário para sincronizações diárias.
- No campo 'Fonte', escolha a pasta local com seus arquivos.
- No campo 'Destino', selecione a pasta de destino no servidor SFTP.
- Defina as Regras de Sincronização:
- Marque a opção 'Enviar arquivos modificados e novos'.
- Salvar e Testar: Salve a tarefa e clique em 'Testar' para garantir que está funcionando.
- Crie uma Tarefa Agendada:
No Cyberduck:
- Crie um Cron Job (para usuários mais avançados):
- Abra 'Terminal' e utilize o comando crontab -e para editar as tarefas agendadas.
- Adicione uma linha como: 0 2 * * * /Applications/Cyberduck.app/Contents/Resources/duck.sh --upload sftp://usuario:senha@servidor/pasta/destino /caminho/local/arquivo.
- Salvar e Sair.
- Crie um Cron Job (para usuários mais avançados):
- Sempre que possível, verifique no software SFTP ou na plataforma SaaS se os arquivos foram sincronizados corretamente.
- Erro de Conexão: Verifique se as credenciais estão corretas e se há acesso à internet.
- Arquivos Não Atualizam: Confirme que o agendamento está ativo e que as permissões de leitura/escrita estão corretas no servidor.
- Notificações de Erros: Habilite notificações ou logs no software para rastrear falhas de sincronização.
Precisa de ajuda? Entre em contato com suporte.