Esta seção tem como finalidade ser referência compartilhada entre a Líber e o Sacado, estabelecendo os cenários que deverão ser validados durante o período de homologação da integração com a API Liber Connect. Assegurando a qualidade e a conformidade da implementação.
A execução de testes após o desenvolvimento da integração é fundamental para identificar falhas de forma antecipada e permitir sua correção em tempo hábil. Além disso, contribui para a validação do sucesso da integração, promovendo um entendimento comum entre todas as partes envolvidas e reduzindo riscos operacionais.
Os testes descritos neste documento foram definidos a partir de uma abordagem técnica e abrangem os seguintes aspectos críticos da integração:
- Validação da conectividade entre o ERP do Sacado e a plataforma Liber (e vice-versa);
- Verificação da coerência entre os estados do título no ERP e os estados definidos pela API Liber Connect;
- Aderência dos fluxos implementados no ERP do Sacado aos fluxos previstos pela Liber.
Recomendamos que os testes sejam realizados em uma sala online, conforme disponibilidade de agenda do time técnico Liber e Sacado, a fim de que todas as dúvidas sejam sanadas, obtendo maior produtividade na execução.
É de extrema importância a participação do time técnico/consultoria de ambas as partes, assim como o time de negócios para compreensão do fluxo.
Cada cenário realizado, será executado e apenas será considerado bem sucedido após a validação entre o resultado esperado e o que foi obtido durante a execução, além do fornecimento das evidências dos processos que foram realizados no ERP. Com o objetivo de garantirmos que o fluxo foi desenvolvido corretamente.
Conforme mencionado anteriormente, para que os testes sejam concluídos, é importante o anexo das evidências do comportamento sistêmico neste documento, a fim de formalizarmos a corretude dos processos.
| Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.1 | Enviar título com fornecedor não cadastrado | Envia um título via API (POST) com fornecedor não registrado na plataforma | Verifica que o fornecedor não está cadastrado e rejeita a inserção do título | Liber retorna erro indicando rejeição por fornecedor inexistente. ERP deve refletir o erro e não processar o título. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.2 | Enviar título com fornecedor cadastrado | Envia título válido via API (POST) | Insere o título e retorna status INSERTED/VERIFIED | Título aparece no ERP como inserido com sucesso. A resposta da Liber reflete corretamente no sistema, bloqueando o título para movimentações. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.3 | Reenviar título já inserido anteriormente | Envia novamente o título com o mesmo reference_id | Identifica duplicidade e rejeita a requisição | Liber retorna erro de título já existente. ERP não deve duplicar nem sobrescrever o título. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.4 | Bloquear título não inserido na Liber | Envia requisição de bloqueio de título inexistente | Retorna erro: título não encontrado | ERP registra falha e impede edição desse título. Idealmente, o ERP deve evitar esse envio. | Não |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.5 | Bloquear título já inserido | Envia requisição de bloqueio para um título válido | Atualiza status para BLOCKED | ERP reflete status BLOCKED, habilitando edição do título. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.6 | Desbloquear título bloqueado | Envia requisição de desbloqueio | Atualiza status do título para VERIFIED/INSERTED | ERP reflete título como desbloqueado e pronto para uso. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.7 | Tentar editar título não cadastrado | Envia requisição PUT para título inexistente | Retorna erro: título não encontrado | ERP deve cancelar a edição e registrar a falha. | Não |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.8 | Editar título sem bloqueio prévio | Envia PUT sem bloquear o título | Rejeita edição por status inválido | ERP deve impedir ou reverter alterações não aceitas pela Liber. | Não |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.9 | Editar título previamente bloqueado | Envia PUT com alterações em campos permitidos (ex: face_value) | Atualiza os dados do título e retorna sucesso | ERP persiste as alterações e mantém sincronização com a Liber. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 1.10 | Editar título previamente bloqueado | Envia PUT com alterações em campos permitidos
(expected_account_for_anticipation) | Atualiza os dados do título e retorna sucesso | ERP persiste as alterações e mantém sincronização com a Liber. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 2.1 | Antecipação concluída com polling intermediário | Realiza venda do título, faz polling durante a negociação e consulta ao final | Atualiza título: PROCESSING → SOLD, venda COMPLETED | ERP atualiza status, baixa o título e muda a carteira para o investidor. | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 2.2 | Investidor recusa a antecipação | Realiza venda do título e consulta o status | Título volta a status anterior: VERIFIED ou BLOCKED | ERP reverte o processo de venda. Título deve voltar com status que indica que está ativo na plataforma Líber | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 2.3 | Estorno por erro interno após antecipação | Consulta status pós-estorno | Libera o título para nova operação, status volta para VERIFIED/INSERTED | ERP desfaz a baixa do título, que deve voltar ao status anterior (Ativo na plataforma Líber) | Sim |
| ID | Cenário de Teste | Ações do Sacado | Ações da Liber | Resultado Esperado | Obrigatório |
|---|
| 3.1 | Atualização de títulos que atingiram o prazo mínimo de operação | Consulta status | Liber atualiza título para EXPIRED quando atingir o prazo mínimo para antecipação | ERP desfaz bloqueio/destrava o título para que seja efetuado o pagamento ao Fornecedor na data de vencimento. (Inativo na Líber) | Sim |
| | | | | |
|---|
| ID | Cenário de teste | Ações do Sacado | Ações da Líber | Resultado esperado | Obrigatório |
| 4.1 | Permitir o download do termo assinado, de uma operação realizada | Busca termo de cessão com o número da operação | Liber retorna com o redirecionamento para link temporário. | Sacado obtém o termo de cessão. | Não |
- Número de referência: Número de referencia que determina a unicidade do título na base da Líber e do ERP do Sacado.
Descrever o racional do número de referência (Exemplo.: Número Sequencial, ou Cod. Fornecedor + Raiz CNPJ + Número NF + Série/Parcela)
- Envio de dados da Nota Fiscal (Serviço, Mercantil e CTE)
- Baixa automática: Utilizar campo settled_at para baixa automática dos títulos liquidados.
- Conta bancária: Envio e atualização dos dados bancários do fornecedor
