SUGESTÃO DE INTEGRAÇÃO MÍNIMA

Transcrição

1 SUGESTÃO DE INTEGRAÇÃO MÍNIMA Autr: Thiag Alipi

2 Índice 1. Cm criar um nv prdut... 3 Exempls de códigs C# para integraçã Cm criar un nv SKU... 4 Exempls de códigs C# para integraçã Integrações cm API REST precisam de autenticaçã! Cm cnsultar estque Cm atualizar estque Cm cnsultar preç Cm atualizar preç Cm fazer uma cnsulta de pedids pr status Cm fazer uma cnsulta de pedid pr ID Cm fazer a trca de status de um pedid Cm cancelar um pedid Cm enviar aprvaçã de pagament para Blet Cm enviar ShippingNtificatin para a captura Flux de integraçã de um pedid(tud feit pr API REST) Flux de atualizaçã de preç (Feit pr API Webservice mais API REST) Lista de Ids de frma de pagament... 10

3 3 1. Cm criar um nv prdut Tecnlgia: WebService Métd: PrductInsertUpdate Retrn: IdPrduct na VTEX Object Enviad: PrductDTO Infrmações sbre s dads que devem ser enviads Os camps que estã em vermelh sã brigatóris e devem vir d ERP Os camps que estã em amarel sã brigatóris, mas sã fixads na integraçã. a. DepartamentId = b. CategryId = c. BrandId = 1 d. LindId = Este vai ser link d prdut na VTEX. Nã se pde ter caracteres especiais e nem espaçs em branc. Exempl: i. Se nme d prdut é: Refrigeradra Cnsul Branc AD123RS, entã camp linkid deve ser: refrigeradra- cnsul- branc- AD123RS e. IsVisible: true f. IsActive: false Prpriedades Tips Tamanh Descriçã Id int nulável - Id d prdut Name String 150 Nme d prdut DepartmentId int nulável - Id d departament CategryId int nulável - Id da categria BrandId int nulável - Id da marca LinkId String 255 Url d prdut (sem espaçs e sem caracteres especiais) RefId String 200 Códig d ERP IsVisible bl nulável - Visível n Site Descriptin String max Descriçã d Prdut DescriptinShrt String max Descriçã resumida d Prdut ReleaseDate DateTime nulável - Data de Lançament KeyWrds String max Palavras Chaves Title String 150 Text que se insere na TAG TITLE n HTML IsActive bl nulável - Td nv prdut inicia cm inativ e pde se utilizar um utr métd para ativar: PrductActive TaxCde String 50 Códig fiscal MetaTagDescriptin String max MetaTagDescriptin. Para Ggle SupplierId int nulável - Id d prvedr ShwWithutStck Bl - Mstrar sem estque ListStreId lista de int - Lista cm s ids das ljas nde prdut deve estar. (multidmíni) AdWrdsRemarketingCde String 200 Códig d AdWrds LmadeeCampaignCde String 200 Códig da campanha d Lmadee

4 4 Exempls de códigs C# para integraçã O dwnlad ds exempls pde ser feit em: Sugerims também a utilizaçã de uma ferramenta de teste chamada SapUi Link d instaladr: 2. Cm criar un nv SKU Tecnlgia: WebService Métd: StckKeepingUnitInsertUpdate Retrn: Objet Enviad: StckKeepingUnitDTO Infrmações sbre s dads que devem ser enviads: Os camps em vermelh sã brigatóris e devem vir d ERP Os camps em amarel sã brigatóris, mas sã fixads na integraçã. a. IsActive = false b. MdalId = 1 Prpriedades Tips Tamanh Descriçã Id int nulável - Id d sku PrductId int nulável - Id d prdut (freign key) IsActive bl nulável - Ativa u nã SKU. Pde-se ativar SKU utilizand métd "StckKeepingUnitActivate" Name string 200 Nme d SKU RefId string 50 Códig d ERP CstPrice decimal nulável (18,2) Preç de cust d prvedr* ListPrice decimal nulável (18,2) Preç Desde* Price decimal nulável (18,2) Preç Pr (preç nrmal) * Height decimal nulável (18,4) Altura* Length decimal nulável (18,4) Cmpriment* Width decimal nulável (18,4) Largura* WeightKg decimal nulável (18,4) Pes em grama(g)* RealHeight decimal nulável (18,4) Altura real* RealLength decimal nulável (18,4) Cmpriment real* RealWidth decimal nulável (18,4) Largura real* RealWeightKg decimal nulável (18,4) Pes em grama(g) real* MdalId int nulável - Refere-se à mdalidade de frete (1- leve, 2- pesad, 3-refrigerad, 4-químic) CubicWeight decimal nulável (18,4) Pes cúbic InternalNte string max Camp bslet IsKit bl nulável - Se SKU é um Kit u nã (uma vez kit, sku nã pde deixar de ser kit) PrductName string 150 Nmbre d prdut IsAvaiable bl nulável - Camp bslet StckKeepingUnitEans lista de StckKeepingUnitEanDTO - Códig de barras (EAN13). Cas um sku esteja ativ, RefId esteja vazi e ean nã fr preenchid inativar-se-á sku DateUpdated DateTime nulável - Data de atualizaçã RewardValue decimal nulável (18,2) Códig de fidelidade EstimatedDateArrival DateTime nulável - Data de pré-venda ManufacturerCde string 100 Códig d fabricante

5 5 CmercialCnditinId int nulável - Id da cndiçã cmercial MeasurementUnit string - Unidade de medida UnitMultiplier decimal nulável - Multiplicadr da unidade Exempls de códigs C# para integraçã O dwnlad ds exempls pde ser feit em: Sugerims também a utilizaçã de uma ferramenta de teste chamada SapUi Link d instaladr: 3. Integrações cm API REST precisam de autenticaçã! Para bter a chave e tken para a autenticaçã, deve- se ingressar n admin da VTEX através da URL: da- lja].vtexcmmercestable.cm.br/admin 1) N módul LicenseManager, 2) Click em Cntas. 3) Depis, faça uma busca pela cnta 4) Click em Editar Há uma área de Segurança, cm se vê na imagem abaix, nde: 1) VTEX APP KEY 2) VTEX APP TOKEN 3) Gerar um nv par de chaves

6 6 4. Cm cnsultar estque Tecnlgia: REST (POST y GET) Métd: POST URL: da- lja].vtexcmmercestable.cm.br/api/lgistics/pvt/inventry/itemsbalance Objet Enviad: JSON Estrutura: ["id":"id- sku1"},"id":"id- sku2"}] Estrutura de Retrn: [ "itemid": " ", "quantity": 310, "eventtimestamp": " ", "saleschannel": "1" }, "itemid": " ", "quantity": 19, "eventtimestamp": " ", "saleschannel": "1" } ] Exempl em Códig C#???????????????????????????????????????????????????????????????????????????? 5. Cm atualizar estque Tecnlgia: REST (POST y GET) Métd: POST URL: da- lja].vtexcmmercestable.cm.br/api/lgistics/pvt/inventry/warehuseitembalances Objet Enviad: JSON Estrutura: [ "warehuseid":"stck- Id","itemId":"id- Sku1","quantity":"xx","dateUtcOnBalanceSystem":null}, "warehuseid":"stck- Id","itemId":"id- Sku1","quantity":"xx","dateUtcOnBalanceSystem":null}] Retrn: true Exempl em Códig C#??????????????????????????????????????????????????????????????????????????? 6. Cm cnsultar preç Tecnlgia: REST (POST y GET) Métd: GET

7 7 URL: sheet/id_sku}?an=nme- da- lja} Retrn: um u mais bjets em Jsn, de acrd cm a quantidade de saleschannel [ "itemid": id- sku, "surce": null, "price": 400, "saleschannel": 2, "medium": null, "campaign": null, "internalcampaign": null, "validfrm": " T11:41:52.33", "validt": " T00:00:00", "listprice": 400 }, "itemid": id- sku, "surce": null, "price": 250, "saleschannel": 1, "medium": null, "campaign": null, "internalcampaign": null, "validfrm": " T11:41:52.33", "validt": " T11:41:52.33", "listprice": 500 } ] 7. Cm atualizar preç Tecnlgia: REST (POST y GET) Métd: POST URL: sheet?an=nme- da- lja} Objet Enviad: JSON Estrutura Enviada: [ "itemid": id- sku, "surce": null, "price": 150, "saleschannel": 1, "medium": null, "campaign": null, "internalcampaign": null, "validfrm": " T11:41:52.33", "validt": " T11:41:52.33", "listprice": 500 } ] Retrn: Dne!!!

8 "invicenumber":"nf0001", "invicevalue":"20000", "curier":"sedex", "inviceurl":" "embeddedinvice":"", "issuancedate":" ", "trackingnumber":"sn0000br", "items": [ 8 8. Cm fazer uma cnsulta de pedids pr status Tecnlgia: REST (POST y GET) Métd: GET URL: da- lja}&f_status=ready- fr- handling Pssibles Status: payment- pending, ready- fr- handling, start- handling, handling, inviced Retrn: Uma lista cm s IDs de pedids. 9. Cm fazer uma cnsulta de pedid pr ID Tecnlgia: REST (POST y GET) Métd: GET URL: id}/?an=nme- da- lja} Retrn: Tds s dads pssíveis de um pedid 10. Cm fazer a trca de status de um pedid Tecnlgia: REST (POST y GET) Métd: POST URL: id}/start- handling/?an=nme- da- lja} 11. Cm cancelar um pedid Tecnlgia: REST (POST y GET) Métd: POST URL: id}/cancel/?an=nme- da- lja} Retrn: "rderid": " ", "receipt": "c08dbd94- b09f- 4b11-910a- bab5c343c312", "date": " T18:04: Z" } 12. Cm enviar aprvaçã de pagament para Blet Tecnlgia: REST (POST y GET) Métd: POST URL: da- lja}.vtexcmmercestable.cm.br/api/ms/pvt/rders/rder- id}/payments/payment- id}/payment- ntificatin 13. Cm enviar ShippingNtificatin para a captura Tecnlgia: REST (POST y GET) Métd: POST URL: id}/shipping- ntificatin?an=nme- da- lja} Objet Enviad: JSON Estrutura Enviada: Se há mais de um prdut, repetir a parte de itens em bld(negrit)

9 9 Retrn: "date": " T20:41: :00", "rderid": " ", "receipt": "59d2d4d89ca346938b29d6824a353c09" } 14. Flux de integraçã de um pedid(tud feit pr API REST) 15. Flux de atualizaçã de preç (Feit pr API Webservice mais API REST)

10 Lista de Ids de frma de pagament Id Nmbre 1 American Express 2 Visa 3 Diners 4 Mastercard 5 Discver 6 Blet Bancári 7 Aura 8 Hipercard 9 El 10 Visa Electrn 11 Cartã da Lja 12 PayPal 13 Bcash 14 Banricmpras 15 Evlucard 16 Vale 17 Prmissry 18 Mercad Pag 19 Débit Online 22 Débit Itaú 23 Débit Bradesc 24 Débit Banc d Brasil 25 Débit Banrisul

11 17. Flux de Status 11