Introdução

A ferramenta de webservice da Moovin dispõe de uma plataforma para integração com sistemas externos independente da linguagem de programação utilizada. Os dados da requisição via POST poderão ser enviados em formato JSON ou XML.

Lista de Métodos

Você poderá verificar todos os nossos métodos disponíveis clicando aqui.

Tabela de Retorno

Veja nossa tabela de retorno clicando aqui. Nela você terá acesso a todos os retornos das requisições enviadas.

Endereço e Token de Webservice

O endereço do webservice é constituído da seguinte URL abaixo:
http://sualoja.integration.moovin.com.br/webservice/nomeDoMetodo.

Substitua o termo sualoja na URL pelo nome do domínio da loja na qual deseja integrar e nomeDoMetodo pelo nome do método utilizado no webservice.

O Token estará disponível no painel administrativo acessando o menu Configurações > Webservice.

Limite de Requisições

O limite de requisição para o webservice deve ser até 60 registros enviados por minuto. Não podendo enviar diversos skus na mesma requisição. Adequar-se para enviar um SKU por requisição.

Consultando Informações

O webservice dispõe de diversos métodos para consulta de informações. Todos os métodos de resgate de informações (métodos get) suportam o envio de filtros de busca. A estrutura de filtros de cada método varia de acordo com o tipo de dados enviado para a requisição. Abaixo segue exemplos de como aplicar o filtro em cada um dos tipos:

XML:

<filtros>
   <filtro1>valor</filtro1>
   <filtro2>valor</filtro2>
</filtros>

JSON:

{
   "filtro1": "valor",
   "filtro2": "valor"
}

Definição do Tipo de Retorno

O tipo de retorno é definido no endpoint da URL de endereço, os tipos possíveis são JSON e XML. Exemplos usando os tipos possíveis de retorno:

Retorno usando JSON: http://sualoja.integration.moovin.com.br/webservice/nomeDoMetodo/json

Retorno usando XML: http://sualoja.integration.moovin.com.br/webservice/nomeDoMetodo/xml

Caso não seja fixadoo um formato de retorno, coletaremos a formatação da requisição (data) do envio e retornaremos no mesmo formato.

JSON:

{
   error: "codigo",
   message: "Mensagem de retorno"
}

XML:

<response>
   <error>codigo</error>
   <message>Mensagem de retorno</message>
</response>

Exemplo de Requisição Via Postman

Todos os métodos deverão ser enviados via POST.
Os parâmetros token e data devem estar localizados no Body.
O campo data servirá para conter o filtro caso for um método get ou como envio caso for um método de update ou save.
Caso for get, é obrigatório enviar pelo menos um filtro. Exemplo na imagem abaixo.

Clique na imagem para ampliar.

Precisa de ajuda? Clique aqui e veja como falar conosco.