(Desenvolvimento) Loja Integrada
Documentação e suporte
- https://api-docs.lojaintegrada.com.br/#3df5c66f-3942-425b-9a3e-c75718fbdecc
- O suporte da loja integrada paga é por chat, senão somente através da comunidade:
- Tem ambiente de homologação?
- Poderá ser disponibilizado, dados de autenticação teste, mediante contato.
Autenticação
-
URL API: Informado pelo cliente através da Loja integrada.
-
Chave API: Informado pelo cliente através da Loja integrada.
- Chave aplicação: Informado pelo cliente através da Loja integrada.
O que é sincronizado?
-
Envio de marcas;
-
Envio de categorias (grupos);
- Envio de grades;
- Envio de variações de grade (tamanhos);
-
Envio de itens;
- Envio de itens agrupados;
-
Atualiza estoque de itens;
- Atualiza preço de itens;
- Envio de nota fiscal de saída;
-
Busca de pedidos;
-
Busca de clientes;
- Atualiza status de pedidos;
Envio de marcas
| Resource | Método |
| marca | POST |
| marca/<Id da marca na Loja integrada> | PUT |
| marca/<id da marca no ERP>?id_externo=1 | PUT |
Regras para envio
-
-
Somente marcas Ativas.
-
Somente marcas com o campo "Exporta para web" marcado.
-
Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).
-
Opções na Configuração
-
-
Se o parâmetro "Exporta Marcas específicas" estiver marcado:
-
Serão enviadas somente as marcas informadas na aba "Marcas".
-
Permite fazer um De/Para das marcas específicas inserindo id da marca da Loja integrada na coluna "Cód. E-commerce". (Deve ser solicitado para a Loja integrada os IDs)
-
-
Dados enviados
|
Tag de envio |
O que será enviado |
|
id_externo |
Id da marca no ERP |
|
nome |
|
|
slug |
Tratamento de retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracãoEcommerce_Marca | |
| Grava/atualiza no ERP a data da ultima sincronização da marca | data e hora atual | IntegracaoEcommerce_Marca.DataHoraUltimaSinc |
Envio de categorias
| Resource | Método |
| categoria | POST |
| categoria/<Id da categoria na Loja integrada> | PUT |
| categoria/<id do grupo no ERP>?id_externo=1 | PUT |
Regras para envio
-
-
Somente grupos Ativos.
-
Somente grupos com o campo "Exporta para web" marcado.
-
Primeira sincronização ou alteração no cadastro do grupo (Data de atualização do cadastro do grupo for maior que a data da última sincronização do grupo).
-
Opções na Configuração
-
- Não usa o parâmetro "Tipo exportação categoria", para a Loja integrada serão sempre enviados Grupos.
-
Se o parâmetro "Exporta Grupos específicos" estiver marcado:
-
Serão enviadas somente os grupos informados na aba "Grupos".
-
-
Permite fazer um De/Para dos grupos específicos inserindo id da categoria da Loja integrada na coluna "Cód. E-commerce". (Deve ser solicitado para a Loja integrada IDs)
Dados enviados
|
Tags de envio |
O que será enviado |
|
id_externo |
Id do grupo no ERP |
|
nome |
descrição do grupo |
|
descricao |
descrição do grupo |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracaoEcommerce_Grupo | |
| Grava/atualiza no ERP a data da ultima sincronização do grupo | data e hora atual | IntegracaoEcommerce_Grupo.DataHoraUltimaSinc |
Envio de grades
| Resource | Método |
| grades | POST |
| categoria/<id da grade no ERP>?id_externo=1 | PUT |
Regras para envio
-
-
Somente grades Ativas.
-
Somente grades com o campo "Exporta terceiros" marcado.
-
Envia somente a primeira sincronização (Data da ultima sincronização da grade zerada - DatahoraUltimaSincLoja).
- Se encontrar uma grade com o mesmo id externo e idgrade na Loja integrada, somente atualiza os dados (PUT).
-
Opções na Configuração
-
- Não usa nenhum parâmetro referente ao agrupamento ou variação.
Dados enviados
|
Tags de envio |
O que será enviado |
|
id_externo |
Id da grade no ERP |
|
nome |
descrição da grade |
|
nome_visivel |
descrição da grade |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Atualiza no ERP a data da ultima sincronização da grade | data e hora atual | grade.DataHoraUltimaSincLoja |
Envio de variações de grade (tamanhos)
| Resource | Método |
| grade/<id da grade no ERP>/variacao?id_externo=1 | POST |
Regras para envio
-
- Somente tamanhos vinculados a grade. Será enviado após o envio da grade.
-
Somente tamanhos Ativos.
-
Somente tamanhos com o campo "Exporta terceiros" marcado.
-
Envia somente a primeira sincronização (Data da ultima sincronização do tamanho zerada - DatahoraUltimaSincLoja).
Opções na Configuração
-
- Não usa nenhum parâmetro referente ao agrupamento ou variação.
Dados enviados
|
Tags de envio |
O que será enviado |
|
id_externo |
Id do tamanho no ERP |
|
nome |
descrição do tamanho |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Atualiza no ERP a data da ultima sincronização do tamanho | data e hora atual | tamanho.DataHoraUltimaSincLoja |
Envio de itens simples
| Resource | Método |
| produto | POST |
| produto/<Id do item na Loja integrada> | PUT |
Regras para envio
-
-
Somente itens com o campo "Exporta para terceiros" marcado.
- Somente itens vinculados a marcas com o campo "Exporta para web" marcado.
-
Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).
- Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).
-
Opções na Configuração
-
-
SKU: o campo "SKU do produto" define se o SKU será o iditem ou referencia.
- Nome: o campo "Descrição do item" define o campo do item que será enviado.
- Descrição, descrição técnica, observação ou complemento
- Preço: o campo "Utilizar" define qual o preço que será enviado:
- Preço de pauta da filial: deve ser informada a "Filial".
- Tabela de preço específica: deve ser informada a Tabela de preço" .
- Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
- O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
- O campo "% Envio estoque", indica o percentual do estoque que será enviado.
- Respeita o campo "Qt. Múltiplo" do cadastro do item.
-
Dados enviados
|
Tags de envio |
O que será enviado |
|
id_externo |
Id do item no ERP |
|
sku |
Id do item ou referencia |
|
ncm |
Classificação fiscal do item |
|
nome |
nome |
|
name |
Descrição, descrição técnica, observação ou complemento |
|
description |
Observação do item |
|
productVariants |
- |
|
sku |
Id do item ou referencia |
|
internalCode |
Id do item no ERP |
|
quantity |
Quantidade em estoque do item |
|
description |
Observação do item |
|
grossWeight |
Peso bruto do item |
|
netWeight |
Peso liquido do item |
|
height |
Altura do item |
|
width |
Largura do item |
|
length |
Comprimento do item |
| prices |
- |
| priceListId |
"1" |
| price |
Preço do item |
| priceFrom |
"0" |
| attributes |
- |
| id |
"1" |
| name |
"U" |
| attributeGroupId |
"1" |
| id |
"1" |
| name |
"U" |
| attributeGroupId |
"2" |
| barCode |
Código de barra do item |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracaoEcommerce_Item | |
| Grava no ERP o id do item na Climba | Id retornado | IntegracaoEcommerce_Item.IdItemEcommerce |
| Grava/atualiza no ERP a data da ultima sincronização do item | data e hora atual | IntegracaoEcommerce_Item.DataHoraUltimaSinc |
Envio das fotos do itens simples
| Resource | Método |
| products/<Id do item no ERP>/pictures | DELETE |
| products/<id do item do ERP>/pictures/base64 | POST |
Regras para envio
-
- Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
- Parâmetro "Sincroniza fotos" marcado.
- Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
- Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.
|
Tags de envio |
O que será enviado |
| image | Foto do item em base64 |
| position | Id da foto do item no ERP |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Grava/atualiza no ERP a data da ultima sincronização do item | data e hora atual | Item.DataHoraUltimaSincClimbaFoto |
Envio de itens agrupados
| Resource | Método |
| produto | POST |
| produto/<Id do item na Loja integrada> | PUT |
Regras para envio
-
-
Somente itens com o campo "Exporta para terceiros" marcado.
- Somente itens vinculados a marcas com o campo "Exporta para web" marcado.
-
Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).
- Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).
-
Opções na Configuração
-
-
SKU: o campo "SKU do produto" define se o SKU será o iditem ou referencia.
- Nome: o campo "Descrição do item" define o campo do item que será enviado.
- Descrição, descrição técnica, observação ou complemento
- Preço: o campo "Utilizar" define qual o preço que será enviado:
- Preço de pauta da filial: deve ser informada a "Filial".
- Tabela de preço específica: deve ser informada a Tabela de preço" .
- Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
- O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
- O campo "% Envio estoque", indica o percentual do estoque que será enviado.
- Respeita o campo "Qt. Múltiplo" do cadastro do item.
-
Dados enviados
|
Tags de envio |
O que será enviado |
|
id |
Id do item no ERP |
|
status |
Status do item no ERP: 1-Atuvo/0-Inativo |
|
categories |
Id da climba vinculado ao grupo/catalogo do item |
|
brandId |
Id da climba vinculado a marca do item |
|
name |
Descrição, descrição técnica, observação ou complemento |
|
description |
Observação do item |
|
productVariants |
- |
|
sku |
Id do item ou referencia |
|
internalCode |
Id do item no ERP |
|
quantity |
Quantidade em estoque do item |
|
description |
Observação do item |
|
grossWeight |
Peso bruto do item |
|
netWeight |
Peso liquido do item |
|
height |
Altura do item |
|
width |
Largura do item |
|
length |
Comprimento do item |
| prices |
- |
| priceListId |
"1" |
| price |
Preço do item |
| priceFrom |
"0" |
| attributes |
- |
| id |
"1" |
| name |
"U" |
| attributeGroupId |
"1" |
| id |
"1" |
| name |
"U" |
| attributeGroupId |
"2" |
| barCode |
Código de barra do item |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracaoEcommerce_Item | |
| Grava no ERP o id do item na Climba | Id retornado | IntegracaoEcommerce_Item.IdItemEcommerce |
| Grava/atualiza no ERP a data da ultima sincronização do item | data e hora atual | IntegracaoEcommerce_Item.DataHoraUltimaSinc |
Envio das fotos do itens simples
| Resource | Método |
| products/<Id do item no ERP>/pictures | DELETE |
| products/<id do item do ERP>/pictures/base64 | POST |
Regras para envio
-
- Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
- Parâmetro "Sincroniza fotos" marcado.
- Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
- Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.
|
Tags de envio |
O que será enviado |
| image | Foto do item em base64 |
| position | Id da foto do item no ERP |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Grava/atualiza no ERP a data da ultima sincronização do item | data e hora atual |
Item.DataHoraUltimaSincClimbaFoto
|
Busca de pedidos
Regras
-
- Busca somente pedidos em aberto na Climba. (status = 2)
Opções na Configuração
-
- Transação:
- Informado no cadastro de E-commerce conforme imagem Clique aqui!
- Filial:
- Informado no cadastro de Filial conforme imagem Clique aqui!
- Responsável Notificação:
- Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
- Método e condições de pagamento:
- Fazer De/para dos metodos/condicoes e parcelas da Climba.
- Informar padrão.
- Se não tiver nenhum acima informado pega do cliente.
- Vendedor:
- Informa padrão.
- Se não tiver nenhum acima pega do cliente.
- Transportadora:
- Fazer De/para das transportadoras da Climba.
- Informa padrão.
- Transação:
Dados usados para criar o pedido
|
Tag de retorno |
Campo correspondente |
|
id |
Id do pedido pda |
|
id |
Numero do pedido |
|
customerComment |
Observação |
|
shippingAddress/state |
UF de destino |
|
name |
nome do cliente |
|
sourceId |
id marketplace |
|
totalValue |
Valor total do pedido |
|
totalValue |
Valor total dos itens |
|
discountValue |
Valor do desconto |
|
additionValue |
Valor do acréscimo |
|
shippingValue |
Valor do frete |
|
payment/id |
Id do método de pagto |
| payment/installmentQuantity |
Parcela do método |
| shipping/id |
Id da transportadora |
Item do pedido
Regras
-
- Somente Itens com SKU correspondente no ERP (iditem ou referencia).
Dados usados para criar os itens
|
Tag de retorno |
Campo correspondente |
Base de dados |
|
sequence |
sequencial do item no pedido |
pedido_item.sequencial |
|
sequence |
sequencial do item no pedido |
pedido_item.idpedidoitem |
|
id |
id do pedido na climba |
pedido_item.idpedidopda |
|
sku |
Sku do item na climba |
|
|
productId |
Id do item no ERP |
|
|
quantity |
Quantidade do item |
pedido_item.qt |
|
sellingPrice |
Valor unitario do item |
pedido_item.valor |
|
sellingPrice |
Valor de pauta |
pedido_item.valorpauta |
|
sellingPrice |
Valor sugerido |
pedido_item.valorsugerido |
|
quantity * sellingPrice |
Valor total do item |
pedido_item.valortotal |
|
discountValue |
Valor do desconto |
pedido_item.valordesconto |
|
discountValue/quantity * sellingPrice |
Percentual do desconto |
pedido_item.perc_desconto |
|
additionValue |
Valor de acrescimo |
pedido.valoracrescimo |
| additionValue/quantity * sellingPrice |
Percentual de acrescimo |
pedido_item.perc_acrescimo |
Cliente do pedido
Regras
-
- Insere novo cliente no ERP;
- Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.
-
Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP.
- Se não retornar tag IE, o IE e IM no ERP será "ISENTO".
Opções na Configuração
-
- Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".
Dados usados para criar o cliente
|
Tag de retorno |
Campo correspondente |
|
"Cadastrado via Climba" |
Observação |
|
birthDate |
Data de nascimento |
|
id |
Id do cliente na Climba |
|
name |
Fantasia |
|
name |
Razão |
|
gender = "m" ou "f" |
Sexo |
|
|
|
|
|
e-mail NF-e |
|
documents/ type |
- |
|
type = "cpf" |
- |
|
number |
CPF |
|
type = "cnpj" |
- |
|
number |
CNPJ |
|
type = "ie" |
- |
|
number |
IE |
|
type = "rg" |
|
|
number |
RG |
|
phones |
|
|
type = "primary" |
|
|
number |
Fone |
|
type = "secundary" |
|
|
number |
Fone 2 |
|
type = "others" |
|
|
number |
Fax |
|
shippingAddress |
|
|
street |
Endereço |
|
streetNumber |
Número |
|
complement |
Complemento |
|
district |
Bairro |
|
state |
UF |
|
zipCode |
CEP |
|
city |
Nome da Cidade |
Envio de Nota fiscal
| Resource | Método |
| orders/<id do pedido pda>/billed | POST |
Regras
-
- Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
- Somente Notas fiscais de saída finalizadas (status = 2).
Opções na Configuração
-
- Permite fazer De/para do operador logístico da transportadora.
Dados enviados
|
Tag de envio |
O que será enviado |
|
number |
Número da NFS |
|
nfeAccessKey |
Chave eletrônica da NFS |
|
xml |
XML da NFS |
| logisticOperatorId |
Id da Operador logistico informada na configuração. Se não envia vazio. |
Atualiza status do pedido na Ideris
| Resource | Método |
| order | PUT |
Regras
-
- Atualiza o status do pedido após o envio da nota fiscal na Ideris;
Dados enviados
|
Tag de envio |
O que será enviado |
|
orderId |
Id do pedido na Ideris |
|
statusId |
1009 - Expedição |