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.

📖 Importância dos Testes em ambiente de homologaçã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.

Sala de testes

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.

Resultados

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.

Evidências

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ários – Envio e Manutenção de Títulos

🔹 Cenário 1.1 – Envio de título com fornecedor não cadastrado

	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

🔹 Cenário 1.2 – Envio de título com fornecedor cadastrado

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

🔹 Cenário 1.3 – Reenvio de título com `reference_id` duplicado

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

🔹 Cenário 1.4 – Bloqueio de título inexistente

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

🔹 Cenário 1.5 – Bloqueio de título existente

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

🔹 Cenário 1.6 – Desbloqueio de título

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

🔹 Cenário 1.7 – Edição de título inexistente

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

🔹 Cenário 1.8 – Edição de título não bloqueado

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

🔹 Cenário 1.9 – Edição de título bloqueado

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

🔹 Cenário 1.10 – Edição de dados bancários

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

📌 Cenários – Antecipação de Títulos

🔹 Cenário 2.1 – Fluxo completo de antecipação

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

🔹 Cenário 2.2 – Antecipação negada pelo investidor (Obrigatório)

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

🔹 Cenário 2.3 – Estorno de operação já concluída (Obrigatório)

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

📌 Cenários – Títulos não operados

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

📌 Cenários – Download do termo de Cessão


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

📌 Outras validações:

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