Conectar o Cin7: receber pedidos e clientes, consultar estoque
No Cin7 Omni, em go.cin7.com, abra uma API connection e anote seu usuário e senha, preencha apenas esses dois campos no Integration, teste, mapeie e ative: entram pedidos de venda e clientes e o estoque pode ser consultado.
O conector do Cin7 traz pedidos de venda e clientes do Cin7 Omni para este sistema e pode consultar as quantidades de estoque mantidas no Cin7, incluindo quantidades disponíveis e em mãos. Ele lê dados do Cin7: não devolve alterações de estoque ao Cin7 e não escreve pedidos nem clientes de volta no Cin7. Não há campo de endereço para preencher: o conector usa sempre o endereço oficial da API do Cin7. Uma conexão usa uma API connection do Cin7.
Pré-requisitos#
- Uma conta do Cin7 Omni à qual você consiga entrar em go.cin7.com.
- Permissão no Cin7 para abrir ou criar uma API connection. O usuário e a senha desta integração vêm dessa API connection.
- O ponto-chave antes de começar: o usuário e a senha da API não são sua conta de acesso ao Cin7. Preencher o e-mail e a senha que você usa para entrar no Cin7 não vai conectar.
- Considere os limites da API do Cin7 ao planejar a frequência de extração: 3 solicitações por segundo, 60 por minuto e 5.000 por dia.
Obter credenciais#
- Entre no Cin7 Omni em go.cin7.com.
- Abra a área de API connection e abra a API connection que você quer usar para esta integração, ou crie uma nova.
- Anote o usuário dessa API connection. Esse usuário é gerado para a API connection e é usado para a autenticação Basic: não é seu nome de acesso ao Cin7.
- Anote a senha de API definida nessa mesma API connection. O usuário e a senha devem vir da mesma API connection: não misture valores de duas conexões diferentes.
Preencher no Integration#
- Abra Integration → Marketplace → Cin7 → Nova conexão.
- username, obrigatório, usuário da API do Cin7: preencha o usuário da API connection do Cin7. O texto de ajuda do campo diz API username.
- password, obrigatório, senha da API do Cin7: preencha a senha de API definida nessa mesma API connection. É um campo do tipo senha e é guardado como segredo.
- Não há mais nada para preencher. Esta conexão não tem campo de endereço: ela se conecta sempre ao endereço oficial https://api.cin7.com/api, então não procure onde alterá-lo.
Testar a conexão#
Clique em Testar a conexão. Se username ou password estiver ausente, o teste para e informa o campo ausente antes de enviar qualquer solicitação, porque a autenticação Basic precisa dos dois valores. Caso contrário, o teste envia uma solicitação com autenticação Basic para ler a lista de filiais, GET https://api.cin7.com/api/v1/Branches, a leitura mais leve do Cin7. Uma resposta 200 significa que a conexão funciona. Uma resposta 401 significa que as credenciais são inválidas. Uma resposta 403 significa que as credenciais foram aceitas, mas esta API connection não tem permissão para esse recurso: 401 e 403 apontam para correções diferentes, então leia o código antes de mudar qualquer coisa. O teste expira após 12 segundos.
Mapping / escolher modelo#
Escolha o mapping padrão do Cin7. Os pedidos de venda são lidos dos dados de pedidos de venda do Cin7, os clientes dos dados de contatos do Cin7 e as consultas de estoque leem os dados de estoque do Cin7. Depois que o teste aprovar, execute uma extração e confira um pedido real lado a lado (número do pedido, cliente, linhas e quantidades), confira um registro de cliente e compare a quantidade de um produto com o que o Cin7 mostra, antes de ativar. Se um campo dos seus pedidos diferir, ajuste esse campo no mapping em vez de mudar registros no Cin7.
Ativar#
Após ativar, a conexão traz pedidos de venda e clientes do Cin7 para este sistema na frequência definida, dentro dos limites do Cin7 de 3 solicitações por segundo, 60 por minuto e 5.000 por dia, e as consultas de estoque leem as quantidades atuais do Cin7. Acompanhe as primeiras extrações em Runs / Logs e compare com o Cin7 antes de deixar a conexão sem supervisão.
O que esta conexão não faz: não devolve alterações de estoque ao Cin7 e não escreve pedidos, clientes nem resultados de fulfillment de volta no Cin7. Continue cuidando disso no próprio Cin7, ou nos sistemas onde o trabalho realmente acontece.
Perguntas frequentes#
O teste falha com 401: credenciais inválidas
O Cin7 rejeitou a autenticação Basic. O usuário ou a senha não corresponde a nenhuma API connection do Cin7, normalmente porque foi preenchido o e-mail e a senha de acesso ao Cin7, ou porque o usuário e a senha vêm de duas API connections diferentes.
No Cin7 Omni, em go.cin7.com, abra a API connection, copie seu usuário exatamente no campo username, defina ou copie a senha de API dessa mesma conexão no campo password, salve e teste novamente. Não use sua senha de acesso ao Cin7.
O teste falha com 403: esta API connection não tem permissão para esse recurso
Isso é diferente do 401: o Cin7 aceitou as credenciais, mas a API connection não tem permissão para ler a lista de filiais usada pelo teste. Mudar a senha novamente não vai corrigir um 403.
No Cin7, revise o acesso dado a esta API connection e permita que ela leia os recursos de que a conexão precisa, ou mude para uma API connection que já tenha esse acesso. Mantenha o mesmo par de usuário e senha dessa conexão, salve e teste novamente.
O teste para antes de enviar uma solicitação e informa um campo ausente
username ou password está vazio. O teste precisa dos dois valores para a autenticação Basic, então ele para em vez de enviar uma solicitação que o Cin7 só pode rejeitar.
Preencha os dois campos a partir da mesma API connection do Cin7 (o usuário da conexão e a senha definida nessa mesma conexão), salve e teste novamente.
Preenchi minha conta de acesso ao Cin7, mas não conecta
A conta de acesso e as credenciais da API connection são duas coisas diferentes no Cin7. Esta conexão se autentica apenas com o usuário e a senha de uma API connection, então uma conta de acesso perfeitamente válida continua falhando aqui.
Vá para go.cin7.com → API connection no Cin7 Omni, abra ou crie uma API connection e use seu usuário e sua senha de API no Integration em vez dos seus dados de acesso. Depois teste novamente.
Conectado, mas nenhum pedido de venda chega
A conexão está funcionando (o teste leu a lista de filiais com sucesso), mas não há nada novo para trazer: o Cin7 não tem pedidos de venda novos no intervalo de extração, ou os registros existentes não são pedidos de venda.
Crie ou confirme um pedido de venda no Cin7, execute uma extração manual e confirme que o pedido aparece na prévia ou em Runs / Logs. Mantenha a frequência de extração dentro dos limites indicados acima.
A consulta de estoque não retorna quantidade para um produto
A conexão consegue ler o estoque no Cin7, mas esse produto não tem um registro de estoque correspondente para ler, ou o código do produto no mapping não corresponde ao produto no Cin7. O teste pode aprovar enquanto um produto específico continua sem nada para retornar.
Verifique primeiro o produto e seu registro de estoque no Cin7, depois verifique o código do produto desse item no mapping e corrija para corresponder ao Cin7. Execute a consulta de estoque novamente só para esse produto.