# E-commerce # (Desenvolvimento) Bitfuel #### **Documentação e suporte** - [https://www.climba.dev/documentacao-api-v1/](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](https://kb.ema.net.br/uploads/images/gallery/2023-11/sDcjyEDa9bylcoXL-configuracaourlapi.png): Informado pelo cliente através da Climba. - [Token de acesso](https://kb.ema.net.br/uploads/images/gallery/2023-11/ak5SVhj96u5akXDi-configuracaotoken.png): 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 |
**Tag de envio** | **O que será enviado** |
**id** | Id da marca na Climba |
**name** | [Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png) |
**description** | Null |
**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 |
**Resource** | **Método** |
categories | POST |
categories/<Id da categoria na Climba> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products | POST |
products/<Id do item no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
products | POST |
products/A<id do agrupamento no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
attributes | POST |
attributes/1/<Id da cor no ERP> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da cor no ERP |
**name** | Descrição da cor |
**attributeGroupId** | "1" |
**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 |
**Resource** | **Método** |
attributes | POST |
attributes/2/<Id do tamanho no ERP> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id do tamanho no ERP |
**name** | Descrição do tamanho |
**attributeGroupId** | "2" |
**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 |
**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 |
**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 |
**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** | |
**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 |
**Resource** | **Método** |
orders/<id do pedido pda>/billed | POST |
**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. |
**Resource** | **Método** |
brands | POST |
brands/<Id da marca na Climba> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da marca na Climba |
**name** | [Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png) |
**description** | Null |
**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 |
**Resource** | **Método** |
categories | POST |
categories/<Id da categoria na Climba> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products | POST |
products/<Id do item no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
brand | POST |
brand | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da marca na Ideris |
**description** | Descrição da marca |
**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 |
**Resource** | **Método** |
department | POST |
department | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id do departamento na Ideris |
**name** | Descrição da família no ERP |
**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 |
**Resource** | **Método** |
ncm | POST |
ncm | PUT |
**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 |
**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 |
**Resource** | **Método** |
category | POST |
category | PUT |
**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 |
**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 |
**Resource** | **Método** |
sku | POST |
sku | PUT |
**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 |
**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 |
**Resource** | **Método** |
ListingModel | POST |
ListingModel | PUT |
**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 |
**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 |
**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 |
**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 |
**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** | |
**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 |
**Resource** | **Método** |
order/<id do pedido pda>/invoice | POST |
**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" |
**Resource** | **Método** |
order | PUT |
**Tag de envio** | **O que será enviado** |
**orderId** | Id do pedido na Ideris |
**statusId** | 1009 - Expedição |
**Resource** | **Método** |
marca | POST |
marca/<Id da marca na Loja integrada> | PUT |
marca/<id da marca no ERP>?id\_externo=1 | PUT |
**Tag de envio** | **O que será enviado** |
**id\_externo** | Id da marca no ERP |
**nome** | [Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png) |
**slug** | [Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png) |
**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 |
**Resource** | **Método** |
categoria | POST |
categoria/<Id da categoria na Loja integrada> | PUT |
categoria/<id do grupo no ERP>?id\_externo=1 | PUT |
**Tags de envio** | **O que será enviado** |
**id\_externo** | Id do grupo no ERP |
**nome** | descrição do grupo |
**descricao** | descrição do grupo |
**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 |
**Resource** | **Método** |
grades | POST |
categoria/<id da grade no ERP>?id\_externo=1 | PUT |
**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 |
**Operação** | **Dado** | **Base de dados ERP** |
Atualiza no ERP a data da ultima sincronização da grade | data e hora atual | grade.DataHoraUltimaSincLoja |
**Resource** | **Método** |
grade/<id da grade no ERP>/variacao?id\_externo=1 | POST |
**Tags de envio** | **O que será enviado** |
**id\_externo** | Id do tamanho no ERP |
**nome** | descrição do tamanho |
**Operação** | **Dado** | **Base de dados ERP** |
Atualiza no ERP a data da ultima sincronização do tamanho | data e hora atual | tamanho.DataHoraUltimaSincLoja |
**Resource** | **Método** |
produto | POST |
produto/<Id do item na Loja integrada> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
produto | POST |
produto/<Id do item na Loja integrada> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**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 |
**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 |
**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** | |
**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 |
**Resource** | **Método** |
orders/<id do pedido pda>/billed | POST |
**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. |
**Resource** | **Método** |
order | PUT |
**Tag de envio** | **O que será enviado** |
**orderId** | Id do pedido na Ideris |
**statusId** | 1009 - Expedição |
**Resource** | **Método** |
brands | POST |
brands/<Id da marca na Climba> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da marca na Climba |
**name** | [Descrição da marca](https://kb.ema.net.br/uploads/images/gallery/2023-11/pwqLvjwToChTeUer-marcadescricao.png) |
**description** | Null |
**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 |
**Resource** | **Método** |
categories | POST |
categories/<Id da categoria na Climba> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products | POST |
products/<Id do item no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**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 |
**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 |
**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** | |
**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 |
**Resource** | **Método** |
orders/<id do pedido pda>/billed | POST |
**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. |
**Resource** | **Método** |
brands | POST |
brands/<Id da marca na Climba> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da marca na Climba |
**name** | Descrição da marca |
**description** | Null |
**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 |
**Resource** | **Método** |
categories | POST |
categories/<Id da categoria na Climba> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products | POST |
products/<Id do item no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
products | POST |
products/A<id do agrupamento no ERP> | PUT |
**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 |
**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 |
**Resource** | **Método** |
products/<Id do item no ERP>/pictures | DELETE |
products/<id do item do ERP>/pictures/base64 | POST |
**Tags de envio** | **O que será enviado** |
**image** | Foto do item em base64 |
**position** | Id da foto do item no ERP |
**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 |
**Resource** | **Método** |
attributes | POST |
attributes/1/<Id da cor no ERP> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id da cor no ERP |
**name** | Descrição da cor |
**attributeGroupId** | "1" |
**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 |
**Resource** | **Método** |
attributes | POST |
attributes/2/<Id do tamanho no ERP> | PUT |
**Tag de envio** | **O que será enviado** |
**id** | Id do tamanho no ERP |
**name** | Descrição do tamanho |
**attributeGroupId** | "2" |
**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 |
**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 |
**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 |
**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** | |
**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 |
**Resource** | **Método** |
orders/<id do pedido pda>/billed | POST |
**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. |
Importante!
- No campo "TOKEN de acesso" é necessário colocar a descrição **bearer** + o token de acesso que conseguimos nos passos acima. - \*\*\* Importante ressaltar que a descrição **bearer** deve ser em **MINUSCULO** e deve existir um **ESPAÇO** entre o bearer e o token de acesso. - Além das informações obrigatórias, não esqueça de configurar os campos das outras abas da configuração E-commerce como '**Configuração**': [](https://kb.ema.net.br/uploads/images/gallery/2024-01/I5X079waHbZR5nSb-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: [](https://kb.ema.net.br/uploads/images/gallery/2024-01/dNxy53Cw0r3rJlAX-image-1706556813306.png) - **Aba** '**Transportadoras**' [](https://kb.ema.net.br/uploads/images/gallery/2024-01/o73f36Tv973hREPV-image-1705667490287.png) - **Aba 'Estoque'** [](http://kb.ema.net.br/uploads/images/gallery/2023-07/1PGNDytyQRbFBxL2-image-1689945523063.png) - **Aba 'Preço':** [](https://kb.ema.net.br/uploads/images/gallery/2024-01/azZNMtsGcO4FHwRt-image-1706550914960.png) - **Aba 'Pedido':** [](http://kb.ema.net.br/uploads/images/gallery/2023-08/bNHqGKXrvbYub6GT-image-1690995058992.png) **E está pronto! integração concluída!** ##### **INFORMAÇÕES ADICIONAIS:** - A implementação desta integração no ERP saiu na versão **17.9.0.614**, tarefa #**344356** - Correções mais importante foram implementadas na release **17.13.4.620**, então é aconselhável atualizar para essa versão caso essa integração for implementada em cliente. - Segundo o retorno do suporte NUVEMSHOP, atualmente só é possível usar um e-mail de cadastro para cada loja. - O token de acesso gerado só é valido por 5 minutos. Caso a configuração da integração E-commerce não seja concluída antes desse tempo, será necessário gerar um novo token de acesso, conforme os passos acima. ##### **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: - Estoque> - Itens> - Novo> [](http://kb.ema.net.br/uploads/images/gallery/2023-07/LdOwwA5j8n5SGtaF-image-1689353763345.png) - Ao criar um novo item, na aba 'Outros', marque a opção '**Exporta para NuvemShop**'. [](https://kb.ema.net.br/uploads/images/gallery/2024-01/i5nvk9SxGw7wjt8J-image-1705668134530.png) - Com isso, finalize o cadastro e salve.**Importante!**
- Quando for enviado o item para a loja, o sistema buscará pelo SKU se este item já existe no NUVEMSHOP. Caso não exista, criará um novo. Caso exista, irá atualizar o atual. - Por padrão, os itens enviados do ERP estão marcados para serem visíveis na loja. - Um item inativo no ERP será enviado para o E-commerce como oculto e não ficará visível na loja. - A descrição do item no NUVEMSHOP depende do que está configurado na integração E-commerce. Verifique o campo que o sistema leva como descrição do produto e altere se necessário: [](https://kb.ema.net.br/uploads/images/gallery/2024-01/knPwm849Dah34qql-image-1705667608365.png) - O parâmetro 'Envia descrição (observação) do item' é para enviar o campo 'Observação' do cadastro de itens no ERP/ERPx: [](https://kb.ema.net.br/uploads/images/gallery/2024-01/XcdnoEwdfqgVPdEN-image-1705667757463.png) ##### **SINCRONIZAÇÃO NUVEMSHOP** - Acesse 'Configurações' e clique em 'Integrar E-commerce' [](http://kb.ema.net.br/uploads/images/gallery/2023-07/4LjwikRxk5TRPxJl-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: - ERP - Item: [](http://kb.ema.net.br/uploads/images/gallery/2023-07/OGsSZOeIC4YNwJiU-image-1689354730489.png) **Loja do ambiente de teste casadasmaquinas2: https://www.nuvemshop.com.br/login** **Login: desenvolvimento@ema.net.br** **Senha: [Dev@Ema#2023](mailto:Dev@Ema#2023)** - NUVEMSHOP - Produto: [](http://kb.ema.net.br/uploads/images/gallery/2023-07/EmCzynzNmmNqqQl8-image-1689354950506.png) ##### **TABELA DE PREÇO** No NUVEMSHOP existe o campo "Promocional", que difere o valor do campo preço normal [](https://kb.ema.net.br/uploads/images/gallery/2024-01/LLggJQYgBuDnMe7t-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: - Vendas - Tabela de preço [](https://kb.ema.net.br/uploads/images/gallery/2024-01/iKErdNVutnwNLxd3-image-1706550025007.png) Ao editar a tabela de preços, na aba 'Itens' é onde vincula o item/produto. O campo promocional é "Valor tabela" [](https://kb.ema.net.br/uploads/images/gallery/2024-01/6Hk2kGyMbj6I6VYK-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 [](https://kb.ema.net.br/uploads/images/gallery/2024-01/Ibx3SIQjgIQQLoML-image-1706550686863.png) - Realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) do E-commerce e verifique no NuvemShop. [](https://kb.ema.net.br/uploads/images/gallery/2024-01/9QALUbocM5KyLIKx-image-1706551031312.png) ##### **GRUPOS = CATEGORIA** Agora vamos complementar esse item, incluindo um grupo em seu cadastro. Acesse: - Estoque> - Grupos> - Novo> [](http://kb.ema.net.br/uploads/images/gallery/2023-07/Ya4TcfUW3wUyvxoO-image-1689355469686.png) - Ao criar um novo, é importante que o parâmetro '**Exporta para NuvemShop**' esteja marcado, pois caso não esteja, ao realizar a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems), o item será enviado sem grupo. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/xS32giUiYvPFfAsy-image-1690996045905.png) Vincule esse grupo no item escolhido e realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) novamente. Em seguida verifique no NUVEMSHOP a categoria criada: - ERP - Grupo: [](http://kb.ema.net.br/uploads/images/gallery/2023-07/Dh4u5OjwyOyiAq0O-image-1689355657431.png) - NUVEMSHOP - Categoria: [](http://kb.ema.net.br/uploads/images/gallery/2023-07/vd7ekrox6IrQCq1X-image-1689355951856.png) - NUVEMSHOP - Ao editar o produto: [](http://kb.ema.net.br/uploads/images/gallery/2023-07/Q7HlPZeECZvew1vi-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**. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/owQHzVnEEFddQPXb-image-1690997698685.png) Feito, salve e acesse o cadastro de catálogos de itens: - Vendas > - Catalogo de itens > [](http://kb.ema.net.br/uploads/images/gallery/2023-08/eXiTsSIXWUhFcO5Q-image-1690997192299.png) - Crie ou edite um catálogo de itens e marque o parâmetro '**Exporta para NuvemShop**': [](http://kb.ema.net.br/uploads/images/gallery/2023-08/3ikwuOCelELWBGvI-image-1690997350629.png) - Em seguida, na aba 'Itens', coloque na grade um item que deseja vincular a este catalogo. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/jzDgscL3fiJNtW1A-image-1690997552556.png) - Realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) do E-commerce e verifique no NuvemShop.Importante:
- Não esqueça a configuração de categoria (grupo ou catalogo) nas configurações do E-commerce! - Caso o item para exportar esteja vinculado a um catalogo que é FILHO (ou seja, é um catalogo vinculado a outro catalogo pai), o NUVEMSHOP irá realizar a importação de catalogo PAI e FILHO. Esse é um comportamento do E-commerce, mesmo que o catalogo pai não esteja marcado para exportar. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/7LFCs8oi6Q1VaQgO-image-1690999059465.png) - Após já ter sido enviada a primeira integração dos itens: - Se houver necessidade de **alterar a configuração do E-commerce** em relação ao envio de categoria (grupo ou catalogo), os itens deverão ser vinculados a nova categoria escolhida (grupo ou catalogo). - Se já estiverem vinculados **ANTES** da alteração, deverá ser atualizado o campo "**DATAHORAULTIMAATUALIZACAO**" dos itens que são exportados para o NUVEMSHOP. ##### **ITEM COM MARCAS** Para o envio de marcas vinculados ao item no NUVEMSHOP, acessar: - Estoque > - Marcas > [](https://kb.ema.net.br/uploads/images/gallery/2024-01/gB33vTnMbor90UUm-image-1705668293305.png) - Deve estar marcado o parâmetro 'Exporta para Nuvemshop' para sincronizar para o e-commerce. - Em seguida, editar o item e vincular a marca na aba 'Adicionais' > 'Informações gerais' [](https://kb.ema.net.br/uploads/images/gallery/2024-01/DiOp7PCpclQHTODn-image-1705668429049.png) - Realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) conforme passado anteriormente. - Verifique no NUVEMSHOP a marca vinculada no item em 'Tags e SEO' [](https://kb.ema.net.br/uploads/images/gallery/2024-01/2zD0kal7ulEp9jyb-image-1705668574498.png) ##### **ITEM = ABA 'INTEGRAÇÕES'** - Editar o item > - Acessar a aba 'Integrações' - Preencher os campos disponíveis: - Campo 'Título SEO'. - Campo 'Descrição SEO'. - Campo 'Tags' - Campo 'Link vídeo'. - Campo 'Comprimento'. - Campo 'Largura'. - Campo 'Altura'. - Campo 'Área m2': Este campo é somente leitura e faz um calculo baseado no comprimento, largura e altura informados. - Parâmetro 'Frete grátis' [](https://kb.ema.net.br/uploads/images/gallery/2024-03/c8gEeSklP24KJe9I-image-1710953939064.png) - Realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) conforme passado anteriormente. - Verifique no NUVEMSHOP o item sincronizado. - O campo 'Link video' disponível mais acima. - E os demais campos estarão disponíveis em 'Tags e SEO'. [](https://kb.ema.net.br/uploads/images/gallery/2024-01/oUY7O5StG0bWrYVA-image-1705669086738.png) - O parâmetro 'Frete grátis' mais abaixo conforme imagem.Importante!
- A aba 'Integrações' só ficará disponível no cadastro do cliente caso a integração e-commerce do sistema for do tipo 'NuvemShop'. - Caso o item que você esteja editando e colocando as informações na aba 'Integrações' fazer parte de um agrupamento, todos os outros itens agrupados juntos terão as informações **dessa aba** replicadas. Altere em um item, e todos os outros serão atualizados. Caso o item seja simples sem nenhum agrupamento, as informações serão enviadas individualmente. ##### **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: - Estoque> - "Ajustar estoque"> [](http://kb.ema.net.br/uploads/images/gallery/2023-07/yHj1TLvAZYZYOToT-image-1689623629408.png) - Vincule o item que foi sincronizado mais cedo e mude seu saldo. [](http://kb.ema.net.br/uploads/images/gallery/2023-07/MSHpsG1DitZbmgcD-image-1689623962484.png) - Realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) conforme passado anteriormente. - Verifique no NUVEMSHOP o novo saldo de estoque deste item. [](http://kb.ema.net.br/uploads/images/gallery/2023-07/GJhyoS9M2jiHnB7b-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: - O NUVEMSHOP não aceita envio de estoque negativo, então se o estoque atual do item no ERP for negativo, será enviado estoque zero para o E-commerce. - Integração de estoque atual após ajuste manual de estoque (conforme mostrado acima) ou nota fiscal de entrada, respeitando o parâmetro de estoque reservado das configurações de E-commerce, se estiver marcado, envia o estoque considerando os reservados. [](https://kb.ema.net.br/uploads/images/gallery/2024-01/GP9OZHSlYuE4xER7-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: - **Exporta itens agrupados e suas variações (cor e tamanho):** Esse parâmetro tem que estar marcado para que o agrupamento seja enviado para o NUVEMSHOP. [](https://kb.ema.net.br/uploads/images/gallery/2024-01/QseBQ4kFeKQVKErn-image-1705667902685.png)importante!
Abaixo algumas regras implementadas na integração em relação a este parâmetro: - Se configuração **NÂO** está marcada para exportar item agrupado: - Serão enviados os itens marcados para exportar para terceiros de forma individual, sem considerar agrupamento; - Se configuração **ESTÁ** marcada para exportar item agrupado: - Serão enviados os itens vinculados a agrupamento que exporta para terceiros e que tenham variação (grade, tamanho e cor). Mesmo que o item em si não esteja marcado para exportar, caso o agrupamento esteja, o item será enviado; - Serão enviados os itens marcados para exportar para terceiros e sem agrupamento; - **NÃO** envia item com agrupamento que não tenha grade, tamanho e cor, será apontado um erro no log "Produto agrupado sem variação". Agora vamos configurar o agrupamento para enviar. Acesse: - Estoque> - Agrupamentos> - Novo> [](http://kb.ema.net.br/uploads/images/gallery/2023-07/qFoSTP0CNeq3GW87-image-1689599944728.png) - Ao criar um novo, é importante que o parâmetro '**Exporta para NuvemShop**' esteja marcado, pois caso não esteja, ao realizar a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems), o agrupador será desconsiderado. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/oyDRihKChMLxyoK6-image-1690995788978.png) Após isso, precisamos configurar a grade + tamanho + cores do agrupamento. Acesse: - Estoque> - Grade de itens > - Grades - Grade - Tamanhos - Grade - Cores [](http://kb.ema.net.br/uploads/images/gallery/2023-07/poXS9MHYc9F7RL56-image-1689600748246.png) - No cadastro 'grades ' vincule os tamanhos/cores cadastrados. Agora, selecione os **ITENS** que deseja incluir nesse agrupamento, edite e informe a grade, tamanho, e cor. [](http://kb.ema.net.br/uploads/images/gallery/2023-07/5gVijufcpbIrzGky-image-1689602132050.png) - Neste exemplo, fizemos isso com três itens, todos com tamanho/cor diferentes. [](http://kb.ema.net.br/uploads/images/gallery/2023-07/7ZXJkSyzdntaStxb-image-1689602221601.png) - Feito a configuração no ERP, realize a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems) e verifique no NUVEMSHOP o produto cadastrado. [](http://kb.ema.net.br/uploads/images/gallery/2023-07/SAsHhx6bflZO1BET-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**. - Clique sobre o produto. ("Tênis" nesse exemplo). - Em '**Variações**' ao clicar sobre cada um, é aberto ao lado a tela para mostrar as informações dessa variação como **ITEM** (tal como descrição, preços, SKU, código de barras, peso e dimensões, etc)**.** - *\* Ao deletar o item (agrupamento) no NUVEMSHOP, as variações são deletadas também.* [](http://kb.ema.net.br/uploads/images/gallery/2023-07/b0tr7qJbydcEXA91-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). [](https://kb.ema.net.br/uploads/images/gallery/2023-10/xfXjbw0HB6Q9XIO9-image-1698684469480.png)Importante!
Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de **CLIENTE**: - Ao realizar a sincronização, será verificado se o CNPJ/CPF informado existe no ERP. - Caso o CNPJ/CPF não exista, será verificado o E-mail. - Caso o E-mail não exista, será verificado o telefone. - Se não existir nenhuma dessas informações, será criado um novo usuário no ERP. - Caso a CIDADE não seja informada na criação do pedido, ao sincronizar, o sistema irá incluir e vincular o campo CIDADE do *cliforemp* como ZERO. A edição/manutenção deste campo fica por parte do usuário do ERP. - Ao importar as cidades dos clientes do E-commerce é considerado acentos e cedilhas. Assim como nas demais integrações no ERP, seguirá o padrão: - Se encontrar a cidade, vincula a cidade encontrada no cliente. - Se não encontrar a cidade, cria uma nova cidade, porém, sem IBGE, pois o NUVEMSHOP não tem código IBGE para vincular. Coloque as informações do cliente e acesse o ERP para realizar a [sincronização](http://kb.ema.net.br/link/594#bkmrk-sincroniza%C3%87%C3%83o-nuvems). ##### **SINCRONIZAÇÃO PEDIDOS** Antes de tudo, acesse a configuração do E-commerce e vamos verificar algumas informações dos pedidos. - Vendas > - Vendas móveis > Parâmetros > Integração E-commerce > - Editar a integração do tipo 'NuvemShop' > - Aba 'Pedido' > - Campos 'Condição' e 'Método' > [](https://kb.ema.net.br/uploads/images/gallery/2024-01/GhMiZCQdG7xo3Yj0-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. - Acesse a aba "Lista de vendas" conforme imagem abaixo. - "Criar novo pedido". [](http://kb.ema.net.br/uploads/images/gallery/2023-07/6ecDYcmIbt4ZsIG7-image-1689622679255.png) - Informar produtos, cliente, e outras informações e salvar. - Em seguida acessar ERP e realizar a sincronização do E-commerce. - Acessar Vendas > Pedidos - Procurar o pedido criado e verificar as informações inseridas. Ex: Pedido - NUVEMSHOP [](http://kb.ema.net.br/uploads/images/gallery/2023-08/TKxR2b93RvQFyFOT-image-1691000352050.png) Pedido - ERP [](http://kb.ema.net.br/uploads/images/gallery/2023-08/kgBaAhoikne75k1m-image-1691000408660.png)Importante!
Abaixo algumas regras implementadas na integração do NUVEMSHOP para cadastro de **PEDIDO**: - Importa somente pedidos com status "**paid**" (pagamento confirmado). - Importa observação do pedido da loja para o campo 'Observação' do pedido no ERP. - Ao criar um pedido no NUVEMSHOP, vincular um item e sincronizar, esse item precisa existir no ERP (SKU), ou o log apontará erros e não será sincronizado. - Na tabela PALMTOP\_PEDIDO foi adicionado o campo "NUMERO" do tipo VARCHAR (30); - Na integração com o NuvemShop, ao buscar o pedido para inserir no ERP, irá pegar o conteúdo da tag "number" e inserir neste novo campo e posteriormente este campo será levado para o campo NUMERO da tabela PEDIDO. - Nas demais integrações, não foi mexido em nada, então ao gerar o pedido, o campo NUMERO irá ficar igual ao IDPEDIDOPDA, como já era. ##### **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. - Acessando as configurações do E-commerce, aba 'Pedido' marque o parâmetro '**Informa métodos e condições específicos para cada forma de pagamento**". [](https://kb.ema.net.br/uploads/images/gallery/2024-01/qfeHgaJiG4F4PONB-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". [](http://kb.ema.net.br/uploads/images/gallery/2023-08/lD6OsSn59Ub0bDhS-image-1691002551568.png) - Forma E-commerce: **custom** - Método - Descrição: **6 - Boleto** - Parcela: **1** - Condição - **Descrição: 1 - Em espécie** 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!
- Campo "**Parcela**" deve receber 1 de valor mínimo e máximo, pois atualmente não está implementado na integração ERP x NuvemShop mais de 1 parcela. - Caso o parâmetro "**Informa métodos e condições especificas para cada forma de pagamento**" esteja marcado, mas nada esteja informado na aba 'Métodos', considera o método/condição informados na aba 'Pedido'. - Caso o campo "**Forma E-commerce**" esteja com descrição '**null**', sistema considera o método/condição informados na aba 'Pedido'. - Campo 'Forma E-commerce' é case sensitive, então deve-se colocar em minúsculo/maiúsculo exatamente como informado no NUVEMSHOP. - No exemplo que criamos, o retorno do método personalizado no NUVEMSHOP foi "**custom**" pois foi em ambiente de teste e tínhamos acesso as informações. Porém, ao implementar a integração DE/PARA em cliente, deve-se consultar o suporte do NUVEMSHOP e solicitar a descrição retornada dos métodos desejados. ##### **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. - Grupo: ```SQL DELETE FROM INTEGRACAOECOMMERCE_GRUPO ``` ```SQL UPDATE GRUPO SET EXPORTAWEB = 'N' ``` - Item: ```SQL DELETE FROM INTEGRACAOECOMMERCE_ITEM ``` ```SQL 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: - Configuração> - Logs de integração E-commerce [](http://kb.ema.net.br/uploads/images/gallery/2023-07/ZtvwhdEcGFUNEyiM-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: - Não envia item com agrupamento que não tenha grade, tamanho e cor (erro log "**Produto agrupado sem variação**.") 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): - [https://democasadasmaquinas2.lojavirtualnuvem.com.br/admin/](https://democasadasmaquinas2.lojavirtualnuvem.com.br/admin/) 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. - Para realizar um pedido pela loja propriamente dita do ambiente demo, acesse "Meus aplicativos" e clique no ambiente de teste atual 'Demo casa das Maquinas'. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/2FgYeG4gR3pnJ3sK-image-1691003139898.png) - Será redirecionado para o site E-commerce, contendo os produtos para compra. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/DtIfAmIf2sl8Lpt1-image-1691003232568.png) - Após realizar alguma compra e verificar na lista de pedidos por exemplo, aparecerá as informações incluídas. Ao sincronizar, também aparecerá no ERP. [](http://kb.ema.net.br/uploads/images/gallery/2023-08/YhHrNbJRM2P1AFov-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** ##### [](https://kb.ema.net.br/uploads/images/gallery/2024-11/YwQusXaJwdrT1P0f-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> [](https://kb.ema.net.br/uploads/images/gallery/2024-11/fZSSP9uT7mLrA8vU-image-1732623730079.png) Aba configurações você apenas seleciona qual SKU será exportado. [](https://kb.ema.net.br/uploads/images/gallery/2024-11/OZTNimjGBS6o9fnY-image-1732623752699.png) Na aba Estoque você parametriza filial/deposito que vai exportar, e se abade quantidade reservada do saldo disponivel. [](https://kb.ema.net.br/uploads/images/gallery/2024-11/ccoNgMiVnf3Y9mda-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. [](https://kb.ema.net.br/uploads/images/gallery/2024-11/RmzlHic67ZnuFoBi-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. [](https://kb.ema.net.br/uploads/images/gallery/2024-11/0U3rkD4KXbD6X4HW-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. [](https://kb.ema.net.br/uploads/images/gallery/2024-11/ZPAq2qD1oaJQPYUy-image-1732623927747.png) Ambiente demo configurado com a tray, documentação disponivel [aqui](https://kb.ema.net.br/link/773#bkmrk-integra%C3%A7%C3%A3o-e-commerc). RFP disponivel em [https://portal.ema.net.br/v2/bpm/instancias/criar/398?TL\_CLASSIFICACAO=37.1.54&IDITEM=37&IDMODULO=1&IDOPERACAO=54](https://portal.ema.net.br/v2/bpm/instancias/criar/398?TL_CLASSIFICACAO=37.1.54&IDITEM=37&IDMODULO=1&IDOPERACAO=54)