# Climba #### **Documentação e suporte** - **[https://www.climba.dev/documentacao-api-v1/](https://www.climba.dev/documentacao-api-v1/)** - WhatsApp suporte: **(48) 3658-4743** - - - - - - #### **Ambiente de homologação** - **Url API**: https://staging-basehomologacaoemasoft.api.climbaapp.com.br/api/v1/ [ Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - **Token**: ZjJjZmJiODE3NjMxODA4MzBmOWNmM2I0N2UwZTA3OTE6NjRjN2JmMmU2MTQ2OGRlNDRiMWFjMzFiYjRhMjNlNmY= - **Loja:** - **link:** [https://staging-basehomologacaoemasoft.climbacommerce.com.br/admin](https://staging-basehomologacaoemasoft.climbacommerce.com.br/admin) - **Usuário**: staging\_basehomologacaoemasoft - **Senha**: &m4pr0@123 - [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/tOgkU6dmcs0v6WJr-loja1.png) - - - - - - #### **Autenticação** - **URL API**: Informado pelo cliente através da Climba. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/gSrKyzbhX2Q5zSkh-urlapi-climba.png) - **Token de acesso:** Informado pelo cliente através da Climba. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/WcV0eErVJEAg06oz-token-climba.png) - - - - - - #### **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**
brandsPOST
brands/<Id da marca na Climba>PUT
##### **Regras para envio** - - Somente marcas Ativas. - Somente marcas com o campo "Exporta para Climba" marcado. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/kItDJtEbOxCl0Tbb-marca-exporta-climba.png) - Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca). - integracaoecommerce\_Marca.DataHoraUltimasinc <= Marca.DataHoraUltimaAtualizacao ##### **Opções na Configuração** - - Se o parâmetro "Exporta Marcas específicas" estiver marcado: [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/n69qW3j9cBBiqKcj-marcas-especificas.png) - Serão enviadas somente as marcas informadas na aba "Marcas". [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/fUszZR2AAO5azttc-abamarcas.png) - Permite fazer um De/Para das marcas específicas inserindo id da marca da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs) [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/WoioN1KsQTnZGBzR-codigomarcas.png) ##### **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 ClimbaId retornadoIntegracaoEcommerce\_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marcadata e hora atualIntegracaoEcommerce\_Marca.DataHoraUltimaSinc
- - - - - - #### **Envio de categorias**
**Resource****Método**
categoriesPOST
categories/<Id da categoria na Climba>PUT
##### **Regras para envio** - - Somente grupos ou catálogos Ativos. - Somente grupos ou catálogos com o campo "Exporta para Climba" marcado. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/Rtz8WnRcfa5zNjib-grupo-exporta-climba.png) - Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos). - integracaoecommerce\_Grupo.DataHoraUltimasinc <= Grupo.DataHoraUltimaAtualizacao ou integracaoecommerce\_Grupo.DataHoraUltimasinc <= Catalogo.DataHoraUltimaAtualizacao ##### **Opções na Configuração** - - O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/KB07qySORWrqpQ80-tipocategoria.png) - Se o parâmetro "Exporta Grupos específicos" estiver marcado: [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ESoioMn9Od3Wf0DP-grupo-especifico.png) - Serão enviadas somente os grupos informados na aba "Grupos". [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ifBEdR9B8wIfjoi6-abagrupos.png) - Permite fazer um De/Para de grupos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs) [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/6uBKRgsoq3oilGRp-codigogrupos.png) - Se o parâmetro "Exporta Catálogos específicos" estiver marcado: [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/WtZtuo657TikNwzk-catalogo-especifico.png) - - Serão enviadas somente os catálogos informados na aba "Catálogos". [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/AkDepSNOBTHxNBJ4-abacatalogo.png) - Permite fazer um De/Para de catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs) [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ZFBCxeMzQoFWM2Wq-codigocatalogo.png) ##### **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 ClimbaId retornadoIntegracaoEcommerce\_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce\_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogodata e hora atualIntegracaoEcommerce\_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce\_Catalogo.DataHoraUltimaSinc
- - - - - - #### **Envio de itens simples**
**Resource****Método**
productsPOST
products/<Id do item no ERP>PUT
##### **Regras para envio** - - Somente itens com o campo "Exporta para Climba" marcado. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ceBdv7KCmUuSDMFg-item-exporta-climba.png "Clique aqui!") - Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado. [Clique aqui!](https://kb.ema.net.br/a.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item). - Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT). ##### **Opções na Configuração** - - **SKU:** - o campo "SKU do produto" define se o SKU será o iditem ou referencia. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - **Nome:** - o campo "Descrição do item" define o campo do item que será enviado. [Clique aqui!](https://kb.ema.net.br/.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - Descrição, descrição técnica, observação ou complemento - **Preço:** - o campo "Utilizar" define qual o preço que será enviado: [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/MyFtUpcLtEjk1IXC-tipopreco.png "Clique aqui!") - Preço de pauta da filial: deve ser informada a "Filial". [Clique aqui!](https://kb.ema.net.br/r/.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - Tabela de preço específica: deve ser informada a Tabela de preço" . [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - **Estoque**: - O campo "Filiais" indica as filiais que deverão somar o estoque por depósitos. [Clique aqui!](https://kb.ema.net.br/ds/images/gallery/2024-01/ykGhjflEaH6mEhjF-homolog1.png "Clique aqui!") - O campo "Depósito" indica os depósitos somados para enviar a quantidade em estoque. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/xefV3qG1R15CnWcK-estoque-depositos.png "Clique aqui!") - O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/lEkecepFfWYfl8m5-estoque-abate.png "Clique aqui!") - O campo "% Envio estoque", indica o percentual do estoque que será enviado. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/slFlvHQQNSbKi5Fm-estoque.png "Clique aqui!") - Respeita o campo "Qt. Múltiplo" do cadastro do item. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2024-01/lFmN9HgzY8ob8OfO-multiplos.png "Clique aqui!") ##### **Dados enviados**
**Tags de envio** **O que será enviado**
**id** Id do item no ERP
**status** Status do item no ERP: 1-Atuvo/0-Inativo
**categories** Id da climba vinculado ao grupo/catalogo do item
**brandId** Id da climba vinculado a marca do item
**name** Descrição, descrição técnica, observação ou complemento
**description** Observação do item
**productVariants** -
**sku** Id do item ou referencia
**internalCode** Id do item no ERP
**quantity** Quantidade em estoque do item
**description** Observação do item
**grossWeight** Peso bruto do item
**netWeight** Peso liquido do item
**height** Altura do item
**width** Largura do item
**length** Comprimento do item
**prices**-
**priceListId**"1"
**price**Preço do item
**priceFrom**"0"
**attributes**-
**id** "1"
**name**"U"
**attributeGroupId**"1"
**id**"1"
**name**"U"
**attributeGroupId**"2"
**barCode**Código de barra do item
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Tabela de controle IntegracaoEcommerce\_Item
Grava no ERP o id do item na ClimbaId retornadoIntegracaoEcommerce\_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do itemdata e hora atualIntegracaoEcommerce\_Item.DataHoraUltimaSinc
##### **Envio das fotos do itens simples**
**Resource****Método**
products/<Id do item no ERP>/picturesDELETE
products/<id do item do ERP>/pictures/base64POST
##### **Regras para envio** - - Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar. - Parâmetro "Sincroniza fotos" marcado. - Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos). - Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.
**Tags de envio** **O que será enviado**
**image**Foto do item em base64
**position**Id da foto do item no ERP
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Grava/atualiza no ERP a data da ultima sincronização do itemdata e hora atualItem.DataHoraUltimaSincClimbaFoto
- - - - - - #### **Envio de itens com variação**
**Resource****Método**
productsPOST
products/A<id do agrupamento no ERP>PUT
##### **Regras para envio** - - Somente agrupamentos com o campo "Exporta para Climba" marcado. - Somente itens do agrupamento com o campo "Exporta para Climba" marcado. - Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item). - Antes de enviar um item novo, é realizada a busca por esse item na Climba, se encontrar um <SKU> na climba com o mesmo <"A"+Id do agrupamento no ERP>, são enviados os dados para atualização (PUT). - Na Climba os agrupamento serão os produtos principais e os itens dos agrupamentos serão as variações. - Atributos da variação são COR e TAMANHO. ##### **Opções na Configuração** - - Campo "Exporta itens agrupados" deve estar marcado. - **Sku:** o campo "SKU do produto" define se o SKU do item de variação será o iditem ou referencia. - **Preço:** o campo "Utilizar" define qual o preço de cada item de variacao que será enviado: - Preço de pauta da filial: deve ser informada a "Filial". - Tabela de preço específica: deve ser informada a Tabela de preço" . - **Estoque**: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque. - O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP. - O campo "% Envio estoque", indica o percentual do estoque que será enviado. - Respeita o campo "Qt.Múltiplo" do cadastro do item. ##### **Dados enviados**
**Tags de envio** **O que será enviado**
**id** "A" + Id do agrupamento no ERP
**status** Status do agrupamento no ERP: 1-Atuvo/0-Inativo
**categories** Id da climba vinculado ao grupo de um item do agrupamento
**brandId** Id da climba vinculado a marca de um item do agrupamento
**name** Descrição do agrupamento
**description** Observação de um item do agrupamento
**productVariants** <as tags abaixo serão enviadas pra cada item do agrupamento>
**sku** Id do item ou referencia
**internalCode** Id do item no ERP
**quantity** Quantidade em estoque do item
**description** Observação do item
**grossWeight** Peso bruto do item
**netWeight** Peso liquido do item
**height** Altura do item
**width** Largura do item
**length** Comprimento do item
**prices**-
**priceListId**"1"
**price**Preço do item
**priceFrom**"0"
**attributes**-
**id** Id da cor do item
**name**Descrição da cor
**attributeGroupId**"1"
**id**Id do tamanho do item
**name**Descrição do tamanho
**attributeGroupId**"2"
**barCode**Código de barra do item
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Tabela de controle IntegracaoEcommerce\_Item
Grava no ERP o id do item na ClimbaId retornadoIntegracaoEcommerce\_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do itemdata e hora atualIntegracaoEcommerce\_Item.DataHoraUltimaSinc
##### **Envio das fotos do itens agrupados**
**Resource****Método**
products/<Id do item no ERP>/picturesDELETE
products/<id do item do ERP>/pictures/base64POST
##### **Regras para envio** - - Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar. - Parâmetro "Sincroniza fotos" marcado. - Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos). - Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.
**Tags de envio** **O que será enviado**
**image**Foto do item em base64
**position**Id da foto do item no ERP
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Grava/atualiza no ERP a data da ultima sincronização do itemdata e hora atualItem.DataHoraUltimaSincClimbaFoto
- - - - - - ##### **Envio de variações** ##### **Cores**
**Resource****Método**
attributesPOST
attributes/1/<Id da cor no ERP>PUT
##### **Regras para envio** - - Somente cores Ativas. - Somente cores com o campo "Exporta para Climba" marcado. - Primeira sincronização ou alteração no cadastro da cor. (Data de atualização do cadastro da cor maior que a data da ultima sincronização da cor) ##### **Dados enviados**
**Tag de envio** **O que será enviado**
**id** Id da cor no ERP
**name** Descrição da cor
**attributeGroupId** "1"
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Grava/atualiza no ERP a data da ultima sincronização da Cordata e hora atualCor.DatahoraultimaSincClimba
##### **Tamanhos**
**Resource****Método**
attributesPOST
attributes/2/<Id do tamanho no ERP>PUT
##### **Regras para envio** - - Somente tamanhos Ativos. - Somente tamanhos com o campo "Exporta para Climba" marcado. - Primeira sincronização ou alteração no cadastro de tamanho. (Data de atualização do cadastro do tamanho maior que a data da ultima sincronização do tamanho) ##### **Dados enviados**
**Tag de envio** **O que será enviado**
**id** Id do tamanho no ERP
**name** Descrição do tamanho
**attributeGroupId** "2"
##### **Tratamento de Retorno**
**Operação****Dado****Base de dados ERP**
Grava/atualiza no ERP a data da ultima sincronização do tamanhodata e hora atualTamanho.DatahoraultimaSincClimba
- - - - - - #### **Busca de pedidos** ##### **Regras** - - Busca somente pedidos em aberto na Climba. (**status = 2)** ##### **Opções na Configuração** - - **Transação:** - Informado no cadastro de E-commerce conforme imagem [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/zSER3yl62xkOMkxI-configuracaopedidotransacao.png) - **Filial:** - Informado no cadastro de Filial conforme imagem [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/y7w6Cu8qV2PVT0ix-configuracaopedidofilial.png) - **Responsável Notificação:** - Informa usuário padrão que irá receber notificações dos pedidos criados no ERP. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/scaled-1680-/PaG4eJ8a4nTS3Whl-configuracaopedidoresponsavel.png) - **Método e condições de pagamento:** - Fazer De/para dos metodos/condicoes e parcelas da Climba. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/woNuFbDr1xEkNsPp-configuracaodeparametodo.png) - Informar padrão. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/sqwLIpHbb4Qe1EOn-configuracaopedidocondicao.png) - Se não tiver nenhum acima informado pega do cliente. - **Vendedor:** - Informa padrão. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/y7w6Cu8qV2PVT0ix-configuracaopedidofilial.png) - Se não tiver nenhum acima pega do cliente. - **Transportadora:** - Fazer De/para das transportadoras da Climba na aba "Transportadoras" [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/y7w6Cu8qV2PVT0ix-configuracaopedidofilial.png) - Informa padrão. [Clique aqui!](https://kb.ema.net.br/uploads/images/gallery/2023-11/y7w6Cu8qV2PVT0ix-configuracaopedidofilial.png) ##### **Dados usados para criar o pedido**
**Tag de retorno** **Campo correspondente**
**id** Id do pedido pda
**id** Numero do pedido
**customerComment** Observação
**shippingAddress/state** UF de destino
**name** nome do cliente
**sourceId** id marketplace
**totalValue** Valor total do pedido
**totalValue** Valor total dos itens
**discountValue** Valor do desconto
**additionValue** Valor do acréscimo
**shippingValue** Valor do frete
**payment/id** Id do método de pagto
**payment/installmentQuantity**Parcela do método
**shipping/id **Id da transportadora
#### **Item do pedido** ##### **Regras** - - Somente Itens com SKU correspondente no ERP (iditem ou referencia). ##### **Dados usados para criar os itens**
**Tag de retorno** **Campo correspondente** **Base de dados**
**sequence** sequencial do item no pedido pedido\_item.sequencial
**sequence** sequencial do item no pedido pedido\_item.idpedidoitem
**id** id do pedido na climba pedido\_item.idpedidopda
**sku** Sku do item na climba
**productId** Id do item no ERP
**quantity** Quantidade do itempedido\_item.qt
**sellingPrice** Valor unitario do item pedido\_item.valor
**sellingPrice** Valor de pauta pedido\_item.valorpauta
**sellingPrice** Valor sugerido pedido\_item.valorsugerido
**quantity \* sellingPrice** Valor total do item pedido\_item.valortotal
**discountValue** Valor do desconto pedido\_item.valordesconto
**discountValue/quantity \* sellingPrice** Percentual do desconto pedido\_item.perc\_desconto
**additionValue** Valor de acrescimo pedido.valoracrescimo
**additionValue/quantity \* sellingPrice**Percentual de acrescimo pedido\_item.perc\_acrescimo
#### **Cliente do pedido** ##### **Regras** - - Insere novo cliente no ERP; - Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados. - Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. - Se não retornar tag IE, o IE e IM no ERP será "ISENTO". ##### **Opções na Configuração** - - Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente". ##### **Dados usados para criar o cliente**
**Tag de retorno** **Campo correspondente**
**"Cadastrado via Climba"** Observação
**birthDate** Data de nascimento
**id** Id do cliente na Climba
**name** Fantasia
**name** Razão
**gender = "m" ou "f"** Sexo
**email** e-mail
**email** e-mail NF-e
**documents/ type** -
**type = "cpf"** -
**number** CPF
**type = "cnpj"** -
**number** CNPJ
**type = "ie"** -
**number** IE
**type = "rg"**
**number** RG
**phones**
**type = "primary"**
**number** Fone
**type = "secundary"**
**number** Fone 2
**type = "others"**
**number** Fax
**shippingAddress**
**street** Endereço
**streetNumber** Número
**complement** Complemento
**district** Bairro
**state** UF
**zipCode** CEP
**city** Nome da Cidade
- - - - - - #### **Envio de Nota fiscal**
**Resource****Método**
orders/<id do pedido pda>/billedPOST
##### **Regras** - - Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3). - Somente Notas fiscais de saída finalizadas (status = 2). ##### **Opções na Configuração** - - Permite fazer De/para do operador logístico da transportadora. ##### **Dados enviados**
**Tag de envio** **O que será enviado**
**number** Número da NFS
**nfeAccessKey** Chave eletrônica da NFS
**xml** XML da NFS
**logisticOperatorId**Id da Operador logistico informada na configuração. Se não envia vazio.