Page Comparison

Versions Compared

Version	Old Version 191	New Version 192
Changes made by	Suporte	Suporte
Saved on	27 Sep, 2021	27 Sep, 2021

Key

This line was added.
This line was removed.
Formatting was changed.

Introdução

...

Expand

title	Get Reservas Estoque

Get Reservas Estoque

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

theme	Midnight
title	Exemplo de XML - getReservasEstoque
linenumbers	true

<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

title	Get Quantidade Estoque

Get Quantidade Estoque

Método

O nome do método utilizado na consulta é getQuantidadeEstoque.

Descrição

Este método retorna uma listagem com a quantidade de estoque de cada SKU

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.
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

theme	Midnight
title	Exemplo de XML
linenumbers	true

<?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

theme	Midnight
title	Exemplo de Json - getQuantidadeEstoque
linenumbers	true

{
	"estoque":[
	{
		"produto_codigo_tamanho":"720162",
		"qtd":"10",
		"cod_loja":1
	}]
}

...

Expand

title	Get Imagens

Get Imagens

Método

O nome do método utilizado na consulta é getImagens.

Descrição

Este método retorna uma listagem com as imagens dos produtos.

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 a quantidade de registros a retornar.
pagina	Integer(10)	Define de qual resultado ele começará a exibir resultados.
status	Integer(10)	Status do produto: 0 - Inativo 1 - Ativo 2 - Ativo invisível
codigo	String(40)	Busca pelo código do produto.
nome	String(200)	Busca pelo nome do produto.
data_cadastro	String(19)	Busca pela data exata de cadastro dos clientes (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’.
data_cadastro_de	String(19)	Busca a partir desta data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’.
data_cadastro_ate	String(19)	Busca até essa data. (Y-m-d h:m:s): ‘2015-12-20’, ‘2016-02-13 00:00:00’.
produto_codigo_cor	String(35)	Busca pelo código da variação de cor do produto associado à cor da imagem.

Retorno

Os retornos são organizados em uma tabela contendo grupo do campo, nome, tipo, e descrição de cada campo.

Grupo	Nome	Tipo	Descrição
raiz	produtos		Campo principal da estrutura. Todos produtos da consulta são retornados dentro dele.
produtos	produto		Contém os dados referentes a um produto.
produto	codigo	String(40)	Identificador do produto na plataforma.
produto	pos	integer(11)	Ordem de exibição das imagens do produto no site.
produto	imagem	String(200)	Nome da imagem do produto com formato.
produto	imagem_url	String(300)	Url completa da imagem do produto.

Exemplo de retorno XML:

Code Block

theme	Midnight
linenumbers	true

<produtos>
   <produto>
       <codigo>0010010086</codigo>
       <pos>1</pos>
       <imagem>
       smartphone-microsoft-lumia-435-0f630c27b4479e38c17de.jpg
       </imagem>
       <imagem_url>
       http://cloudfront.net/smartphone-microsoft-lumia-435-0f630c27b4479e38c17de.jpg
       </imagem_url>
   </produto>
</produtos>

...

Expand

title	Get Pedidos

Get Pedidos

Método

O nome do método utilizado na consulta é getPedidos

Filtros

Os filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.

Nome	Tipo	Descrição
codigo	String(20)	Busca por um código específico de um pedido
data_de	String(19)	Busca pedidos cadastrados apartir desta data, incluindo a data de filtro (Y-m-d h:m:s).
data_ate	String(19)	Busca pedidos cadastrados até esta data, incluindo a data de filtro (Y-m-d h:m:s)..
cpf_cnpj	String(20)	Busca pelo CPF ou CNPJ do cliente do pedido.
produto_codigo	String(40)	Busca pedidos pelo código dos produtos que ele contém.
produto_codigo_cor	String(40)	Busca pedidos pelo código de cor dos produtos que ele contém.
produto_codigo_tamanho	String(40)	Busca pedidos pelo código de tamanho dos produtos que ele contém.
codigo_vendedor	Integer(11)	Busca pelo código do revendedor ou usuário que realizou a venda. Normalmente definido pelo televendas.
num_transacao	String(250)	Busca pedidos pelo número da transação. Pode ser usado mais de um número de transação separado por vírgula.
codigo_status_pedido	Integer(11)	Busca pedidos pelo código do status atual do pedido. Os códigos podem ser buscados do recurso getStatusPedidos.
limite	Integer(6)	Limita a busca para um número positivo igual ou menor a 100.
pagina	Integer(10)	paginaInteger(10)Filtra a página exibida conforme o limite de produtos que é retornado
data_ultima_atualizacao_de	String(19)	Busca pedidos alterados a partir desta data, incluindo a data de filtro (Y-m-d h:m:s).
data_ultima_atualizacao_ate	String(19)	Busca pedidos alterados até esta data, incluindo a data de filtro (Y-m-d h:m:s).
ordem_data_criacao	String(19)	O valor pode ser DESC (Decrescente) ou ASC (Crescente)
ordem_data_atualizacao	String(19)	O valor pode ser DESC (Decrescente) ou ASC (Crescente)
pedido_troca	Integer(11)	Define se o pedido obteve uma troca ou não. “0” - Não “1” - Sim
Importado	integer(1)	Define se o pedido foi importado pelo ERP ou não. "0" - Não "1" - Sim

Observações:

Não são retornados pedidos inativos (deletados pela plataforma).
Não são retornados pedidos com status “Em compra”.
Não é retornado o filtro de NF gerando uma otimização na consulta com o parâmetro getPedidosV2

Retorno

Os retornos são organizados em uma tabela contendo grupo do campo, nome, tipo, e descrição de cada campo.

Grupo	Nome	Tipo	Descrição
raiz	pedidos		Campo principal da estrutura. Todos pedidos da consulta são retornados dentro dele.
pedidos	pedido		As informações dos pedidos são retornadas dentro deste campo. Cada campo de pedido é referente a um pedido diferente cadastrado na plataforma.
pedido	codigo_pedido	Integer(20)	Número do pedido na plataforma
pedido	data	Datetime	Data e hora da criação do pedido. exemplo: 2015-09-11 17:38:45
pedido	data_ultima_atualizacao	Datetime	Data e hora da atualização do pedido. exemplo: 2015-09-11 17:38:45
pedido	numero_pedido_troca	Integer(11)	Número do pedido que obteve a troca
pedido	taxa_marketplace	Decimal(9.2)	Taxa cobrada pelo pedido de marketplace
pedido	taxa_frete_marketplace	Decimal(9.2)	TAxa de frete cobrada pelo marketplace
pedido	codigo_forma_pagamento	Integer(11)	Identificador da forma de pagamento na plataforma.
pedido	nome_forma_pagamento	Varchar(50)	Descrição formatada da forma de pagamento.
pedido	loja_venda	Varchar(50)	Nome da loja de venda do pedido.
pedido	nome_loja_pagamento	Varchar(50)	Nome formatado da loja de pagamento na plataforma.
pedido	codigo_status_pedido	Integer(11)	Identificador do status atual de pedido.
pedido	descricao_loja_status_pedido	Varchar(150)	Descrição formatada do status de pedido que é exibida na plataforma.
pedido	descricao_cliente_status_pedido	Varchar(200)	Descrição formatada que é exibida para os clientes do Ecommerce.
pedido	status_transacao	Varchar(50)	Descrição do Status de pagamento exibida na plataforma.
pedido	parcelas	Integer(11)	Número de parcelas do pedido.
pedido	valor_acrescimo	Decimal(9,2)	Valor de Acréscimo
pedido	valor_parcial	Decimal(9,2)	Valor parcial do pedido.
pedido	valor_total	Decimal(9,2)	Valor total do pedido com a soma de frete e encargos.
pedido	valor_frete	Decimal(9,2)	Valor total de frete cobrado no pedido.
pedido	valor_presente	Decimal(9,2)	Valor adicional de embalagem para presente.
pedido	valor_taxa_gateway	Decimal(9,2)	Valores adicionais de taxas cobrados pelo gateway.
pedido	forma_pagamento_sistema_pagamento	Varchar(150)
pedido	desconto_bonus	Decimal(9,2)	Valor total de descontos de bônus do pedido.
pedido	desconto_pontos	Decimal(9,2)	Valor total de descontos do sistema de prontos.
pedido	desconto_vlr_compra	Decimal(9,2)	Valor total de outros tipos de desconto. Exemplos: Etiquetas, Boleto, etc.
pedido	desconto_num_pedidos	Decimal(9,2)	Valor total de descontos por número x de compras feitas.
pedido	desconto_cupom	Decimal(9,2)	Valor total de descontos de cupons.
pedido	clearsale_score	Varchar(10)	Score de retorna de análise de risco da Clearsale.
pedido	codigo_cupom_desconto	Varchar(50)	Código identificador de um cupom de desconto vinculado a compra.
pedido	desconto_total	Decimal(9,2)	Soma total dos descontos do pedido.
pedido	cliente_ip	Varchar(30)	Endereço de ip do cliente no momento da compra.
pedido	separado_por_usuario	Varchar(50)	Usuário responsável pela separação do pedido (caso exista).
pedido	data_separado	Varchar(20)	Data e hora da separação. exemplo: 2015-09-11 17:38:45
pedido	navegador	Varchar(25)	Nome do navegador do cliente no momento da compra.
pedido	navegador_versao	Varchar(10)	Versão do navegador do cliente no momento da compra.
pedido	sistema_operacional	Varchar(15)	Sistema operacional do cliente no momento da compra.
pedido	mobile	Tinyint(1)	Define se o acesso foi através de um dispositivo Mobile. “0” - Não “1” - Sim
pedido	meio_ambiente	tinyint(4)	Flag de relação com os pedidos e preservação do meio ambiente.
pedido	pagamento_venc_boleto	Date	Data de vencimento do boleto.
pedido	url_boleto	Varchar(250)	Url do boleto.
pedido	importado	Tinyint(1)	Status de importação do pedido com o ERP ou outros sistemas.
pedido	campanha_id	Integer(11)	Identificador da campanha relacionada ao pedido.
pedido	campanha_ident	Varchar(50)	Identificador da campanha relacionada ao pedido.
pedido	vendedor_nome	Varchar(60)	Identificador do nome do revendedor.
pedido	vendedor_codigo	Integer	Identificador do código do revendedor.
pedido	vendedor_nome	Varchar()	Identificador do nome do revendedor.
pedido	vendedor_codigo		Identificador do código do revendedor.
pedido	pagamento_identificador	Varchar(200)	Identificador do pagamento. Obs: Caso o pedido seja de marketplace o valor será seu identificador no mesmo.
pedido	codigo_revendedor	Varchar(25)	Código do revendedor do pedido. Exemplo: Origem do televendas.
pedido	itens	Array	Contém todos os itens do pedido.
itens	*item*		Cada item se refere a um produto do pedido.
item	codigo	Varchar(35)	Código produto no momento em que o pedido foi efetuado.
item	produto_codigo	Varchar(40)	Código principal do produto cadastrado na plataforma.
item	produto_codigo_cor	Varchar(35)	Código do primeiro nível de variação do produto. Exemplo: Variação de cor.
item	produto_codigo_tamanho	Varchar(35)	Código do segundo nível de variação do produto. Exemplo: Variação de tamanho.
item	id_marketplace_item	Varchar(35)	Código enviado pelo Marketplace Mercado Libre e Colombo
item	qtd	Integer(11)	Quantidade de venda do produto no pedido.
item	cor	Varchar(50)	Nome da cor do produto.
item	tamanho	Varchar(20)	Nome do tamanho do produto.
item	nome_loja	Varchar(200)	Nome da loja de estoque do item.
item	cod_loja	Varchar(30)	Código da loja de estoque do item.
item	valor	Decimal(9,2)	Valor do Item no momento da compra.
item	valor_pago	Decimal(9,2)	Valor final pago pelo item.
item	prazo_entrega_extra	Integer(3)	Dias extra para entrega do produto.
item	nfe_ncm	Varchar(20)	Número do NCM do produto.
item	nfe_origem	Integer(1)	Origem do produto: “0” - Nacional “1” - Importação direta “2” - Importação indireta
item	peso	Varchar(10)	Peso do produto em gramas.
item	presente	Tinyint(1)	Define se o item é um presente: “0” - Não “1” - Sim
item	pre_venda	Integer(1)	Define se o item é de pré-venda: “0” - Não “1” - Sim
item	personalizacao (desenvolvimento)	Varchar(250)	Contém os dados da personalização do item de pedido.
item	data_envio_pre_venda	Date	Data de envio da pré-venda.
item	descricao	Text	Descrição do item no pedido.
pedido	*cliente*		Contém os dados do cliente do pedido.
cliente	codigo	Integer(11)	Identificador do cliente na plataforma.
cliente	nome	Varchar(100)	Nome do cliente na plataforma.
cliente	telefone_residencial	Varchar(15)	Telefone da residência do cliente.
cliente	telefone_celular	Varchar(15)	Telefone celular do cliente.
cliente	telefone_comercial	Varchar(15)	Telefone comercial do cliente.
cliente	cpf_cnpj	Varchar(20)	Número do CPF ou CNPJ do cliente.
cliente	email	Varchar(120)	Endereço de correio eletrônico do cliente (Email).
cliente	data_nasc	Data	Data de nascimento do cliente. Ex: 1992-12-28
pedido	*dados_entrega*		Contém todas as informações de entrega do pedido
dados_entrega	nome	Varchar(100)	Nome do destinatário.
dados_entrega	rg	Varchar(20)	Número do RG do destinatário.
dados_entrega	endereco	Varchar(150)	Endereço do destinatário.
dados_entrega	número	Varchar(10)	Número do endereço do destinatário.
dados_entrega	complemento	Varchar(130)	Complementos de entrega.
dados_entrega	bairro	Varchar(30)	Bairro de entrega.
dados_entrega	cep	Varchar(10)	Número do CEP de entrega.
dados_entrega	cidade	Varchar(50)	Cidade de entrega.
dados_entrega	estado	Varchar(2)	Sigla do estado de entrega.
dados_entrega	email	Varchar(120)	Endereço do correio eletrônico do destinatário.
dados_entrega	instruções	Varchar(100)	Instruções extra para a entrega do pedido.
pedido	*dados_transporte*		Contém os dados referentes ao transporte do pedido.
dados_transporte	modalidade	Varchar(50)	Descrição da modalidade de envio.
dados_transporte	codigo_rastreio	Varchar(60)	Código de rastreamento do pedido.
dados_transporte	valor_transporte	Decimal(9,2)	Valor total do transporte (Valor original cotado na transportadora).
dados_transporte	prazo_entrega	Integer(3)	Prazo de entrega para o pedido.
dados_transporte	codigo_transportadora	Integer(11)	Identificador da modalidade de envio.
dados_transporte	tipo	Integer(1)	Tipo de entrega do pedido: “0” - Normal “1” - Expresso “2” - Loja “3” - Econômico “4” - Pague ao receber
dados_transporte	data_postagem	Date	Data da postagem do pedido.
dados_transporte	data_entrega	Date	Data da entrega do pedido.
pedido	*dados_transacao*		Dados da transação do pedido. Obs: Os dados dentro deste campo só será retornados se houver ao menos uma transação para o pedido. Um pedido pode conter diversas transações.
dados_transacao	transacao
transacao	data	Date
transacao	cod_forma_pagamento	Integer(11)	Identificador da forma de pagamento
transacao	forma_pagamento	Varchar(50)	Nome da forma de pagamento.
transacao	parcelas	Integer(2)	Número de parcelas da transação.
transacao	gateway	Varchar(50)	Nome do gateway da transação.
transacao	valor_total	Decimal(9,2)	Valor total da transação.
transacao	vencimento_boleto	Date	Data de vencimento do boleto.
transacao	mensagem_retorno	Varchar(200)	Mensagem de retorno do gateway.
transacao	codigo_retorno	Varchar(20)	Código de retorno do gateway.
transacao	num_autorizacao	Varchar(200)	Número da autorização do pagamento.
transacao	num_transacao	Varchar(250)	Número da transação.
	adquirente	Varchar(20)	Identificador da adquirente.
transacao	num_comp_venda	Varchar(200)	Número do comprovante de venda do pedido.
transacao	data_pagamento	Date	data de pagamento da transação.
transacao	identificador_conta	Varchar(200)	Identificador da conta. Utilizado no momento para coletar o identificador da conta no Mercado Livre.
transacao	nome_conta	Varchar(200)	Nome da conta. Utilizado no momento para coletar o nome da conta no Mercado Livre.

Code Block

theme	Midnight
linenumbers	true

<filtros>
 <codigo>29355</codigo>
</filtros>

Code Block

theme	Midnight
title	Exemplo JSON - GetPedidoV2
linenumbers	true

{
    "pedidos": [
        {
            "codigo_pedido": "39077",
            "data": "2019-12-23 13:53:30",
            "data_ultima_atualizacao": "2019-12-23 13:53:31",
            "codigo_forma_pagamento": "33",
            "nome_forma_pagamento": "Pagamento Netshoes - Netshoes",
            "loja_venda": "",
            "nome_loja_pagamento": "E-commerce",
            "codigo_status_pedido": "2",
            "descricao_loja_status_pedido": "Pendente",
            "descricao_cliente_status_pedido": "Pendente",
            "status_transacao": "Pendente",
            "pagamento_efetuado": "N",
            "parcelas": "1",
			"valor_acrescimo": "10.00",
            "valor_parcial": "99.89",
            "valor_total": "113.89",
            "valor_frete": "14.00",
            "valor_presente": "0.00",
            "valor_taxa_gateway": "",
            "forma_pagamento_sistema_pagamento": "",
            "desconto_bonus": "0.00",
            "desconto_pontos": "0.00",
            "desconto_vlr_compra": "0.00",
            "desconto_num_pedidos": "0.00",
            "desconto_cupom": "0.00",
            "clearsale_score": "",
            "codigo_cupom_desconto": "",
            "desconto_total": "0.00",
            "cliente_ip": "",
            "qtd_itens": "1",
            "separado_por_usuario": "",
            "data_separado": "0000-00-00 00:00:00",
            "navegador": "",
            "navegador_versao": "",
            "sistema_operacional": "",
            "mobile": "0",
            "meio_ambiente": "0",
            "pagamento_venc_boleto": "0000-00-00",
            "importado": "0",
            "campanha_id": "58",
            "campanha_ident": "marketplace.netshoes",
            "pagamento_identificador": "36488046",
            "codigo_revendedor": "",
			"pedido_troca" "N",
			"numero_pedido_troca": "",
			"taxa_marketplace": "0.00",
			"taxa_frete_marketplace": "0.00",
            "itens": {
                "item": [
                    {
                        "codigo": "10.3318.37",
                        "produto_codigo": "6365667302",
                        "produto_codigo_cor": "6365667302427",
                        "produto_codigo_tamanho": "10.3318.37",
                        "qtd": "1",
                        "cor": "Napa Rosa",
                        "tamanho": "37",
                        "nome_loja": "E-commerce",
                        "cod_loja": "1",
                        "valor": "99.89",
                        "valor_pago": "99.89",
                        "prazo_entrega_extra": "0",
                        "nfe_ncm": "",
                        "nfe_origem": "0",
                        "peso": "1000",
                        "presente": "N",
                        "pre_venda": "N",
                        "personalizacao": "",
                        "data_envio_pre_venda": "0000-00-00",
                        "descricao": "Ref: 5667302 | Tam.: 37 | TÊNIS MOLECA FEMININO | Cor: NAPA ROSA",
                        "id_marketplace_item": ""
                    }
                ]
            },
            "cliente": {
                "codigo": "40897",
                "nome": "Teste Moovin LTDA",
                "telefone_residencial": "(77)777777777",
                "telefone_celular": "(77)777777777",
                "telefone_comercial": "",
                "cpf_cnpj": "012345678910",
                "email": "3089d11903282cda1ce06cfaa76ecb0c@netshoes.com.br",
                "data_nasc": "2019-12-23"
            },
            "dados_entrega": {
                "nome": "Teste de Destinatario",
                "rg": "",
                "endereco": "Avenida Inacio Berwian",
                "numero": "700",
                "complemento": "123456",
                "instrucoes": "Morada do Sol",
                "bairro": "Morada do Sol",
                "cep": "95775000",
                "cidade": "TUPANDI",
                "estado": "RS",
                "email": "3089d11903282cda1ce06cfaa76ecb0c@netshoes.com.br",
                "telefone_residencial": "(77)777777777",
                "telefone_celular": "(88)888888888",
                "telefone_comercial": ""
            },
            "dados_transacao": {
                "transacao": [
                    {
                        "data": "0000-00-00",
                        "cod_forma_pagamento": "33",
                        "forma_pagamento": "Pagamento Netshoes - Netshoes",
                        "parcelas": "1",
                        "gateway": "0",
                        "valor_total": "113.89",
                        "vencimento_boleto": "0000-00-00",
                        "mensagem_retorno": "",
                        "codigo_retorno": "",
                        "num_autorizacao": "",
                        "num_transacao": "",
                        "ident": "799995948",
                        "adquirente": "",
                        "num_comp_venda": "",
                        "data_pagamento": "2019-12-23 13:53:31",
                        "data_aprovacao": ""
                    }
                ]
            },
            "dados_transporte": {
                "modalidade": "Sedex",
                "codigo_rastreio": "",
                "valor_transporte": "14.00",
                "prazo_entrega": "5",
                "codigo_transportadora": "4",
                "tipo": "Expresso",
                "data_postagem": "0000-00-00 00:00:00",
                "data_entrega": "0000-00-00"
            }
        }
    ]
}

...

Expand

title	Get Tamanho

Get Tamanho

Método

O nome do método utilizado na consulta é getTamanho.

Descrição

Este método retorna uma listagem com os tamanhos cadastrados.

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)	Defini a quantidade de registros a retornar
produto_codigo	String(40)	Busca por produtos no estoque que contenham este código
produto_codigo_cor	String(40)	Busca por produtos no estoque que contenham este código de variação de cor
produto_codigo_tamanho	String(40)	Busca por produtos no estoque com um código de variação de tamanho específico
pagina	Integer(10)	Filtra a página exibida conforme o limite de produtos que é retornado
disponivel	Integer(1)	Disponibilidade em estoque do produto 0 - Sem estoque 1 - Com estoque
data_de	Datetime	Busca a partir da data de criação da variação de tamanho
data_até	Datetime	Busca até a data de criação da variação de tamanho

Code Block

theme	Midnight
title	Exemplo JSON - GetTamanho
linenumbers	true

{
    "produtos": [
        {
            "codigo": "000011CT00020007",
            "codigo_cor": "007979",
            "tamanhos": {
                "tamanho": [
                    {
                        "codigo_produto_tamanho": "00797947",
                        "cod_tamanho": "5",
                        "cod_loja": "1",
                        "tamanho": "47",
                        "ean": "7700007979479",
                        "medida1": "0",
                        "medida2": "0",
                        "medida3": "0",
                        "tamanho_descricao": "47",
                        "qtd": "99",
                        "valores": []
                    },
                    {
                        "codigo_produto_tamanho": "00797948",
                        "cod_tamanho": "6",
                        "cod_loja": "1",
                        "tamanho": "48",
                        "ean": "7700007979486",
                        "medida1": "0",
                        "medida2": "0",
                        "medida3": "0",
                        "tamanho_descricao": "48",
                        "qtd": "98",
                        "valores": []
                    },
                    {
                        "codigo_produto_tamanho": "00797949",
                        "cod_tamanho": "7",
                        "cod_loja": "1",
                        "tamanho": "49",
                        "ean": "7700007979493",
                        "medida1": "0",
                        "medida2": "0",
                        "medida3": "0",
                        "tamanho_descricao": "49",
                        "qtd": "94",
                        "valores": []
                    }
                ]
            }
        }
    ]
}

Code Block

theme	Midnight
title	Exemplo XML- GetTamanho
linenumbers	true

<?xml version="1.0" encoding="UTF-8" ?>
<produtos>
    <produto>
        <codigo>000011CT00020007</codigo>
        <codigo_cor>007979</codigo_cor>
        <tamanhos>
            <tamanho>
                <codigo_produto_tamanho>00797947</codigo_produto_tamanho>
                <cod_tamanho>5</cod_tamanho>
                <cod_loja>1</cod_loja>
                <tamanho>47</tamanho>
                <ean>7700007979479</ean>
                <medida1>0</medida1>
                <medida2>0</medida2>
                <medida3>0</medida3>
                <tamanho_descricao>47</tamanho_descricao>
                <qtd>99</qtd>
                <valores />
            </tamanho>
            <tamanho>
                <codigo_produto_tamanho>00797948</codigo_produto_tamanho>
                <cod_tamanho>6</cod_tamanho>
                <cod_loja>1</cod_loja>
                <tamanho>48</tamanho>
                <ean>7700007979486</ean>
                <medida1>0</medida1>
                <medida2>0</medida2>
                <medida3>0</medida3>
                <tamanho_descricao>48</tamanho_descricao>
                <qtd>98</qtd>
                <valores />
            </tamanho>
            <tamanho>
                <codigo_produto_tamanho>00797949</codigo_produto_tamanho>
                <cod_tamanho>7</cod_tamanho>
                <cod_loja>1</cod_loja>
                <tamanho>49</tamanho>
                <ean>7700007979493</ean>
                <medida1>0</medida1>
                <medida2>0</medida2>
                <medida3>0</medida3>
                <tamanho_descricao>49</tamanho_descricao>
                <qtd>94</qtd>
                <valores />
            </tamanho>
        </tamanhos>
    </produto>
</produtos>

...

Expand

title	Get Cor

Get Cor

Método

O nome do método utilizado na consulta é getCor.

Descrição

Este método retorna uma listagem com os produtos e suas variações de cores cadastradas.

Filtros

Os filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.

Nome	Tipo
limite	Integer(10)	Defini a quantidade de registros a retornar
produto_codigo_cor	String(40)	Busca por produtos no estoque que contenham este código de variação de cor
pagina	Integer(10)	Filtra a página exibida conforme o limite de produtos que é retornado
disponivel	Integer(1)	Disponibilidade em estoque do produto 0 - Sem estoque 1 - Com estoque
data_de	Datetime	Busca a partir da data de criação da variação cor
data_ate	Datetime	Busca até a data de criação da variação cor
kit	integer	0 - Não retorna produtos kit 1 - Retorna produtos Kit

Code Block

theme	Midnight
title	Exemplo JSON - GetCor
linenumbers	true

{
    "produtos": [
        {
            "codigo": "06161616",
            "cores": {
                "cor": [
                    {
                        "codigo_produto_cor": "922337203685477580k",
                        "titulo": "Titulo do produto",
                        "descricao": "Descricao do produto",                                       
                        "referencia": "",
                        "pre_venda": "",
                        "qtd": "222",
                        "data": "2019-12-19 11:24:22",
                        "link": "teste",
                        "cod_desconto": "0",
                        "status": "1",
                        "destaque": "",
                        "lancamento": "1",
                        "utiliza_valor_tamanho": "0",
                        "prazo_entrega_extra": "2",
                        "genero": "M",
                        "cor": "Areia",
                        "cor_fabricante": "Preta",
                        "cor_secundaria": "Amarelo",
                        "valores": [
                            {
                                "vlr_antigo": "0.00",
                                "vlr_atual": "173.65",
                                "percentual_desconto": "0.00",
                                "data_inicial": "0000-00-00 00:00:00",
                                "data_final": "0000-00-00 00:00:00"
                            },
                            {
                                "vlr_antigo": "0.00",
                                "vlr_atual": "75.00",
                                "percentual_desconto": "0.00",
                                "data_inicial": "2018-09-17 00:00:00",
                                "data_final": "2018-09-28 00:00:00"
                            },
                            {
                                "vlr_antigo": "81.33",
                                "vlr_atual": "81.33",
                                "percentual_desconto": "16.00",
                                "data_inicial": "0000-00-00 00:00:00",
                                "data_final": "0000-00-00 00:00:00"
                            },
                            {
                                "vlr_antigo": "41.71",
                                "vlr_atual": "41.71",
                                "percentual_desconto": "0.00",
                                "data_inicial": "0000-00-00 00:00:00",
                                "data_final": "0000-00-00 00:00:00"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

Code Block

theme	Midnight
title	Exemplo XML - GetCor
linenumbers	true

<?xml version="1.0" encoding="UTF-8" ?>
<produtos>
    <produto>
        <codigo>06161616</codigo>
        <cores>
            <cor>
                <codigo_produto_cor>922337203685477580k</codigo_produto_cor>
                <referencia />
                <pre_venda />
                <qtd>222</qtd>
                <data>2019-12-19 11:24:22</data>
                <link>demanda-57264</link>
                <cod_desconto>0</cod_desconto>
                <status>1</status>
                <destaque />
                <lancamento>1</lancamento>
                <utiliza_valor_tamanho>0</utiliza_valor_tamanho>
                <prazo_entrega_extra>2</prazo_entrega_extra>
                <genero>M</genero>
                <cor>Areia</cor>
                <cor_fabricante>Preta</cor_fabricante>
                <cor_secundaria>Amarelo</cor_secundaria>
                <valores>
                    <vlr_antigo>0.00</vlr_antigo>
                    <vlr_atual>173.65</vlr_atual>
                    <percentual_desconto>0.00</percentual_desconto>
                    <data_inicial>0000-00-00 00:00:00</data_inicial>
                    <data_final>0000-00-00 00:00:00</data_final>
                </valores>
                <valores>
                    <vlr_antigo>0.00</vlr_antigo>
                    <vlr_atual>75.00</vlr_atual>
                    <percentual_desconto>0.00</percentual_desconto>
                    <data_inicial>2018-09-17 00:00:00</data_inicial>
                    <data_final>2018-09-28 00:00:00</data_final>
                </valores>
                <valores>
                    <vlr_antigo>81.33</vlr_antigo>
                    <vlr_atual>81.33</vlr_atual>
                    <percentual_desconto>16.00</percentual_desconto>
                    <data_inicial>0000-00-00 00:00:00</data_inicial>
                    <data_final>0000-00-00 00:00:00</data_final>
                </valores>
                <valores>
                    <vlr_antigo>41.71</vlr_antigo>
                    <vlr_atual>41.71</vlr_atual>
                    <percentual_desconto>0.00</percentual_desconto>
                    <data_inicial>0000-00-00 00:00:00</data_inicial>
                    <data_final>0000-00-00 00:00:00</data_final>
                </valores>
            </cor>
        </cores>
    </produto>
</produtos>

...

Expand

title	Save Produtos

Save Produtos

Método

O nome do método utilizado na consulta é saveProdutos.

Descrição

Salva 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.

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
atualiza	Integer(1)	0 - Para não atualizar o produto se for encontrado. 1 - Para atualizar se o produto for encontrado.
produto_codigo (*)	String(40)	Código de identificação do produto.
produto_codigo_cor (*)	String(35)	Código para identificação da variação de cor do produto.
produto_codigo_tam (*)	String(35)	Código para identificação da variação de tamanho do produto. Esse código deve ser único!
titulo (*)	String(200)	Título (nome) do produto.
titulo_completo	String(250)	Título completo (nome detalhado) do produto.
preco_custo	Float (12,2)	Valor de custo do produto.
faixa_etaria	String (35)	Faixa etária do produto: – ambos – adulto – infantil
cor (*)	String (50)	Nome da cor do produto
cor_secundaria	String (50)	Nome da cor secundaria do produto
cor_fabricante	String (50)	Nome da cor do fabricante do produto
tamanho (*)	String (20)	Tamanho do produto (PP,M,G,32...)
variacao (*)	String (12)	Variação do produto. Possíveis valores: - cor - tamanho - cortamanho - none
referencia	String (35)	Referencia do fabricante.
marca	String(100)	Nome da marca
descricao	String	Descrição do produto em texto ou HTML.
caracteristicas_tecnicas	String	Descrição técnica produto em texto ou HTML.
peso (*)	Float(8,2)	Float de até 10 posições. Utilizar o peso em gramas.
medidas (*)	String(14)	Medidas do produto no formato: Altura x Largura x Comprimento. Exemplo: 12x13x14
peso_tamanho	Float(8,2)	Float de até 10 posições. Utilizar o peso em gramas.
medidas_tamanho	String(14)	Medidas do tamanho do produto no formato: Altura x Largura x Comprimento. Exemplo: 12x13x14
lancamento	Integer(1)	Define se produto é lançamento. - 0 para Não - 1 para Sim
destaque	Integer(1)	Define se produto deve esta em destaque. - 0 para Não - 1 para Sim
genero (*)	String(1)	- 1 para Masculino - 2 para Feminino - 0 para Ambos
status (*)	Integer	Status relacionado ao produto. - 1 para Ativo - 0 para Inativo
status_cor (*)	Integer	Status relacionado à cor especificada para o produto, sem alterar o status do produto base. - 1 para Ativo - 0 para Inativo
data_cadastro	String(25)	Data e hora de cadastro do produto no formato 9999-99-99 99:99:99
garantia	String(200)	Texto de garantia do produto.
garantia_tempo	Integer(11)	Tempo em dias de garantia do produto.
estoque_minino	Integer(11)	Quantidade mínima do estoque.
categorias	Objeto	Objeto que contém o array categoria.
limpar_categorias	Integer	Está tag não é obrigatória no envio, quando enviada faz todas as relações de categorias antigas cadastradas no produto serem apagadas. Deve ser enviado junto a tag ‘atualiza’. - 1 para Sim - 0 para Não
categoria	Array	Conjunto que conterá as categorias.
categoria_pai	Array	Conjunto de categoria_pai.
nome	String(100)	Nome da categoria pai.
codigo	Integer(11)	Código da categoria pai. Esse código deve ser único.
caracteristicas¹	Array	Conjunto de características da categoria pai.
renovar_caracteristicas	Integer(1)	Defini se será renovada ou não as caracteristicas enviadas. Valores: - 0 “Não” - 1 “Sim”
caracteristica	Array	Característica relacionada ao conjunto de Características.
nome	String(50)	Nome da característica.
atributos	Array	Conjunto de atributos da característica.
atributo	Array	Atributo relacionado ao conjunto de atributos.
codigo²	Integer(11)	Código do atributo. Pode ser consultado no método getCaracteristicas.
nome²	String(50)	Nome do atributo.
categorias_filho	Array	Conjunto de categoria_filho.
categoria_filho	Array	Categoria filho.
nome (*)	String(100)	Nome da categoria filho.
codigo (*)	Integer(11)	Código da categoria filho. Esse código deve ser único.
caracteristicas¹	Array	Conjunto de características da categoria pai.
renovar_caracteristicas	Integer(1)	Defini se será renovada ou não as caracteristicas enviadas. Valores: - 0 “Não” - 1 “Sim”
caracteristica	Array	Característica relacionada ao conjunto de Características.
nome	String(50)	Nome da característica.
atributos	Array	Conjunto de atributos da característica.
atributo	Array	Atributo relacionado ao conjunto de atributos.
codigo²	Integer(11)	Código do atributo. Pode ser consultado no método getCaracteristicas.
nome²	String(50)	Nome do atributo.
categorias_neto	Array	Conjunto de categoria_neto.
categoria_neto	Array	Categoria neto.
nome	String(100)	Nome da categoria neto.
codigo	Integer(11)	Código da categoria neto. Esse código deve ser único.
caracteristicas¹	Array	Conjunto de características da categoria pai.
renovar_caracteristicas	Integer(1)	Defini se será renovada ou não as caracteristicas enviadas. Valores: - 0 “Não” - 1 “Sim”
caracteristica	Array	Característica relacionada ao conjunto de Características.
nome	String(50)	Nome da característica.
multiplo	Integer(1)	Define se a característica permite múltipla seleção. Valores: Sim Não
filtravel	Integer(1)	Define se a característica poderá ser usada como filtro. Valores: Sim Não
obrigatorio	Integer(1)	Define se a característica é de uso obrigatório. Valores: Sim Não
tipo	Integer(1)	Define se a característica é de produto ou estoque ou ambos. Valores: Estoque Produto Ambos
exibe_descricao	String(3)	Define se a característica será exibida na descrição do produto. Valores: Sim Não
genero	Integer(1)	Define o gênero da característica. Valores: M para Masculino F para Feminino 0 Ambos
Faixa etaria	Integer(1)	Define a faixa etária da característica. Valores: Infantil Adulto Ambas
atributos	Array	Conjunto de atributos da característica.
atributo	Array	Atributo relacionado ao conjunto de atributos.
codigo²	Integer(11)	Código do atributo. Pode ser consultado no método getCaracteristicas.
nome²	String(50)	Nome do atributo.
posicao	Integer	Posição da Imagem, comparada com as outras do mesmo produto.
generico	Integer(1)	Informa se a imagem deve ser utilizada em todas as variações. - 0 para Não - 1 para Sim
imagem_variacao	Integer(1)	Informa se a imagem pertence apenas a esta variação. - 0 para Não - 1 para Sim
principal	Integer(1)	Informa se esta é a imagem principal do produto. - 0 para Não - 1 para Sim
link	String	Formato de link que será utilizado para acessar o produto na loja. Devem ser enviados apenas letras, maiúsculas ou minúsculas, sem acentos, números e o caractere especial “-” Caso esse campo não seja informado, seu produto receberá um link padrão, que seu título - nome da cor.
meta_title	String	Meta tag de título relacionada ao produto.
meta_keywords	String	Meta tag de palavras -chave relacionadas ao produto. Elas devem ser enviadas separadas por vírgula.
ean13	String(13)	EAN do produto estoque.
descricao_cor	String	Descrição da variação de cor em texto ou HTML.
nfe_origem	Integer(1)	Define a origem do NCM do produto. - 0 para “Nacional”. - 1 para “Importação direta”. - 2 para “Importação indireta”.
nfe_ncm	String	Número do NCM do produto.
imagens	Object	Tag referente a imagens de produtos.
limpar_imagens	Integer(1)	Define se deve remover as imagens atuais. 0 - “Não” 1 - “Sim”
Imagem	Array of Objects	Lista de imagens pertencentes a um produto. sub-tag de imagens.
Imagem	String	Url completa da imagem. sub-tag de imagem.
imagem_base64	String	Caso a url da imagem não for preenchida, é utilizado esse campo para realizar o upload de uma imagem codificada em base_64. sub-tag de imagem(*).
posicao	Integer	Posição usada para definir a ordem de visualizações das imagens no produto. sub-tag de imagem(*).
generico	Integer	Define se a imagem é genérica de um produto ou relacionada a uma variação específica. - 0 “Não” - 1 “Sim” Obs: Caso passado o valor “1” então a imagem será relacionada a variação específica do produto. sub-tag de imagem(*).
principal	Integer	Define se a imagem é a principal do produto. - 0 “Não” - 1 “Sim” sub-tag de imagem(*).

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.

Code Block

theme	Midnight
title	Exemplo XML - saveProduto
linenumbers	true

<produtos>
	<produto>
		<atualiza>1</atualiza>
		<produto_codigo />
		<produto_codigo_cor />
		<produto_codigo_tam />
		<titulo />
		<preco_custo />
		<meta_title />
		<meta_keywords />
		<meta_description />
		<faixa_etaria />
		<cor />
		<cor_secundaria />
		<cor_fabricante />
		<nfe_origem>1</nfe_origem>
		<ean13/>
		<nfe_ncm />
		<tamanho />
		<variacao />
		<referencia />
		<marca />
		<descricao />
		<caracteristicas_tecnicas />
		<peso />
		<medidas />
		<destaque />
		<lancamento />
		<genero />
		<status />
		<data_cadastro />
		<categorias>
			<limpar_categorias>1</limpar_categorias>
			<categoria>
				<categoria_pai>
					<nome>Automotivo</nome>
					<codigo>1111</codigo>
					<categorias_filho>
						<categoria_filho>
							<nome>Carros</nome>
							<codigo>2222</codigo>
							<categorias_neto>
								<categoria_neto>
									<nome>Esporte</nome>
									<codigo>33333-111</codigo>
									<caracteristicas>
										<caracteristica>
											<nome>caracteristica</nome>
											<codigo>15</codigo>
											<tipo>estoque</tipo>
											<multiplo>sim</multiplo>
											<filtravel>sim</filtravel>
											<exibe_descricao>sim</exibe_descricao>
											<obrigatorio>sim</obrigatorio>
											<atributos>
												<atributo>
													<nomeatributo 1
                                                        
													</nome>
													<codigo>10</codigo>
												</atributo>
												<atributo>
													<nome>atributo 2</nome>
													<codigo>20</codigo>
												</atributo>
											</atributos>
										</caracteristica>
									</caracteristicas>
								</categoria_neto>
							</categorias_neto>
						</categoria_filho>
					</categorias_filho>
				</categoria_pai>
			</categoria>
		</categorias>
		<imagens>
			<imagem>
				<limpar_imagens>0</limpar_imagens>
				<imagem />
				<imagem_base64 />
				<posicao />
				<generico />
				<principal />
				<imagem_variacao />
			</imagem>
		</imagens>
	</produto>
</produtos>

Code Block

theme	Midnight
title	Exemplo Json - saveProduto
linenumbers	true

{
  "produto": [
    {
      "atualiza": 1,
      "produto_codigo": "1234",
      "produto_codigo_cor": "1234-5",
      "produto_codigo_tam": "12345-5-1",
      "titulo": "Teste Moovin",
      "faixa_etaria": 0,
      "cor": "Preto",
      "cor_secundaria": "Branco",
      "cor_fabricante": "Preto/Branco",
      "tamanho": "M",
      "variacao": "cortamanho",
      "referencia": "12345",
      "marca": "Adidas",
      "descricao": "Teste Moovin Descrição",
      "ean13": "1111111111111",
      "nfe_origem": "1",
      "nfe_ncm": "12345",
      "caracteristicas_tecnicas": "",
      "peso": 99.9,
      "medidas": "10x30x20",
      "destaque": 1,
      "lancamento": 0,
      "genero": "1",
      "status": 1,
      "data_cadastro": "",
      "categorias": {
        "limpar_categorias": 1,
        "categoria": [
          {
            "categoria_pai": {
              "nome": "Automotivo",
              "codigo": "1111",
              "categorias_filho": {
                "categoria_filho": {
                  "nome": "Carros",
                  "codigo": "2222",
                  "categorias_neto": {
                    "categoria_neto": {
                      "nome": "Esporte",
                      "codigo": "33333-111",
                      "caracteristicas": {
                        "caracteristica": {
                          "nome": "caracteristica",
                          "codigo": "10101",
                          "tipo": "Estoque",
                          "multiplo": "Sim",
                          "filtravel": "Sim",
                          "exibe_descricao": "Sim",
                          "obrigatorio": "Sim"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          {
            "categoria_pai": {
              "nome": "Automotivo",
              "codigo": "1111",
              "categorias_filho": {
                "categoria_filho": {
                  "nome": "Carros",
                  "codigo": "2222",
                  "categorias_neto": {
                    "categoria_neto": {
                      "nome": "Passeio",
                      "codigo": "33333-222"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "imagens": {
        "limpar_imagens": 0,
        "imagem": [
          {
            "imagem": "",
            "imagem_base64": "",
            "posicao": "0",
            "generico": "1",
            "principal": "1",
            "imagem_variacao": "1"
          }
        ]
      }
    }
  ]
}

...

Expand

title	Update Pedido

Update Pedido

Método

O nome do método utilizado na consulta é updatePedido.

Descrição

Atualiza os dados dos pedidos (1 ou mais pedidos).

Dados

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

theme	Midnight
title	Exemplo XML - updatePedido
linenumbers	true

<pedidos>
   <pedido>
       <codigo_pedido> 107 </codigo_pedido>
       <codigo_integracao>123456790</codigo_integracao>
       <codigo_rastreio> DU827432251BR </codigo_rastreio>
       <data_postagem> 2016-11-21 13:00:00 </data_postagem>
       <data_entrega> 2016-11-21 </data_entrega>
       <codigo_modalidade_envio> 32 </codigo_modalidade_envio>
       <uf_transporte> RS </uf_transporte>
       <data_pagamento> 2016-11-21 </data_pagamento>
       <codigo_status_pedido> 4 </codigo_status_pedido>
       <status_transacao> aprovado </status_transacao>
	   <importado>1</importado>
   </pedido>
</pedidos>

Code Block

theme	Midnight
title	Exemplo Json - updatePedido
linenumbers	true

{
   "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
    }
  ]
}

...

Expand

title	Update Precos V2

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

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.

Code Block

theme	Midnight
title	Exemplo XML - updatePrecos
linenumbers	true

<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

theme	Midnight
title	Exemplo Json - updatePrecos
linenumbers	true

{
  "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

title	Update User Status

Update User Status

Método

O nome do método utilizado na consulta é updateUserStatus.

Descrição

Atualiza o status de um usário pré- cadastrado ou de um grupo de usuários.

Dados

Nome	Tipo	Descrição
email	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

Inativando/Ativando usuário pelo E-mail

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <email>teste@moovin.com.br</email>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "email": "teste@moovin.com.br",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo Nome

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <nome>João da Silva</nome>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "nome": "João da Silva",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo Status Atual

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <status_atual>1</status_atual>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "status_atual": "1",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pela Data de Nascimento

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <data_de_nascimento>01/01/1990</data_de_nascimento>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "data_de_nascimento": "01/01/1990",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo Login

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <usuario>joao.silva</usuario>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "usuario": "joao.silva",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo Código

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <codigo>220</codigo>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "codigo": "220",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo Telefone

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <telefone>(51) 99999-9999</telefone>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "telefone": "(51) 99999-9999",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo

Loja

Celular

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <loja>Loja 1</loja><celular>(51) 99999-9999</celular>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "lojacelular": "Loja 1(51) 99999-9999",
      "status": "0"
    }
  ]
}

Inativando/Ativando usuário pelo

Celular

Loja

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
    <celular>(51) 99999-9999</celular><loja>Loja 1</loja>
    <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "celularloja": "(51) 99999-9999Loja 1",
      "status": "0"
    }
  ]
}

Inativando/Ativando grupo de usuários

Code Block

theme	Midnight
title	Exemplo XML - updateUserStatus
linenumbers	true

<usuario>
     <grupo>gerencia</grupo>
     <status>0</status>
</usuario>

Code Block

theme	Midnight
title	Exemplo Json - updateUserStatus
linenumbers	true

{
  "usuario": [
    {
      "grupo": "gerencia",
      "status": "0"
    }
  ]
}

...

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.

...