E-commerce

(Desenvolvimento) Bitfuel

Documentação e suporte


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brands POST
brands/<Id da marca na Climba> PUT
Regras para envio
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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

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
Opções na Configuração
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

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
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
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
Opções na Configuraçã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
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 
Opções na Configuração
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 
Opções na Configuração
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


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brands POST
brands/<Id da marca na Climba> PUT
Regras para envio
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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

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

 
 

 

 

 

(Desenvolvimento) Ideris

Documentação e suporte


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brand POST
brand PUT
Regras para envio
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuraçã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
Opções na Configuraçã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
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 
Opções na Configuração
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 
Opções na Configuração
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 
Dados enviados

Tag de envio

O que será enviado

orderId

Id do pedido na Ideris

statusId

1009 - Expedição

 

 



Loja Integrada

Documentação e suporte

Autenticação


O que é sincronizado?


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
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuraçã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
Opções na Configuraçã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
Opções na Configuração
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

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
Opções na Configuração
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

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
Opções na Configuraçã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
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 
Opções na Configuração
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 
Opções na Configuração
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 
Dados enviados

Tag de envio

O que será enviado

orderId

Id do pedido na Ideris

statusId

1009 - Expedição

 

 

(Desenvolvimento) Magento

Documentação e suporte


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brands POST
brands/<Id da marca na Climba> PUT
Regras para envio
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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

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
Opções na Configuraçã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
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 
Opções na Configuração
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 
Opções na Configuração
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.

 

 

 

Climba

Documentação e suporte

 


Ambiente de homologação

 


Autenticação

 


O que é sincronizado?

 


Envio de marcas

Resource Método
brands POST
brands/<Id da marca na Climba> PUT
Regras para envio
Opções na Configuração
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
Opções na Configuração
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
Opções na Configuração
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

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
Opções na Configuração
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

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
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
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
Opções na Configuraçã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
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 
Opções na Configuração
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 
Opções na Configuração
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.

 

 

 

Nuvemshop

SOBRE O NUVEMSHOP

A NUVEMSHOP é um site e-commerce que permite criar sua própria loja online auto gerenciável, sem a necessidade de conhecimentos técnicos. Ela oferece uma solução tecnológica pensada em micro, pequenas, médias e grandes empresas. 

O conteúdo aqui incluso referencia-se a uma integração entre ERP X NUVEMSHOP, permitindo ao usuário novas opções de recursos para melhor organização do seu negócio. 

Siga os passos abaixo, sem pular nenhuma etapa, e no fim poderá utilizar essa melhoria corretamente. 

LOGIN NO NUVEMSHOP

Caso o cliente não possua uma conta, é necessário criar. Importante ressaltar que a Ema é parceira do NS, então a conta disponibilizada é uma conta DEMO para testes. Mesmo que apareçam avisos de plano ou encerramento de teste gratis, a conta possui todas as funções necessárias para os testes com o ERP. 

image-1687279139909.png

O aplicativo é o responsável pela comunicação da API com a loja, neste exemplo é usado a loja 'Demo Casa das Maquinas', que é uma loja base para testes.

image-1688391186957.png

OBTENDO O TOKEN

image-1688390058855.png

Isso o levará para uma pagina onde estará o código para obter acesso a API. 

image-1688390237701.png

OBTENDO O TOKEN - API
{
"client_id": "7433",
"client_secret": "2e6156a1b496e8552cfc656e71e3c66d5db4e2b008ecf1eb",
"grant_type": "authorization_code",
"code": "e4a01f5ac80ab8f8d3e3c8ef8c3403df7447bbce"
}

Sendo:

image-1688390491339.png

Exemplo de retorno:

{
    "access_token": "7de79ca10bf0a3eaa059f6e226d4890202fd1ae9",
    "token_type": "bearer",
    "scope": "read_content,write_content,read_products,write_products,read_coupons,write_coupons,read_customers,write_customers,read_orders,write_orders,read_shipping,write_shipping,read_discounts,write_discounts,read_draft_orders,write_draft_orders,write_scripts,read_locations,write_locations,read_fulfillment_orders,write_fulfillment_orders",
    "user_id": 2847442
}

* Ao configurar as informações no POSTMAN, não é necessário informar nada nas abas de 'Params', 'Authorization', 'Headers' ets. Apenas o endereço POST e a aba 'Body': 

image-1688391432952.png

CONFIGURANDO A INTEGRAÇÃO NO ERP

image-1688392121178.png

image-1705667214183.png

Url do ambiente de teste: https://api.nuvemshop.com.br/v1/3324150

Token do ambiente de teste: bearer ea136f8dae7e7361fcb4dfd25c645da1c88df815

image-1688392620438.png

Importante!

image-1706551240749.png

Ao marcar o parâmetro 'Utiliza 'De/Para' na transportadora ao importar pedido para ERP, a aba 'Transportadoras' ficará visível para configuração. 

Marcando o parâmetro "Insere na observação do pedido os itens sem valor ou sem SKU", ao sincronizar o pedido do NUVEMSHOP para o ERP com itens sem SKU, ou seja, item criados diretamente no NUVEMSHOP, o sistema irá informar na observação do pedido importado. 

Ex: 

image-1706556813306.png

image-1705667490287.png

image-1689945523063.png

image-1706550914960.png

image-1690995058992.png

E está pronto! integração concluída! 

INFORMAÇÕES ADICIONAIS: 
ITEM = PRODUTO 

Vamos mostrar abaixo a relação de Item e Produto de ERP x Nuvemshop. Com a integração E-commerce devidamente configurada, acesse: 

image-1689353763345.png

image-1705668134530.png

Importante!

image-1705667608365.png

image-1705667757463.png

SINCRONIZAÇÃO NUVEMSHOP 

image-1689354695651.png

Com isso, a sincronização será realizada. E isso já basta para cadastrar no NUVEMSHOP um produto (sendo denominado como "ITEM" no ERP). 

EX: 

image-1689354730489.png

Loja do ambiente de teste casadasmaquinas2:  https://www.nuvemshop.com.br/login

Login: desenvolvimento@ema.net.br

Senha: Dev@Ema#2023

image-1689354950506.png

TABELA DE PREÇO 

No NUVEMSHOP existe o campo "Promocional", que difere o valor do campo preço normal

image-1706549615884.png

Para realizar a configuração desse preço promocional é necessário vincular o item do ERP em uma tabela de preço. Acessar: 

image-1706550025007.png

Ao editar a tabela de preços, na aba 'Itens' é onde vincula o item/produto. O campo promocional é "Valor tabela" 

image-1706550233608.png

Importante ressaltar que, na aba 'Versões', é onde está a data em que este valor promocional é valido. Caso já tenha passado da data, o valor promocional não será enviado. 

* Verificar o campo 'Versão vigente' da tabela de preço. 

Após, realizar a alteração, acesse os parâmetros gerais do e-commerce e vincule a tabela de preço 

image-1706550686863.png

image-1706551031312.png

GRUPOS = CATEGORIA

Agora vamos complementar esse item, incluindo um grupo em seu cadastro. Acesse: 

image-1689355469686.png

image-1690996045905.png

Vincule esse grupo no item escolhido e realize a sincronização novamente. Em seguida verifique no NUVEMSHOP a categoria criada: 

image-1689355657431.png

image-1689355951856.png

image-1689356007180.png

* Os subgrupos vinculados também serão enviados ao NUVEMSHOP caso o parâmetro esteja marcado. 

CATALOGOS = CATEGORIA 

Assim como na configuração de grupo acima, é possível vincular o item do NUVEMSHOP com uma categoria, esta sendo um CATALOGO DE ITEM no ERP. Para isso, antes precisamos alterar as configurações da integração E-commerce para considerar a exportação de CATALOGO e não GRUPO

image-1690997698685.png

Feito, salve e acesse o cadastro de catálogos de itens:

image-1690997192299.png

image-1690997350629.png

image-1690997552556.png

Importante: 

image-1690999059465.png

ITEM COM MARCAS 

Para o envio de marcas vinculados ao item no NUVEMSHOP, acessar:

image-1705668293305.png

image-1705668429049.png

image-1705668574498.png

ITEM = ABA 'INTEGRAÇÕES'

image-1710953939064.png

image-1705669086738.png

Importante!

SINCRONIZAÇÃO ESTOQUE

Após realizar a inclusão do item no ERP e sincronizar para o NUVEMSHOP, precisamos atualizar o estoque do item. Acesse: 

image-1689623629408.png

image-1689623962484.png

image-1689624205256.png

Importante!

Outras informações como preço, descrição, observação são atualizadas ao editar no ERP e sincronizar novamente. Abaixo algumas regras implementadas na integração em relação ao estoque do item:

image-1705667869520.png

AGRUPAMENTO = VARIAÇÕES 

Vamos vincular um item em um agrupador no ERP e configurar sua grade/tamanho/cor. Porém, antes de iniciar, vamos verificar alguns parâmetro da integração E-commerce NUVEMSHOP: 

image-1705667902685.png

importante!

Abaixo algumas regras implementadas na integração em relação a este parâmetro: 

Agora vamos configurar o agrupamento para enviar. Acesse: 

image-1689599944728.png

image-1690995788978.png

Após isso, precisamos configurar a grade + tamanho + cores do agrupamento. Acesse: 

image-1689600748246.png

image-1689602132050.png

image-1689602221601.png

image-1689602610887.png

Importante!

O que acontece aqui é que o item enviado para o NS com um agrupamento é incluído como uma VARIAÇÃO. E o agrupamento em si é incluído como um produto.  

image-1689622198596.png

SINCRONIZAÇÃO CLIENTE

Existe apenas uma forma de incluir um novo cliente no ERP pelo NUVEMSHOP, que seria ao incluir um pedido, colocando as informações do cliente (Nome, Sobrenome, E-mail, Telefone e CPF/CNPJ).  

image-1698684469480.png

Importante!

Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de CLIENTE

Coloque as informações do cliente e acesse o ERP para realizar a sincronização.

SINCRONIZAÇÃO PEDIDOS 

Antes de tudo, acesse a configuração do E-commerce e vamos verificar algumas informações dos pedidos. 

image-1705667983646.png

Os pedidos importados do E-commerce devem seguir o padrão de método/condição configurados nesses dois campos. Agora, vamos criar um pedido no NUVEMSHOP e sincronizar para o nosso ERP.

image-1689622679255.png

Ex: 

Pedido - NUVEMSHOP

image-1691000352050.png

Pedido - ERP 

image-1691000408660.png

Importante!

Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de PEDIDO:

DE/PARA NA INTEGRAÇÃO DE PEDIDOS

Assim como informado acima, ao realizar a importação de um pedido do NUVEMSHOP, o sistema irá vincular o método e condição de pagamento automaticamente com o que está configurado na integração E-commerce.

Porém, existe um parâmetro permite com que o sistema traga diferentes métodos e condições de acordo com a forma de pagamento escolhida no site NUVEMSHOP. 

image-1705668014705.png

Em seguida, na aba 'Métodos', informe os métodos escolhidos para cada forma de pagamento no NUVEMSHOP. No exemplo abaixo, criamos uma forma de pagamento PERSONALIZADA (PIX) no site e o retorno dessa personalização é descrito como "custom". 

image-1691002551568.png

Com isso, todo pedido criado no NUVEMSHOP que possua o método de pagamento PIX (custom) será importado no ERP com o método 'Boleto' e a condição 'Em espécie (dinheiro)'. 

Importante! 

TABELAS E LOG E-COMMERCE 

Tabelas relacionadas à integração E-commerce (NÃO TODAS). Utilizamos os comando abaixo para "zerar" a base de teste e podermos começar a exportar novos registros sem dar nenhum conflito com sincronizações anteriores.

** IMPORTANTE realizar em uma base de teste e verificar se necessário adicionar a clausula WHERE, para não afetar registros importantes. 

DELETE 
  FROM INTEGRACAOECOMMERCE_GRUPO
UPDATE GRUPO 
   SET EXPORTAWEB = 'N'
DELETE 
  FROM INTEGRACAOECOMMERCE_ITEM
UPDATE ITEM 
   SET EXPORTAPALM = 'N'

Sobre os logs do E-commerce, toda vez que algum problema surge durante a sincronização o sistema guarda o retorno para consulta. Acesse: 

image-1689626716731.png

Importante que sempre depois de uma integração bem sucedida, ter o costume de verificar o log para garantir que pequenos detalhes não passem despercebidos. Assim como foi descrito ao longo deste conteúdo, algumas mensagens de erro são auto entendíveis ou de fácil solução para o usuário: 

Porém ainda existem outras mensagens mais técnicas que são mostradas em log e dependendo do contexto, são importantes serem verificadas. 

É necessário ABRIR TAREFAS sobre melhorias no log, caso necessário. 

TESTE / QA 

Para realizar os testes dessa integração com possíveis melhorias e correções, leia o conteúdo desde o começo e acesse o ambiente demo (para testes): 

Tudo o que for feito no ERP (conforme os exemplos acima) e depois sincronizado, aparecerá nesse ambiente demo (devidamente configurado nessa loja). 

Importante ressaltar que a Ema é parceira do NUVEMSHOP, então a conta disponibilizada é uma conta DEMO para testes. Mesmo que apareçam avisos de plano ou encerramento de teste grátis, a conta possui todas as funções necessárias para os testes com o ERP. Se houver duvidas, contatar o suporte do NUVEMSHOP e informar o e-mail, passando as duvidas em seguida. 

image-1691003139898.png

image-1691003232568.png

image-1691003337222.png

 

Tray

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"

ATENÇÃO: Quando realizar a primeira integração, o sistema vai importar as notas de saida emitidas na tray dos ultimos 90 dias, por conta disso pode demorar um pouco mais do que esperavamos.


Documentação 

image-1732623581464.png

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>

image-1732623730079.png

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

image-1732623752699.png

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

image-1732623783487.png

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.

image-1732623806949.png

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.

image-1732623866583.png

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

image-1732623927747.png

Ambiente demo configurado com a tray, documentação disponivel aqui.

RFP disponivel em https://portal.ema.net.br/v2/bpm/instancias/criar/398?TL_CLASSIFICACAO=37.1.54&IDITEM=37&IDMODULO=1&IDOPERACAO=54