Como integrar transportadoras pela SSW Sistemas

Configure transportadoras que utilizam o sistema SSW na sua loja virtual.

Quando usar

A SSW é um sistema utilizado por diversas transportadoras.

Se a transportadora que você deseja integrar utiliza a SSW, você pode realizar a integração seguindo este procedimento.

Criando o tipo de frete

Para iniciar a configuração:

1. Acesse Configuração > Tipos de frete.
2. Clique em Criar tipo de frete.
3. Selecione a opção SSW Sistemas.

Entendendo as abas de configuração

O tipo de frete possui as seguintes abas:

• Geral
• Canais
• Configurações do frete
• Expedição
• Regras de exibição
• Rastreamento
• Performance

Preenchendo a aba Geral

Na aba Geral, informe:

• Nome interno: usado apenas para identificação interna
• Nome: exibido ao cliente
• Ativado: define se o frete ficará disponível
• Descrição: campo interno para observações

Preenchendo a aba Canais

Na aba Canais, selecione os canais que utilizarão esse tipo de frete.

Preenchendo a aba Configurações do frete

Na aba Configurações do frete, configure os dados da integração e envio.

Integração

Preencha:

• Domínio: domínio utilizado no contrato com a transportadora
• Login da SSW: fornecido pela transportadora
• Senha da SSW: fornecida pela transportadora
• CNPJ do contrato: CNPJ vinculado ao contrato

Embalagem

Preencha:

• Largura
• Altura
• Comprimento

Se você não tiver uma embalagem padrão, utilize os valores sugeridos pela plataforma.

No campo Peso adicional, recomendamos informar 100 g como margem de segurança.

Prazo

No campo Adicional de prazo, informe uma margem de segurança.

Exemplo: se o prazo calculado for 3 dias e você adicionar 3 dias, o cliente verá 6 dias.

No campo Transportadora retorna em, defina:

• Dias úteis, quando o prazo for informado em dias úteis
• Dias corridos, quando o prazo for informado em dias corridos

Valor

Configure margens de segurança no valor do frete.

Adicional fixo de preço

Soma um valor fixo ao frete.

Exemplo: R$ 10,00 + R$ 5,00 = R$ 15,00.

Adicional percentual de preço

Aplica um percentual sobre o valor do frete.

Exemplo: R$ 10,00 + 20% = R$ 12,00.

Frete grátis a partir de

Defina um valor mínimo de carrinho para oferecer frete grátis, se necessário.

Entendendo a soma de adicionais

Se você configurar adicional fixo e percentual, o percentual será aplicado sobre a soma do valor base com o adicional fixo.

Exemplo:

• valor retornado pela transportadora: R$ 10,00
• adicional fixo: R$ 10,00
• subtotal: R$ 20,00
• adicional percentual (20%): R$ 4,00
• valor final: R$ 24,00

Preenchendo a aba expedição

Na aba Expedição, você encontra três campos.

Habilitar envio automático de pedidos

Ao ativar essa opção, a plataforma envia o pedido automaticamente para a transportadora assim que uma nota fiscal for vinculada ao pedido.

O comportamento varia conforme o tipo de integração:

• em transportadoras com integração direta, como Correios e J&T, o envio ocorre via API
• em transportadoras sem integração direta, a plataforma envia automaticamente um e-mail com o XML da NF-e

Nesse momento, a plataforma também pode gerar o link ou o código de rastreamento, quando a transportadora oferece esse recurso.

Contato para notificação

Esse campo é opcional.

Use essa opção para selecionar um contato já cadastrado que receberá, por e-mail, os XMLs das notas fiscais dos pedidos.

Esse recurso deve ser usado apenas quando a transportadora não possui integração logística via API. Quando a integração existe, a plataforma faz o envio automaticamente, sem necessidade de notificação manual.

Criar remessa automaticamente

Ao ativar essa opção, a plataforma adiciona automaticamente os pedidos a uma remessa de postagem da transportadora, desde que eles atendam aos critérios abaixo:

• pagamento confirmado
• sem nota fiscal vinculada
• criado há no máximo 7 dias

Depois de ativar esse campo, a plataforma exibe configurações adicionais da remessa, como nome da remessa, dias de criação e horário limite.

Preenchendo a aba Regras de exibição

Configure quando o frete ficará disponível.

• Região: selecione onde o frete será exibido
• Grupos de clientes: selecione grupos específicos ou deixe em branco para todos
• Ocultar quando não conseguir calcular o frete: defina o comportamento em caso de erro
• Categoria de frete: restrinja o frete a categorias específicas, se necessário
• Regra da categoria: configure apenas se uma categoria for selecionada
• Visibilidade: limite por preço, peso ou volume

Preenchendo a aba Rastreamento

Na aba Rastreamento, informe o link de rastreio.

Use o seguinte padrão:

https://ssw.inf.br/cgi-local/tracking/CNPJ/[nf]

Substitua "CNPJ" pelo CNPJ utilizado no contrato.

No campo Entregue se existirem as palavras, informe palavras que indicam entrega concluída, separadas por ponto e vírgula.

Preenchendo a aba Performance

Configure regras para contingência em caso de falha ou lentidão da transportadora.

Tempo máximo de resposta

Informe o tempo limite, em segundos, para retorno do cálculo.

Exemplo: 20 segundos.

Tipo de frete de contingência

Selecione um frete alternativo para ser utilizado caso a transportadora não responda dentro do tempo definido.

Finalizando a configuração

Após preencher todos os campos, clique em Criar.

Validando a integração

Após a configuração:

1. Realize um pedido de teste.
2. Verifique se o frete está sendo calculado corretamente.