Objetivo

Garantir que integrações com parceiros estejam funcionando corretamente, assegurando qualidade, previsibilidade e segurança operacional.

Fluxo de Homologação

1. Finalização do desenvolvimento

Ao concluir o desenvolvimento, o parceiro deve sinalizar o time de Parcerias, que realizará o agendamento da validação.

2. Preparação para homologação

Antes da validação, o parceiro deve:

• Garantir que a integração está funcional em seu ambiente;
• estar preparado para demonstrar os fluxos principais;
• alinhar com o time Frenet sua disponibilidade de data e hora para a validação.

Para realização dos testes da integração, o parceiro deve possuir uma conta criada na Frenet e informar ao time responsável o e-mail utilizado no cadastro para liberação de saldo e limite de etiquetas, quando necessário.

3. Modelo de homologação

A homologação ocorre em reunião síncrona, no formato de validação assistida.
Toda a validação é realizada em ambiente de produção da Frenet.

Durante a reunião:

• O parceiro compartilha a tela;
• apresenta os fluxos da integração;
• o time de Qualidade valida os cenários em tempo real.
  

4. Escopo da validação

Os itens validados dependerão das funcionalidades implementadas pelo parceiro na integração.
Durante a homologação, devem ser demonstrados e validados, a depender da implementação realizada, os seguintes itens:

Onboarding de sellers

• Criação de contas via API;
• geração e uso de token por seller;
• verificação de usuário já cadastrado;
• inclusão de dados adicionais ao cadastro (quando aplicável).

Gestão de transportadoras

• Consulta de serviços disponíveis para o seller;
• ativação e desativação de meios de envio;
• configuração de serviços adicionais (declaração de valor, aviso de recebimento, mão própria);
• busca e seleção de unidades de postagem (por UF ou por CEP);
• definição de unidade de postagem padrão.

Cotação no checkout (pré cotação)

• Cálculo de frete em tempo real;
• retorno de preço, prazo e serviços disponíveis;
• validação de CEPs de origem e destino;
• cotação com múltiplos volumes e itens.

Gestão de pedidos e envios

• Registro de pedidos na Frenet;
• listagem e consulta de envios;
• reimpressão de etiquetas;
• cancelamento de envios.

Geração de etiquetas

• Criação de pedido e geração imediata da etiqueta em fluxo one-click (quando aplicável);
• criação de pedido seguida de efetivação posterior do envio em fluxo de duas etapas (quando aplicável);
• retorno de código de rastreio, URL de etiqueta e documento de postagem;
• validade operacional da etiqueta gerada para postagem e rastreamento;
• comportamento em caso de saldo insuficiente.

Rastreamento

• Consulta de status de entrega por código de rastreio;
• retorno do histórico completo de movimentação;
• eventos de ocorrência com data, local e descrição.

Carteira

• Consulta de saldo disponível, bloqueado e limite de etiquetas;
• comportamento em caso de ausência de crédito (saldo insuficiente);
• fluxo de depósito e adição de saldo;
• consulta de extrato de operações.
  

5. Tratativa de inconsistências

Caso sejam identificados problemas durante a homologação, os pontos serão sinalizados na própria reunião.
Quando se tratar de ajustes simples e de baixíssimo esforço de implementação, as correções podem ser realizadas no momento, aproveitando a mesma sessão.

Para casos que exijam alterações mais complexas, o parceiro deverá realizar os ajustes posteriormente, sendo necessário o agendamento de uma nova rodada de homologação.

Não havendo aprovação imediata, o time de Qualidade documentará os pontos que devem ser corrigidos e encaminhará ao parceiro por e-mail.

6. Materiais para documentação ao usuário

Após a homologação, o parceiro deve encaminhar imagens do fluxo de:

• Criação de conta;
• configuração;
• geração de pedido;
• impressão de etiquetas.
  

Esses materiais serão utilizados para construção de conteúdo de apoio ao usuário e divulgação da integração pela Frenet, quando aplicável.

7. Aprovação da homologação

A homologação será considerada concluída quando:

• Todos os fluxos estiverem funcionando conforme esperado;
• não houver inconsistências que impeçam a utilização da integração em produção.
  

Após aprovação:

• O time de Parcerias seguirá com a ativação da integração;
• poderão ser iniciadas ações de lançamento, quando aplicável.