Integrações com e-commerce

• Climba
• (Desenvolvimento) Ideris
• (Desenvolvimento) Loja Integrada
• (Desenvolvimento) NuvemShop
• (Desenvolvimento) Magento
• (Desenvolvimento) Bitfuel
• (Desenvolvimento) Digisoft
• Tray (Em desenvolvimento)

Climba

Documentação e suporte

• https://www.climba.dev/documentacao-api-v1/
• WhatsApp suporte: (48) 3658-4743

 

---

Ambiente de homologação

• Url API: https://staging-basehomologacaoemasoft.api.climbaapp.com.br/api/v1/   Clique aqui!
• Token: ZjJjZmJiODE3NjMxODA4MzBmOWNmM2I0N2UwZTA3OTE6NjRjN2JmMmU2MTQ2OGRlNDRiMWFjMzFiYjRhMjNlNmY=
• Loja:
  • link: https://staging-basehomologacaoemasoft.climbacommerce.com.br/admin  
  • Usuário: staging_basehomologacaoemasoft    
  • Senha: &m4pr0@123
  • Clique aqui!

 

---

Autenticação

• URL API: Informado pelo cliente através da Climba.   Clique aqui!

• Token de acesso: Informado pelo cliente através da Climba.   Clique aqui!

 

---

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos ou catálogos);

• Envio de itens;

• Envio de itens com variação (agrupamento);

• Envio de nota fiscal de saída;

• Busca de pedidos;

• Busca de clientes. 

 

---

Envio de marcas

Resource	Método
brands	POST
brands/<Id da marca na Climba>	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para Climba" marcado. Clique aqui!

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

    • integracaoecommerce_Marca.DataHoraUltimasinc  <= Marca.DataHoraUltimaAtualizacao

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado:  Clique aqui!

    • Serão enviadas somente as marcas informadas na aba "Marcas".  Clique aqui!

    • Permite fazer um De/Para das marcas específicas inserindo id da marca da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs) Clique aqui!

Dados enviados

Tag de envio	O que será enviado
id	Id da marca na Climba
name	Descrição da marca
description	Null

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Climba	Id retornado	IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

 

---

Envio de categorias

Resource	Método
categories	POST
categories/<Id da categoria na Climba>	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado. Clique aqui!

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

    • integracaoecommerce_Grupo.DataHoraUltimasinc  <= Grupo.DataHoraUltimaAtualizacao ou integracaoecommerce_Grupo.DataHoraUltimasinc  <= Catalogo.DataHoraUltimaAtualizacao

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP. Clique aqui!

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: Clique aqui!

    • Serão enviadas somente os grupos informados na aba "Grupos". Clique aqui!

    • Permite fazer um De/Para de grupos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs) Clique aqui!

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: Clique aqui!

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". Clique aqui!

      • Permite fazer um De/Para de catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs) Clique aqui!

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
parentId	Id do grupo ou catalogo pai no ERP
name	descrição do grupo ou catálogo
order	Classificacao do grupo ou catalogo
description	Null

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Climba	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens simples

Resource	Método
products	POST
products/<Id do item no ERP>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado. Clique aqui!

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado. Clique aqui!

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU:

    • o campo "SKU do produto" define se o SKU será  o iditem ou referencia. Clique aqui!

  • Nome:
    • o campo "Descrição do item" define o campo do item que será enviado. Clique aqui!
      • Descrição, descrição técnica, observação ou complemento
  • Preço:
    • o campo "Utilizar" define qual o preço que será enviado: Clique aqui!
    • Preço de pauta da filial: deve ser informada a "Filial". Clique aqui!
    • Tabela de preço específica: deve ser informada a Tabela de preço" . Clique aqui!
  • Estoque:
    • O campo "Filiais" indica as filiais que deverão somar o estoque por depósitos. Clique aqui!
    • O campo "Depósito" indica os depósitos somados para enviar a quantidade em estoque.  Clique aqui!
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP. Clique aqui!
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado. Clique aqui!
    • Respeita o campo "Qt. Múltiplo" do cadastro do item. Clique aqui!

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de itens com variação

Resource	Método
products	POST
products/A<id do agrupamento no ERP>	PUT

Regras para envio

• • Somente agrupamentos com o campo "Exporta para Climba" marcado.

  • Somente itens do agrupamento com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <"A"+Id do agrupamento no ERP>, são enviados os dados para atualização (PUT).
  • Na Climba os agrupamento serão os produtos principais e os itens dos agrupamentos serão as variações.
  • Atributos da variação são COR e TAMANHO.

Opções na Configuração

• • Campo "Exporta itens agrupados" deve estar marcado.

  • Sku: o campo "SKU do produto" define se o SKU do item de variação será  o iditem ou referencia.

  • Preço: o campo "Utilizar" define qual o preço de cada item de variacao que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado. 
    • Respeita o campo "Qt.Múltiplo" do cadastro do item. 

Dados enviados

Tags de envio	O que será enviado
id	"A" + Id do agrupamento no ERP
status	Status do agrupamento no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo de um item do agrupamento
brandId	Id da climba vinculado a marca de um item do agrupamento
name	Descrição do agrupamento
description	Observação de um item do agrupamento
productVariants	<as tags abaixo serão enviadas pra cada item do agrupamento>
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	Id da cor do item
name	Descrição da cor
attributeGroupId	"1"
id	Id do tamanho do item
name	Descrição do tamanho
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens agrupados

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de variações

Cores

Resource	Método
attributes	POST
attributes/1/<Id da cor no ERP>	PUT

Regras para envio

• • Somente cores Ativas.
  • Somente cores com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro da cor. (Data de atualização do cadastro da cor maior que a data da ultima sincronização da cor) 

Dados enviados

Tag de envio	O que será enviado
id	Id da cor no ERP
name	Descrição da cor
attributeGroupId	"1"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização da Cor	data e hora atual	Cor.DatahoraultimaSincClimba

Tamanhos

Resource	Método
attributes	POST
attributes/2/<Id do tamanho no ERP>	PUT

Regras para envio

• • Somente tamanhos Ativos.
  • Somente tamanhos com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro de tamanho. (Data de atualização do cadastro do tamanho maior que a data da ultima sincronização do tamanho) 

Dados enviados

Tag de envio	O que será enviado
id	Id do tamanho no ERP
name	Descrição do tamanho
attributeGroupId	"2"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do tamanho	data e hora atual	Tamanho.DatahoraultimaSincClimba

---

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP. Clique aqui!
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba. Clique aqui!
    • Informar padrão. Clique aqui!
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão. Clique aqui!
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba na aba "Transportadoras" Clique aqui!
    • Informa padrão. Clique aqui!

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
id	Numero do pedido
customerComment	Observação
shippingAddress/state	UF de destino
name	nome do cliente
sourceId	id marketplace
totalValue	Valor total do pedido
totalValue	Valor total dos itens
discountValue	Valor do desconto
additionValue	Valor do acréscimo
shippingValue	Valor do frete
payment/id	Id do método de pagto
payment/installmentQuantity	Parcela do método
shipping/id	Id da transportadora

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
sequence	sequencial do item no pedido	pedido_item.sequencial
sequence	sequencial do item no pedido	pedido_item.idpedidoitem
id	id do pedido na climba	pedido_item.idpedidopda
sku	Sku do item na climba
productId	Id do item no ERP
quantity	Quantidade do item	pedido_item.qt
sellingPrice	Valor unitario do item	pedido_item.valor
sellingPrice	Valor de pauta	pedido_item.valorpauta
sellingPrice	Valor sugerido	pedido_item.valorsugerido
quantity * sellingPrice	Valor total do item	pedido_item.valortotal
discountValue	Valor do desconto	pedido_item.valordesconto
discountValue/quantity * sellingPrice	Percentual do desconto	pedido_item.perc_desconto
additionValue	Valor de acrescimo	pedido.valoracrescimo
additionValue/quantity * sellingPrice	Percentual de acrescimo	pedido_item.perc_acrescimo

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Climba"	Observação
birthDate	Data de nascimento
id	Id do cliente na Climba
name	Fantasia
name	Razão
gender  = "m" ou "f"	Sexo
email	e-mail
email	e-mail NF-e
documents/ type	-
type  = "cpf"	-
number	CPF
type = "cnpj"	-
number	CNPJ
type = "ie"	-
number	IE
type = "rg"
number	RG
phones
type = "primary"
number	Fone
type = "secundary"
number	Fone 2
type = "others"
number	Fax
shippingAddress
street	Endereço
streetNumber	Número
complement	Complemento
district	Bairro
state	UF
zipCode	CEP
city	Nome da Cidade

---

Envio de Nota fiscal

Resource	Método
orders/<id do pedido pda>/billed	POST

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados

Tag de envio	O que será enviado
number	Número da NFS
nfeAccessKey	Chave eletrônica da NFS
xml	XML da NFS
logisticOperatorId	Id da Operador logistico informada na configuração. Se não envia vazio.

 

 

 

(Desenvolvimento) Ideris

Documentação e suporte

• https://apiv3.ideris.com.br/swagger/index.html
• Normalmente o Suporte com a Ideris é via WhatsApp: 
  • +55 41 3405-4098
• Tem ambiente de homologação?
  • Url: https://apiv3.ideris.com.br
  • Token: bhngohad6fbmsncvd8v4qacyd9g7w7qqatf4krhypfgiybwsddecix9wbrij6joju9ns32ozugxga93k5rw2shpk7yiwgrvr6eie
  • Loja: https://web.ideris.com.br/login
    • Usuário: jacke.venson@gmail.com
    • Senha: devideris123

---

Autenticação

• URL API: Informado pelo cliente através da Ideris.

• Token de acesso: Informado pelo cliente através da Ideris.

---

O que é sincronizado?

• Envio de marcas;

• Envio de departamentos (famílias);
• Envio de NCM;

• Envio de categorias (grupos ou catálogos);

• Envio de itens (SKU);

• Criação/Edição de modelo de anúncio por SKU;

• Busca de pedidos;

• Busca de clientes. 

• Envio de nota fiscal de saída;
• Atualização do status do pedido;

---

Envio de marcas

Resource	Método
brand	POST
brand	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para web" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da marca da Ideris na coluna "Cód. E-commerce". (Deve ser solicitado para a Ideris os IDs)

    • Antes de enviar uma marca nova, é realizada a busca pela descrição da marca na Ideris, se encontrar uma marca com a mesma descrição, são enviados os dados para atualização (PUT).

Dados enviados

Tag de envio	O que será enviado
id	Id da marca na Ideris
description	Descrição da marca

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Ideris	Id retornado	IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

---

Envio de departamentos

Resource	Método
department	POST
department	PUT

Regras para envio

• • Somente famílias Ativas.

  • Somente famílias com o campo "Exporta para web" marcado.

  • Primeira sincronização ou alteração no cadastro da família (Data de atualização do cadastro da família for maior que a data da última sincronização da família).

Opções na Configuração

• • Se o parâmetro "Exporta famílias específicas" estiver marcado: 

    • Serão enviadas somente as famílias informadas na aba "Famílias". 

    • Permite fazer um De/Para das famílias específicas inserindo id do departamento da Ideris na coluna "Cód. E-commerce". (Deve ser solicitado para a Ideris os IDs)

    • Antes de enviar uma familia nova, é realizada a busca pela descrição da família na Ideris, se encontrar um departamento com a mesma descrição, são enviados os dados para atualização (PUT).

Dados enviados

Tag de envio	O que será enviado
id	Id do departamento na Ideris
name	Descrição da família no ERP

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Familia
Grava no ERP o id do departamento na Ideris	Id retornado	IntegracaoEcommerce_Familia.IdFamiliaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da familia	data e hora atual	IntegracaoEcommerce_Familia.DataHoraUltimaSinc

---

Envio de NCM

Resource	Método
ncm	POST
ncm	PUT

Regras para envio

• • Somente classificações fiscais Ativas.

  • Somente classificações fiscais com o campo "Exporta para web" marcado.

  • Primeira sincronização ou alteração no cadastro da classificação fiscal (Data de atualização do cadastro da classificação fiscal for maior que a data da última sincronização da classificação fiscal).

Opções na Configuração

• • Se o parâmetro "Exporta NCM's específicos" estiver marcado: 

    • Serão enviadas somente as classificações fiscais informadas na aba "NCM". 

    • Permite fazer um De/Para das classificações fiscais específicas inserindo id do NCM da Ideris na coluna "Cód. E-commerce". (Deve ser solicitado para a Ideris os IDs)

    • Antes de enviar um NCM novo, é realizada a busca pelo NCM na Ideris, se encontrar um NCM igual, são enviados os dados para atualização (PUT).

Dados enviados

Tag de envio	O que será enviado
id	Id do NCM na Ideris
name	Descrição da classificação fiscal no ERP
code	Classificação fiscal no ERP

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_NCM
Grava no ERP o id do NCN na Ideris	Id retornado	IntegracaoEcommerce_NCM.IdNCMEcommerce
Grava/atualiza no ERP a data da ultima sincronização do NCM	data e hora atual	IntegracaoEcommerce_NCM.DataHoraUltimaSinc

---

Envio de categorias

Resource	Método
category	POST
category	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta terceiros" ou "Exporta para Ideris" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para de grupo ou catálogos específicos inserindo id da categoria da Ideris na coluna "Cód. E-commerce".  (Deve ser solicitado para a Ideris os IDs)

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
name	descrição do grupo ou catálogo
parentCategoryId	Id do grupo ou catalogo pai no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Ideris	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens (SKU)

Resource	Método
sku	POST
sku	PUT

Regras para envio

• • Somente itens ativos.

  • Somente itens com o campo "Exporta para terceiros" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para web" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Ideris, se encontrar um SKU na Ideris com o mesmo SKU que está sendo enviado, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado. "Não aplicavel na Ideris"
    • Descrição, descrição técnica, observação ou complemento: "Não aplicavel na Ideris"
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado. "Não aplicavel na Ideris"
    • Respeita o campo "Qt. Múltiplo" do cadastro do item. "Não aplicavel na Ideris"

Dados enviados

Tags de envio	O que será enviado
id	Id do item na Ideris
sku	Id do item ou referencia no ERP
title	Descrição do item no ERP
type	"SIMPLES"
updateStockListings	"True"
updateStockKit	"True"
ean	Código de barras do item
ncmId	Id da Ideris vinculado ao NCM do item
originId	Origem do item
stocks	tag do estoque
currentStock	Quantidade em estoque do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Ideris	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

---

Criação\Edição de modelo de anúncio por SKU

Resource	Método
ListingModel	POST
ListingModel	PUT

Regras para criação\edição

• • Mesma regra dos itens, pois esta rotina será executada exatamente após o retorno com sucesso do envio do item para a Ideris.

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .

Dados enviados

Tags de envio	O que será enviado
id	Id do modelo do anuncio do item na Ideris
title	Descrição do item no ERP
brandId	Id da Ideris vinculado a marca do item
categoryId	Id da Ideris vinculado ao grupo ou catalogo do item
departmentId	Id da Ideris vinculado a familia do item
statusId	"1" - Ativo
type	"SIMPLES"
SKUId	Id do SKU inserido na Ideris
SKU	Id do item ou referencia no ERP
quantity	Quantidade em estoque do item
longDescription	Descrição técnica do item
weight	Peso líquido do item
length	Comprimento da embalagem do item
width	Largura da embalagem do item
height	Altura da embalagem do item
weightPackage	Peso bruto do item
lengthPackage	Comprimento da embalagem do item
widthPackage	Largura da embalagem do item
heightPackage	Altura da embalagem do item
cost	Valor do custo médio unitário do item
value	Preço do item
listingModelImage	Tag de imagens
Base64	Imagens do item em base 64

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Ideris	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

 

---

Busca de pedidos

Regras

• • Busca somente pedidos na Ideris com:
    • Status em aberto (statusid = 1007).
    • Pagamento aprovado na Ideris (payments = approved).

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para marcando o parâmetro "Informa Vendedor/Representante específico para cada marketplace" e inserindo o vendedor conforme marketplace igual a tag "originName" da Ideris;
    • Irá pegar metodos e condicoes do vendedor selecionado na aba "Vendedores" para o marketplace do pedido;
    • Se não tiver nenhum de/para pega do padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Fazer De/para marcando o parâmetro "Informa Vendedor/Representante específico para cada marketplace" e inserindo o vendedor conforme marketplace igual a tag "originName" da Ideris;
    • Irá pegar o vendedor selecionado na aba "Vendedores" para o marketplace do pedido;
    • Se não tiver nenhum de/para pega do padrão.
    • Se não tiver nenhum acima pega do cliente.
    • Tipo do vendedor será o tipo do vendedor do De/para, senão tiver de/para será o tipo 1.
  • Transportadora:
    
    • Informa padrão.

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
originName	nome do marketplace
totalAmount	Valor total do pedido
totalAmount	Valor total dos itens
discount	Valor do desconto
feeShipment	Valor do frete
feeShipment	Tarifa envio Ideris
feeOrder	Tarifa venda Ideris

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
id	id do pedido na Ideris	pedido_item.idpedidopda
codeProduct	Sku do item na Ideris	iditem ou referencia
quantity	Quantidade do item	pedido_item.qt
unitPrice	Valor unitario do item	pedido_item.valor
unitPrice	Valor de pauta	pedido_item.valorpauta
unitPrice	Valor sugerido	pedido_item.valorsugerido
quantity * unitPrice	Valor total do item	pedido_item.valortotal
discount	Valor do desconto  rateado nos itens	pedido_item.valordesconto
discount/quantity * unitPrice	Percentual do desconto	pedido_item.perc_desconto

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o mesmo CPF ou CNPJ somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Ideris"	Observação
documentType	CPF ou CNPJ
ie	"ISENTO"
im	"ISENTO"
customerFirstName + customerLastName	Fantasia
customerLastName	Razão
customerEmail	e-mail
customerEmail	e-mail de nfe
phoneAreaCode + phoneNumber	Fone
addressStreet	Endereço
addressNumber	Número
addressComment	Complemento
districtName	Bairro
stateAbbreviation	UF
addressZipCode	CEP
cityName	Nome da Cidade

---

Envio de Nota fiscal

Resource	Método
order/<id do pedido pda>/invoice	POST

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados

Tag de envio	O que será enviado
orderId	Id do pedido na Ideris
number	Número da Nota
key	Chave eletrônica da nota
serie	Série da nota
xml	XML da Nota - base 64
issueAt	Data de emissão da nota
statusId	"1021" - Nota autorizada
cfop	Envia código CFOP somente se o marketplace for "Shopee"
MoveToInTransit	"False"

---

Atualiza status do pedido na Ideris

Resource	Método
order	PUT

Regras 

• • Atualiza o status do pedido após o envio da nota fiscal na Ideris;

•  

Dados enviados

Tag de envio	O que será enviado
orderId	Id do pedido na Ideris
statusId	1009 - Expedição

 

 

(Desenvolvimento) Loja Integrada

Documentação e suporte

• https://api-docs.lojaintegrada.com.br/#3df5c66f-3942-425b-9a3e-c75718fbdecc
• O suporte da loja integrada paga é por chat, senão somente através da comunidade:
  • https://comunidade.lojaintegrada.com.br/
• Tem ambiente de homologação?
  • Poderá ser disponibilizado, dados de autenticação teste, mediante contato.

Autenticação

• URL API: Informado pelo cliente através da Loja integrada.

• Chave API: Informado pelo cliente através da Loja integrada.

• Chave aplicação: Informado pelo cliente através da Loja integrada.

---

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos);

• Envio de grades;
• Envio de variações de grade (tamanhos);

• Envio de itens;

• Envio de itens agrupados;

• Atualiza estoque de itens;

• Atualiza preço de itens;
• Envio de nota fiscal de saída;

• Busca de pedidos;

• Busca de clientes;

• Atualiza status de pedidos;

---

Envio de marcas

Resource	Método
marca	POST
marca/<Id da marca na Loja integrada>	PUT
marca/<id da marca no ERP>?id_externo=1	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para web" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da marca da Loja integrada na coluna "Cód. E-commerce". (Deve ser solicitado para a Loja integrada os IDs)

Dados enviados

Tag de envio	O que será enviado
id_externo	Id da marca no ERP
nome	Descrição da marca
slug	Descrição da marca

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

 

---

Envio de categorias

Resource	Método
categoria	POST
categoria/<Id da categoria na Loja integrada>	PUT
categoria/<id do grupo no ERP>?id_externo=1	PUT

Regras para envio

• • Somente grupos Ativos.

  • Somente grupos com o campo "Exporta para web" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo (Data de atualização do cadastro do grupo for maior que a data da última sincronização do grupo).

Opções na Configuração

• • Não usa o parâmetro "Tipo exportação categoria", para a Loja integrada serão sempre enviados Grupos.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

    •  

  • Permite fazer um De/Para dos grupos específicos inserindo id da categoria da Loja integrada na coluna "Cód. E-commerce".  (Deve ser solicitado para a Loja integrada IDs)

Dados enviados

Tags de envio	O que será enviado
id_externo	Id do grupo no ERP
nome	descrição do grupo
descricao	descrição do grupo

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo
Grava/atualiza no ERP a data da ultima sincronização do grupo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc

---

Envio de grades

Resource	Método
grades	POST
categoria/<id da grade no ERP>?id_externo=1	PUT

Regras para envio

• • Somente grades Ativas.

  • Somente grades com o campo "Exporta terceiros" marcado.

  • Envia somente a primeira sincronização (Data da ultima sincronização da grade zerada - DatahoraUltimaSincLoja).

  • Se encontrar uma grade com o mesmo id externo e idgrade na Loja integrada, somente atualiza os dados (PUT).

Opções na Configuração

• • Não usa nenhum parâmetro referente ao agrupamento ou variação.

Dados enviados

Tags de envio	O que será enviado
id_externo	Id da grade no ERP
nome	descrição da grade
nome_visivel	descrição da grade

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Atualiza no ERP a data da ultima sincronização da grade	data e hora atual	grade.DataHoraUltimaSincLoja

---

Envio de variações de grade (tamanhos)

Resource	Método
grade/<id da grade no ERP>/variacao?id_externo=1	POST

Regras para envio

• • Somente tamanhos vinculados a grade. Será enviado após o envio da grade.

  • Somente tamanhos Ativos.

  • Somente tamanhos com o campo "Exporta terceiros" marcado.

  • Envia somente a primeira sincronização (Data da ultima sincronização do tamanho zerada - DatahoraUltimaSincLoja).

Opções na Configuração

• • Não usa nenhum parâmetro referente ao agrupamento ou variação.

Dados enviados

Tags de envio	O que será enviado
id_externo	Id do tamanho no ERP
nome	descrição do tamanho

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Atualiza no ERP a data da ultima sincronização do tamanho	data e hora atual	tamanho.DataHoraUltimaSincLoja

---

Envio de itens simples

Resource	Método
produto	POST
produto/<Id do item na Loja integrada>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para terceiros" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para web" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id_externo	Id do item no ERP
sku	Id do item ou referencia
ncm	Classificação fiscal do item
nome	nome
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de itens agrupados

Resource	Método
produto	POST
produto/<Id do item na Loja integrada>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para terceiros" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para web" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba.
    • Informar padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão.
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba.
    • Informa padrão.

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
id	Numero do pedido
customerComment	Observação
shippingAddress/state	UF de destino
name	nome do cliente
sourceId	id marketplace
totalValue	Valor total do pedido
totalValue	Valor total dos itens
discountValue	Valor do desconto
additionValue	Valor do acréscimo
shippingValue	Valor do frete
payment/id	Id do método de pagto
payment/installmentQuantity	Parcela do método
shipping/id	Id da transportadora

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
sequence	sequencial do item no pedido	pedido_item.sequencial
sequence	sequencial do item no pedido	pedido_item.idpedidoitem
id	id do pedido na climba	pedido_item.idpedidopda
sku	Sku do item na climba
productId	Id do item no ERP
quantity	Quantidade do item	pedido_item.qt
sellingPrice	Valor unitario do item	pedido_item.valor
sellingPrice	Valor de pauta	pedido_item.valorpauta
sellingPrice	Valor sugerido	pedido_item.valorsugerido
quantity * sellingPrice	Valor total do item	pedido_item.valortotal
discountValue	Valor do desconto	pedido_item.valordesconto
discountValue/quantity * sellingPrice	Percentual do desconto	pedido_item.perc_desconto
additionValue	Valor de acrescimo	pedido.valoracrescimo
additionValue/quantity * sellingPrice	Percentual de acrescimo	pedido_item.perc_acrescimo

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Climba"	Observação
birthDate	Data de nascimento
id	Id do cliente na Climba
name	Fantasia
name	Razão
gender  = "m" ou "f"	Sexo
email	e-mail
email	e-mail NF-e
documents/ type	-
type  = "cpf"	-
number	CPF
type = "cnpj"	-
number	CNPJ
type = "ie"	-
number	IE
type = "rg"
number	RG
phones
type = "primary"
number	Fone
type = "secundary"
number	Fone 2
type = "others"
number	Fax
shippingAddress
street	Endereço
streetNumber	Número
complement	Complemento
district	Bairro
state	UF
zipCode	CEP
city	Nome da Cidade

---

Envio de Nota fiscal

Resource	Método
orders/<id do pedido pda>/billed	POST

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados

Tag de envio	O que será enviado
number	Número da NFS
nfeAccessKey	Chave eletrônica da NFS
xml	XML da NFS
logisticOperatorId	Id da Operador logistico informada na configuração. Se não envia vazio.

---

Atualiza status do pedido na Ideris

Resource	Método
order	PUT

Regras 

• • Atualiza o status do pedido após o envio da nota fiscal na Ideris;

•  

Dados enviados

Tag de envio	O que será enviado
orderId	Id do pedido na Ideris
statusId	1009 - Expedição

 

 

(Desenvolvimento) NuvemShop

Documentação e suporte

• https://www.climba.dev/documentacao-api-v1/
• Normalmente o Suporte com a NuvemShop via WhatsApp: 
  • +55 11 4020-7216
• Tem ambiente de homologação?
  • Colocar a Url de teste
  • Colocar o Token de teste
  • Colocar site
    • Colocar usuario
    • Colocar senha

---

Autenticação

• URL API: Informado pelo cliente através da Nuvem shop.

• Token de acesso: Informado pelo cliente através da Nuvem Shop.

---

O que é sincronizado?

• Envio de categorias (grupos ou catálogos);

• Envio de itens;

• Envio de itens com variação (agrupamento);

• Busca de pedidos;

• Busca de clientes. 

---

 

Envio de categorias

Resource	Método
categories	POST
categories/<Id da categoria na Climba>	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
parentId	Id do grupo ou catalogo pai no ERP
name	descrição do grupo ou catálogo
order	Classificacao do grupo ou catalogo
description	Null

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Climba	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens simples

Resource	Método
products	POST
products/<Id do item no ERP>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de itens com variação

Resource	Método
products	POST
products/A<id do agrupamento no ERP>	PUT

Regras para envio

• • Somente agrupamentos com o campo "Exporta para Climba" marcado.

  • Somente itens do agrupamento com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <"A"+Id do agrupamento no ERP>, são enviados os dados para atualização (PUT).
  • Na Climba os agrupamento serão os produtos principais e os itens dos agrupamentos serão as variações.
  • Atributos da variação são COR e TAMANHO.

Opções na Configuração

• • Campo "Exporta itens agrupados" deve estar marcado.

  • Sku: o campo "SKU do produto" define se o SKU do item de variação será  o iditem ou referencia.

  • Preço: o campo "Utilizar" define qual o preço de cada item de variacao que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado. 
    • Respeita o campo "Qt.Múltiplo" do cadastro do item. 

Dados enviados

Tags de envio	O que será enviado
id	"A" + Id do agrupamento no ERP
status	Status do agrupamento no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo de um item do agrupamento
brandId	Id da climba vinculado a marca de um item do agrupamento
name	Descrição do agrupamento
description	Observação de um item do agrupamento
productVariants	<as tags abaixo serão enviadas pra cada item do agrupamento>
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	Id da cor do item
name	Descrição da cor
attributeGroupId	"1"
id	Id do tamanho do item
name	Descrição do tamanho
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens agrupados

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de variações

Cores

Resource	Método
attributes	POST
attributes/1/<Id da cor no ERP>	PUT

Regras para envio

• • Somente cores Ativas.
  • Somente cores com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro da cor. (Data de atualização do cadastro da cor maior que a data da ultima sincronização da cor) 

Dados enviados

Tag de envio	O que será enviado
id	Id da cor no ERP
name	Descrição da cor
attributeGroupId	"1"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização da Cor	data e hora atual	Cor.DatahoraultimaSincClimba

Tamanhos

Resource	Método
attributes	POST
attributes/2/<Id do tamanho no ERP>	PUT

Regras para envio

• • Somente tamanhos Ativos.
  • Somente tamanhos com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro de tamanho. (Data de atualização do cadastro do tamanho maior que a data da ultima sincronização do tamanho) 

Dados enviados

Tag de envio	O que será enviado
id	Id do tamanho no ERP
name	Descrição do tamanho
attributeGroupId	"2"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do tamanho	data e hora atual	Tamanho.DatahoraultimaSincClimba

---

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba.
    • Informar padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão.
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba.
    • Informa padrão.

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
id	Numero do pedido
customerComment	Observação
shippingAddress/state	UF de destino
name	nome do cliente
sourceId	id marketplace
totalValue	Valor total do pedido
totalValue	Valor total dos itens
discountValue	Valor do desconto
additionValue	Valor do acréscimo
shippingValue	Valor do frete
payment/id	Id do método de pagto
payment/installmentQuantity	Parcela do método
shipping/id	Id da transportadora

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
sequence	sequencial do item no pedido	pedido_item.sequencial
sequence	sequencial do item no pedido	pedido_item.idpedidoitem
id	id do pedido na climba	pedido_item.idpedidopda
sku	Sku do item na climba
productId	Id do item no ERP
quantity	Quantidade do item	pedido_item.qt
sellingPrice	Valor unitario do item	pedido_item.valor
sellingPrice	Valor de pauta	pedido_item.valorpauta
sellingPrice	Valor sugerido	pedido_item.valorsugerido
quantity * sellingPrice	Valor total do item	pedido_item.valortotal
discountValue	Valor do desconto	pedido_item.valordesconto
discountValue/quantity * sellingPrice	Percentual do desconto	pedido_item.perc_desconto
additionValue	Valor de acrescimo	pedido.valoracrescimo
additionValue/quantity * sellingPrice	Percentual de acrescimo	pedido_item.perc_acrescimo

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Climba"	Observação
birthDate	Data de nascimento
id	Id do cliente na Climba
name	Fantasia
name	Razão
gender  = "m" ou "f"	Sexo
email	e-mail
email	e-mail NF-e
documents/ type	-
type  = "cpf"	-
number	CPF
type = "cnpj"	-
number	CNPJ
type = "ie"	-
number	IE
type = "rg"
number	RG
phones
type = "primary"
number	Fone
type = "secundary"
number	Fone 2
type = "others"
number	Fax
shippingAddress
street	Endereço
streetNumber	Número
complement	Complemento
district	Bairro
state	UF
zipCode	CEP
city	Nome da Cidade

---

 

 

 

 

(Desenvolvimento) Magento

Documentação e suporte

• https://developer.adobe.com/commerce/webapi/rest/quick-reference/
• Suporte Magento;
  • Colocar numero aqui
• Tem ambiente de homologação?
  • Não

---

Autenticação

• URL API: Informado pelo cliente através da Climba.

• Usuario: Informado pelo cliente através da Magento.

• Senha: Informado pelo cliente através da Magento.

---

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos);

• Envio de itens;

• Busca de pedidos;

• Busca de clientes. 

• Envio de nota fiscal de saída;

---

Envio de marcas

Resource	Método
brands	POST
brands/<Id da marca na Climba>	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tag de envio	O que será enviado
id	Id da marca na Climba
name	Descrição da marca
description	Null

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Climba	Id retornado	IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

 

---

Envio de categorias

Resource	Método
categories	POST
categories/<Id da categoria na Climba>	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
parentId	Id do grupo ou catalogo pai no ERP
name	descrição do grupo ou catálogo
order	Classificacao do grupo ou catalogo
description	Null

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Climba	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens simples

Resource	Método
products	POST
products/<Id do item no ERP>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

 

---

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba.
    • Informar padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão.
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba.
    • Informa padrão.

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
id	Numero do pedido
customerComment	Observação
shippingAddress/state	UF de destino
name	nome do cliente
sourceId	id marketplace
totalValue	Valor total do pedido
totalValue	Valor total dos itens
discountValue	Valor do desconto
additionValue	Valor do acréscimo
shippingValue	Valor do frete
payment/id	Id do método de pagto
payment/installmentQuantity	Parcela do método
shipping/id	Id da transportadora

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
sequence	sequencial do item no pedido	pedido_item.sequencial
sequence	sequencial do item no pedido	pedido_item.idpedidoitem
id	id do pedido na climba	pedido_item.idpedidopda
sku	Sku do item na climba
productId	Id do item no ERP
quantity	Quantidade do item	pedido_item.qt
sellingPrice	Valor unitario do item	pedido_item.valor
sellingPrice	Valor de pauta	pedido_item.valorpauta
sellingPrice	Valor sugerido	pedido_item.valorsugerido
quantity * sellingPrice	Valor total do item	pedido_item.valortotal
discountValue	Valor do desconto	pedido_item.valordesconto
discountValue/quantity * sellingPrice	Percentual do desconto	pedido_item.perc_desconto
additionValue	Valor de acrescimo	pedido.valoracrescimo
additionValue/quantity * sellingPrice	Percentual de acrescimo	pedido_item.perc_acrescimo

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Climba"	Observação
birthDate	Data de nascimento
id	Id do cliente na Climba
name	Fantasia
name	Razão
gender  = "m" ou "f"	Sexo
email	e-mail
email	e-mail NF-e
documents/ type	-
type  = "cpf"	-
number	CPF
type = "cnpj"	-
number	CNPJ
type = "ie"	-
number	IE
type = "rg"
number	RG
phones
type = "primary"
number	Fone
type = "secundary"
number	Fone 2
type = "others"
number	Fax
shippingAddress
street	Endereço
streetNumber	Número
complement	Complemento
district	Bairro
state	UF
zipCode	CEP
city	Nome da Cidade

---

Envio de Nota fiscal

Resource	Método
orders/<id do pedido pda>/billed	POST

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados

Tag de envio	O que será enviado
number	Número da NFS
nfeAccessKey	Chave eletrônica da NFS
xml	XML da NFS
logisticOperatorId	Id da Operador logistico informada na configuração. Se não envia vazio.

 

 

 

(Desenvolvimento) Bitfuel

Documentação e suporte

• https://www.climba.dev/documentacao-api-v1/
• Normalmente o Suporte com a Climba é via WhatsApp: 
  • Colocar numero aqui
• Tem ambiente de homologação?
  • Colocar a Url de teste
  • Colocar o Token de teste
  • Colocar site
    • Colocar usuario
    • Colocar senha

---

Autenticação

• URL API: Informado pelo cliente através da Climba.

• Token de acesso: Informado pelo cliente através da Climba.

---

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos ou catálogos);

• Envio de itens;

• Envio de itens com variação (agrupamento);

• Envio de nota fiscal de saída;

• Busca de pedidos;

• Busca de clientes. 

---

Envio de marcas

Resource	Método
brands	POST
brands/<Id da marca na Climba>	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tag de envio	O que será enviado
id	Id da marca na Climba
name	Descrição da marca
description	Null

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Climba	Id retornado	IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

 

---

Envio de categorias

Resource	Método
categories	POST
categories/<Id da categoria na Climba>	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
parentId	Id do grupo ou catalogo pai no ERP
name	descrição do grupo ou catálogo
order	Classificacao do grupo ou catalogo
description	Null

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Climba	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens simples

Resource	Método
products	POST
products/<Id do item no ERP>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de itens com variação

Resource	Método
products	POST
products/A<id do agrupamento no ERP>	PUT

Regras para envio

• • Somente agrupamentos com o campo "Exporta para Climba" marcado.

  • Somente itens do agrupamento com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <"A"+Id do agrupamento no ERP>, são enviados os dados para atualização (PUT).
  • Na Climba os agrupamento serão os produtos principais e os itens dos agrupamentos serão as variações.
  • Atributos da variação são COR e TAMANHO.

Opções na Configuração

• • Campo "Exporta itens agrupados" deve estar marcado.

  • Sku: o campo "SKU do produto" define se o SKU do item de variação será  o iditem ou referencia.

  • Preço: o campo "Utilizar" define qual o preço de cada item de variacao que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado. 
    • Respeita o campo "Qt.Múltiplo" do cadastro do item. 

Dados enviados

Tags de envio	O que será enviado
id	"A" + Id do agrupamento no ERP
status	Status do agrupamento no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo de um item do agrupamento
brandId	Id da climba vinculado a marca de um item do agrupamento
name	Descrição do agrupamento
description	Observação de um item do agrupamento
productVariants	<as tags abaixo serão enviadas pra cada item do agrupamento>
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	Id da cor do item
name	Descrição da cor
attributeGroupId	"1"
id	Id do tamanho do item
name	Descrição do tamanho
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens agrupados

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

Envio de variações

Cores

Resource	Método
attributes	POST
attributes/1/<Id da cor no ERP>	PUT

Regras para envio

• • Somente cores Ativas.
  • Somente cores com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro da cor. (Data de atualização do cadastro da cor maior que a data da ultima sincronização da cor) 

Dados enviados

Tag de envio	O que será enviado
id	Id da cor no ERP
name	Descrição da cor
attributeGroupId	"1"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização da Cor	data e hora atual	Cor.DatahoraultimaSincClimba

Tamanhos

Resource	Método
attributes	POST
attributes/2/<Id do tamanho no ERP>	PUT

Regras para envio

• • Somente tamanhos Ativos.
  • Somente tamanhos com o campo "Exporta para Climba" marcado.
  • Primeira sincronização ou alteração no cadastro de tamanho. (Data de atualização do cadastro do tamanho maior que a data da ultima sincronização do tamanho) 

Dados enviados

Tag de envio	O que será enviado
id	Id do tamanho no ERP
name	Descrição do tamanho
attributeGroupId	"2"

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do tamanho	data e hora atual	Tamanho.DatahoraultimaSincClimba

---

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba.
    • Informar padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão.
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba.
    • Informa padrão.

Dados usados para criar o pedido

Tag de retorno	Campo correspondente
id	Id do pedido pda
id	Numero do pedido
customerComment	Observação
shippingAddress/state	UF de destino
name	nome do cliente
sourceId	id marketplace
totalValue	Valor total do pedido
totalValue	Valor total dos itens
discountValue	Valor do desconto
additionValue	Valor do acréscimo
shippingValue	Valor do frete
payment/id	Id do método de pagto
payment/installmentQuantity	Parcela do método
shipping/id	Id da transportadora

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Tag de retorno	Campo correspondente	Base de dados
sequence	sequencial do item no pedido	pedido_item.sequencial
sequence	sequencial do item no pedido	pedido_item.idpedidoitem
id	id do pedido na climba	pedido_item.idpedidopda
sku	Sku do item na climba
productId	Id do item no ERP
quantity	Quantidade do item	pedido_item.qt
sellingPrice	Valor unitario do item	pedido_item.valor
sellingPrice	Valor de pauta	pedido_item.valorpauta
sellingPrice	Valor sugerido	pedido_item.valorsugerido
quantity * sellingPrice	Valor total do item	pedido_item.valortotal
discountValue	Valor do desconto	pedido_item.valordesconto
discountValue/quantity * sellingPrice	Percentual do desconto	pedido_item.perc_desconto
additionValue	Valor de acrescimo	pedido.valoracrescimo
additionValue/quantity * sellingPrice	Percentual de acrescimo	pedido_item.perc_acrescimo

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Tag de retorno	Campo correspondente
"Cadastrado via Climba"	Observação
birthDate	Data de nascimento
id	Id do cliente na Climba
name	Fantasia
name	Razão
gender  = "m" ou "f"	Sexo
email	e-mail
email	e-mail NF-e
documents/ type	-
type  = "cpf"	-
number	CPF
type = "cnpj"	-
number	CNPJ
type = "ie"	-
number	IE
type = "rg"
number	RG
phones
type = "primary"
number	Fone
type = "secundary"
number	Fone 2
type = "others"
number	Fax
shippingAddress
street	Endereço
streetNumber	Número
complement	Complemento
district	Bairro
state	UF
zipCode	CEP
city	Nome da Cidade

---

Envio de Nota fiscal

Resource	Método
orders/<id do pedido pda>/billed	POST

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados

Tag de envio	O que será enviado
number	Número da NFS
nfeAccessKey	Chave eletrônica da NFS
xml	XML da NFS
logisticOperatorId	Id da Operador logistico informada na configuração. Se não envia vazio.

 

 

 

(Desenvolvimento) Digisoft

Documentação e suporte

• https://www.digisoftecommerce.com.br/
• Suporte com a Digisoft desconhecido
• Sem ambiente de homologação

---

Autenticação

• URL API: Informado pelo cliente através da Digisoft

• Token de acesso: Informado pelo cliente através da Digisoft

• PV: Informado pelo cliente através da Digisoft

---

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos);

• Envio de itens;

• Envio de estoque e preço dos itens;
• Envio de cliente;

---

Envio de marcas

Resource	Método
brands	POST
brands/<Id da marca na Climba>	PUT

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tag de envio	O que será enviado
id	Id da marca na Climba
name	Descrição da marca
description	Null

Tratamento de retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Climba	Id retornado	IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca	data e hora atual	IntegracaoEcommerce_Marca.DataHoraUltimaSinc

 

---

Envio de categorias

Resource	Método
categories	POST
categories/<Id da categoria na Climba>	PUT

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tags de envio	O que será enviado
id	Id da categoria na Climba
parentId	Id do grupo ou catalogo pai no ERP
name	descrição do grupo ou catálogo
order	Classificacao do grupo ou catalogo
description	Null

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Climba	Id retornado	IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo	data e hora atual	IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 

---

Envio de itens simples

Resource	Método
products	POST
products/<Id do item no ERP>	PUT

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tags de envio	O que será enviado
id	Id do item no ERP
status	Status do item no ERP: 1-Atuvo/0-Inativo
categories	Id da climba vinculado ao grupo/catalogo do item
brandId	Id da climba vinculado a marca do item
name	Descrição, descrição técnica, observação ou complemento
description	Observação do item
productVariants	-
sku	Id do item ou referencia
internalCode	Id do item no ERP
quantity	Quantidade em estoque do item
description	Observação do item
grossWeight	Peso bruto do item
netWeight	Peso liquido do item
height	Altura do item
width	Largura do item
length	Comprimento do item
prices	-
priceListId	"1"
price	Preço do item
priceFrom	"0"
attributes	-
id	"1"
name	"U"
attributeGroupId	"1"
id	"1"
name	"U"
attributeGroupId	"2"
barCode	Código de barra do item

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Tabela de controle		IntegracaoEcommerce_Item
Grava no ERP o id do item na Climba	Id retornado	IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	IntegracaoEcommerce_Item.DataHoraUltimaSinc

Envio das fotos do itens simples

Resource	Método
products/<Id do item no ERP>/pictures	DELETE
products/<id do item do ERP>/pictures/base64	POST

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tags de envio	O que será enviado
image	Foto do item em base64
position	Id da foto do item no ERP

Tratamento de Retorno

Operação	Dado	Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item	data e hora atual	Item.DataHoraUltimaSincClimbaFoto

---

 

 

 

 

 

Tray (Em desenvolvimento)

Funcionamento

A integração com a Tray foi desenvolvida em parceria com a Monvatti consultoria em marketing digital.

A idéia é vender a Tray com Monvatti junto pois isso aumenta as chances de sucesso e colocamos um especialista em e-commerce para apoiar nossos clientes.

Funcionalidade liberada na versao 18.6 - tarefa  370946

O que exportamos: SKU / Descrição do item / Estoque / Preço de venda(Este ultimo com parametro)

O que importamos: XML da nota fiscal de saida de vendas vinculada a pedidos com situação = "A enviar" e "Aguardando envio ml"

---

Documentação 

Na aba autenticação é solicitado 4 informações:

URL API e Code, deve solicitar a Tray via atendimento dentro do site.

Consumer Key e Consumer Secret são sempre os mesmos, segue informações abaixo:

<ag. informações monvatti>

Aba configurações você apenas seleciona qual SKU será exportado.

Na aba Estoque você parametriza filial/deposito que vai exportar, e se abade quantidade reservada do saldo disponivel.

A precificação também pode ser configurada, além disso existe um parametro adicional se atualiza o preço de venda ou não.

Ao importar um XML de venda, o sistema verifica pelo CPF/CNPJ se o cliente já existe e caso não, é cadastrado automaticamente, nesta aba você parametriza o tipo de cliente.

E por fim, na aba NFS é parametrizado as informações para importação das notas de venda.

Um ponto importante para exportação dos itens, na Tray é configurado apenas o parametro exporta Tray dentro do cadastro do item, aba adicionais / Outros.