# (Desenvolvimento) NuvemShop #### **Documentação e suporte** - [https://www.climba.dev/documentacao-api-v1/](https://www.climba.dev/documentacao-api-v1/) - Normalmente o Suporte com a NuvemShop via WhatsApp: - +55 11 4020-7216 - Tem ambiente de homologação? - Colocar a Url de teste - Colocar o Token de teste - Colocar site - Colocar usuario - Colocar senha - - - - - - #### **Autenticação** - [URL API](https://kb.ema.net.br/uploads/images/gallery/2023-11/sDcjyEDa9bylcoXL-configuracaourlapi.png): Informado pelo cliente através da Nuvem shop. - [Token de acesso](https://kb.ema.net.br/uploads/images/gallery/2023-11/ak5SVhj96u5akXDi-configuracaotoken.png): Informado pelo cliente através da Nuvem Shop. - - - - - - #### **O que é sincronizado?** - Envio de categorias (grupos ou catálogos); - Envio de itens; - Envio de itens com variação (agrupamento); - Busca de pedidos; - Busca de clientes. - - - - - - #### **Envio de categorias**
**Resource** | **Método** |
categories | POST |
categories/<Id da categoria na Climba> | PUT |
**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 |