1. Garantir que os produtos estejam cadastrados em ambos sistemas (na Vnda e no Shop9) com os mesmos códigos.
2. Solicitar ao cliente que envie os seguintes dados, que podem ser consultados no painel da shop 9 instalado no computador do cliente:
Endereço da API
Porta
Código da filial
Número de série
Senha
Código de operação
Código caixa
Código da conta bancária
3. Testando o IP e porta:
Fazer um teste alterando os dados da url abaixo e pesquisando no navegador:
https://[URL ou IP]:[Porta]/auth?serie=[Número de Série]&codfilial=[Código da Filial]
Copiar a url e pesquisar no navegador, caso esteja acessando normalmente, deve retornar a seguinte mensagem:
{"sucesso":true,"mensagem":null,"tipo":null,"complementoTipo":null,"statusCode":200,"dados":{"token":"SElEQVBBLTQwMDc3MS1CT0RFMDAwNw0KYWRtaW4NCjYzNzI1NzcyNDQxMDA4NjYxMQ0KTW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNjkuMC4zNDk3LjkyIFNhZmFyaS81MzcuMzY=:gqYFo/ozgrzv3LcYs5q2pP9b8vTd5Wq94GFTkZIogBA=","expireAt":"2020-05-23T07:27:21.0086611+00:00"}}
Confirmação do IP: Verifique corretamente o IP da máquina onde o módulo Integrações será executado. Para isso, acesse https://meuip.com.br/.
Nesse site também é possível testar se a porta está aberta, basta preeencher com o IP e porta fornecida, o retorno deve ser de "acessível": https://www.testeportas.com.br
Para a liberação dessa porta é preciso que o seller em contato com a provedora de internet.
Outro ponto importante, é necessário que o módulo Integrações esteja em execução na Shop9.
4. Realizar o cadastro aqui: https://hub.vnda.com.br/ (login no Keeper)
- Host: preencher com o host da loja (ex: www.nomedaloja.com)
- Integração: Shop9
- Identificador do pacote: Deixar em branco
- Prefixo do Pedido: Deixar em branco
- Restaurar estoque em caso de falha?: Não
- Reservar estoque em caso de falha?: Não
- Zerar estoque de SKUs não encontrados no ERP? Não
- Status para encaminhar para outras integrações: Deixar em branco
- Sincronizar estoque com o: Ecommerce
- Endereço da API: Enviado pelo Cliente, deve ter: [Url do serviço]:[Porta]
- Número de série: Enviado pelo Cliente
- Código da filial: Enviado pelo Cliente
- Senha: Enviado pelo Cliente
- Código de operação: Enviado pelo Cliente
- Código caixa: Enviado pelo Cliente
- Código da conta bancária: Enviado pelo Cliente
- Integrar estoque automaticamente: Sim para ativar a atualização de estoque (sempre validar com o cliente dado que a ativação pode alterar todo o estoque da loja)
5. Cadastro do hook no admin:
Com um e-mail @vnda você deverá acessar admin > configurações > hook e cadastrar um hook de order-confirmed e como url utilizar hook disponível no HUB ao lado do nome da marca
6. Enviar um pedido teste para o ERP e pedir para o cliente validar os dados do pedido que entrou (principalmente informações de frete e pagamento que podem necessitar de um mapeamento)
6. Possíveis mapeamentos para a integração;
6.1 : Tipo de entrega:
De (Vnda): valor entre () na informação de entrega do pedido.
Para (Shop9): CNPJ cadastrado na forma de entrega (Enviado pelo Cliente)
Obs: É importante que sedex e pac tenham cnpj's diferentes para distinguir a forma do envio na importação do pedido
6.2: Transportadora:
De (Vnda): valor fora do () na informação de entrega do pedido.
6.3: Condição de Pagamento
De (Vnda): Pix, Boleto, Cartão de crédito
Para (shop): Conforme tabela abaixo:
6.4: Meio de pagamento
De (Vnda): Concatenando (nome do adquirente/subadquirent + nome bandeira + condição)
Exemplos:
pagar.me - Pix, pagarme Mastercard - Crédito parcelado, pagarme Mastercard - Crédito a vista, cielo_v3 Mastercard - Crédito parcelado, pagseguro Hipercard - Crédito parcelado.
Para (Shop9): Deve solicitar para o seller lhe enviar a tabela desse cadastro onde devemos identificar os códigos na primeira coluna, conforme imagem de exemplo abaixo:
7 - Tópicos complementares:
Essa é a documentação de API: https://www.idealsoft.com.br/integracoes/
Abaixo um exemplo de cUrl para chamada de estoque. Importante atualizar os parâmetros no header "timestamp" e "signature" quando for utilizar, como sugestão, para gerar esses parâmetros pode-se cnsultar uma IA.
curl --location 'http://45.4.182.38:60000/estoque?codigoProduto=10431' \
--header 'CodFilial: 1' \
--header 'serie: HIFAPA-455764-MNWC' \
--header 'timestamp: 1746467797' \
--header 'signature: DjyY1NoPf9R06dx6XVpq71KHGIRyQYNCEhuxM8sw1Tg=' \
--header 'Authorization: TokenSElGQVBBLTQ1NTc2NC1NTldDMDAwMQ0KYWRtaW4NCjYzODgyMTQ4MTkwNTg4MDUzOA0KUG9zdG1hblJ1bnRpbWUvNy40My40:ZpdMzkXQbOCzxexzGUU7ZVUI73CpVrGgXhbjiL02Dkc='
É bem comum existir mais de uma filial de estoque na Shop9. Caso ocorra alguma divergência do estoque consultado em relação a filial que o seller deseja sincronizar com o ecommerce, deve ser realizado um ajuste pelo seller no módulo de integração da Shop9, trata-se do campo "FILIAL_EXPORTAR" conforme prints abaixo:
