(Desenvolvimento) Digisoft
Documentação e suporte
- https://www.digisoftecommerce.com.br/
- Suporte com a Digisoft desconhecido
- Sem ambiente de homologação
Autenticação
-
URL API: Informado pelo cliente através da Digisoft
-
Token de acesso: Informado pelo cliente através da Digisoft
- PV: Informado pelo cliente através da Digisoft
O que é sincronizado?
-
Envio de marcas;
-
Envio de categorias (grupos);
-
Envio de itens;
- Envio de estoque e preço dos itens;
- Envio de cliente;
Envio de marcas
| Resource | Método |
| brands | POST |
| brands/<Id da marca na Climba> | PUT |
Regras para envio
-
-
Somente marcas Ativas.
-
Somente marcas com o campo "Exporta para Climba" 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 categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)
-
-
Dados enviados
|
Tag de envio |
O que será enviado |
|
id |
Id da marca na Climba |
|
name |
|
|
description |
Null |
Tratamento de retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracãoEcommerce_Marca | |
| Grava no ERP o id da marca na Climba | Id retornado | IntegracaoEcommerce_Marca.IdMarcaEcommerce |
| Grava/atualiza no ERP a data da ultima sincronização da marca | data e hora atual | IntegracaoEcommerce_Marca.DataHoraUltimaSinc |
Envio de categorias
| Resource | Método |
| categories | POST |
| categories/<Id da categoria na Climba> | PUT |
Regras para envio
-
-
Somente grupos ou catálogos Ativos.
-
Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.
-
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).
-
Opções na Configuração
-
- O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.
-
Se o parâmetro "Exporta Grupos específicos" estiver marcado:
-
Serão enviadas somente os grupos informados na aba "Grupos".
-
-
Se o parâmetro "Exporta Catálogos específicos" estiver marcado:
-
-
Serão enviadas somente os catálogos informados na aba "Catálogos".
-
-
-
Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)
Dados enviados
|
Tags de envio |
O que será enviado |
|
id |
Id da categoria na Climba |
|
parentId |
Id do grupo ou catalogo pai no ERP |
|
name |
descrição do grupo ou catálogo |
|
order |
Classificacao do grupo ou catalogo |
|
description |
Null |
Tratamento de Retorno
| Operação | Dado | Base de dados ERP |
| Tabela de controle | IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo | |
| Grava no ERP o id da categoria na Climba | Id retornado | IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce |
| Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo | data e hora atual | IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc |
Envio de itens simples
| Resource | Método |
| products | POST |
| products/<Id do item no ERP> | PUT |
Regras para envio
-
-
Somente itens com o campo "Exporta para Climba" marcado.
- Somente itens vinculados a marcas 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 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 |