Aviso:
Os programas PD0309, PD0310, PD0623, PD0627 e PD0628 estarão disponíveis até a release 12.1.2311 do sistema para utilização com uma loja por modelo de negócio (B2C/B2B). Para suporte a múltiplas lojas por modelo de negócio ou a partir da versão 12.1.2403 deverá ser utilizada a Central de Configurações E-commerce (https://tdn.totvs.com/x/NhvKK).
01. CATEGORIA
Ao cadastrar uma categoria no programa PD0623, essa categoria será enviada do ERP Datasul para o E-commerce.
No momento que é cadastrada ou alterada uma categoria, será gerado um registro na tabela: depto-integr-loja.
Na tabela depto-integr-loja fica armazenada o código da categoria e a data e hora da última criação ou alteração do registro.
Para confirmar que a categoria foi criada e visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cdp/v1/businessFamilyPublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Requisição REST que apresenta todas as categorias cadastradas no programa PD0623.
Para retornar todas as categorias cadastradas no programa PD0623, a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscadas todas as categorias criadas/alteradas a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações da categoria do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| categoryParentCode | depto-integr-loja.cod-familia-comerc | Código da Família Comercial no ERP |
| categoryErpDesc | depto-integr-loja.desc-familia-comerc-erp | Descrição da Família Comercial no ERP |
| categoryName | depto-integr-loja.nom-depto | Nome da Categoria no e-commerce |
| categoryDescription | depto-integr-loja.dsl-depto | Descrição da Categoria no e-commerce |
| isActive | depto-integr-loja.log-ativo | Define se a categoria estará ativa no e-commerce |
| categoryParentCode | depto-integr-loja.cod-familia-comerc-pai | Se a categoria é filha de outra categoria, é gravado neste campo o código da categoria pai |
| erpLastChange | depto-integr-loja.dtm-alter | Data e hora da última criação ou alteração do registro |
| areItemsIntegrated | log-itens-integr | Indica se a categoria possui item já integrado com o e-commerce (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
02. PRODUTO
Ao cadastrar um item no programa PD0623, esse item será enviada do ERP Datasul para o E-commerce.
No momento que é cadastrado um item no programa PD0623, será gerado um registro na tabela: item-integr-loja.
Na tabela item-log fica armazenada o código do item e a data e hora da última criação ou alteração do registro.
Na primeira carga dos itens do ERP Datasul para o e-commerce, todos os itens gravados na tabela item-integr-loja serão enviados para o e-commerce.
Nas cargas posteriores serão considerados os itens que possuírem registros na tabela item-log.
Para confirmar que o item foi definido para ser enviado para o e-commerce e visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cep/v1/productPublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Para retornar todos os itens cadastrados no programa PD0623 (ou que sofreram uma alteração nos dados do item por meio do programa CD0204 ou CD0903) a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscados os itens criados/alterados a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações do produto do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| categoryCode | item.fm-cod-com | Código da Família Comercial a qual o item pertence no ERP |
| itemCode | item.cod-item | Código do item |
| itemDescription | item.desc-item | Descrição do item |
| isActive | item.cod-obsoleto | Define se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce) |
| erpLastChange | item-log.dtm-alter | Data e hora da última criação ou alteração do registro |
| integratedDeposit | log-integr-depos | Indica se o item possui um depósito já integrado com o e-commerce (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
| integratedPriceTab | log-integr-tb | Indica se o item possui uma tabela de preço já integrada com o e-commerce (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
03. DEFINIÇÕES DO PRODUTO
Ao cadastrar um item no programa PD0623, as definições desse item será enviada do ERP Datasul para o E-commerce.
No momento que é cadastrado um item no programa PD0623, será gerado um registro na tabela: item-integr-loja.
Na tabela item-log fica armazenada o código do item e a data e hora da última criação ou alteração do registro.
Na primeira carga dos itens do ERP Datasul para o e-commerce, todas as definições dos itens gravados na tabela item-integr-loja serão enviadas para o e-commerce.
Nas cargas posteriores serão considerados as definições dos itens que possuírem registros na tabela item-log.
Para confirmar que as definições dos itens serão envidas para o e-commerce e visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cep/v1/productSkuPublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Para retornar todas as definições dos itens cadastrados no programa PD0623 (ou que sofreram uma alteração nos dados do item por meio do programa CD0204 ou CD0903) a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscados todas as definições dos itens criados/alterados a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações das definições do produto do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| referenceCode | item.cod-refer | Código da Família Comercial a qual o item pertence no ERP |
| itemCode | item.cod-item | Código do item |
| itemDescription | item.desc-item | Descrição do item |
| isActive | item.cod-obsoleto | Define se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce) |
| erpLastChange | item-log.dtm-alter | Data e hora da última criação ou alteração do registro |
| barCode | item-mat.cod-ean | Código GTIN do item informado no programa CD0903 |
| length | item.comprim | Comprimento do item informada no programa CD0903 |
| height | item.altura | Altura do item informada no programa CD0903 |
| width | item.largura | Largura do item informada no programa CD0903 |
| weight | item.peso-liquido | Peso líquido do item informado no programa CD0903 |
| realWeight | item.peso-bruto | Peso bruto do item informado no programa CD0903 |
| measurementUnit | item.un | Unidade de medida informada para o item no programa CD0204 |
| productRootCode | item.it-codigo | Código do item no ERP |
Caso o item possua o tipo de controle de estoque por referência, algumas informações serão buscadas da tabela ref-item:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| referenceCode | ref-item.cod-refer | Código da Família Comercial a qual o item pertence no ERP |
| itemCode | ref-item.cod-item | Código do item |
| itemDescription | item.desc-item | Descrição do item |
| isActive | item.cod-obsoleto | Define se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce) |
| erpLastChange | item-log.dtm-alter | Data e hora da última criação ou alteração do registro |
| barCode | item-mat.cod-ean | Código GTIN do item informado no programa CD0903 |
| length | ref-item.comprim | Comprimento do item informada no programa CD0903 |
| height | ref-item.altura | Altura do item informada no programa CD0903 |
| width | ref-item.largura | Largura do item informada no programa CD0903 |
| weight | ref-item.peso-liquido | Peso líquido do item informado no programa CD0903 |
| realWeight | ref-item.peso-bruto | Peso bruto do item informado no programa CD0903 |
| measurementUnit | item.un | Unidade de medida informada para o item no programa CD0204 |
| productRootCode | item.it-codigo | Código do item no ERP |
04. SALDO EM ESTOQUE
Ao cadastrar um item no programa PD0623, e um depósito no programa PD0628, o saldo em estoque do item informado no programa PD0623, com o depósito e estabelecimento informado no PD0028, será verificado o saldo em estoque disponível desse item/estabelecimento/depósito e enviado do ERP Datasul para o E-commerce.
No momento que é cadastrado um depósito no programa PD0628, será gerado um registro na tabela: tab-integr-loja-cia.
Na tabela movto-estoq fica armazenada o código do item, estabelecimento, depósito e a data e hora da última criação ou alteração do registro.
Na primeira carga dos itens do ERP Datasul para o e-commerce, todos os saldo em estoque disponíveis dos depósitos gravados na tabela tab-integr-loja-cia serão enviadas para o e-commerce.
Nas cargas posteriores serão considerados as definições dos itens que possuírem registros na tabela movto-estoq.
No Programa PD0623 o item IPHONE 13 foi definido como um item a ser integrado no e-commerce.
No programa PD0628 foi definido que os depósitos que terão seu saldo em estoque disponível para o e-commerce, para o estabelecimento 1 serão fab, alm e esp:
Portanto se o item IPHONE 13 possuir saldo em estoque cadastrado no estabelecimento 1, para um dos depósitos (fab, alm e esp) o saldo em estoque disponível será enviado para o e-commerce:
Na imagem acima, o item IPHONE 13, tem saldo em estoque cadastrado para o estabelecimento 1, somente no depósito fab. Portando somente o saldo disponível no estoque fab do estabelecimento 1 será enviado para o e-commerce.
Se desejar enviar também o saldo em estoque disponível dos outros depósitos informados no programa PD0628 (alm e esp) será necessário cadastrar saldo em estoque para o item IPHONE 13 e estabelecimento 1 nos depósitos alm e esp.
Para confirmar que as definições do saldo em estoque foram realizadas corretamente e serão enviadas para o e-commerce, e que será possível visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cep/v1/stockBalancePublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Para retornar todas as definições do saldo em estoque informado para o item cadastrado no programa PD0623, e depósito e estabelecimento no programa PD0628 (e que sofreram uma alteração no saldo em estoque disponível) a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscadas todo o saldo em estoque disponível criado/alterado a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações das definições do saldo em estoque do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| branchCode | saldo-estoq.cod-estabel | Código do estabelecimento a qual o saldo em estoque foi vinculado no ERP |
| itemCode | saldo-estoq.it-codigo | Código do item a qual o saldo em estoque foi vinculado no ERP. Caso o item seja possua o controle de estoque por referência, a tag itemCode será preenchida dessa forma: saldo-estoq.it-codigo|saldo-estoq.cod-refer |
| referenceCode | saldo-estoq.cod-refer | Referência do item a qual o saldo em estoque foi vinculado no ERP |
| warehouseCode | cod-depos | Depósito a qual o saldo em estoque foi vinculado no ERP |
| erpLastChange | DATETIME-TZ(MONTH(movto-estoq.dt-trans), DAY(movto-estoq.dt-trans), YEAR(movto-estoq.dt-trans), INTEGER(ENTRY(1, movto-estoq.hr-trans, ':')), INTEGER(ENTRY(2, movto-estoq.hr-trans, ':')), INTEGER(ENTRY(3, movto-estoq.hr-trans, ':')), 0) | Data e hora da última criação ou alteração do registro |
| quantity | saldo-estoq.qtidade-atu - saldo-estoq.qt-alocada - saldo-estoq.qt-aloc-prod - saldo-estoq.qt-aloc-ped. | Define o saldo disponível em estoque (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
05. TABELA DE PREÇO
Ao cadastrar uma tabela de preço no programa PD0627, a tabela de preço será enviada do ERP Datasul para o E-commerce.
No momento que é cadastrado um item no programa PD0627, será gerado um registro na tabela: tab-integr-loja-cia
Na tabela tab-preco-log fica armazenada o código da tabela e a data e hora da última criação ou alteração do registro.
Na primeira carga dos itens do ERP Datasul para o e-commerce, todas as definições dos itens gravados na tabela tab-integr-loja-cia serão enviadas para o e-commerce.
Nas cargas posteriores serão considerados as definições dos itens que possuírem registros na tabela tab-preco-log.
Para confirmar que as tabelas de preços serão enviadas para o e-commerce e visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cdp/v1/priceTablePublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Para retornar todas as tabelas de preços cadastradas no programa PD0627 (e que sofreram uma alteração no programa CD1508) a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscadas todas as tabelas de preços criadas/alteradas a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações da tabela de preço do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| priceTableCode | tb-preco.nr-tabpre | Código da tabela de preço no ERP |
| initialDate | tb-preco.dt-inival | Data de início de validade da tabela de preço no ERP. |
| finalDate | tb-preco.dt-fimval | Data final de validade da tabela de preço no ERP |
| priceTableDescription | tb-preco.descricao | Descrição da tabela de preço no ERP |
| erpLastChange | tb-preco.dtm-alter | Data e hora da última criação ou alteração do registro |
| isActive | tb-preco.situacao | Define se a tabela de preço estará ativa no e-commerce ( informação não utilizada no e-commerce) |
06. ITEM DA TABELA DE PREÇO
Para que um item tenha seu preço enviado do ERP Datasul para o e-commerce, será necessário cadastrar um item no programa PD0623, informar um preço para este item no programa CD1508 e que a tabela a qual este item está vinculado, esteja informada no PD0627. Com esta parametrização será enviado o preço do item do ERP Datasul para o E-commerce.
No momento que é cadastrado um preço para o item na tabela de preço no programa CD1508, será gerado um registro na tabela: preço-item.
Na tabela preco-item-log fica armazenado o código do item, tabela de preço, preço do item e a data e hora da última criação ou alteração do registro.
Na primeira carga dos itens do ERP Datasul para o e-commerce, todos os preços dos itens informados no programa PD0623, das tabelas de preço do programa PD0627 e que tenham preço cadastrados no CD1508, serão enviadas para o e-commerce.
Nas cargas posteriores serão considerados as definições dos preços dos itens que possuírem registros na tabela preco-item-log.
No Programa PD0623 o item IPHONE 13 foi definido como um item a ser integrado no e-commerce.
No programa PD0627 foi definido que a tabela de preço VTEX é uma tabela a ser integrada do ERP Datasul para o e-commerce:
E no programa CD1508 foi cadastrado um preço para o item IPHONE 13 na tabela de preço VTEX:
Com isso o preço do item IPHONE 13 da tabela de preço VTEX será enviado do ERP Datasul para o e-commerce.
Para confirmar que as tabelas de preços serão enviadas para o e-commerce e visualizar os dados que estão sendo enviados do ERP Datasul para VTEX, é possível realizar uma requisição REST para o servidor onde a integração será executada por meio da ROTA:
GET - http://[servidor]/dts/datasul-rest/resources/prg/cdp/v1/priceItemPublic/ecommerce
A autorização para acesso é feita por meio de autenticação Basic Auth, informando usuário e senha de um usuário cadastrado no ERP:
Para retornar todos os preços dos itens das tabelas de preços cadastradas no programa PD0627 (e que sofreram uma alteração no preço programa CD1508) a partir de uma última data e hora de atualização do registro utilizar a ROTA:
Necessário informar o Query Params lastUpdate no formato de data e hora: 2022-02-17T00:00:00.001
Neste exemplo serão buscadas todas as tabelas de preços criadas/alteradas a partir do dia 17-02-2022 e do horário 00:00:00:
O JSON que envia as informações dos preços dos itens da tabela de preço do ERP Datasul para o e-commerce é composto dos seguintes campos:
| SERIALIZE-NAME | TABELA.CAMPO ERP | Descrição |
|---|---|---|
| priceTableCode | preço-item.nr-tabpre | Código da tabela de preço no ERP |
| startDate | preco-item.dt-inival | Data de início de validade do preço do item da tabela de preço no ERP. |
| endDate | endDate | Define a data final de validade do preço do item da tabela de preço (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
| itemCode | preco-item.it-codigo | Código do item no ERP. Caso o item possua o controle de estoque por referência, a tag itemCode será preenchida dessa forma: preco-item.it-codigo|preco-item.cod-refer |
| erpLastChange | preco-item.dtm-alter | Data e hora da última criação ou alteração do registro |
| isActive | preco-item.situacao | Define se o preço do item da tabela de preço estará ativo no e-commerce ( informação não utilizada no e-commerce) |
| price | preco-item.preco-fob | Preço do item na tabela de preço no ERP |
| priceItemKey | priceItemKey | Define a chave do preço do item da tabela de preço (preco-item.nr-tabpre|preco-item.it-codigo|preco-item.cod-refer|preco-item.cod-unid-med|preco-item.dt-inival|reco-item.quant-min) para encontrar este registro no e-commerce (campo não disponível na tabela do banco de dados, apenas de controle interno no ERP) |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas