Páginas filhas
  • Rotas REST - E-commerce

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

SERIALIZE-NAMETABELA.CAMPO ERPDescrição
categoryParentCodedepto-integr-loja.cod-familia-comercCódigo da Família Comercial no ERP
categoryErpDescdepto-integr-loja.desc-familia-comerc-erpDescrição da Família Comercial no ERP
categoryNamedepto-integr-loja.nom-deptoNome da Categoria no e-commerce
categoryDescriptiondepto-integr-loja.dsl-deptoDescrição da Categoria no e-commerce
isActivedepto-integr-loja.log-ativoDefine se a categoria estará ativa no e-commerce
categoryParentCodedepto-integr-loja.cod-familia-comerc-paiSe a categoria é filha de outra categoria, é gravado neste campo o código da categoria pai
erpLastChangedepto-integr-loja.dtm-alterData e hora da ultima criação ou alteração do registro
areItemsIntegratedlog-itens-integrIndica se a categoria possui item já integrado com o e-commerce (campo lógico para controle interno no ERP)

02. 

...

PRODUTO

Ao cadastrar um item no programa PD0623, esse item será enviada do ERP Datasul para o E-commerce.

...

O JSON que envia as informações da categoria do produto do ERP Datasul para o e-commerce é composto dos seguintes campos:

SERIALIZE-NAMETABELA.CAMPO ERPDescrição
categoryCodedepto-integr-lojaitem.fm-cod-comCódigo da Família Comercial a qual o item pertence no ERP
itemCodedepto-integr-lojaitem.cod-item Código do item 
itemDescriptiondepto-integr-lojaitem.desc-item Descrição do item 
isActivedepto-integr-lojaitem.cod-obsoletoDefine se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce)
erpLastChangedeptoitem-integr-lojalog.dtm-alterData e hora da ultima criação ou alteração do registro 
integratedDepositdepto-integr-loja.log-integr-deposIndica se o item possui um depósito já integrado com o e-commerce (campo lógico para controle interno no ERP)
integratedPriceTabdepto-integr-loja.log-integr-tbIndica se o item possui uma tabela de preço já integrada com o e-commerce (campo lógico para 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/cdp/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:

Image Added

Image Added


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 ultima data e hora de atualização do registro utilizar a ROTA:

GET http://servidor/dts/datasul-rest/resources/prg/cdp/v1/productSkuPublic/ecommerce?lastUpdate=2022-02-17T00:00:00.001


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 no dia 17-02-2022 a partir da 00:00:00:

Image Added


O JSON que envia as informações das definições do produto do ERP Datasul para o e-commerce é composto dos seguintes campos:

SERIALIZE-NAMETABELA.CAMPO ERPDescrição
referenceCodeitem.cod-referCódigo da Família Comercial a qual o item pertence no ERP
itemCodeitem.cod-item Código do item 
itemDescriptionitem.desc-item Descrição do item 
isActiveitem.cod-obsoletoDefine se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce)
erpLastChangeitem-log.dtm-alterData e hora da ultima criação ou alteração do registro 
barCodeitem-mat.cod-eanCódigo GTIN do item informado no programa CD0903
lengthitem.comprimComprimento do item informada no programa CD0903
heightitem.alturaAltura do item informada no programa CD0903
widthitem.larguraLargura do item informada no programa CD0903
weightitem.peso-liquidoPeso líquido do item informado no programa CD0903
realWeightitem.peso-brutoPeso bruto do item informado no programa CD0903
measurementUnititem.unUnidade de medida informada para o item no programa CD0204
productRootCodeitem.it-codigoCó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-NAMETABELA.CAMPO ERPDescrição
referenceCoderef-item.cod-referCódigo da Família Comercial a qual o item pertence no ERP
itemCoderef-item.cod-item Código do item 
itemDescriptionitem.desc-item Descrição do item 
isActiveitem.cod-obsoletoDefine se o item estará ativo no e-commerce (totalmente obsoleto no CD0204, significa que o item estará inativo no e-commerce)
erpLastChangeitem-log.dtm-alterData e hora da ultima criação ou alteração do registro 
barCodeitem-mat.cod-eanCódigo GTIN do item informado no programa CD0903
lengthref-item.comprimComprimento do item informada no programa CD0903
heightref-item.alturaAltura do item informada no programa CD0903
widthref-item.larguraLargura do item informada no programa CD0903
weightref-item.peso-liquidoPeso líquido do item informado no programa CD0903
realWeightref-item.peso-brutoPeso bruto do item informado no programa CD0903
measurementUnititem.unUnidade de medida informada para o item no programa CD0204
productRootCodeitem.it-codigoCódigo do item no ERP 

...

03. SOLUÇÃO


Totvs custom tabs box
tabsPasso 01, Passo 02, Passo 03, Passo 04
idspasso1,passo2
Totvs custom tabs box items
defaultyes
referenciapasso1

Totvs custom tabs box items
defaultno
referenciapasso2

...