Preciso desenvolver uma integração entre CUBi e outra ferramenta, quais são os próximos passos?

É muito comum que seja necessário ou conveniente que uma integração entre o sistema da CUBi e outro sistema aconteça. Nossa equipe está bastante familiarizada com o apoio ao desenvolvimento dessas integrações e é justamente por isso que temos uma documentação completa de nossa API. Para planejar uma integração recomendamos fortemente seguir os passos abaixo:

Avalie a disponibilidade do outro sistema
Verifique se o sistema que você quer integrar à CUBi possui essa função de integração e recepção/envio de dados para outros sistemas. É importante consultar a documentação e o suporte técnico dessa outra solução para verificar essa possibilidade antes de seguir qualquer outro passo.

Se você se sente perdido(a) nesta etapa, aqui vão algumas perguntas que precisam ser respondidas sobre o sistema que será integrado com a CUBi:

1.1 É possível desenvolver integrações do seu sistema com sistemas externos?
Ex.: sim é possível, não, não temos essa função e etc [...]

1.2 Onde posso encontrar a documentação para desenvolvedores de integração?
Ex.: a documentação fica disponível na url "x", não temos documentação por favor sempre entre em contato com nosso suporte via suporte@empresa.com

Refine o detalhamento sobre a integração desejada
Detalhe exatamente como funcionaria a integração e não deixe de prever casos de exceção. Um ERP, por exemplo, pode ter dezenas de canais diferentes de recepção e cadastro de uma nova conta a pagar, qual delas sua empresa utiliza? Também pode depender de personalizações que possam ter sido desenvolvidas especialmente para sua empresa no ERP. Por isso, essa é a etapa mais importante. Por experiência 90% das integrações que falham tem origem em uma etapa de refinamento pouco detalhada.

Se você se sente perdido(a) nesta etapa, aqui vão algumas perguntas que precisam ser respondidas:

2.1 Quais são os dados do outro sistema que devem ser enviados à CUBi e quando?
Ex.: mensagem de requisição no endpoint "x", ID único do centro de custo, ID único da Unidade e etc [...]

2.2 Quais são os dados que devem ser enviados da CUBi para o outro sistema e quando?
Ex.: o valor total da fatura com vírgula como separador de decimal e sem separadores de milhar, data de vencimento no formato DD/MM/AAAA e código de barras no formato de apenas números e etc [...]

2.3 Quando a integração falhar, o que deve ser feito?
Ex.: enviar e-mail para fulano@empresa.com, tentar enviar novamente em 5 minutos, adicionar botão de integrar manualmente no sistema e etc [...]

2.4 Qual será o gatilho definido para que a integração ocorra?
Ex.: todo dia 08h00, no momento da recepção de uma fatura da CUBi, no momento do processamento de uma fatura na CUBi, manualmente por um botão na tela "x", no momento que o outro sistema disparar uma mensagem de sucesso e etc [...]

2.5 Se um dado for editado no sistema da CUBi qual deve ser o comportamento da integração?
Ex.: enviar um aviso para o email fulano@, reenviar as informações atualizadas para o sistema de integração e etc [...]

2.6 Se um arquivo ou Unidade for deletada no sistema da CUBi qual deve ser o comportamento da integração?
Ex.: não fazer nada, enviar uma requisição de deleção também para o sistema de integração e etc [...]

2.4 Se a deleção de um arquivo ou Unidade for revertida no sistema da CUBi qual deve ser o comportamento da integração?
Ex.: enviar mensagem por email para fulano@, não fazer nada e etc [...]

2.4 Se a extração de dados de um arquivo for refeita qual deve ser o comportamento da integração?
Ex.: enviar um aviso para o email fulano@, reenviar as informações atualizadas para o sistema de integração e etc [...]

2.4 Se um arquivo de água ou danfe não for vinculado à uma Unidade qual deve ser o comportamento da integração?
Ex.: não executar a integração, enviar uma requisição de tarefa para o sistema de integração e etc [...]

Contrate uma equipe qualificada e que entenda dos sistemas em integração.
Você pode solicitar uma proposta específica para que a equipe da CUBi execute a integração, usar a própria equipe caso tenha conhecimento, contratar a equipe do outro fornecedor ou até mesmo uma equipe externa de desenvolvedores. Em qualquer um dos casos nosso suporte estará disponível para apoia-lo em dúvidas e sugestões.

É importante ressaltar que quando a equipe da CUBi não é contratada diretamente para executar a integração não há nenhuma obrigação da CUBi em adaptar ou desenvolver novas funções ou integrações sendo que as equipes externas devem considerar o desenvolvimento de integrações considerando a documentação de endpoints disponíveis da CUBi "as is".