Introdução
A ferramenta de webservice da Moovin dispõe de uma plataforma POST 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. O formato de retorno será igual ao formato enviado, ou poderá ser definido apenas acrescentando ao final da URL o tipo de formato:
Endereço de web service
O endereço do webservice é constituído da seguinte URL, substitua a sualoja pelo nome da loja e nomeDoMetodo pelo nome do método utilizado no web service.
http://sualoja.integration.moovin.com.br/webservice/nomeDoMetodo
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/json
- Retorno usando XML: http://sualoja.integration.moovin.com.br/webservice/xml
Consultando informações
...
Introdução
A ferramenta de webservice da Moovin dispõe de uma plataforma POST 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. O formato de retorno será igual ao formato enviado, ou poderá ser definido apenas acrescentando ao final da URL o tipo de formato:
Endereço de web service
O endereço do webservice é constituído da seguinte URL, substitua a sualoja pelo nome da loja e nomeDoMetodo pelo nome do método utilizado no web service.
http://sualoja.integration.moovin.com.br/webservice/nomeDoMetodo
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/json
- Retorno usando XML: http://sualoja.integration.moovin.com.br/webservice/xml
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 suportam o envio de filtros de busca. Na descrição dos métodos abaixo, será listado o nome e os filtros que cada um suporta.
...
Expand | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
Get Reservas Estoque
|
Nome | Tipo | Descrição |
limite | Integer(10) | Define quantos resultados serão exibidos na consulta. Caso seja informado um número maior que 100, ele retornará 30. |
pagina | Integer(10) | Define de qual resultado ele começará a exibir resultados. |
sku | String(100) | Caso seja informado, retornará apenas as informações de estoque daquele produto. Caso queira consultar mais skus, insira diversos skus nesta tag separado por vírgula |
id_reserva | Integer(10) | Identificador da reserva |
data_reserva_de | String(100) | Busca a partir desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_reserva_ate | String(100) | Busca a até desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_liberacao_de | String(100) | Busca a partir desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_liberacao_ate | String(100) | Busca a até desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<reservas> <reserva> <id>123</id <codigo_pedido>1000</codigo_pedido> <codigo_produto>12212</codigo_produto> <status>Criado</status> <qtd>1</qtd> <loja>01</loja> </reserva> <reserva> <id>124</id> <codigo_pedido>1000</codigo_pedido> <codigo_produto>122121</codigo_produto> <status>Liberado</status> <qtd>1</qtd> <loja>02</loja> </reserva> <reservas> |
...
Expand | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
Get Quantidade Estoque
|
Nome | Tipo | Descrição |
limite | Integer(10) | Define quantos resultados serão exibidos na consulta. Caso seja informado um número maior que 100, ele retornará 30. |
pagina | Integer(10) | Define de qual resultado ele começará a exibir resultados. |
produto_codigo_tamanho | String(100) | Caso seja informado, retornará apenas as informações de estoque daquele produto. |
data_modificacao_de | String(19) | Busca a partir desta data. (Y-m-d h:m:s): `2015-12-20`, `2016-02-13 00:00:00` |
data_modificacao_ate | String(19) | Busca até essa data. (Y-m-d h:m:s): `2015-12-20`, `2016-02-13 00:00:00` |
Exemplo de retorno XML:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8" ?> <estoques> <estoque> <produto_codigo_tamanho>1000028401889</produto_codigo_tamanho> <qtd>4</qtd> <cod_loja>loja-1</cod_loja> </estoque> <estoque> <produto_codigo_tamanho>1000028401889</produto_codigo_tamanho> <qtd>10</qtd> <cod_loja>02</cod_loja> </estoque> </estoques> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "estoque":[ { "produto_codigo_tamanho":"720162", "qtd":"10", "cod_loja":1 }] } |
...
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get ImagensMétodoO nome do método utilizado na consulta é getImagens. DescriçãoEste método retorna uma listagem com as imagens dos produtos. FiltrosOs filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
RetornoOs retornos são organizados em uma tabela contendo grupo do campo, nome, tipo, e descrição de cada campo.
Exemplo de retorno XML:
|
...
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get PedidosMétodoO nome do método utilizado na consulta é getPedidos FiltrosOs filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
Observações:
RetornoOs retornos são organizados em uma tabela contendo grupo do campo, nome, tipo, e descrição de cada campo.
|
...
Expand | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||
Get TamanhoMétodoO nome do método utilizado na consulta é getTamanho. DescriçãoEste método retorna uma listagem com os tamanhos cadastrados. FiltrosOs filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
|
...
Expand | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
Get CorMétodoO nome do método utilizado na consulta é getCor. DescriçãoEste método retorna uma listagem com os produtos e suas variações de cores cadastradas. FiltrosOs filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
|
...
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Save ProdutosMétodoO nome do método utilizado na consulta é saveProdutos. DescriçãoSalva os produtos enviados. Caso um produto já exista, o webservice irá atualizar as informações se o nos dados estiver o campo atualiza com o valor 1. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
Observações¹ O array caracteristicas deve ser colocado no nível da categoria correspondente. Exemplo: Um televisor de 50 polegadas tela LCD, da categoria principal Televisores e categoria filho Tela LCD deve conter as caracteristicas respectivas a categoria filho Tela LCD. ² Deve ser enviado o nome do atributo OU o código do atributo. Um dos dois é obrigatório o envio.
|
...
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Save NfeMétodoO nome do método utilizado na consulta é saveNfe. DescriçãoSalva ou atualiza a nota fiscal de um pedido e altera o status do pedido para faturado. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
ObservaçõesCaso seja passado o campo status_pedido com um valor diferente de zero, o pedido será atualizado para o status correspondente cadastrado na plataforma. Se não for enviado o código, será usado o status padrão nas configurações de webservice na subseção saveNfe.
ObservaçõesCaso seja passado o campo status_pedido com um valor diferente de zero, o pedido será atualizado para o status correspondente cadastrado na plataforma. Se não for enviado o código, será usado o status padrão nas configurações de webservice na subseção saveNfe.
|
Expand | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
Save EanMétodoO nome do método utilizado na consulta é saveEan. DescriçãoAtualiza o código EAN de um produto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
| |||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
Save EanMétodoO nome do método utilizado na consulta é saveEan. DescriçãoAtualiza o código EAN de um produto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | |||||||||||||||||||||||||||
Nome | Tipo | Descrição | |||||||||||||||||||||||||
produto_codigo_tam (*) | String(50) | Código do produto a ser atualizado(Código da variação de tamanho) | ean13 (*) | Integer(13) | Código EAN do produto a ser atualizado
ean13": "12132311221"
},
{
"produto_codigo_tam": "22222222",
"ean13": "212121212121"
}
]
} |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Save CupomMétodoO nome do método utilizado na consulta é saveCupom. DescriçãoSalva o cupom de desconto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Save CupomMétodoO nome do método utilizado na consulta é saveCupom. DescriçãoSalva o cupom de desconto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nome | Tipo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
codigo(*) | String(50) | Código de identificação do cupom. Esse código deve ser único. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipos_pagamento | String(100) | Tipos de pagamentos permitidos para ser usado o cupom. São eles: cartao_credito - Cartão de crédito, transferencia - Transferência, boleto - Boleto bancário, sistema_pagamento - Sistema de pagamento, deposito - Depósito em conta, cartao_debito - Cartão de débito, dinheiro - Dinheiro, multiplos_cartoes_credito - Múltiplos cartões, multiplos_cartoes_credito_boleto - Múltiplos cartões + Boleto Caso não seja enviada a tag, ou envie com o valor “all”, irá selecionar todas. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cliente_cpf_cnpj | String(20) | CPF ou CNPJ do cliente. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_desconto(*) | Float(9,2) | Valor de desconto que será aplicado, de acordo com o tipo. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipo_desconto(*) | String(10) | Tipo de desconto que será aplicado - “percentual” ou “valor” | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_normal_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Normal” Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_expresso_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Expresso” Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_economico_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Economico” Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_minimo_compra | Float(9,2) | Valor mínimo para utilizar o cupom. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_maximo_compra | Float(9,2) | Valor máximo para utilizar o cupom. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
validade_inicio | Datetime | Data de validade inicial do cupom. Formato: Y-m-d H:i:s | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
validade_fim | Datetime | Data de validade final do cupom. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipo_utilizacao(*) | String(20) | Tipo de utilização do cupom. Valores: “unica_geral”, “unica_cliente”, “livre”. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_produto_com_desconto | Integer(1) | Define se permite se utilizado o cupom com produtos que já possuem desconto. Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
descricao | String(150) | Descrição do cupom. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
observacao_cliente | String(150) | Mensagem que será exibida para o cliente ao adicionar cupom. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_pontos_na_compra | Integer(1) | Permite gerar pontos ao usar o cupom. Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_uso_kit | Integer(1) | Permite o uso do cupom em kits. Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_uso_produtos_pre_venda | Integer(1) | Permite uso em produtos de pré-venda. Valores: 1 - Permite; 0 - Não permite. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status(*) | Integer(1) | Status do cupom Valores: 1 - Ativo; 0 - Inativo. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categorias | String | Categorias em que será permitido o uso do cupom. Deve ser enviado o nome exato da(s) categoria(s). Caso desejar adicionar mais de uma, enviar separando-as por vírgula. Caso não seja enviado nada ou “all” na tag, irá selecionar todas. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
produtos | String | Produtos em que será permitido o uso do cupom. Deve ser enviado o SKU (Código que fica na aba 02. Estoque). Caso desejar adicionar mais de um, enviar separando os SKU’s por vírgula. | marcas | String |
| |||
<data>
<codigo>Teste12345</codigo>
<tipos_pagamento>cartao_credito,boleto</tipos_pagamento>
<cliente_cpf_cnpj>25731394334</cliente_cpf_cnpj>
<valor_desconto>10</valor_desconto>
<tipo_desconto>percentual</tipo_desconto>
<frete_normal_gratis>0</frete_normal_gratis>
<frete_expresso_gratis>0</frete_expresso_gratis>
<frete_economico_gratis>1</frete_economico_gratis>
<valor_minimo_compra>100</valor_minimo_compra>
<valor_máximo_compra>500</valor_máximo_compra>
<validade_inicio>2018-05-20 00:00:00</validade_inicio>
<validade_fim>2018-05-30 00:00:00</validade_fim>
<tipo_utilizacao>livre</tipo_utilizacao>
<permite_produto_com_desconto>1</permite_produto_com_desconto>
<descricao>Teste Teste</descricao>
<observacao_cliente>olá</observacao_cliente>
<permite_pontos_na_compra>0</permite_pontos_na_compra>
<permite_uso_kit>0</permite_uso_kit>
<permite_uso_produtos_pre_venda>0</permite_uso_produtos_pre_venda>
<status>1</status>
<produtos>1223,123</produtos>
<marcas>Adidas</marcas>
<categorias>Tênis,Sapatênis</categorias>
</data> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"codigo": "Teste12345",
"tipos_pagamento": "cartao_credito,boleto",
"cliente_cpf_cnpj": "25731394334",
"valor_desconto": 10,
"tipo_desconto": "percentual",
"frete_normal_gratis": 0,
"frete_expresso_gratis": 0,
"frete_economico_gratis": 1,
"valor_minimo_compra": 100,
"valor_maximo_compra": 500,
"validade_inicio": "2018-05-20 00:00:00",
"validade_fim": "2018-05-30 00:00:00",
"tipo_utilizacao": "livre",
"permite_produto_com_desconto": 1,
"descricao": "Teste Teste",
"observacao_cliente": "Teste",
"permite_pontos_na_compra": 0,
"permite_uso_kit": 0,
"permite_uso_produtos_pre_venda": 0,
"status": 1,
"produtos": "1223,123",
"marcas": "Adidas",
"categorias": "Tênis,Sapatênis"
} |
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
Save RedirectMétodoO nome do método utilizado na consulta é saveRedirect. DescriçãoSalva os redirecionamentos de urls DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
|
Expand | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
Save Client GroupMétodoO nome do método utilizado na consulta é saveClientGroup. DescriçãoVincula um cliente a um grupo de valores. OBS: O CPF/CNPJ não deve conter caracteres não numéricos nem pontuação e deve ser relativo a um cliente já cadastrado na plataforma. O nome grupo deve ser o mesmo de um grupo previamente cadastrado na plataforma. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
|
Métodos UPDATE
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
Update Status ProdutoO nome do método utilizado na consulta é updateStatusProduto. DescriçãoAtualiza o status de um produto e/ou de suas variações. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
| ||||||||||||||||||
Expand | ||||||||||||||||||
| ||||||||||||||||||
Update Status Produto Método O nome do método utilizado na consulta é updateStatusProduto. DescriçãoAtualiza o status de um produto e/ou de suas variações. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | ||||||||||||||||||
Nome | Tipo | Descrição | ||||||||||||||||
produto_codigo (*) | String(50) | Código do produto a ser atualizado | ||||||||||||||||
status (*) | Integer | Status relacionado ao produto. - 1 para Ativo - 0 para Inativo | ||||||||||||||||
produto_cor | Array | Campo que deve conter as informações de variação de cor dos produtos a ter os status atualizados. | ||||||||||||||||
produto_codigo_cor | String(50) | Código da variação de cor do produto a ser atualizado. | status | Integer |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"codigo": "Teste12345",
"tipos_pagamento": "cartao_credito,boleto",
"cliente_cpf_cnpj": "25731394334",
"valor_desconto": 10,
"tipo_desconto": "percentual",
"frete_normal_gratis": 0,
"frete_expresso_gratis": 0,
"frete_economico_gratis": 1,
"valor_minimo_compra": 100,
"valor_maximo_compra": 500,
"validade_inicio": "2018-05-20 00:00:00",
"validade_fim": "2018-05-30 00:00:00",
"tipo_utilizacao": "livre",
"permite_produto_com_desconto": 1,
"descricao": "Teste Teste",
"observacao_cliente": "Teste",
"permite_pontos_na_compra": 0,
"permite_uso_kit": 0,
"permite_uso_produtos_pre_venda": 0,
"status": 1,
"produtos": "1223,123",
"marcas": "Adidas",
"categorias": "Tênis,Sapatênis"
} |
title | Save Redirect |
---|
Save Redirect
Método
O nome do método utilizado na consulta é saveRedirect.
Descrição
Salva os redirecionamentos de urls
Dados
Os dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
Nome
Tipo
Descrição
url_antiga(*)
String(255)
URL antiga do produto, categoria, marca, página de texto e etc..
status(*)
Status do redirect
Valores:
1 - Ativo;
0 - Inativo.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<urls>
<url>
<url_antiga>https://www.loja.com.br/tenis-nike-0001</url_antiga>
<url_nova>https://www.loja.com.br/tenis-nike-0002</url_nova>
<status>0</status>
</url>
<url>
<url_antiga>https://www.loja.com.br/nike</url_antiga>
<url_nova>https://www.loja.com.br/adidas</url_nova>
<status />
</url>
</urls> |
title | Save Client Group |
---|
Save Client Group
Método
O nome do método utilizado na consulta é saveClientGroup.
Descrição
Vincula um cliente a um grupo de valores.
OBS: O CPF/CNPJ não deve conter caracteres não numéricos nem pontuação e deve ser relativo a um cliente já cadastrado na plataforma. O nome grupo deve ser o mesmo de um grupo previamente cadastrado na plataforma.
Dados
Os dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
Nome
Tipo
Descrição
cpf_cnpj (*)
Integer
Código de indentificação CPF/CNPJ do cleinte.
nome_grupo (*)
String
Nome do grupo de valores.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<root>
<cpf_cnpj>90485774038</cpf_cnpj>
<nome_grupo>Teste</nome_grupo>
</root> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"cpf_cnpj": "0491875002",
"nome_grupo": "Teste"
} |
...
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Update CupomMétodoO nome do método utilizado na consulta é saveCupom. DescriçãoSalva o cupom de desconto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
ObservaçõesNas tags de “limpar”, caso seja enviado 0 e também seja enviado mais algum valor que ainda não esteja cadastrado na respectiva tag do “limpar” (Ex: limpar_produtos -> produtos), irá apenas adicionar mais um item. Caso envie a tag “limpar” como 1, irá remover o que está salvo no momento e adicionar o que foi enviado na respectiva tag. Caso não seja enviado nada, ao limpar, irá selecionar todos.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Update CupomMétodoO nome do método utilizado na consulta é saveCupom. DescriçãoSalva o cupom de desconto. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nome | Tipo | Descrição | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
codigo(*) | String(50) | Código de identificação do cupom. Esse código deve ser único. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipos_pagamento | String(100) | Tipos de pagamentos permitidos para ser usado o cupom. São eles: cartao_credito - Cartão de crédito, transferencia - Transferência, boleto - Boleto bancário, sistema_pagamento - Sistema de pagamento, deposito - Depósito em conta, cartao_debito - Cartão de débito, dinheiro - Dinheiro, multiplos_cartoes_credito - Múltiplos cartões, multiplos_cartoes_credito_boleto - Múltiplos cartões + Boleto Caso não seja enviada a tag, ou envie com o valor “all”, irá selecionar todas. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cliente_cpf_cnpj | String(20) | CPF ou CNPJ do cliente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_desconto(*) | Float(9,2) | Valor de desconto que será aplicado, de acordo com o tipo. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipo_desconto(*) | String(10) | Tipo de desconto que será aplicado - “percentual” ou “valor” | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_normal_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Normal” Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_expresso_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Expresso” Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
frete_economico_gratis | Integer(1) | Permite utilizar o cupom quando houver frete grátis nas modalidades “Economico” Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_minimo_compra | Float(9,2) | Valor mínimo para utilizar o cupom. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valor_maximo_compra | Float(9,2) | Valor máximo para utilizar o cupom. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
validade_inicio | Datetime | Data de validade inicial do cupom. Formato: Y-m-d H:i:s | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
validade_fim | Datetime | Data de validade final do cupom. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tipo_utilizacao(*) | String(20) | Tipo de utilização do cupom. Valores: “unica_geral”, “unica_cliente”, “livre”. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_produto_com_desconto | Integer(1) | Define se permite se utilizado o cupom com produtos que já possuem desconto. Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
descricao | String(150) | Descrição do cupom. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
observacao_cliente | String(150) | Mensagem que será exibida para o cliente ao adicionar cupom. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_pontos_na_compra | Integer(1) | Permite gerar pontos ao usar o cupom. Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_uso_kit | Integer(1) | Permite o uso do cupom em kits. Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
permite_uso_produtos_pre_venda | Integer(1) | Permite uso em produtos de pré-venda. Valores: 1 - Permite; 0 - Não permite. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status(*) | Integer(1) | Status do cupom Valores: 1 - Ativo; 0 - Inativo. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
categorias | String | Categorias em que será permitido o uso do cupom. Deve ser enviado o nome exato da(s) categoria(s). Caso desejar adicionar mais de uma, enviar separando-as por vírgula. Caso não seja enviado nada ou “all” na tag, irá selecionar todas. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
produtos | String | Produtos em que será permitido o uso do cupom. Deve ser enviado o SKU (Código que fica na aba 02. Estoque). Caso desejar adicionar mais de um, enviar separando os SKU’s por vírgula. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
marcas | String | Marcas em que será permitido o uso do cupom. Deve ser enviado o nome exato da(s) marca(s). Caso desejar adicionar mais de uma, enviar separando-as por vírgula. Caso não seja enviado nada ou “all” na tag, irá selecionar todas. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
limpar_marcas | Integer(1) | Define se deve remover as marcas que estão salvas no cupom. Valores: 1 - Limpar; 0 - Não limpar. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
limpar_produtos | Integer(1) | Define se deve remover os produtos que estão salvos no cupom. Valores: 1 - Limpar; 0 - Não limpar. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
limpar_categorias | Integer(1) | Define se deve remover as categorias que estão salvas no cupom. Valores: 1 - Limpar; 0 - Não limpar. |
<data>
<codigo>Teste12345</codigo>
<tipos_pagamento>cartao_credito,boleto</tipos_pagamento>
<cliente_cpf_cnpj>25731394334</cliente_cpf_cnpj>
<valor_desconto>10</valor_desconto>
<tipo_desconto>percentual</tipo_desconto>
<frete_normal_gratis>0</frete_normal_gratis>
<frete_expresso_gratis>0</frete_expresso_gratis>
<frete_economico_gratis>1</frete_economico_gratis>
<valor_minimo_compra>100</valor_minimo_compra>
<valor_maximo_compra>1000</valor_maximo_compra>
<validade_inicio>2018-05-20 00:00:00</validade_inicio>
<validade_fim>2018-05-30 00:00:00</validade_fim>
<tipo_utilizacao>livre</tipo_utilizacao>
<permite_produto_com_desconto>1</permite_produto_com_desconto>
<descricao>Teste Teste</descricao>
<observacao_cliente>olá</observacao_cliente>
<permite_pontos_na_compra>0</permite_pontos_na_compra>
<permite_uso_kit>0</permite_uso_kit>
<permite_uso_produtos_pre_venda>0</permite_uso_produtos_pre_venda>
<status>1</status>
<produtos>1223,123</produtos>
<marcas>Adidas</marcas>
<categorias>Tênis,Sapatênis</categorias>
<limpar_produtos>1</limpar_produtos>
<limpar_marcas>1</limpar_marcas>
<limpar_categorias>1</limpar_categorias>
</data> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"codigo": "Teste12345",
"tipos_pagamento": "cartao_credito,boleto",
"cliente_cpf_cnpj": "25731394334",
"valor_desconto": 10,
"tipo_desconto": "percentual",
"frete_normal_gratis": 0,
"frete_expresso_gratis": 0,
"frete_economico_gratis": 1,
"valor_minimo_compra": 100,
"valor_maximo_compra": 1000,
"validade_inicio": "2018-05-20 00:00:00",
"validade_fim": "2018-05-30 00:00:00",
"tipo_utilizacao": "livre",
"permite_produto_com_desconto": 1,
"descricao": "Teste Teste",
"observacao_cliente": "Teste",
"permite_pontos_na_compra": 0,
"permite_uso_kit": 0,
"permite_uso_produtos_pre_venda": 0,
"status": 1,
"produtos": "1223,123",
"marcas": "Adidas",
"categorias": "Tênis,Sapatênis",
"limpar_produtos": 1,
"limpar_marcas": 1,
"limpar_categorias": 1
} |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Update PedidoMétodoO nome do método utilizado na consulta é updatePedido. DescriçãoAtualiza os dados dos pedidos (1 ou mais pedidos). DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
UpdatePedidoPrecos V2MétodoO nome do método utilizado na consulta é updatePedidoupdatePrecosV2. DescriçãoAtualiza os dados dos pedidos (1 ou mais pedidos)Realiza os mesmos processos do método updatePrecos, porém a requisição deve ser enviada com um produto por vez, para que o retorno seja tratado de forma individual. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | ||||||||||
Nome | Tipo | Descrição | ||||||||
codigo_pedido (*) | Integer(11) | Código do pedido. | ||||||||
codigo_integracao | String(35) | Código de integração do pedido | ||||||||
codigo_rastreio | String(60) | Código de rastreio do pedido. | ||||||||
data_postagem | Datetime | Data da postagem da transportadora. | ||||||||
data_entrega | Date | Data de entrega da transportadora. | ||||||||
codigo_modalidade_envio | Integer(11) | Código da modalidade de envio da transportadora. | ||||||||
uf_transporte | String(2) | UF do transporte. | ||||||||
data_pagamento | Date | Data de pagamento. | ||||||||
codigo_status_pedido | Integer(11) | Status do pedido. | ||||||||
status_transacao | String(30) | Status da transação. | ||||||||
importado | Tinyint(1) | Status de importação do pedido com o ERP ou outros sistemas. 0 - Pedido não sincronizado 1 - Pedido sincronizado | ||||||||
Code Block | ||||||||||
|
Nome | Tipo | Descrição |
produto_codigo_cor | Integer(35) | Codigo de identificação da variação de cor do produto. Esse código deve ser único. |
produto_codigo_tamanho | Integer(35) | Código de identificação da variação de tamanho do produto. Esse código deve ser único. |
preco_custo | Float(12,2) | Valor que será apresentado como preço de custo do produto. Se não for recebido, o valor não será alterado. |
preco_de | Float(12,2) | Valor que será apresentado como preço antigo do produto. Se não for recebido, o valor não será alterado. |
preco_por | Float(12,2) | Valor que será apresentado como preço atual do produto. Se não for recebido ou for recebido com as constantes valor_atual ou [vlr_atual], o valor não será alterado. |
preco_antigo_tamanho | Float(12,2) | Preço antigo do tamanho. Caso enviar essa tag, não enviar as tags preco_de e preco_por |
preco_atual_tamanho | Float(12,2) | Preço atual do tamanho. Caso enviar essa tag, não enviar as tags preco_de e preco_por |
preco_antigo_atacado | Float(12,2) | Preço antigo de atacado. Se não for recebido, o valor não será alterado. |
preco_atual_atacado | Float(12,2) | Preço atual do atacado. Se não for recebido, o valor não será alterado. |
manter_desconto | Integer(1) | Não altera os descontos já aplicados no produto na Moovin. Valores: 1 - Não alterar o desconto; 0 - Alterar o desconto. |
codigo_etiqueta | string(50) | Código para identificação da etiqueta de desconto. Esse código deve ser único. |
desconto_avista | Float(12,2) | Valor de desconto a vista aplicado no produto |
oculta_vlr | Interger(1) | Ocultar valor antigo do produto. Valores: 1 - Ocultar valor; 0 - Não ocultar valor. |
Nome | Tipo | Descrição |
---|---|---|
produto_codigo_cor | Integer(35) | |
produto_codigo_tamanho | Integer(35) | |
preco_custo | Float(12,2) | |
preco_de | Float(12,2) | |
preco_por | Float(12,2) | |
preco_antigo_tamanho | Float(12,2) | |
preco_atual_tamanho | Float(12,2) | |
manter_desconto | Integer(1) | |
codigo_etiqueta | string(50) | |
oculta_vlr |
Observações
O quadro de parâmetros não mostra mas o código identificador da variação de cor ou o código da variação de tamanho é obrigatório, o funcionamento do método varia de acordo com o código recebido.
Se o código da variação de cor for enviado, o preço será atualizado se o produto usa o preço na variação de cor.
Se o código da variação de tamanho for enviado, o preço será atualizado se o produto usa preço por variação de tamanho.
Não é possível enviar a tag "codigo_etiqueta" e "desconto_avista" na mesma requisição.
Update Precos V2
Método
O nome do método utilizado na consulta é updatePrecosV2.
Descrição
Realiza os mesmos processos do método updatePrecos, porém a requisição deve ser enviada com um produto por vez, para que o retorno seja tratado de forma individual.
Dados
Os dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
Nome
Tipo
Descrição
produto_codigo_cor
Integer(35)
Codigo de identificação da variação de cor do produto. Esse código deve ser único.
produto_codigo_tamanho
Integer(35)
Código de identificação da variação de tamanho do produto. Esse código deve ser único.
preco_de
Float(12,2)
Valor que será apresentado como preço antigo do produto. Se não for recebido, o valor não será alterado.
preco_por
Float(12,2)
Valor que será apresentado como preço atual do produto. Se não for recebido ou for recebido com as constantes valor_atual ou [vlr_atual], o valor não será alterado.
manter_desconto
Integer(1)
Não altera os descontos já aplicados no produto na Moovin.
Valores:
1 - Não alterar o desconto;
0 - Alterar o desconto.
codigo_etiqueta
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"pedido": [
{
"codigo_pedido": "107",
"codigo_integracao": "123456790",
"codigo_rastreio": "DU827432251BR",
"data_postagem": "2016-11-21 13:00:00",
"data_entrega": "2016-11-21",
"codigo_modalidade_envio": 32,
"uf_transporte": "RS",
"data_pagamento": "2016-11-21",
"codigo_status_pedido": 4 ,
"status_transacao": "aprovado",
"importado": 1
}
]
} |
title | Update Precos V2 |
---|
<produtos>
<produto>
<produto_codigo_tamanho>12345</produto_codigo_tamanho>
<preco_antigo_tamanho>0.0</preco_antigo_tamanho>
<preco_atual_tamanho>229.9</preco_atual_tamanho>
<codigo_etiqueta>5</codigo_etiqueta>
<manter_descontos>1</manter_descontos>
</produto>
</produtos> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"produto": [
{
"produto_codigo_cor": "12345",
"preco_custo": 100.00,
"preco_de": 200.22,
"preco_por": 300.3,
"preco_antigo_atacado": 200.99,
"preco_atual_atacado": 150.99
}
]
} |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
Update Precos - DescontinuadoMétodoO nome do método utilizado na consulta é updatePrecos. DescriçãoAtualiza os preços de produtos. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: produto_codigo_cor | Integer(35) | produto_codigo_tamanho | Integer(35) | preco_custo
Nome | Tipo | Descrição |
preco_por | Float(12,2)
ObservaçõesO quadro de parâmetros não mostra mas o código identificador da variação de cor ou o código da variação de tamanho é obrigatório, o funcionamento do método varia de acordo com o código recebido. Se o código da variação de cor for enviado, o preço será atualizado se o produto usa o preço na variação de cor. Se o código da variação de tamanho for enviado, o preço será atualizado se o produto usa preço por variação de tamanho. Não é possível enviar a tag "codigo_etiqueta" e "desconto_avista" na mesma requisição. Code Block | | |||||||||||||||||||||||||||||||||||||||||||
|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<produtos> <produto> <produto_codigo_cor>12345-123</produto_codigo_cor> <preco_de>199.99</preco_de> <preco_por>159.99</preco_por> <preco_antigo_atacado>99.99</preco_antigo_atacado> <preco_atual_atacado>79.99</preco_atual_atacado> <codigo_etiqueta>1234</codigo_etiqueta> </produto> <produto> <produto_codigo_cor>6789-123</produto_codigo_tamanho>12345<cor> <produto_codigo_tamanho>6789-123-00</produto_codigo_tamanho> <preco_antigo_tamanho>0tamanho>299.0<99</preco_antigo_tamanho> <preco_atual_tamanho>229tamanho>259.9<99</preco_atual_tamanho> <codigo_etiqueta>5</codigo_etiqueta> <manter_descontos>1</manter_descontos> </produto> </produtos> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "produto": [ { "produto_codigo_cor": "12345-123", "preco_custode": 100199.0099, "preco_depor": 200159.2299, "preco_porantigo_atacado": 30099.399, "preco_antigoatual_atacado": 20079.99, "precocodigo_atual_atacadoetiqueta": 150.99123 } ] } |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdatePrecos - DescontinuadoUser StatusMétodoO nome do método utilizado na consulta é updatePrecos updateUserStatus. DescriçãoAtualiza os preços de produtoso status de um usário pré- cadastrado ou de um grupo de usuários. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:
ObservaçõesO quadro de parâmetros não mostra mas o código identificador da variação de cor ou o código da variação de tamanho é obrigatório, o funcionamento do método varia de acordo com o código recebido. Se o código da variação de cor for enviado, o preço será atualizado se o produto usa o preço na variação de cor. Se o código da variação de tamanho for enviado, o preço será atualizado se o produto usa preço por variação de tamanho. O código do produto é recebido somente para especificar melhor o filtro, em caso de existirem variações de cor com o mesmo código.
Inativando/Ativando usuário pelo E-mail
Inativando/Ativando usuário pelo Nome
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Update User StatusMétodoO nome do método utilizado na consulta é updateUserStatus. DescriçãoAtualiza o status de um usário pré- cadastrado ou de um grupo de usuários. DadosOs dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nome | Tipo | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
String | E-mail de cadastro do usuário | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
grupo | String | Nome do grupo de usuários | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
nome | String | Nome do usuário | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status_atual | String | Status atual do usuário Valores: 1 - Ativo. 0 - Inativo | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data_de_nascimento | Date | Data de nascimento do usuário. Formato: dd/mm/yyyy | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
usuario | String | Login do usuário | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
codigo | Integer(35) | Código do usuário | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
telefone | Varchar(15) | Telefone Residencial do usuário | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
celular | Varchar(15) | Telefone Celular do usuário | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
loja | Varchar(15) | Nome da loja | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | Integer(1) | Define se status do usuário será ativo ou inativo. Valores: 1 - Ativo. 0 - Inativo |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario>
<status_atual>1</status_atual>
<status>0</status>
</usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"usuario": [
{
"status_atual": "1",
"status": "0"
}
]
} |
Inativando/Ativando usuário pela Data de Nascimento
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario>
<data_de_nascimento>01/01/1990</data_de_nascimento>
<status>0</status>
</usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"usuario": [
{
"data_de_nascimento": "01/01/1990",
"status": "0"
}
]
} |
Inativando/Ativando usuário pelo Login
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <email>teste@moovin<usuario>joao.com.br<silva</email>usuario> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "emailusuario": "teste@moovinjoao.com.brsilva", "status": "0" } ] } |
Inativando/Ativando usuário pelo
NomeCódigo
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <nome>João da Silva</nome><codigo>220</codigo> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "nomecodigo": "João da Silva220", "status": "0" } ] } |
Inativando/Ativando usuário pelo
Status AtualTelefone
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <status_atual>1</status_atual><telefone>(51) 99999-9999</telefone> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "status_atualtelefone": "1(51) 99999-9999", "status": "0" } ] } |
Inativando/Ativando usuário
pela Data de Nascimentopelo Celular
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <data_de_nascimento>01/01/1990</data_de_nascimento><celular>(51) 99999-9999</celular> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "data_de_nascimentocelular": "01/01/1990(51) 99999-9999", "status": "0" } ] } |
Inativando/Ativando usuário
pelo Loginpela Loja
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <usuario>joao.silva</usuario><loja>Loja 1</loja> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "usuarioloja": "joao.silvaLoja 1", "status": "0" } ] } |
Inativando/Ativando
usuário pelo Códigogrupo de usuários
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario> <codigo>220< <grupo>gerencia</codigo>grupo> <status>0</status> </usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "usuario": [ { "codigogrupo": "220gerencia", "status": "0" } ] } |
Inativando/Ativando usuário pelo Telefone
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario>
<telefone>(51) 99999-9999</telefone>
<status>0</status>
</usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"usuario": [
{
"telefone": "(51) 99999-9999",
"status": "0"
}
]
} |
Inativando/Ativando usuário pelo Celular
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario>
<celular>(51) 99999-9999</celular>
<status>0</status>
</usuario> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{
"usuario": [
{
"celular": "(51) 99999-9999",
"status": "0"
}
]
} |
Inativando/Ativando usuário pela Loja
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<usuario>
<loja>Loja 1</loja>
<status>0</status>
</usuario> |
Get Reservas E
Método
O nome do método utilizado na consulta é getReservasEstoque.
Descrição
Este método retorna uma listagem com a quantidade de estoque de cada SKU a ser reservado
Filtros
Os filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
Nome | Tipo | Descrição |
limite | Integer(10) | Define quantos resultados serão exibidos na consulta. Caso seja informado um número maior que 100, ele retornará 30. |
pagina | Integer(10) | Define de qual resultado ele começará a exibir resultados. |
sku | String(100) | Caso seja informado, retornará apenas as informações de estoque daquele produto. Caso queira consultar mais skus, insira diversos skus nesta tag separado por vírgula |
id_reserva | Integer(10) | Identificador da reserva |
data_reserva_de | String(100) | Busca a partir desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_reserva_ate | String(100) | Busca a até desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_liberacao_de | String(100) | Busca a partir desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
data_liberacao_ate | String(100) | Busca a até desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’. |
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| Json
| updateUserStatus
| ||||||||
{<reservas>"usuario": [ { "loja": "Loja 1", "status": "0" } ] } Inativando/Ativando grupo de usuários
Code Block | | |||||||||
|
Tabela de retornos
O webservice retorna na requisição duas informações o código e a mensagem, para facilitar a compreensão, nós disponibilizamos uma tabela contendo o código, mensagem e descrição:
...
Código | Mensagem |
0 | Sucesso |
1 | Dados não enviados ou em formato desconhecido |
2 | Método inexistente |
3 | Nenhum resultado encontrado para a busca |
4 | Token não enviado ou incorreto |
5 | Não foi possível identificar a requisição |
6 | Ocorreu um erro interno ao carregar o webservice |
7 | Verifique se os dados foram enviados corretamente |
8 | Data não enviada ou em formato incorreto |
9 | Verifique se os dados dos produtos foram enviados corretamente |
10 | Loja não cadastrada |
11 | Verifique se as categorias foram enviadas em formato correto |
12 | Existem categorias com o nome vazio |
13 | Verifique se todas as categorias tem código |
14 | JSON enviado em formato incorreto |
15 | XML enviado em formato incorreto |
16 | Nenhuma categoria enviada |
17 | Categorias enviadas em formato incorreto |
18 | Nenhuma característica enviada |
19 | Verifique se as características foram enviadas em formato correto |
20 | Nenhum dado recebido |
21 | Verifique se os dados foram enviados de forma correta |
22 | Verifique se todos os pedidos foram enviados com o código de identificação |
23 | Existem pedidos com itens inexistente. Verifique e tente novamente |
24 | Existem pedidos com clientes inexistente. Verifique e tente novamente |
25 | Existem pedidos sem identificação. Verifique por favor e tente novamente |
26 | Ocorreu um erro ao cadastrar o produto, verifique todas as informações |
27 | Verifique se o 'preco_por' ou 'preco_atual_tamanho' foi enviado em todos os produtos |
28 | Verifique se o 'preco_de' ou 'preco_antigo_tamanho'foi enviado em todos os produtos |
29 | Ocorreu um erro interno ao carregar as configurações, por favor, entre em contato. |
30 | Não foi possível atualizar os preços para todos grupos de usuário |
31 | Verifique os marketplaces enviados |
32 | Alguns produtos não existem na Moovin. Preços inalterados. |
33 | Alguns produtos não possuem relação com todos os marketplaces enviados. |
34 | O valor atual de um ou mais produtos esta zerado. |
35 | Alguns produtos não foram atualizados. Erro externo (API). |
36 | Marketplaces validos: b2w,cnova,walmart,mercadolivre |
37 | Os preços devem ser numéricos. |
38 | Na plataforma, verifique se todos os produtos estão com o status ENVIADO para todos os marketplaces. |
39 | Erro ao salvar os dados na Moovin. |
40 | Já existe um registro com algum dos dados informados na requisição que deve ser único na plataforma. |
41 | Código de tamanho do produto inexistente. |
42 | Produto não foi atualizado pois a quantidade enviada é igual a quantidade do produto no estoque da plataforma |
43 | Ocorreu um erro ao salvar o produto |
44 | O pedido não foi encontrado |
45 | Ocorreu um erro ao salvar o pedido |
46 | Código do produto não foi encontrado |
47 | Erro ao salvar categoria |
48 | Método desabilitado. |
49 | Deve ser feito a alteração de um produto por requisição. |
50 | Não é possível alterar os valores do produto pois existe um desconto programado ativo no momento. |
52 | Código inválido, cor ou tamanho do produto. Estes campos não aceitam caracteres especiais. |
70 | Em fila, aguarde alguns minutos para testar novamente. |
71 | Enviado fila. |
...