SUGESTÃO DE INTEGRAÇÃO MÍNIMA Autor: Thiago Alipio & Augusto Pierzynski

Transcrição

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

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... 12

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: 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 URL: 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 URL: 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ç Métd: GET

7 7 URL: 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": Cm atualizar preç URL: 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 8 8. Cm fazer uma cnsulta de pedids pr status Métd: GET URL: 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 Métd: GET URL: Retrn: Tds s dads pssíveis de um pedid 10. Cm fazer a trca de status de um pedid URL: Cm cancelar um pedid URL: Retrn: "rderid": " ", "receipt": "c08dbd94-b09f-4b11-910a-bab5c343c312", "date": " T18:04: Z" 12. Cm enviar aprvaçã de pagament para Blet URL: Cm criar uma transprtadra e suas janelas de entrega para Entrega Agendada Técnlgia: REST (POST y GET) URL: Object Enviad: JSON Estrutura Enviada:

9 9 "id": "59", "slatype": "Entrega Agendada", "name": "Entrega Agendada", "scheduleddelivery": true, "maxrangedelivery": 10, "dayofweekfrdelivery": [ "dayofweek": 0, "deliveryranges": [ "starttime": "08:00:00", "endtime": "13:00:00", "listprice": 5.00 "starttime": "13:00:00", "endtime": "17:00:00", "listprice": 50 "starttime": "17:00:00", "endtime": "22:00:00", "listprice": 500 "dayofweek": 1, "deliveryranges": [ "starttime": "08:00:00", "endtime": "13:00:00", "starttime": "13:00:00", "endtime": "17:00:00", "starttime": "17:00:00", "endtime": "22:00:00", "dayofweek": 2, "deliveryranges": [ "starttime": "08:00:00", "endtime": "13:00:00", "starttime": "13:00:00", "endtime": "17:00:00", "starttime": "17:00:00", "endtime": "22:00:00", "dayofweek": 3, "deliveryranges": [ "starttime": "08:00:00", "endtime": "13:00:00", "starttime": "13:00:00", "endtime": "17:00:00", "starttime": "17:00:00", "endtime": "22:00:00", "dayofweek": 4, "deliveryranges": [ "starttime": "08:00:00", "endtime": "13:00:00", "starttime": "13:00:00", "endtime": "17:00:00", "starttime": "17:00:00", "endtime": "22:00:00", "dayofweek": 5, "deliveryranges": [ "dayofweek": 6, "deliveryranges": [, "freightvalue": [, "factrcubicweight": null, "freighttableprcessstatus": 1

10 Cm cancelar uma janela de entrega para Entrega Agendada Técnlgia: REST (POST y GET) URL: api/lgistics/pvt/cnfiguratin/freights/id-transprtadra/adddayfweekblcked Object Enviad: JSON Estructura Enviada: T08:00:00 Observaçã: É necessári enviar smente a hra inicial da janela. 15. Cm cancelar blquei de uma janela de entrega para Entrega Agendada Técnlgia: REST (POST y GET) URL: api/lgistics/pvt/cnfiguratin/freights/id-transprtadra/remvedayfweekblcked Object Enviad: JSON Estrutura Enviada: T08:00:00 Observaçã: É necessári enviar smente a hra inicial da janela. 16. Cm enviar ShippingNtificatin para a captura URL: Objet Enviad: JSON Estrutura Enviada: Se há mais de um prdut, repetir a parte de itens em bld(negrit) "invicenumber":"nf0001", "invicevalue":"20000", "curier":"sedex", "inviceurl":" "embeddedinvice":"", "issuancedate":" ", "trackingnumber":"sn0000br", "items": [ "id": "id-sku", "price": 10000, "quantity": 1 Retrn: "date": " T20:41: :00", "rderid": " ", "receipt": "59d2d4d89ca346938b29d6824a353c09"

11 Flux de integraçã de um pedid(tud feit pr API REST) 18. Flux de atualizaçã de preç (Feit pr API Webservice mais API REST)

12 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 26 PagSegur

13 20. Flux de Status 13