Como autenticar a integração com a Unlock Fulfillment

A integração com a Unlock permite conectar a Base ao sistema de fulfillment para sincronizar informações relacionadas a produtos, estoque e expedição de pedidos.

1. Pré-requisitos

Antes de realizar a autenticação, certifique-se de que:

• Você possui um usuário cadastrado no portal da Unlock;
• O usuário possui acesso à filial que será utilizada na integração;
• Você possui o ID da filial fornecido pela Unlock;
• O usuário e a senha utilizados são os mesmos utilizados para acessar o portal da Unlock.

Importante: a autenticação não utiliza uma API Key. O acesso é realizado com o usuário e senha da conta da Unlock.

2. Configurar o usuário na Unlock

Para realizar a autenticação pela Base, o usuário utilizado precisa ter acesso a pelo menos uma filial na Unlock.

Mesmo usuários com perfil de proprietário ou administrador podem não conseguir utilizar a integração se nenhuma filial estiver vinculada à conta.

Caso o usuário ainda não tenha uma filial associada:

1. Acesse o portal da Unlock.
2. Crie ou selecione o usuário que será utilizado na integração.
3. Vincule ao usuário a(s) filial(is) que ele deverá acessar.
4. Confirme se o usuário consegue visualizar a filial diretamente no portal.

Importante: o ID da filial é obrigatório para a integração. Cada seller possui sua própria filial na Unlock. Por isso, utilize o ID fornecido pela Unlock para a conta que está sendo configurada.

3. Autenticar a conta na Base

1. Na Base, acesse Integrações.
2. Localize a integração com a Unlock.
3. Selecione a opção para adicionar ou autenticar uma conta.
4. Informe o usuário da conta Unlock.
5. Informe a senha utilizada para acessar o portal da Unlock.
6. Informe o ID da filial que será utilizada.
7. Salve a configuração.

Importante: o ID da filial é informado manualmente na Base. As filiais não aparecem em uma lista ou campo de seleção. A Base apenas verifica se o ID informado está associado ao usuário utilizado na autenticação.

Após uma autenticação bem-sucedida, a Base consulta a Unlock para obter as informações disponíveis para aquela filial, como:

• Origem dos pedidos;
• Plataforma fiscal;
• Transportadoras disponíveis;
• Outras informações relacionadas à operação da filial.

Importante: caso novas informações, como uma nova transportadora, sejam adicionadas posteriormente na Unlock, é necessário salvar novamente a integração na Base para que os novos dados sejam consultados.

4. Como validar a filial

Se a autenticação não for concluída ou a Base não permitir salvar a configuração, verifique se o usuário possui acesso à filial informada.

Para validar:

1. Acesse o portal da Unlock utilizando as mesmas credenciais informadas na Base.
2. Verifique se o usuário possui acesso à filial desejada.
3. Confirme se o ID da filial informado na Base corresponde a uma filial disponível para esse usuário.

Exemplo

Se a configuração da Base utiliza o ID da filial 474, o usuário utilizado na autenticação precisa ter acesso à filial 474 dentro da Unlock.

Se a filial 474 não estiver associada ao usuário, a Base não conseguirá concluir a configuração.

Atenção: se for necessário testar outro usuário, confirme primeiro qual conta deve ser utilizada. Contas administrativas podem ter acesso a várias filiais e, por isso, podem apresentar informações diferentes das disponíveis para o usuário operacional.

5. Problemas comuns na autenticação

A senha está correta, mas não consigo salvar a integração

A senha pode estar correta e a conexão com a Unlock ter sido estabelecida normalmente. Nesse caso, o problema pode estar relacionado às permissões do usuário.

Verifique se o usuário possui acesso à filial informada no campo ID da filial.

A filial não é validada pela Base

A Base não apresenta uma lista de filiais para seleção. O ID da filial é informado manualmente e a Base verifica se esse ID está associado ao usuário autenticado.

Nesse caso:

1. Acesse a Unlock com o mesmo usuário e senha.
2. Verifique quais filiais estão disponíveis para o usuário.
3. Confirme o ID da filial que deve ser utilizado.
4. Caso necessário, solicite ao administrador da Unlock que associe a filial ao usuário.
5. Retorne à Base e realize novamente a autenticação.

---

6. Informações importantes sobre a integração

Operação somente no Brasil

A integração foi desenvolvida para operações realizadas no Brasil.

Nota fiscal obrigatória para expedição

Para que um pedido seja enviado à Unlock, é necessário que exista uma NF-e aprovada, com o respectivo XML autorizado pela SEFAZ.

Além disso, o CPF/CNPJ do cliente é obrigatório.

Produtos precisam estar vinculados

Antes de enviar pedidos para a Unlock, os produtos da Base precisam estar vinculados aos respectivos produtos cadastrados na Unlock.

Sem esse vínculo, o pedido não poderá seguir para expedição.

Etiqueta de envio

A Unlock não gera nem imprime a etiqueta de envio.

A etiqueta deve ser obtida de um envio de transportadora já criado no mesmo pedido da Base ou adicionada manualmente por meio de um arquivo.

São aceitos formatos como PDF e ZPL.

Por padrão, o pedido precisa possuir uma etiqueta para seguir no processo. Caso a operação não exija etiqueta, essa obrigatoriedade pode ser desativada nas configurações da integração.

Importante: o campo Transportadora da integração com a Unlock indica qual transportadora a Unlock deve utilizar na operação. Ele não é a origem da etiqueta.

Processo de envio do pedido

Os pedidos enviados para a Unlock seguem uma sequência de etapas:

1. Criação do cliente;
2. Criação do pedido;
3. Aprovação do pagamento;
4. Alteração do status para Preparando para entrega;
5. Registro da nota fiscal;
6. Alteração do status para Faturado;
7. Associação da etiqueta de envio, quando uma etiqueta for necessária ou estiver disponível.

Se alguma dessas etapas falhar, o pedido poderá permanecer como incompleto na Unlock.

Sem recebimento de mercadorias

A integração contempla operações de saída. Não há suporte para fluxos de entrada de mercadorias.

Atualmente, a integração contempla:

• Pedidos de saída;
• Produtos;
• Níveis de estoque.

7. Resumo

Para autenticar corretamente a Unlock na Base, utilize as credenciais de acesso ao portal da Unlock e informe o ID da filial à qual o usuário possui acesso.

A principal validação em caso de erro de autenticação é verificar se o ID informado corresponde a uma filial realmente disponível para o usuário utilizado.

Importante: ter acesso ao portal da Unlock não significa, necessariamente, ter acesso a todas as filiais. O usuário precisa estar vinculado especificamente à filial informada na Base.