You are on page 1of 37

Manual dos WebServices de integrao com o BACOS

Verso do Web Service: 5. B. 5

Conte!do
Contedo..................................................................................................................................................................................................... 1 WebServices................................................................................................................................................................................................ 1 Produtos.................................................................................................................................................................................................. 1 Endereos........................................................................................................................................................................................... 1 Lista de mtodos................................................................................................................................................................................. 1 Clientes.................................................................................................................................................................................................... 3 Endereos........................................................................................................................................................................................... 3 Lista de mtodos ................................................................................................................................................................................ 3 Pedidos.................................................................................................................................................................................................... 3 Endereos........................................................................................................................................................................................... 3 Lista de mtodos ................................................................................................................................................................................ 3 Exemplos..................................................................................................................................................................................................... 4 rea para desenvolvedores......................................................................................................................................................................... 4 !ntrodu"o................................................................................................................................................................................................ 4 C#ave de identi$ica"o............................................................................................................................................................................ 4 %abelas com c&di'os para inte'ra"o de pedidos.................................................................................................................................. 4 (luxo de atuali)a"o dos dados.................................................................................................................................................................. * !ntrodu"o................................................................................................................................................................................................ * +tuali)a"o das in$orma,es do produto................................................................................................................................................ * !nte'ra"o de clientes............................................................................................................................................................................. !nte'ra"o de pedidos............................................................................................................................................................................. . /etornos da execu"o dos mtodos....................................................................................................................................................... . 0vidas $re1uentes.................................................................................................................................................................................. . 0ocumenta"o das propriedades................................................................................................................................................................ 2 0escri"o dos valores pertinentes aos tipos de dados codi$icados..........................................................................................................32 !n$orma,es pertinentes ao resultado da opera"o reali)ada 40ados/esultado5peracao6 ....................................................................31 %abela de c&di'os de resultados de opera,es reali)adas....................................................................................................................... 33 7ist&rico de atuali)a,es dos Web Services 8+C5S............................................................................................................................. 34

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

WebServices
"rodutos
Este WebService destina:se a inte'ra"o de produtos do sistema +8+C5S 4;PL Solu,es6 com sistemas externos. <m exemplo seria a atuali)a"o dos dados de produtos em um site de e:commerce. + utili)a"o deste WebService permite tambm a atuali)a"o das in$orma,es de esto1ue= preos entre outras in$orma,es relacionadas aos produtos comerciali)ados por uma empresa.

#ndereos
Lin>? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWS"rodutos.asm!mportar os mtodos para criar uma aplica"o? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWS"rodutos.asm-.WS/0

0ista de m1todos

Categorias"roduto/is%oniveis 0eve ser utili)ado para obter as in$orma,es de cate'orias de produtos para o site 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. Classes/is%oniveis 0eve ser utili)ado para obter as in$orma,es de Classes de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. Con2irmar3ecebimentoCategoria"roduto Auando uma cate'oria de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimentoClasse Auando uma Classe de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento/escritor"re/e2inido Auando um 0escritor Pr:0e$inido de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento#sto4ue Auando o saldo de esto1ue de um produto se torna dispon@vel para inte'ra"o ele se torna um item de uma lista at 1ue seBa retirado da mesma. Para retirC:lo da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento5amilia Auando uma (amilia de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento6ru%o"roduto Auando uma Drupo de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimentoMarca Auando uma marca de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento"reco Auando o preo de um produto se torna dispon@vel para inte'ra"o ele se torna um item de uma lista at 1ue seBa retirado da mesma. Para retirC:lo da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. Con2irmar3ecebimento"roduto Auando um produto se torna dispon@vel para inte'ra"o elE se torna um item de uma lista at 1ue seBa retirado da mesma. Para retirC:lo da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
Con2irmar3ecebimentoSub6ru%o"roduto Auando uma Sub:Drupo de produto se torna dispon@vel para inte'ra"o ela se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:la da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra a mesma irC permanecer na lista inde$inidamente. /escritores"re/e2inidos/is%oniveis 0eve ser utili)ado para obter as in$orma,es de 0escritores Pr:0e$inidos de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. #sto4ueOn0ine Se deseBar poss@vel locali)ar o saldo de esto1ue de 1ual1uer produto com a posi"o do momento= ou seBa= obter o saldo de esto1ue online. EocF pode solicitar o saldo de esto1ue de um nico produto ou de uma lista. Go retorno todos os produtos 1ue estavam presentes na solicita"o s"o apresentados com os seus respectivos resultados 4sucesso ou erro6. #sto4ues/is%oniveis 0eve ser utili)ado para obter as in$orma,es de saldos de esto1ue de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. 5amilias/is%oniveis 0eve ser utili)ado para obter as in$orma,es de (amilias de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. 6ru%o"rodutos/is%oniveis 0eve ser utili)ado para obter as in$orma,es de Drupo de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. Marcas/is%oniveis 0eve ser utili)ado para obter as in$orma,es de marcas de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. "recoOn0ine Se deseBar poss@vel locali)ar o preo de 1ual1uer produto com a posi"o do momento= ou seBa= obter o preo online. EocF pode solicitar o preo de um nico produto ou de uma lista. Go retorno todos os produtos 1ue estavam presentes na solicita"o s"o apresentados com os seus respectivos resultados 4sucesso ou erro6. "recos/is%oniveis 0eve ser utili)ado para obter as in$orma,es de preos de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. "rodutos/is%oniveis 0eve ser utili)ado para obter as in$orma,es de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o. Sub6ru%o"rodutos/is%oniveis 0eve ser utili)ado para obter as in$orma,es de Sub:Drupo de produtos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre uma inclus"o= altera"o de al'uma in$orma"o ou exclus"o.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

Clientes
Este WebService destina:se a inte'ra"o de clientes com o sistema +8+C5S. <m exemplo seria a capta"o de pedidos por um site de e: commerce. 5 cliente se cadastraria para a compra e posteriormente seria $eita a inte'ra"o dos seus dados no sistema +8+C5S para 1ue $osse poss@vel a emiss"o da nota $iscal= por exemplo.

#ndereos
Lin>? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWSClientes.asm!mportar os mtodos para criar aplica"o? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWSClientes.asm-.WS/0

0ista de m1todos

CadastrarCliente Permite a inclus"o dos clientes diretamente no sistema +8+C5S. Podem ser enviados vCrios clientes de uma nica ve) se assim $or deseBado.

"edidos
#ndereos
Lin>? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWS"edidos.asm!mportar os mtodos para criar aplica"o? $tt%:&&' (.').(5.((':* +,&AbacosWebSvc&AbacosWS"edidos.asm-.WS/0

0ista de m1todos

Con2irmar3ecebimentoStatus"edido Auando um status de pedido se torna dispon@vel para inte'ra"o ele se torna um item de uma lista at 1ue seBa retirada da mesma. Para retirC:lo da lista necessCrio in$ormar 1ue a sua inte'ra"o $oi bem sucedida. Este mtodo deve ser usado para isso. Caso a con$irma"o n"o ocorra o mesmo irC permanecer na lista inde$inidamente. 7nserir"edido Permite a inclus"o dos pedidos diretamente no sistema +8+C5S. Podem ser enviados vCrios pedidos de uma nica ve) se assim $or deseBado. "edido#-iste Este mtodo deve ser usado para identi$icar se um pedido BC $oi inclu@do na base de dados do +8+C5S. Status"edido/is%oniveis 0eve ser utili)ado para obter as in$orma,es de status de pedidos 1ue est"o dispon@veis para a inte'ra"o. + in$orma"o se torna dispon@vel para inte'ra"o 1uando ocorre al'uma altera"o no status do pedido.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

#-em%los
0elp#i? $tt%:&&888.9%lsolucoes.com.br&AbacosWebServices&/el%$iVC0.:i%

rea %ara desenvolvedores


7ntroduo
+ Crea para desenvolvedores tem por obBetivo proporcionar aos desenvolvedores um local onde eles podem ter o primeiro contato com o Web Service= inclusive podendo importar as assinaturas dos mtodos 4!mportar o WS0L6. Gesta Crea poss@vel iniciar o desenvolvimento sem 1ue #aBa a necessidade de esperar a implanta"o de todas as rotinas no ambiente do cliente 1ue utili)a o sistema 8+C5S.

C$ave de identi2icao
Para comear a inte'ra"o com os WebServices 8+C5S necessCrio a libera"o de uma c#ave de identi$ica"o. Praticamente todos os mtodos dos Web Services utili)am esta c#ave para identi$icar o inte'rador e locali)ar todos os parHmetros e con$i'ura,es associados ao mesmo. Para a Crea de testes a c#ave de identi$ica"o in$ormada abaixo deverC ser usada. Auando entrar em produ"o serC 'erado outra= por isso= o inte'rador deverC solicitC:la ao suporte tcnico da ;PL antes de iniciar o envio dos dados o$iciais. C#ave para uso na Crea de testes da ;PL? CB5'#5 /;5<,A;+(C ;=+<=;','5A+55+5/+

>abelas com c?digos %ara integrao de %edidos


5s c&di'os abaixo s"o apenas para a Crea de desenvolvimento. Em produ"o ser"o de$inidos outros. Como o conceito do 8+C5S permite 1ue seBam correlacionados os c&di'os do inte'rador com os do sistema= serC poss@vel trabal#ar com os c&di'os do inte'rador= ou seBa= em produ"o ser"o $eitas con$i'ura,es e os c&di'os do inte'rador poder"o ser usados. Esta metodolo'ia tem por obBetivo desobri'ar o inte'rador a criar um es1uema I0EJP+/+K em seu sistema a $im de enviar os c&di'os corretos. >rans%ortadora C&di'o 0escri"o CS CorreiosJSE0EL CE CorreiosJE:SE0EL 5orma de %agamento C&di'o 0escri"o 32 E!S+ -4 8oleto p&s:$aturado 3e%resentante C&di'o 0escri"o 1 /epresentante padr"o

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

5lu-o de atuali:ao dos dados


7ntroduo
+ inte'ra"o com o Web Service pode ser $eita com a ar1uitetura 1ue o inte'rador deseBar 4online ou batc#6 usando WindoMs Services ou uma c#amada manual solicitada pelo usuCrio. +consel#amos ao inte'rador tomar cuidados 1uanto ao $ato de paralisar o $luxo normal no site como= por exemplo= se n"o $or poss@vel incluir o pedido usando o Web Service ent"o n"o poderC ser $inali)ado o pedido. 0F pre$erFncia por n"o abortar o processo de capta"o do pedido= re'istre:o e depois e$etue a inte'ra"o com o 8+C5S. +consel#amos ao inte'rador 1ue utili)e um I/obNK baseado em WindoMs Service. Este mtodo BC $oi testado e se mostrou muito e$iciente. Ouitos cuidados na con$ec"o de um servio devem ser tomados= pois um WindoMs Service= n"o tem uma inter$ace visual para o monitoramento do usuCrio. Para suprir esta necessidade opte por utili)ar um mecanismo de envio de email para um 'rupo de usuCrios 1ue deve $icar responsCvel pela administra"o da inte'ra"o.

Atuali:ao das in2orma@es do %roduto


S"o disponibili)adas diversas in$orma,es do produto como a sua marca= 'rupo= sub:'rupo= descritor pr:de$inido 4valores variCveis6= classes= $am@lias= entre outros. Para uma estrutura padr"o de manuten"o do cadastro do produto a in$orma"o do produto inicia no 8+C5S e disponibili)ada atravs do WebService para 1ue o inte'rador atuali)e as in$orma,es= por exemplo= no site de e:commerce. Geste caso= o inte'rador deve construir um mecanismo 1ue de tempos em tempos acesse o WebService e obten#a as in$orma,es a serem inte'radas. Para obter os dados do produto= por exemplo= deve ser executado o mtodo IProdutos0isponiveisK. Existem diversas propriedades no produto e al'umas delas se re$erem a outras tabelas 1ue se $orem usadas pelo inte'rador devem ser obtidas antes de ocorrer a inte'ra"o do produto. Vamos a um e-em%lo: Go site devem ser inte'radas as in$orma,es do produto= sua marca e $am@lia. 5 inte'rador precisa destas in$orma,es= pois sem elas= os dados do produto $icariam incompletos. Para 1ue esta inte'ra"o ocorra serC necessCrio acessar o Web Service I+bacosWSProdutos.asmxK e executar os mtodos I(amilia0isponiveisK= IOarcas0isponiveisK e por ltimo IProdutos0isponiveisK. %odos os mtodos tFm uma propriedade 1ue deve ser usada para a con$irma"o de 1ue a in$orma"o BC $oi inte'rada e 1ue a'ora n"o precisa estar presente na pr&xima busca. 5 mtodo 1ue sinali)a 1ue a in$orma"o $oi inte'rada se c#ama= respectivamente= ICon$irmar/ecebimento(amiliaK= ICon$irmar/ecebimentoOarcaK e ICon$irmar/ecebimentoProdutoK. 5 1uadro abaixo demonstra o $luxo de execu"o dos mtodos para o exemplo citado acima. Se4Aenciamento da e-ecuo dos m1todos +bacosWSProdutos.asmx Otodo 0escri"o (amilias0isponiveis Solicitar in$orma,es da $am@lia do produto Con$irmar/ecebimento(amil ia Sinali)a no sistema 8+C5S 1ue a in$orma"o da $am@lia BC $oi inte'rada.

Sentido

!nte'rador 0eve solicitar a lista de $am@lias disponibili)adas para atuali)a"o. Esta lista contm as in$orma,es da $am@lia do produto 1ue tiveram al'uma altera"o ou 1ue $oram recentemente inclu@das. 0eve con$irmar se inte'rou a $am@lia. Se $or con$irmado= na pr&xima ve) 1ue $or solicitada a lista de $am@lias= a1uela 1ue BC $oi con$irmada n"o aparecerC mais. Para isso necessCrio passar o valor da propriedade IProtocolo(amiliaK da classe de dados I0ados(amiliasProdutosK retornado pelo mtodo I(amilias0isponiveisK 4Eide se"o de documenta"o das propriedades6.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

Oarcas0isponiveis

Solicitar in$orma,es da marca do produto Sinali)a no sistema 8+C5S 1ue a in$orma"o da marca BC $oi inte'rada.

Con$irmar/ecebimentoOarc a

Produtos0isponiveis

Solicitar in$orma,es do produto

Con$irmar/ecebimentoProd uto

Sinali)a no sistema 8+C5S 1ue a in$orma"o do produto BC $oi inte'rada.

0eve solicitar a lista de marcas disponibili)adas para atuali)a"o. Esta lista contm as in$orma,es da marca do produto 1ue tiveram al'uma altera"o ou 1ue $oram recentemente inclu@das. 0eve con$irmar se inte'rou a marca. Se $or con$irmado= na pr&xima ve) 1ue $or solicitada a lista de marcas= a1uela 1ue BC $oi con$irmada n"o aparecerC mais. Para isso necessCrio passar o valor da propriedade IProtocoloOarcaK da classe de dados I0adosOarcasProdutosK retornado pelo mtodo IOarcas0isponiveisK 4Eide se"o de documenta"o das propriedades6. 0eve solicitar a lista de produtos disponibili)ados para atuali)a"o. Esta lista contm as in$orma,es dos produtos 1ue tiveram al'uma altera"o ou 1ue $oram recentemente inclu@dos. 0eve con$irmar se inte'rou o produto. Se $or con$irmado= na pr&xima ve) 1ue $or solicitada a lista de produtos= a1uele 1ue BC $oi con$irmado n"o aparecerC mais. Para isso necessCrio passar o valor da propriedade IProtocoloProdutoK da classe de dados I0adosProdutosK retornado pelo mtodo IProdutos0isponiveisK 4Eide se"o de documenta"o das propriedades6.

+ se1PFncia acima indica a ordem com 1ue os mtodos devem ser executados para 1ue as in$orma,es seBam atuali)adas pelo inte'rador. Geste exemplo= usamos apenas al'uns mtodos representando uma por"o dos dados do produto. Caso o inte'rador utili)e um conBunto maior de dados do produto= como por exemplo= o 'rupo do produto= ele deverC proceder da mesma $orma= apenas executando os mtodos pertinentes Q in$orma"o 1ue necessita. Em todos os casos= a se1PFncia de obter as in$orma,es dispon@veis e con$irmar o recebimento delas deverC ser se'uida.

7ntegrao de clientes
Se4Aenciamento da e-ecuo dos m1todos. !nte'rador Enviar os dados do cliente para o sistema 8+C5S atravs do Web Service. 0eve #aver o envio das in$orma,es 1uando um novo cliente $or cadastrado ou 1uando ocorrer uma altera"o nos dados do cliente. Em ambos os casos o mecanismo tem o mesmo $uncionamento n"o precisando ser in$ormado se uma inclus"o ou altera"o. Sentido Otodo CadastrarCliente +bacosWSClientes.asmx 0escri"o Possibilita a inclus"o ou altera"o dos dados do cliente. Este mtodo permite o envio de vCrios clientes de uma nica ve). Para isso= basta passar um arraR de dados de clientes pelo mtodo.

BO>A: 5 cadastramento de clientes deve ocorrer antes da inte'ra"o do pedido. Su'erimos 1ue sempre 1ue um pedido $or inte'rado os dados de novos clientes ou mesmo sua altera"o= seBam enviadosS 5 envio dos dados do cliente n"o obri'a o envio dos pedidos. Clientes e pedidos s"o Web Services di$erentes para 1ue o inte'rador possa desenvolver rotinas de atuali)a"o independentes.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

7ntegrao de %edidos
Se4Aenciamento da e-ecuo dos m1todos. !nte'rador 0eve enviar os dados do pedido= seus itens e $orma de pa'amento. 0ados como o c&di'o da $orma de pa'amento= transportadora e representante precisam de con$i'ura"o prvia no sistema 8+C5S 4deJpara de c&di'os6 para 1ue os pedidos entrem normalmente. Sentido +bacosWSPedidos.asmx Otodo !nserirPedido 0escri"o Possibilita a inclus"o do pedido. GT5 possibilita a altera"o do pedido= sendo assim= o inte'rador deve ter certe)a 1ue o pedido BC pode ser inte'rado. Se #ouver necessidade de altera"o= esta deverC ser $eita no sistema 8+C5S. Este mtodo permite o envio de vCrios pedidos de uma nica ve). Para isso= basta passar um arraR de dados de pedido pelo mtodo. 0isponibili)a uma lista com os status pelos 1uais o pedido BC passou para 1ue o inte'rador possa sinali)ar a situa"o do pedido. Sinali)a no sistema 8+C5S 1ue a in$orma"o do status do pedido BC $oi inte'rada.

Se $or deseBado o recebimento dos status 1ue indicam o estC'io do pedido no sistema 8+C5S o inte'rador deverC buscar as in$orma,es pertinentes aos status usando o Web Service. 0eve con$irmar se inte'rou o status do pedido. Se $or con$irmado= na pr&xima ve) 1ue $or solicitada a lista de status de pedidos= a1uele 1ue BC $oi con$irmado n"o aparecerC mais. Para isso necessCrio passar o valor da propriedade IProtocoloStatusPedidoK da classe de dados I0adosStatusPedidosK retornado pelo mtodo IStatusPedido0isponiveisK 4Eide se"o de documenta"o das propriedades6.

StatusPedido0isponiveis

Con$irmar/ecebimentoStatusPe dido

BO>A: + solicita"o dos status de pedido pode ser $eita ap&s todos os pedidos terem sido inte'rados= pois o mtodo IStatusPedido0isponiveisK retorna uma lista com os status de todos os pedidosS 5 mtodo IPedidoExisteK serve para descobrir se o pedido BC $oi inte'rado anteriormente. Ele deve ser usado apenas se n"o $or poss@vel controlar o envio do pedido para o Web Service. Este mtodo retorna apenas se o pedido existe e n"o possibilita a sua altera"oS Para a inte'ra"o dos pedidos n"o preciso in$ormar a propriedade servio de entre'a basta in$ormar a propriedade transportadora 1ue BC serC su$iciente para identi$icar a transportadora no 8+C5S. 5 c&di'o passado na transportadora BC possibilita a locali)a"o do servio de entre'a= pois $eita uma con$i'ura"o 1ue correlaciona o c&di'o com a transportadora e servio de entre'aS + propriedade condi"o de pa'amento s& deve ser usada em casos espec@$icos. Esta propriedade $ica por padr"o desativado.

3etornos da e-ecuo dos m1todos


%odos os mtodos retornam uma classe 1ue identi$ica a situa"o da execu"o 4Eide I0ados/esultado5peracaoK6. Esta classe existe para 1ue seBa poss@vel enviar maiores detal#es sobre exception 1ue ocorrem na execu"o de um procedimento. Otodos 1ue recebem arraRs de dados para execu"o devolvem arraRs de resultado da execu"o. Para 1ue seBa mais $Ccil a identi$ica"o do problema= caso ele ocorra= su'erimos 1ue o inte'rador crie al'um tipo de retorno 1ue in$orme todos os dados contidos nas propriedades da classe de resultados da opera"o. Por exemplo= a propriedade IExceptionOessa'eK contm a mensa'em 'erada pelo erro 1ue disparou o mecanismo de IExceptionK seBa ele no banco de dados ou no pr&prio Web service= por este motivo= muito importante in$ormC:lo 1uando $or necessCrio relatar o erro ao suporte tcnico da ;PL.

/!vidas 2re4uentes
9

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
0vida Como devem ser enviadas as in$orma,es pertinentes Q S;<s de produtos.

Esclarecimento Go 8+C5S trabal#amos com o conceito de produto IP+!:(!L75K. + propriedade na classe de dados do produto 1ue li'a um produto ao outro a ICodi'oProdutoPaiK. %odos os produtos $il#os devem ter esta propriedade preenc#ida com o c&di'o do produto pai. Eamos pe'ar um produto como exemplo? Deladeira 411U ou 33U volts6 Produto P+!? Deladeira Produtos (!L75S? Deladeira 11UE e Deladeira 33UE= ambos os produtos com a propriedade ICodi'oProdutoPaiK preenc#ida com o c&di'o IDeladeiraK. Este relacionamento se encontra na propriedade ICate'orias0oSiteK na classe de dados de produtos I0adosProdutosK. 5 c&di'o da cate'oria provem de cate'orias do produto 4Classe 0adosCate'oriasProduto retornada pelo mtodo ICate'oriasProdutos0isponiveisK6.

Como identi$ico a associa"o do produto com a cate'oria do site 4tambm con#ecido como departamentos6

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

/ocumentao das %ro%riedades


Categoria de %roduto CClasse: /adosCategorias"rodutoD
Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para a inte'ra"o obtida atravs do mtodo VCate'oriasProdutos0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoCate'oriaProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao C&di'o 'erado no 8+C5S para a cate'oria do produto. Codi'oCate'oriaProduto tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado como c#ave de identi$ica"o. #-em%lo: *U3 C&di'o da cate'oria do produto onde a cate'oria estC subordinada. tde!nteiro $alse $alse 9 ComentErio: + estrutura de associa"o de cate'orias em Crvore= ou seBa= podem existir cate'orias associadas a outras cate'orias e n"o #C limite para o nmero de n@veis. BO>A: Se o valor desta propriedade $or )erado si'ni$ica 1ue a cate'oria n"o estC subordinada a nen#uma outra. #-em%lo: *U1 Gome 0escri"o da cate'oria do produto. #-em%lo: Calados tdeCaracter true $alse 1UU $alse $alse

ProtocoloCate'oriaProduto

Codi'oCate'oriaProdutoPai

Marca de %roduto CClasse: /adosMarcas"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VOarcas0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoOarcaV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao Gome 0escri"o da marca do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para a marca do produto. Codi'oOarca tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para a marca do produto. Codi'oExternoOarca tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 +tivo !ndica se a marca do produto estC ativa ou n"o. #-em%lo: true tde8oolean $alse $alse tdeCaracter true $alse 1UU $alse $alse

ProtocoloOarca

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

Classe de %roduto CClasse: /adosClasses"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VClasses0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoClasseV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao Gome 0escri"o da Classe do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para a Classe do produto. Codi'oClasse tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para a Classe do produto. Codi'oExternoClasse tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 tdeCaracter true $alse 1UU $alse $alse

ProtocoloClasse

5amilia de %roduto CClasse: /ados5amilias"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo V(amilias0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimento(amiliaV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao Gome 0escri"o da (amilia do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para a $amilia do produto. Codi'o(amilia tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para a $amilia do produto. Codi'oExterno(amilia tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 tdeCaracter true $alse 1UU $alse $alse

Protocolo(amilia

6ru%o de %roduto CClasse: /ados6ru%os"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VDruposProdutos0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoDrupoProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +cao +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado $alse $alse

ProtocoloDrupo

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao Gome 0escri"o do 'rupo do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para o 'rupo do produto. Codi'oDrupo tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para o 'rupo do produto. Codi'oExternoDrupo tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 tdeCaracter true $alse 1UU

Sub;gru%o de %roduto CClasse: /adosSub6ru%os"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VSubDruposProdutos0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoSubDrupoProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao Gome 0escri"o da SubDrupo do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para a Sub:Drupo do produto. Codi'oSubDrupo tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para a Sub:Drupo do produto. Codi'oExternoSubDrupo tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 C&di'o 'erado no 8+C5S para o 'rupo do produto. Codi'oDrupo tde!nteiro true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU C&di'o ami'Cvel para o 'rupo do produto. Codi'oExternoDrupo tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. #-em%lo: +8C:U1 tdeCaracter true $alse 1UU $alse $alse

ProtocoloSubDrupo

/escritor %r1;de2inido de %roduto CClasse:


/ados/escritores"re/e2inidos"rodutosD
Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3**

ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como Protocolo0escritorPre0e$inid inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo V0escritoresPre0e$inidos0isponiveisV e cada item deve ser o sinali)ado usando o mtodo VCon$irmar/ecebimento0escritorPre0e$inidoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +cao +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. $alse $alse

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
#-em%lo: aieOanutencao Gome 0escri"o da 0escritorPre0e$inido do produto. #-em%lo: Gi>e C&di'o 'erado no 8+C5S para a 0escritorPre0e$inido do produto. tde!nteiro true true 9 tdeCaracter true $alse 1UU

Codi'o0escritorPre0e$inido ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU Gmero do descritor pr:de$inido do produto. Gumero tde!nteiro true true 9 ComentErio: Este nmero identi$ica o conBunto de descritores associados no cadastramento do produto. Este nmero comp,e a c#ave de unicidade. #-em%lo: 1 C&di'o do 'rupo do descritor pr:de$inido. DrupoCodi'o tde!nteiro true true 9 ComentErio: Podem existir vCrios 'rupos de descritores. 5s 'rupo servem para di$erenciar os tipos de conBuntos de in$orma,es. #-em%lo: 1 0escri"o da 0escritorPre0e$inido do produto. DrupoGome tdeCaracter true $alse 1UU ComentErio: Podem existir vCrios 'rupos de descritores. 5s 'rupo servem para di$erenciar os tipos de conBuntos de in$orma,es. #-em%lo: C&di'os padroni)ados de cores

"roduto CClasse: /ados"rodutosD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VProdutos0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 +"o ocorrida no 8+C5S e 1ue 'erou a disponibilidade da in$orma"o. tdeCodi$icado +cao ComentErio: Para maiores in$orma,es vide tabela com os detal#es dos campos codi$icados. #-em%lo: aieOanutencao C&di'o interno do produto e 1ue n"o se repete Codi'oProduto+bacos tde!nteiro true true 9 ComentErio: C&di'o interno utili)ado como PrimarR;eR no cadastro do produto #-em%lo: 1U14 C&di'o ami'Cvel para o produto e 1ue n"o se repete. Codi'oProduto tdeCaracter true true 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. Go 8+C5S= este c&di'o nunca se repete. #-em%lo: ;PL:U1 C&di'o do produto onde a produto estC subordinado. tdeCaracter $alse $alse 1* ComentErio: + estrutura de associa"o de produtos em Crvore= ou seBa= podem existir produtos associados a outros produtos e n"o #C limite para o nmero de n@veis. BO>A: Se o valor desta propriedade $or branco si'ni$ica 1ue o produto n"o estC subordinado a nen#um outro. #-em%lo: *U1 Codi'o8arras C&di'o numrico 1ue representa o c&di'o de barras do produto. !denti$ica o tipo do produto. %ipoProduto ComentErio: Oaiores detal#es vide tipos codi$icados V%ipoProdutoEnumV. #-em%lo: tpreProduto GomeProduto Gome ou t@tulo do produto tdeCaracter $alse $alse 3** tdeCaracter tdeCodi$icado $alse $alse $alse $alse 13 $alse $alse

ProtocoloProduto

Codi'oProdutoPai

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
#-em%lo: Wornadas nas estrelas : 5 $ilme 0escri"o apurada do produto 0escricao tdeCaracter $alse $alse 9UUU ComentErio: Este texto descreve o produto com mais detal#es 1ue o seu t@tulo. #-em%lo: Wornadas nas estrelas : 5 $ilme VEers"o do diretorV. Codi'oOarca C&di'o da marca do produto. #-em%lo: Eideolar c&di'o do produto Bunto ao $abricante. Codi'o(abricante tdeCaracter $alse $alse 4U ComentErio: Pode ser o c&di'o interno do produto= c&di'o de barras ou 1ual1uer outro c&di'o 1ue identi$i1ue o produto Bunto ao $abricante. C&di'o da classe de produto C&di'o da $amilia de produto C&di'o do 'rupo de produto C&di'o do sub:'rupo de produto Peso do produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Comprimento do produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Lar'ura do produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Espessura ou altura do produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Auantidade de produto por embala'em Auantidade m@nima de saldo de esto1ue de$inida para o produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Auantidade mCxima de saldo de esto1ue de$inida para o produto 5ormato: 2222222222.222 41U inteiros e 3 decimais6 Gome da unidade de medida do produto Si'la ou abrevia"o da unidade de medido do produto #-em%lo: PC= ;D ou OL + unidade de medida se re$ere a 1uilosX !ndica a existFncia de produtos subordinados 4Produtos $il#os6. Pra)o estimado de entre'a do produto 4em dias uteis6. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a tde8oolean tde8oolean tde!nteiro tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse 9 3** 3** 3** 3** 3** 3** 3** 3** 3** tdeCaracter tdeCaracter $alse $alse $alse $alse 3** 3** tdeGumerico $alse $alse 13 tde!nteiro tdeGumerico $alse $alse $alse $alse 9 13 tdeGumerico $alse $alse 13 tdeGumerico $alse $alse 1* tdeGumerico $alse $alse 1* tde!nteiro tde!nteiro tde!nteiro tde!nteiro tdeGumerico $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse 9 9 9 9 13 ComentErio: 5 cadastro de classes de produtos pode ser obtido atravs do mtodo VClasses0isponiveisV. ComentErio: 5 cadastro de $amilias de produtos pode ser obtido atravs do mtodo V(amilias0isponiveisV. ComentErio: 5 cadastro de 'rupos de produtos pode ser obtido atravs do mtodo VDrupoProdutos0isponiveisV. ComentErio: 5 cadastro de sub:'rupos de produtos pode ser obtido atravs do mtodo VSubDrupoProdutos0isponiveisV. tde!nteiro $alse $alse 9

Codi'oClasse Codi'o(amilia Codi'oDrupo Codi'oSubDrupo Peso Comprimento Lar'ura Espessura AtdePorEmbala'em AtdeOinimaEsto1ue AtdeOaximaEsto1ue <nidadeOedidaGome <nidadeOedida+brev <nidadeOedidaAuilo Produto%em(il#os Pra)oEntre'a0ias CampoC$'UU1 CampoC$'UU3 CampoC$'UU3 CampoC$'UU4 CampoC$'UU* CampoC$'UUCampoC$'UU. CampoC$'UU9

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
con$i'ura,es 'enricas. CampoC$'UU2 CampoC$'U1U CampoC$'U11 CampoC$'U13 CampoC$'U13 CampoC$'U14 CampoC$'U1* CampoC$'U1CampoC$'U1. CampoC$'U19 CampoC$'U12 CampoC$'U3U CampoC$'!ntUU1 CampoC$'!ntUU3 CampoC$'!ntUU3 CampoC$'!ntUU4 CampoC$'!ntUU* CampoC$'!ntUUCampoC$'!ntUU. CampoC$'!ntUU9 CampoC$'!ntUU2 CampoC$'!ntU1U CampoC$'!ntU11 CampoC$'!ntU13 CampoC$'!ntU13 CampoC$'!ntU14 CampoC$'!ntU1* CampoC$'!ntU1CampoC$'!ntU1. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. Campo de uso 'eral associado ao produto e 1ue destinado a con$i'ura,es 'enricas. tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3**

Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
a con$i'ura,es 'enricas espec@$icas para o inte'rador. CampoC$'!ntU19 CampoC$'!ntU12 CampoC$'!ntU3U CampoC$'!ntU31 CampoC$'!ntU33 CampoC$'!ntU33 CampoC$'!ntU34 CampoC$'!ntU3* CampoC$'!ntU3CampoC$'!ntU3. CampoC$'!ntU39 CampoC$'!ntU32 CampoC$'!ntU3U Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Campo de uso 'eral associado Q inter$ace do produto e 1ue destinado tdeCaracter a con$i'ura,es 'enricas espec@$icas para o inte'rador. Lista de descritores simples associados ao produto 0escritorSimples tdeClasse ComentErio: Oaiores detal#es veBa as propriedades de V0ados0escritorSimplesV. #-em%lo: Embala'em especial Lista de descritores pr:de$inidos associados ao produto 0escritorPre0e$inido tdeClasse $alse $alse ComentErio: Oaiores detal#es veBa as propriedades de V0ados0escritorPre0e$inidoV. #-em%lo: C5/ Lista de caracter@sticas complementares associadas ao produto tdeClasse $alse CaracteristicasComplementa ComentErio: Oaiores detal#es veBa as propriedades de V0adosCaracteristicasComplementaresV. res #-em%lo: Sin&pse ProdutosSubstitutos Cate'orias0oSite Lista de produtos substitutos associados ao produto. Lista de cateorias do site associadas ao produto tdeClasse tdeClasse $alse $alse ComentErio: Oaiores detal#es veBa as propriedades de V0adosProdutosSubstitutosV. $alse ComentErio: Oaiores detal#es veBa as propriedades de V0adosCate'orias0oSiteV. $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse $alse 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3** 3**

$alse

/escritor sim%les associado ao %roduto CClasse: /ados/escritorSim%lesD


Bome Codi'o!nterno /escrio >i%o de dado Obrigat?rio C$ave >aman$o true true 9 C&di'o 'erado pelo 8+C5S utili)ado e 1ue nico independentemente tde!nteiro do produto. ComentErio: Este campo pode ser usado como c#ave de unicidade. Gmero 1ue di$erencia os descritores simples. Gumero tde!nteiro true true 9 ComentErio: Se $or deseBado utili)ar o VCodi'o!nternoV como c#ave de unicidade este campo deverC ser utili)ado tambm. Ealor ou descri"o 1ue di$erencia o descritor simples. G"o se repete no produto. tdeCaracter $alse $alse *U

0escricao

/escritor %r1;de2inido associado ao %roduto CClasse:


/ados/escritor"re/e2inidoD
9

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
Bome /escrio C&di'o 'erado no 8+C5S para a 0escritorPre0e$inido do produto. Codi'o!nterno

5
Obrigat?rio C$ave >aman$o true true 9

>i%o de dado tde!nteiro

ComentErio: Este c&di'o nico no 8+C5S e pode ser usado com c#ave de identi$ica"o. #-em%lo: 1UU Gmero do descritor pr:de$inido do produto. tde!nteiro true true 9 ComentErio: Este nmero identi$ica o conBunto de descritores associados no cadastramento do produto. Este nmero comp,e a c#ave de unicidade. #-em%lo: 1

Gumero

0escricao

0escri"o do 0escritor Pr:0e$inido do produto. #-em%lo: Gi>e C&di'o do 'rupo do descritor pr:de$inido.

tdeCaracter tde!nteiro

true true

$alse true

1UU 9

DrupoCodi'o

ComentErio: Podem existir vCrios 'rupos de descritores. 5s 'rupo servem para di$erenciar os tipos de conBuntos de in$orma,es. #-em%lo: 1 0escri"o da 0escritorPre0e$inido do produto. tdeCaracter true $alse 1UU ComentErio: Podem existir vCrios 'rupos de descritores. 5s 'rupo servem para di$erenciar os tipos de conBuntos de in$orma,es. #-em%lo: C&di'os padroni)ados de cores

DrupoGome

CaracterFstica com%lementar associada ao %roduto CClasse:


/adosCaracteristicasCom%lementaresD
Bome /escrio C&di'o 'erado no 8+C5S para a caracter@stica complementar do produto. Codi'o!nterno >i%o de dado tde!nteiro Obrigat?rio C$ave >aman$o true true 9

ComentErio: Este c&di'o nico no 8+C5S e pode ser usado como c#ave de identi$ica"o. #-em%lo: 1UU C&di'o 'erado no 8+C5S para o tipo de caracter@stica complementar do produto. tde!nteiro true true 9

%ipoCodi'o

ComentErio: Podem existir vCrios 'rupos de descritores. 5s 'rupo servem para di$erenciar os tipos de conBuntos de in$orma,es. #-em%lo: 1 0escri"o do tipo de caracter@stica complementar do produto. tdeCaracter true $alse 1UU ComentErio: Podem vCrios tipos di$erentes dentro de um mesmo 'rupo. #-em%lo: Sin&pse C&di'o 'erado no 8+C5S para o 'rupo de tipo de caracter@stica complementar do produto. tde!nteiro true true 9

%ipoGome

%ipoDrupoCodi'o

ComentErio: Podem existir vCrios 'rupos de textos para di$erenciar a caracteristicas complementares. #-em%lo: 1 0escri"o do 'rupo de tipo de caracter@stica complementar do produto. tdeCaracter true $alse 1UU ComentErio: Podem existir vCrios 'rupos de textos para di$erenciar a caracteristicas complementares. #-em%lo: 0ados para $ilmes %exto livre com todas as in$orma,es necessCrias para o produto. tdeCaracter true $alse 9UUU ComentErio: !n$orma,es complexas podem ser colocadas neste campo= inclusive= usando:se ta' 7%OL para realar o texto= mudar a $onte de caracteres= taman#o do texto= etc.. #-em%lo: Oais uma ve) a GSS #nter%rise sur'e or'ul#osamente= nesta monta'em especial do diretor= restaurada do $ilme...

%ipoDrupoGome

%exto

"roduto substituto CClasse: /ados"rodutosSubstitutosD


Bome /escrio >i%o de dado Obrigat?rio C$ave >aman$o

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
C&di'o do produto substituto. Codi'oSubstituto

5
$alse $alse 1*

tde!nteiro

ComentErio: 5 produto substituto pode ser 1ual1uer produto existente no cadastro. Ga inte'ra"o o produto disponibili)ado como substituto deve obri'atoriamente ser um produto 1ue estC ativado para a inte'ra"o= do contrCrio= ele n"o serC liberado.

Categoria do site associada ao %roduto CClasse: /adosCategorias/oSiteD


Bome /escrio C&di'o 'erado no 8+C5S para a cate'oria. Codi'oCate'oria >i%o de dado tde!nteiro Obrigat?rio C$ave >aman$o true true 9 ComentErio: Este c&di'o nico no 8+C5S e pode ser usado como c#ave de identi$ica"o. #-em%lo: *U3 C&di'o da cate'oria onde a cate'oria estC subordinada. tde!nteiro $alse $alse 9 ComentErio: + estrutura de associa"o de cate'orias em Crvore= ou seBa= podem existir cate'orias associadas a outras cate'orias e n"o #C limite para o nmero de n@veis. BO>A: Se o valor desta propriedade $or )erado si'ni$ica 1ue a cate'oria n"o estC subordinada a nen#uma outra. #-em%lo: *U1

Codi'oCate'oriaPai

Saldo de esto4ue do %roduto CClasse: /ados#sto4ueD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ado como inte'rado para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VEsto1ues0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoCate'oriaProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 C&di'o ami'Cvel para o produto e 1ue n"o se repete. Codi'oProduto tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. Go 8+C5S= este c&di'o nunca se repete. #-em%lo: ;PL:U1 Saldo m@nimo de esto1ue para o produto. tdeGumerico $alse $alse 1* ComentErio: Deralmente este valor utili)ado para indicar o saldo 1ue deve ser considerado para e$etuar a compra do produto. 5ormato: 222222222.222222 42 inteiros e - decimais6 #-em%lo: 1*.U Saldo dispon@vel de esto1ue para o produto. Saldo0isponivel 5ormato: 222222222.222222 42 inteiros e - decimais6 #-em%lo: 2222.22 tdeGumerico $alse $alse 1*

ProtocoloEsto1ue

SaldoOinimo

3esultado da busca do saldo de esto4ue do %roduto COn;0ineD CClasse:


/ados#sto4ue3esultadoD
Bome /escrio C&di'o ami'Cvel para o produto e 1ue n"o se repete. Codi'oProduto >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 1*

ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. Go 8+C5S= este c&di'o nunca se repete. #-em%lo: ;PL:U1 Saldo m@nimo de esto1ue para o produto. tdeGumerico $alse $alse 1* ComentErio: Deralmente este valor utili)ado para indicar o saldo 1ue deve ser considerado para e$etuar a compra do produto. 5ormato: 222222222.222222 42 inteiros e - decimais6 #-em%lo: 1*.U

SaldoOinimo

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
Saldo dispon@vel de esto1ue para o produto. Saldo0isponivel 5ormato: 222222222.222222 42 inteiros e - decimais6 #-em%lo: 2222.22 %ipo de li'a"o do produto Produto%ipoLi'acao tdeCodi$icado $alse $alse ComentErio: Oaiores detal#es veBa V%Produto%ipoLi'acaoEnumV em in$orma,es de tipos codi$icados. #-em%lo: tptleProdutoP+! !n$orma o resultado da busca pelo saldo do produto. /esultado tdeClasse $alse $alse ComentErio: 5 resultado serve para a avalia"o se a busca pelo produto $oi bem sucedida. Em uma lista com vCrios produtos poder"o existir al'uns 1ue estar"o 5; e outros com al'um tipo de problema. #-em%lo: 3UUUU3 : 5;

5
$alse $alse 1*

tdeGumerico

"reo do %roduto CClasse: /ados"recoD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ada como inte'rada para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VPrecos0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoCate'oriaProdutoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 C&di'o ami'Cvel para o produto e 1ue n"o se repete. Codi'oProduto tdeCaracter $alse $alse 1* ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. Go 8+C5S= este c&di'o nunca se repete. #-em%lo: ;PL:U1 Codi'oProdutoPai C&di'o do produto onde a produto estC subordinado. tdeCaracter $alse $alse 1* ComentErio: + estrutura de associa"o de produtos em Crvore= ou seBa= podem existir produtos associados a outros produtos e n"o #C limite para o nmero de n@veis. BO>A: Se o valor desta propriedade $or branco si'ni$ica 1ue o produto n"o estC subordinado a nen#um outro. #-em%lo: *U1 GomeLista Gome da lista de preos disponibili)ada ComentErio: 33.2U Preco%abela 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: Preo V0EV do produto. Preo normal. PrecoPromocional Preo VP5/V do produto. Preo promocional. 5ormato: 2222222222222.222222 413 inteiros e 3 decimais6 0ata em 1ue iniciou a promo"o 0ata!nicioPromocao 5ormato: 00OO++++ 77?OO?SS.OOO #-em%lo: U2U43UU9 UU?UU?UU.UUU 0ata de trmino da promo"o 0ata%erminoPromocao 5ormato: 00OO++++ 77?OO?SS.OOO #-em%lo: 3UU43UU9 33?*2?*2.22. tde0ata7oraStr $alse $alse 31 tde0ata7oraStr $alse $alse 31 tdeGumerico $alse $alse 1* tdeCaracter tdeGumerico $alse $alse $alse $alse *U 1*

ProtocoloPreco

3esultado da busca do %reo do %roduto COn;0ineD CClasse:


/ados"reco3esultadoD
Bome Codi'oProduto /escrio C&di'o ami'Cvel para o produto e 1ue n"o se repete. >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 1*

ComentErio: Este c&di'o 'erado pelo usuCrio no $ormato 1ue ac#ar ser o mais ami'Cvel para o seu uso. Go 8+C5S= este c&di'o nunca se repete.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
#-em%lo: ;PL:U1 C&di'o do produto onde a produto estC subordinado. tdeCaracter $alse $alse 1* ComentErio: + estrutura de associa"o de produtos em Crvore= ou seBa= podem existir produtos associados a outros produtos e n"o #C limite para o nmero de n@veis. BO>A: Se o valor desta propriedade $or branco si'ni$ica 1ue o produto n"o estC subordinado a nen#um outro. #-em%lo: *U1 GomeLista Gome da lista de preos disponibili)ada ComentErio: 33.2U Preco%abela 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: Preo V0EV do produto. Preo normal. PrecoPromocional Preo VP5/V do produto. Preo promocional. 5ormato: 2222222222222.222222 413 inteiros e 3 decimais6 0ata em 1ue iniciou a promo"o 0ata!nicioPromocao 5ormato: 00OO++++ 77?OO?SS.OOO #-em%lo: U2U43UU9 UU?UU?UU.UUU 0ata de trmino da promo"o 0ata%erminoPromocao 5ormato: 00OO++++ 77?OO?SS.OOO #-em%lo: 3UU43UU9 33?*2?*2.22. %ipo de li'a"o do produto Produto%ipoLi'acao tdeCodi$icado $alse $alse ComentErio: Oaiores detal#es veBa V%Produto%ipoLi'acaoEnumV em in$orma,es de tipos codi$icados. #-em%lo: tptleProduto(!L75 !n$orma o resultado da busca pelo preo do produto. /esultado tdeClasse $alse $alse ComentErio: 5 resultado serve para a avalia"o se a busca pelo produto $oi bem sucedida. Em uma lista com vCrios produtos poder"o existir al'uns 1ue estar"o 5; e outros com al'um tipo de problema. #-em%lo: 3UUUU3 : 5; tde0ata7oraStr $alse $alse 31 tde0ata7oraStr $alse $alse 31 tdeGumerico $alse $alse 1* tdeCaracter tdeGumerico $alse $alse $alse $alse *U 1*

Codi'oProdutoPai

Clientes CClasse: /adosClientesD


Bome /escrio Endereo eletrNnico 4e:mail6 >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 1UU ComentErio: Esta propriedade pode ser cripto'ra$ada para mel#orar a se'urana. Go 8+C5S= dever"o ser con$i'urados dois parametros? VC#aveV e VE!V= do contrCrio= n"o serC poss@vel utili)ar a cripto'ra$ia. Estes parametros s"o passados pelo inte'rador para 1ue seBam preenc#idos no 8+C5S. Por padr"o= esta propriedade n"o cripto'ra$ada. 5 nico al'oritmo de cripto'ra$ia dispon@vel o 30ES. #-em%lo: >plY>plsolucoes.com.br CP( ou CGPW da pessoa $@sica ou da empresa tdeCaracter $alse $alse 14 ComentErio: Para identi$icar se o nmero um CP( ou CGPW preciso avaliar o tipo de pessoa 4(@sica ou Wur@dica6. Esta propriedade pode ser cripto'ra$ada para mel#orar a se'urana. Go 8+C5S= dever"o ser con$i'urados dois parametros? VC#aveV e VE!V= do contrCrio= n"o serC poss@vel utili)ar a cripto'ra$ia. Estes parametros s"o passados pelo inte'rador para 1ue seBam preenc#idos no 8+C5S. Por padr"o= esta propriedade n"o cripto'ra$ada. 5 nico al'oritmo de cripto'ra$ia dispon@vel o 30ES. 5ormato: 0eve ser enviado sem V.V= V:V ou VJV e deve ter no m@nimo 11 e no mCximo 14 di'itos. #-em%lo: 1334*-.92UU Codi'o C&di'o do cliente tdeCaracter $alse $alse 1* ComentErio: Este campo contm o c&di'o com o 1ual o cliente identi$icado no sistema ori'em. 5 8+C5S irC

EOail

CP(ouCGPW

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
preenc#er automaticamente este campo com um nmero se1Pencial= caso n"o seBa in$ormado e= se no 8+C5S= n"o estiver parametri)ado 1ue a c#ave para identi$ica"o do cliente o c&di'o. #-em%lo: S!%UUUU1 %ipo de pessoa 4(@sica ou Wur@dica6 %ipoPessoa tdeCodi$icado $alse $alse ComentErio: Oaiores detal#es veBa V%ipoPessoaEnumV em in$orma,es de tipos codi$icados. #-em%lo: tpe(isica /D para pessoa $@sica. 0ocumento tdeCaracter $alse $alse ComentErio: !n$ormar o nmero sem 1ual1uer $ormata"o= ou seBa= retirar traos e pontos. #-em%lo: *9199*493 !nscricaoEstadual !nscricaoOunicipal Gome Gome/edu)ido ContatoGome Gmero da inscri"o estadual da empresa. ComentErio: 0eixar este campo em branco 1uando $or pessoa $@sica. Gmero da inscri"o municipal da empresa. ComentErio: 0eixar este campo em branco 1uando $or pessoa $@sica. Gome para pessoa $@sica ou ra)"o social para pessoa Bur@dica Gome curtoJapelido para pessoa $@sica ou nome $antasia para pessoa Bur@dica. Gome da pessoa para contato. Sexo para pessoa $@sica. Sexo tdeCaracter tdeCaracter tdeCaracter tdeCodi$icado $alse $alse $alse $alse $alse $alse $alse $alse 1UU 3U *U tdeCaracter $alse $alse tdeCaracter $alse $alse

ComentErio: Auando $or uma pessoa Bur@dica in$ormar VtseEmpresaV. Oaiores detal#es sobre o tipo vide V%ipoSexoEnumV em detal#es de tipos codi$icados. #-em%lo: tse(eminino 0ata de nascimento da pessoa $@sica. tde0ataStr $alse $alse 9 5ormato: 00OO++++ #-em%lo: 1*U312.U

0ataGascimento

Pro$issao Site %ele$one (ax Celular

Pro$iss"o Site na Meb #-em%lo: MMM.>plsolucoes.com.br %ele$one para contato (ax Celular 0ata de cadastramento 1ue deve ser re'istrada 5ormato: 00OO++++ 77?OO?SS.CCC #-em%lo: 1UU43UU9 1.?**?*-.4*Classi$ica"o do cliente

tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tde0ata7oraStr

$alse $alse $alse $alse $alse $alse

$alse $alse $alse $alse $alse $alse

*U 1UU 1* 1* 1* 31

0ataCadastro

tdeCaracter

$alse

$alse

Classi$icacao

ComentErio: + classi$ica"o do cliente pode ser previamente con$i'urada na inte'ra"o. Geste caso= todos os clientes cadastrados ter"o a mesma classi$ica"o. %ambm poss@vel cadastrar a classi$ica"o atravs do pr&prio cadastramento do cliente. Geste caso= a inte'ra"o veri$ica se a in$orma"o enviada BC uma classi$ica"o cadastrada e caso n"o encontre e$etua a inclus"o automaticamente. + $orma de identi$ica"o atravs do nome da classi$ica"o. Sub:re'i"o do cliente tdeCaracter $alse $alse ComentErio: + sub:re'i"o do cliente pode ser previamente con$i'urada na inte'ra"o. Geste caso= todos os clientes cadastrados $ar"o parte da mesma sub:re'i"o. %ambm poss@vel cadastrar a sub:re'i"o atravs do pr&prio cadastramento do cliente. Geste caso= a inte'ra"o veri$ica se a in$orma"o enviada BC uma sub:re'i"o cadastrada e caso n"o encontre e$etua a inclus"o automaticamente. + $orma de identi$ica"o atravs do nome da sub:re'i"o Drupo do cliente tdeCaracter $alse $alse ComentErio: 5 'rupo do cliente pode ser cadastrado atravs do pr&prio cadastramento do cliente. Geste caso= a inte'ra"o veri$ica se a in$orma"o enviada BC um 'rupo cadastrado e caso n"o encontre e$etua a inclus"o automaticamente. + $orma de identi$ica"o atravs do nome do 'rupo. 0ados do endereo do cliente. tdeClasse $alse $alse ComentErio: Oaiores detal#es veBa as propriedades de V0adosEnderecoV.

Sub/e'iao

DrupoCliente

Endereco

#ndereo CClasse: /ados#nderecoD


9

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
Bome /escrio Endereo recon#ecido pelos correios Lo'radouro

5
Obrigat?rio C$ave >aman$o true $alse 9U

>i%o de dado tdeCaracter

ComentErio: Caso n"o seBa poss@vel enviar a in$orma"o de nmero do lo'radouro separadamente colo1ue a in$orma"o nesta propriedade e deixe o nmero em branco. #-em%lo: +l. +ra'uaia

GumeroLo'radouro ComplementoEndereco 8airro Ounicipio Estado Cep

Gmero do endereo #-em%lo: 1323 Complemento do endereo #-em%lo: . andar 8airro #-em%lo: +lp#avile Cidade ou munic@pio #-em%lo: 8arueri Estado da $edera"o #-em%lo: SP CEP da localidade #-em%lo: U-4**UUU %ipo do local de entre'a

tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCodi$icado

$alse $alse $alse $alse $alse $alse $alse

$alse $alse $alse $alse $alse $alse $alse

3U -U -U 3 9

%ipoLocalEntre'a

ComentErio: Oaiores detal#es veBa V%%ipoLocalEntre'aEnumV em in$orma,es de tipos codi$icados. #-em%lo: tlee/esidencial

3esultado da incluso do cliente no BACOS CClasse:


/adosClientes3esultadoD
Bome /escrio Endereo eletrNnico 4e:mail6 EOail >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 1UU

ComentErio: !n$orma"o retornada para 1ue possa ser $eita uma correla"o entre as in$orma,es enviadas para inclus"o e o resultado obtido com a opera"o. #-em%lo: >plY>plsolucoes.com.br CP( ou CGPW da pessoa $@sica ou da empresa tdeCaracter $alse $alse 14 ComentErio: !n$orma"o retornada para 1ue possa ser $eita uma correla"o entre as in$orma,es enviadas para inclus"o e o resultado obtido com a opera"o. #-em%lo: 1334*-.92UU C&di'o do cliente tdeCaracter $alse $alse 1* ComentErio: !n$orma"o retornada para 1ue possa ser $eita uma correla"o entre as in$orma,es enviadas para inclus"o e o resultado obtido com a opera"o. #-em%lo: S!%UUUU1 %ipo de pessoa 4(@sica ou Wur@dica6 tdeCodi$icado $alse $alse ComentErio: !n$orma"o retornada para 1ue possa ser $eita uma correla"o entre as in$orma,es enviadas para inclus"o e o resultado obtido com a opera"o. #-em%lo: tpe(isica !n$orma o resultado da inclus"o do cliente. tdeClasse $alse $alse ComentErio: 5 resultado serve para a avalia"o se a inclus"o $oi bem sucedida. Em uma lista com vCrios clientes poder"o existir al'uns 1ue estar"o 5; e outros com al'um tipo de problema. #-em%lo: 3UUUU3 : 5;

CP(ouCGPW

Codi'o

%ipoPessoa

/esultado

3esultado da busca de %edidos e-istentes no BACOS CClasse:


/ados"edidos#-istentesD
Bome Gumero0oPedido /escrio Gmero do pedido pes1uisado. >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 1*

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
ComentErio: Oesmo se o nmero do pedido n"o existir na base de dados serC retornado. + di$erena 1ue serC in$ormado na propriedade V/esultadoV uma cr@tica por n"o ter encontrado o pedido. Existente Status+tual !ndica se o pedido pes1uisado existe na base de dados. !n$orma o status do pedido 4Eide V%StatusPedidoExistenteEnumV6. !n$orma o resultado da busca pelo pedido. /esultado tde8oolean tdeCodi$icado tdeClasse $alse $alse $alse $alse $alse $alse

ComentErio: 5 resultado serve para a avalia"o se a busca pelo pedido $oi bem sucedida. Em uma lista com vCrios pedidos poder"o existir al'uns 1ue estar"o 5; e outros com al'um tipo de problema. #-em%lo: 3UUUU3 : 5;

7n2orma@es %ara a integrao do %edido CClasse: /ados"edidosD


Bome Gumero0oPedido /escrio Gmero do pedido. #-em%lo: UU3U.U1* Endereo eletrNnico 4e:mail6 tdeCaracter $alse $alse 1UU ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES. >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse

EOail

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres.

#-em%lo: >plY>plsolucoes.com.br CP( ou CGPW da pessoa $@sica ou da empresa tdeCaracter $alse $alse 14 ComentErio: Para identi$icar se o nmero um CP( ou CGPW preciso avaliar o tipo de pessoa 4(@sica ou Wur@dica6. 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

CP(ouCGPW

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres.

5ormato: 0eve ser enviado sem V.V= V:V ou VJV e deve ter no m@nimo 11 e no mCximo 14 di'itos. #-em%lo: 1334*-.92UU C&di'o do cliente Codi'oCliente tdeCaracter $alse $alse 1* ComentErio: Este campo contm o c&di'o com o 1ual o cliente identi$icado no sistema ori'em. 5 8+C5S irC preenc#er automaticamente este campo com um nmero se1Pencial= caso n"o seBa in$ormado e= se no 8+C5S= n"o estiver parametri)ado 1ue a c#ave para identi$ica"o do cliente o c&di'o. #-em%lo: S!%UUUU1 /epresentante de venda do pedido /epresentanteEendas CondicaoPa'amento tdeCaracter $alse $alse *U ComentErio: Este representante deve ser previamente cadastrado no 8+C5S. Caso seBa passado em branco= serC preenc#ido com a con$i'ura"o espec@$ica do inte'rador. Condi"o de pa'amento para o pedido. tdeCaracter $alse $alse *U ComentErio: /e'ras para o preenc#imento da condi"o de pa'amento do pedido con$orme o tipo da $orma de pa'amento? Carto de cr1dito: G"o deve ser in$ormada a condi"o de pa'amento= ou seBa= deixar em branco. Auando #ouver parcelamento este deverC ser in$ormado diretamente no campo de parcelas do cart"o 4Eide V0adosPedidos(ormaP'toV propriedade VCartaoAtdeParcelasV6S BoletoH /e%osito ou C$e4ue: G"o obri'at&rio o preenc#imento para estas $ormas de pa'amento= mas se $or necessCrio= poderC ser in$ormada. Geste caso preciso con$i'urar no 8+C5S para aceitar esta in$orma"oS

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
/emais 2ormas de %agamento: G"o permitido in$ormar a condi"o. Geste caso= n"o deve ser preenc#ido. tdeGumerico $alse $alse 1*

Ealor total das mercadorias.

EalorPedido

ComentErio: Este valor corresponde Q soma da multiplica"o da 1uantidade pelo preo de venda de todos os itens do pedido. 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 1UU.22 Ealor $rete do pedido. tdeGumerico $alse $alse 1* 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 9.UU Ealor de encar'os ou se'uros. tdeGumerico $alse $alse 1* 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: U.UU Ealor do desconto sobre o total do pedido. tdeGumerico $alse $alse 1* ComentErio: Este desconto sobre o valor total do pedido e n"o se re$ere ao desconto individual nos itens do pedido 1ue possa ocorrer 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 1.4U Ealor total cobrado pelas embala'ens de presente. tdeGumerico $alse $alse 1* 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: *.UU

Ealor(rete

EalorEncar'os

Ealor0esconto

EalorEmbala'emPresente

0ataEenda

0ata e #ora 1ue ocorreu a venda dos produtos. 5ormato: 00OO++++ 77?OO %ransportadora 1ue deverC $a)er a entre'a do pedido e 1ue $oi utili)ada no cClculo do valor do $rete #-em%lo: C5//E!5S Servio de entre'a da transportadora 1ue $oi selecionado para o pedido #-em%lo: C5//E!5SJE:SE0EL Canal de venda onde o pedido $oi $eito.

tde0ata7oraStr

$alse

$alse

14

%ransportadora

tdeCaracter

$alse

$alse

*U

ServicoEntre'a

tdeCaracter tdeCaracter

$alse $alse

$alse $alse

*U *U

Canal

ComentErio: Geste campo deve ser passado o nome do canal cadastrado no 8+C5S. +%EGZT5? Se #ouver a necessidade de utili)ar este campo= o inte'rador= deverC utili)ar os nomes cadastrados no 8+C5S e passC:los para o Web Service para 1ue este n"o recuse a inclus"o do pedido. #-em%lo: S#optime

SubCanal 0estGome 0estSexo

Sub:divis"o do canal de venda. ComentErio: !dem ao campo VCanalV. Gome do destinatCrio Sexo do destinatCrio para pessoa $@sica.

tdeCaracter tdeCaracter tdeCaracter

$alse $alse $alse

$alse $alse $alse

*U 1UU

ComentErio: Para pessoa $@sica= in$ormar V(V $eminino ou VOV masculino. Auando $or uma pessoa Bur@dica in$ormar VEV. Oaiores detal#es sobre o tipo vide V%ipoSexoEnumV em detal#es de tipos codi$icados. Endereo eletrNnico do destinatCrio 4e:mail6 tdeCaracter $alse $alse 1UU ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

0estEmail

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres.

#-em%lo: >plY>plsolucoes.com.br

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
0est%ele$one %ele$one de contato de destinatCrio Endereo do destinatCrio recon#ecido pelos correios 0estLo'radouro

5
$alse true $alse $alse 1* 9U

tdeCaracter tdeCaracter

ComentErio: Caso n"o seBa poss@vel enviar a in$orma"o de nmero do lo'radouro separadamente colo1ue a in$orma"o nesta propriedade e deixe o nmero em branco. #-em%lo: +l. +ra'uaia

0estGumeroLo'radouro 0estComplementoEndereco 0est8airro 0estOunicipio 0estEstado 0estCep

Gmero do endereo do destinatCrio. #-em%lo: 1323 Complemento do endereo do destinatCrio. #-em%lo: . andar 8airro do destinatCrio. #-em%lo: +lp#avile Cidade ou munic@pio do destinatCrio. #-em%lo: 8arueri Estado da $edera"o do destinatCrio. #-em%lo: SP CEP da localidade do destinatCrio. #-em%lo: U-4**UUU 0estinatCrio : CP( ou CGPW da pessoa $@sica ou da empresa

tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter tdeCaracter

$alse $alse $alse $alse $alse $alse $alse

$alse $alse $alse $alse $alse $alse $alse

3U -U -U 3 9 14

0estCP(

ComentErio: Para identi$icar se o nmero um CP( ou CGPW preciso avaliar o tipo de pessoa 4(@sica ou Wur@dica6. 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres.

5ormato: 0eve ser enviado sem V.V= V:V ou VJV e deve ter no m@nimo 11 e no mCximo 14 di'itos. #-em%lo: 1334*-.92UU 0est%ipoPessoa 0estinatCrio : %ipo de pessoa 4(@sica ou Wur@dica6 tdeCodi$icado $alse $alse ComentErio: Oaiores detal#es veBa V%ipoPessoaEnumV em in$orma,es de tipos codi$icados. #-em%lo: tpe(isica 0estinatCrio : /D para pessoa $@sica. 0est0ocumento tdeCaracter $alse $alse ComentErio: !n$ormar o nmero sem 1ual1uer $ormata"o= ou seBa= retirar traos e pontos. Para pessoa Bur@dica pode ser deixado em branco. #-em%lo: *9199*493 0est!nscricaoEstadual 0est!nscricaoOunicipal 0est/e$erencia 0estinatCrio : Gmero da inscri"o estadual da empresa. ComentErio: 0eixar este campo em branco 1uando $or pessoa $@sica. 0estinatCrio : Gmero da inscri"o municipal da empresa. ComentErio: 0eixar este campo em branco 1uando $or pessoa $@sica. 0estinatCrio : Ponto de re$erFncia do endereo. #-em%lo: Pr&ximo ao Oc 0onalds da /io Ge'ro 0estinatCrio : %ipo do local de entre'a. 0est%ipoLocalEntre'a tdeCodi$icado $alse $alse ComentErio: Oaiores detal#es veBa V%%ipoLocalEntre'aEnumV em in$orma,es de tipos codi$icados. #-em%lo: tlee/esidencial EmitirGotaSimbolica Emitir uma nota simb&lica 1ue acompan#arC a mercadoria 1ue serC entre'ue no destinatCrio e uma nota de cobrana para o cliente 1ue $arC tde8oolean o pa'amento do pedido. $alse $alse tdeCaracter $alse $alse -U tdeCaracter $alse $alse tdeCaracter $alse $alse

ComentErio: <sar esta op"o nos casos onde necessCrio o enviar uma de simples remessa para o destinatCrio e outra

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
de venda para o cliente. Por exemplo= nos casos em 1ue um pedido se re$ere ao envio de um presente onde o presenteado estC em um endereo e o presenteador 4comprador6 estC em outro e= claro= obri'at&rio uma nota $iscal 1ue acompan#e a mercadoria entre'ue. Ealor do cupom de desconto utili)ado no pedido. tdeGumerico $alse $alse 1* ComentErio: Este valor serC inclu@do automaticamente no sistema 8+C5S como uma $orma de pa'amento do pedido= ou seBa= o cupom de desconto considerado uma espcie de VO5E0+V e serC utili)ado para e$etuar o pa'amento de parte do valor do pedido. Geste caso= a nota $iscal serC emitida com o valor total= pois o cupom considerado como V0!G7E!/5V e deve ter os impostos cobrados normalmente. Para um mel#or entendimento veBa este exemplo? %otal do pedido /[ 4UU=UUS EalorCupom0esconto

Ealor do cupom utili)ado /[ 1UU=UU (orma de pa'amento? Cart"o de crdito E!S+S

Este pedido terC o dbito de /[ 3UU=UU no cart"o e o saldo de /[ 1UU.UU serC pa'o com o cupom. 5 bacos irC e$etuar a baixa da $orma de pa'amento VCupom de descontoV automaticamente 1uando a inte'ra"o do pedido ocorrer. 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 33.4U GumeroCupom0esconto Gmero do cupom de desconto utili)ado no pedido. #-em%lo: 133.133.133131331.1331 +nota"o para o pedido 416. tdeCaracter $alse $alse 9UUU ComentErio: %exto livre 1ue pode ser usado para anota,es 'erais. +s anota,es do pedido no 8+C5S tFm uma classi$ica"o previamente cadastrada. +ntes de se comear a utili)ar a anota"o no pedido necessCrio con$i'urar previamente esta classi$ica"o. +p&s a con$i'ura"o toda a anota"o enviada serC inclu@da no pedido com a classi$ica"o de$inida. #-em%lo: Entre'ar no per@odo comercial +nota"o para o pedido 436. tdeCaracter $alse $alse 9UUU ComentErio: %exto livre 1ue pode ser usado para anota,es 'erais. +s anota,es do pedido no 8+C5S tFm uma classi$ica"o previamente cadastrada. +ntes de se comear a utili)ar a anota"o no pedido necessCrio con$i'urar previamente esta classi$ica"o. +p&s a con$i'ura"o toda a anota"o enviada serC inclu@da no pedido com a classi$ica"o de$inida. #-em%lo: Oensa'ens para o presente +nota"o para o pedido 436. tdeCaracter $alse $alse 9UUU ComentErio: %exto livre 1ue pode ser usado para anota,es 'erais. +s anota,es do pedido no 8+C5S tFm uma classi$ica"o previamente cadastrada. +ntes de se comear a utili)ar a anota"o no pedido necessCrio con$i'urar previamente esta classi$ica"o. +p&s a con$i'ura"o toda a anota"o enviada serC inclu@da no pedido com a classi$ica"o de$inida. #-em%lo: Personali)a"o do produto PedidoWaPa'o 0ata0oPa'amento (ormas0ePa'amento !tens !ndica se o pedido BC $oi pa'oX 0ata e #ora 1ue ocorreu o pa'amento do pedido. 5ormato: 00OO++++ 77?OO Lista de $orma de pa'amento utili)ada no pedido. Lista com os produtos do pedido. tdeClasse tdeClasse $alse $alse $alse $alse ComentErio: Oaiores detal#es veBa as propriedades de V0adosPedidos(ormaP'toV. ComentErio: Oaiores detal#es veBa as propriedades de V0adosPedidos!temV. tde8oolean tde0ataStr $alse $alse $alse $alse 14 tdeCaracter $alse $alse 4U

+notacao1

+notacao3

+notacao3

5orma de %agamento do %edido CClasse: /ados"edidos5orma"gtoD


Bome /escrio (orma de pa'amento do pedido (ormaPa'amentoCodi'o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse *U ComentErio: 5 c&di'o passado na $orma de pa'amento pode ser 1ual1uer $ormato deseBado. 8asta con$i'urar previamente no 8+C5S o V0EJP+/+V para 1ue os pedidos possam ser inclu@dos normalmente. #-em%lo: UU1 Ealor Ealor total do cobrado pelo pedido. tdeGumerico $alse $alse 1*

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
5ormato: 2222222222222.22 413 inteiros e 3 decimais6 Gmero do cart"o de crdito tdeCaracter $alse $alse 4U ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

CartaoGumero

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres. tdeCaracter $alse $alse 4U

Gmero do c&di'o de se'urana do cart"o de crdito.

CartaoCodi'oSe'uranca

ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres. tdeOes+noStr $alse $alse 4U

OFs e ano da validade do cart"o de crdito.

CartaoEalidade

ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres. tdeCaracter $alse $alse *U

Gome impresso no cart"o de crdito.

CartaoGome!mpresso

ComentErio: 7M"O3>AB>#: Esta propriedade pode ser criptografada para melhorar a segurana. Para isso, no BACOS, necessrio ha ilitar o uso da criptografia. Ser necessrio configurar dois parametros! "Cha#e" e o "$etor de iniciali%a&o '$()". Estes dois parametros de#em ser fornecidos pelo integrador e estruturados da forma *ue achar melhor. Predefini+es da criptografia! Algoritmo de criptografia ,-ES.

CartaoAtdeParcelas CartaoCodi'o+utori)acao

Parametros com tamanho m/imo de! "Cha#e" 01 caracteres e "$etor de iniciali%a&o '$()" 2 caracteres. tde!nteiro tdeCaracter $alse $alse $alse $alse *U 3U

Auantidade de parcelas de$inidas para o pedido. C&di'o de autori)a"o da transa"o com a administradora.

ComentErio: Como este nmero s& existe 1uando ocorre a transa"o com a administradora ele pode ser deixado em branco se n"o estiver dispon@vel. 0ata do vencimento do boleto. tde0ataStr $alse $alse 9 ComentErio: Se este campo n"o $or preenc#ido serC calculado automaticamente con$orme a parametri)a"o existente no 8+C5S. 5ormato: 00OO++++ #-em%lo: 1UU43UU9 41U de abril de 3UU96 Gmero bancCrio 'erado para o boleto tdeCaracter $alse $alse 3U ComentErio: Se este campo n"o $or preenc#ido serC calculado automaticamente com base no nmero do pedido. #-em%lo: UUUUUUUUUUUU1991

8oletoEencimento

8oletoGumero8ancario

7tem do %edido CClasse: /ados"edidos7temD


Bome Codi'oProduto Preco<nitario /escrio C&di'o do produto Preo unitCrio li1uido >i%o de dado tdeCaracter tdeGumerico Obrigat?rio C$ave >aman$o $alse $alse $alse $alse 1* 1*

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5
ComentErio: 5 preo unitCrio l@1uido se re$ere ao preo BC dedu)ido o desconto concedido para o item do pedido. 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 33.2U Auantidade de itens do produto AuantidadeProduto 5ormato: 222222222.222222 42 inteiros e - decimais6 #-em%lo: 1 Embala'emPresente Oensa'emPresente 5 pedido $oi marcado para ser embalado para presenteX #-em%lo: true + mensa'em di'itada pelo cliente para 1ue seBa colocada no cart"o 1ue tdeCaracter acompan#a a embala'em para presente. Preo unitCrio bruto tdeGumerico $alse $alse $alse $alse 1* tde8oolean $alse $alse tdeGumerico $alse $alse 1*

Preco<nitario8ruto

ComentErio: 5 preo unitCrio bruto se re$ere ao preo sem desconto= ou seBa= seria o preo V0EV apresentado para o cliente. 5ormato: 2222222222222.22 413 inteiros e 3 decimais6 #-em%lo: 3*.UU

3esultado da integrao do %edido CClasse: /ados"edidos3esultadoD


Bome Gumero0oPedido /escrio Gmero do pedido enviado para inte'ra"o. #-em%lo: UU3U.U1* !n$orma o resultado da inclus"o do pedido. /esultado tdeClasse $alse $alse ComentErio: 5 resultado serve para a avalia"o se a inclus"o $oi bem sucedida. Em uma lista com vCrios pedidos poder"o existir al'uns 1ue estar"o 5; e outros com al'um tipo de problema. #-em%lo: 3UUUU3 : 5; !n$orma os detal#es do resultado inclus"o da $orma de pa'amento do pedido. (ormas0ePa'amento/esult ado tdeClasse $alse $alse >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse

ComentErio: +s in$orma,es disponibili)adas e 1ue devem ser analisadas= s"o as se'uintes? 5orma"agamento: (orma de pa'amento passada para inclus"o no pedidoS

3esultado: /esultado da opera"o de inclus"o da $orma de pa'amento. Gesta propriedade podem ser obtidas in$orma,es a respeito do c&di'o de erro e mensa'ens 1ue $oram 'eradas no processo. tdeClasse $alse $alse

!n$orma os detal#es do resultado inclus"o do item do pedido.

!tens/esultado

ComentErio: +s in$orma,es disponibili)adas e 1ue devem ser analisadas= s"o as se'uintes? Codigo"roduto: C&di'o do produto passado para inclus"o no pedidoS

3esultado: /esultado da opera"o de inclus"o do item. Gesta propriedade podem ser obtidas in$orma,es a respeito do c&di'o de erro e mensa'ens 1ue $oram 'eradas no processo.

Status do %edido CClasse: /adosStatus"edidoD


Bome /escrio !denti$icador para e$etuar a baixa na inte'ra"o >i%o de dado tdeCaracter Obrigat?rio C$ave >aman$o $alse $alse 3** ComentErio: 5 identi$icador aponta para a in$orma"o 1ue estC sendo inte'rada e 1ue deverC ser sinali)ada como inte'rada para 1ue n"o continue aparecendo na lista de disponibilidade para inte'ra"o. + lista de in$orma,es dispon@veis para inte'ra"o obtida atravs do mtodo VStatusPedido0isponiveisV e cada item deve ser sinali)ado usando o mtodo VCon$irmar/ecebimentoStatusPedidoV. #-em%lo: (42203U8:1U-9:4E-.:8-9+:0EU4983.UE80 GumeroPedido Codi'oStatus Gmero do pedido. #-em%lo: UU3U.U1* C&di'o do status do pedido. tdeCaracter $alse $alse 1* ComentErio: Este c&di'o parametri)ado para ser enviado com a codi$ica"o 1ue $or mais ade1uada para o inte'rador. tdeCaracter $alse $alse 1*

ProtocoloStatusPedido

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
\ necessCrio criar uma lista V0EJP+/+V no 8+C5S. #-em%lo: +3. 0escri"o do status do pedido StatusPedido ComentErio: 0escritivo con$i'urado para o status. #-em%lo: Pa'amento con$irmado 0ata e #ora da atuali)a"o do status do pedido. 0ata7ora 5ormato: 00OO++++ 77?OO?SS.CCC #-em%lo: 11U43UU9 1.?3U?**.4*9 SerieGota GumeroGota 0ataEmissaoGota Srie da nota $iscal. ComentErio: Esta in$orma"o s& existirC ap&s o $aturamento do pedido. Gmero da nota $iscal. ComentErio: Esta in$orma"o s& existirC ap&s o $aturamento do pedido. 0ata e #ora da emiss"o da nota $iscal. ComentErio: Esta in$orma"o s& existirC ap&s o $aturamento do pedido. 5ormato: 00OO++++ 77?OO?SS.CCC #-em%lo: 11U43UU9 1.?3U?**.4*9 Gumero5bBeto AuantidadeEolumes Gmero do obBeto da transportadora do pedido. ComentErio: Esta in$orma"o s& existirC ap&s o $aturamento do pedido. Auantidade de volumes da nota. tde!nteiro $alse $alse tdeCaracter $alse $alse 3U tde0ata7oraStr $alse $alse 31 tde!nteiro $alse $alse 9 tdeCaracter $alse $alse 3 tde0ata7oraStr $alse $alse 31 tdeCaracter $alse $alse 1UU

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

/escrio dos valores %ertinentes aos ti%os de dados codi2icados


C?digo ComentErio

>i%os de resultados em o%era@es com o Web Service C#numerador:


>i%o/e3esultado#numD
tdre!nde$inido tdreSucesso Este o valor padr"o e s& serC visuali)ado no caso em 1ue uma situa"o n"o ten#a sido tratada. Sucesso na opera"o executada.

tdreSucessoSem0ad Sucesso na opera"o executada porm n"o $oram retornadas in$orma,es. os tdre+lerta tdreErro+plicacao tdreErro0ata8ase= tdreErro0ados tdreErroDeral tdreOensa'em <ma mensa'em de alerta 1ue 'eralmente serve para indicar 1ue se deve ter uma aten"o aos resultados da opera"o executada. Erros ocorridos com o WebService e 1ue n"o est"o relacionados ao banco de dados. Erros ocorridos durante a intera"o com o banco de dados. !nconsistFncias com os dados in$ormados ou erros na estrutura da in$orma"o. Erros 'enricos durante a execu"o da opera"o. <ma mensa'em n"o relacionada a um erro. Serve para enviar mensa'ens padroni)adas.

>i%o de ao na integrao dos dados dis%onibili:ados %elo WebService C#numerador: >Acao7ntegracao#numD


aie!nde$inido aieOanutencao aieExclusao Este o valor padr"o e s& serC visuali)ado no caso em 1ue uma situa"o n"o ten#a sido tratada. (oi reali)ada uma opera"o 1ue resultou na inclus"o ou na altera"o da in$orma"o associada Q inte'ra"o. (oi reali)ada uma opera"o 1ue resultou no cancelamento= desativa"o ou exclus"o da in$orma"o associada Q inte'ra"o.

Classi2icao do obIeto documentado C#numerador: >i%oObIeto#numD


toeClasse toeOetodo toePropriedade Classe de dados. Otodo usado para a inte'ra"o. Campo 1ue contm al'um tipo de in$orma"o.

>i%o de in2ormao arma:enada %ela %ro%riedade C#numerador:


>i%o/ado#numD
tdeClasse tdeCaracter tde!nteiro tdeGumerico tde0ata7oraStr tde0ataStr tdeCodi$icado tde8oolean tdeOes+noStr Classe de dados. Caracteres al$anumricos. Gmeros inteiros. Gmeros com casas decimais. 0ata e #ora em um $ormato strin'. 5 $ormato utili)ado na inte'ra"o com o 8+C5S V00OO++++ 77?OO?SS.CCCV. 0ata em um $ormato strin'. 5 $ormato utili)ado na inte'ra"o com o 8+C5S V00OO++++V. Ealores previamente de$inidos para o campo. Estes valores s"o provenientes de um tipo enumerado e identi$icados por um nome 1ue se assemel#a a um c&di'o nico. S"o aceitos apenas dois valores. >rue: Eerdadeiro ou 5alse: (also. OFs e ano no $ormato strin'. 5 $ormato utili)ado no 8+C5S VOO++++V.

>i%o de %essoa C#numerador: >i%o"essoa#numD


tpe!nde$inido tpe(isica tpeWuridica Auando o tipo da pessoa n"o in$ormada. Pessoa (@sica. Pessoa Wur@dica.

Se-o C#numerador: >i%oSe-o#numD


9

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
tse!nde$inido tse(eminino tseOasculino tseEmpresa Auando o sexo n"o in$ormado. (eminino. Oasculino. Para 1uando a pessoa $or do tipo Bur@dica.

>i%o de %roduto C#numerador: >i%o"roduto#numD


tpre!nde$inido tpreProduto tpreServico Este o valor padr"o e s& serC visuali)ado no caso em 1ue uma situa"o n"o ten#a sido tratada. Produtos. Servios.

>i%o de ligao do %roduto C#numerador: >"roduto>i%o0igacao#numD


tptle!nde$inido Este o valor padr"o e s& serC visuali)ado no caso em 1ue uma situa"o n"o ten#a sido tratada. Produto VP+!V= ou seBa= existem produtos no cadastro 1ue est"o li'ados ao produto em 1uest"o. Exemplo? "roduto "A7: OC1uina de lavar tptleProdutoP+!

"roduto 570JO: OC1uina de lavar : 11UE

tptleProduto(!L75

Produto V(!L75V= ou seBa= o produto em 1uest"o estC relacionado a outro 1ue identi$ica um 'rupo de in$orma,es. Exemplo? "roduto 570JO: OC1uina de lavar : 11UE

tptleProduto;it

"roduto "A7: OC1uina de lavar

Produto ;!%= ou seBa= um produto 1ue composto por uma lista de outros produtos.

tptleProdutoSimples Produto simples= ou seBa= um produto sem 1ual1uer li'a"o com outros.

>i%o do local de entrega do endereo C#numerador: >>i%o0ocal#ntrega#numD


tlee0escon#ecido tlee/esidencial tleeComercial Local descon#ecido. Local residencial. Local comercial.

Status atual do %edido e-istente C#numerador: >Status"edido#-istente#numD


tspeeGaoEncontrado !n$orma"o n"o dispon@vel por1ue o pedido n"o existe tspeeEm+ndamento Pedido estC em andamento no sistema tspee(aturado tspee0espac#ado tspeeEntre'ue tspeeCancelado Pedido $oi $aturado Pedido $oi sinali)ado como despac#ado Pedido $oi sinali)ado como entre'ue Pedido $oi cancelado

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

7n2orma@es %ertinentes ao resultado da o%erao reali:ada C/ados3esultadoO%eracaoD


Bome /escrio Gmero 1ue representa o c&di'o da tabela de mensa'ens. Codi'o >i%o de dado tde!nteiro ComentErio: + codi$ica"o das mensa'ens permite 1ue o desenvolvedor possa criar tratamentos ade1uados para os tipos de erros 1ue ocorrem na inte'ra"o ou para as mensa'ens e alertas existentes. #-em%lo: 1UUUU1 0escri"o ou mensa'em 'erada para o c&di'o da tabela de mensa'ens. 0escricao ComentErio: + mensa'em 'erada pode ser divul'ada para posterior avalia"o. #-em%lo: Problemas com os dados do cart"o de crdito. %ipo de resultado associado ao c&di'o da tabela de mensa'ens. %ipo tdeCodi$icado ComentErio: 5s tipos de mensa'ens servem para cate'ori)ar erros e alertas. Esta cate'ori)a"o pode ser usada pelo desenvolvedor para criar tratamentos espec@$icos para cada situa"o. Oaiores detal#es sobre os tipos poss@veis de resultados podem ser obtidos na tabela de tipos codi$icados. 4Eide I%ipo0e/esultadoEnumK6 #-em%lo: tdreSucesso + mensa'em associada Q exce"o 1ue 'erou o erro. ExceptionOessa'e tdeClasse ComentErio: Esta propriedade pode aBudar ao suporte tcnico na identi$ica"o da causa do erro ocorrido. #-em%lo: %+bacosWSException Gome da classe de exception 1ue 'erou o erro ExceptionClassGame tdeCaracter ComentErio: Esta propriedade pode aBudar ao suporte tcnico na identi$ica"o da causa do erro ocorrido. #-em%lo: SALException ExceptionStac>%race Pil#a de execu"o at o momento em 1ue ocorreu o erro. tdeCaracter ComentErio: Esta propriedade pode aBudar ao suporte tcnico na identi$ica"o da causa do erro ocorrido. tdeCaracter

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

>abela de c?digos de resultados de o%era@es reali:adas


C?digo >i%o 1UUUU1 tdre+lerta 3UUUU1 tdreSucesso "arKmetros: ]U^ 0escri"o da opera"o 1ue $oi reali)ada. Exemplo? Lista de produtos dispon@veis para inte'ra"o. 3UUUU3 tdreSucesso 5;. tdreSucessoSem0a 3UUUU3 5;= porm n"o #C dados. dos C&di'o do erro n"o encontrado. Codi'o nr.? ]U^. 3UUUU1 tdreErro+plicacao "arKmetros: ]U^ Gmero do c&di'o de erro 1ue n"o se encontra na lista. Erro na obten"o dos dados para a inte'ra"o. 5ri'em V]U^V. 3UUUU3 tdreErro0ata8ase "arKmetros: ]U^ 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de marcas dispon@veis para inte'ra"o. Erro na disponibili)a"o das in$orma,es. 5ri'em V]U^V. 3UUUU3 tdreErro0ata8ase "arKmetros: ]U^ 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de preos dispon@veis para inte'ra"o. + opera"o executada n"o vClida. Oensa'em? ]U^. 3UUUU4 tdreErro+plicacao "arKmetros: ]U^ 0escreve a opera"o 1ue $oi executada. Exemplo? 8uscar os produtos dispon@veis para inte'ra"o. + execu"o da rotina 'erou uma cr@tica. 0etal#es? _ 5ri'em? ]U^ _ Lin#a em 1ue ocorreu o erro? ]1^ _ Gome do obBeto onde ocorreu o erro? ]3^ _ C&di'o de erro do banco de dados? ]3^ "arKmetros: L M 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de marcas dispon@veis para inte'ra"oS 3UUUU* tdreErro0ata8ase Mensagem a%resentada 5correram erros durante a obten"o das in$orma,es pertinentes a lista de itens. Eeri$i1ue o retorno em cada item para maiores detal#es. 5pera"o V]U^V e$etuada com sucesso.

L(M Lin#a no obBeto do banco de dados 1ue 'erou o erro. Serve como re$erFncia para locali)a"o do problemasS L'M 5bBeto do banco de dados 4procedure= $unction= vieM= etc6 1ue 'erou o erroS L,M C&di'o do erro 'erado pelo banco de dados.

+ execu"o da rotina 'erou uma cr@tica. 5ri'em V]U^V. 3UUUU- tdreErro0ata8ase "arKmetros: ]U^ 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de preos dispon@veis para inte'ra"o. Problemas de conex"o com o banco de dados? Connection strin'? V]U^V. 3UUUU. tdreErro0ata8ase "arKmetros: ]U^ Strin' de conex"o com o banco de dados utili)ada 1uando ocorreu o erro. G"o $oi poss@vel retornar as in$orma,es do item solicitado. 5ri'em? V]U^V : !tem? ]1^ ` V]3^V "arKmetros: L M 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de marcas dispon@veis para inte'ra"oS

3UUUU9 tdreErroDeral

L(M 0escri"o do valor 1ue estC sendo re$erenciado pelo itemS L'M Ealor do item utili)ado para a pes1uisa.

3UUUU2 tdreErro0ados 3UUU1U tdreErro0ados 3UUU11 tdreErro0ados 3UUU13 tdreErro0ados

Gmero do cart"o de crdito invClido. C&di'o de se'urana do cart"o de crdito invClido. OFsJ+no de validade do cart"o de crdito invClido. + lista com os dados para processamento n"o $oi in$ormada. Lista para processamento? V]U^V "arKmetros: ]U^ 0escreve 1ual 'rupo de in$orma,es a lista representa. Exemplo? Pedidos para processamento= produtos para veri$ica"o do esto1ue= etc.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
3UUU13 tdreErro0ados 3UUU14 tdreErro0ata8ase %ipo de sexo in$ormado n"o compat@vel com o tipo da pessoa. Problemas com a conex"o ao banco de dados. G"o $oi poss@vel identi$icar 1ual o servidor de banco de dados onde deve ser $eita a conex"o. Poss@vel problema de parametri)a"o na strin' de conex"o. + c#ave para identi$ica"o da inter$ace de inte'ra"o n"o vClida. Processo ori'em V]U^V : C#ave enviada V]1^V. "arKmetros: L M 0escreve a ori'em dos dados onde ocorreu o erro. Exemplo? Lista de marcas dispon@veis para inte'ra"oS

3UUU1* tdreErro0ados

3UUU1- tdreErro0ados 3UUU1. tdreErro0ados 3UUU19 tdreErro0ata8ase

L(M C#ave de identi$ica"o da inter$ace. Esta c#ave passada para o inte'rador e obri'at&ria no envio das in$orma,es para o 8+C5S.

%ipo de pessoa n"o $oi in$ormado. Sexo da pessoa $@sica deve ser masculino ou $eminino. Propriedade de dados V]U^V n"o $oi in$ormada. "arKmetros: ]U^ Gome da propriedade 1ue n"o $oi preenc#ida. Problemas ao descripto'ra$ar in$orma,es do pedido nr. V]U^V re$erente a V]1^V. "arKmetros: L M !n$orma o nmero do pedido 1ue apresentou o problemaS

3UUU12 tdreErro0ados

L(M /e$ere:se Q propriedade 1ue apresentou o problema com a descripto'ra$ia.

Problemas ao descripto'ra$ar in$orma,es do cliente nome V]U^V re$erente a V]1^V. "arKmetros: L M !n$orma o nome do cliente 1ue apresentou o problemaS

3UUU3U tdreErro0ados

L(M /e$ere:se Q propriedade 1ue apresentou o problema com a descripto'ra$ia.

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

Jist?rico de atuali:a@es dos Web Services BACOS


/ata Verso Web Service Verso BACOS Web Service a2etado ComentErio Govos parametros para capta"o dos dados do destinatCrio na classe V0adosPedidosV? /est>i%o"essoa: %ipo de pessoa 4Eide V%ipoPessoaEnumV6S

/estC"5: 0eve ser utili)ado para in$ormar tanto o CP( como o CGPWS /est7nscricao#stadual: !nscri"o estadualS /est7nscricaoMunici%al: !nscri"o municipalS /est/ocumento: 0ocumento 4/D para pessoa $@sica6.

Wun#oJ3UU9

3.UU.UU1U

4.U8.U1*4

+bacosWSPedidos.asmx

Wun#oJ3UU9 3.JU9J3UU9 3.JU9J3UU9 3.JU9J3UU9 3.JU9J3UU9 U3JU2J3UU9 U*JU2J3UU9 13JU2J3UU9 13J11J3UU9 13J11J3UU9 13J11J3UU9 3-J11J3UU9 3-J11J3UU9 3-J11J3UU9

3.UU.UU1U 4.U8.U1-U 4.U8.U1-U 4.U8.U1-U 4.U8.U1-U 4.U8.U1-1 4.U8.U1-3 4.U8.U1-3 *.U8.UUU4 *.U8.UUU4 *.U8.UUU4 *.U8.UUU* *.U8.UUU* *.U8.UUU*

4.U8.U1*4 4.U8.U1-U 4.U8.U1-U 4.U8.U1-U 4.U8.U1-U 4.U8.U1-1 4.U8.U1-3 4.U8.U1-3 *.U8.UUU4 *.U8.UUU4 *.U8.UUU4 *.U8.UUU* *.U8.UUU* *.U8.UUU*

+bacosWSClientes.asmx %odos os Web Services +bacosWSClientes.asmx

Govo parametro V!nscricaoOunicipalV na classe V0adosClientesV : !nscri"o municipal do cliente. Oudana no $ormato do c&di'o de vers"o. Govo parametro VSub/e'iaoV na classe V0adosClientesV : Sub:re'i"o do cliente.

Govo parametro VProduto%ipoLi'acaoV nas classes +bacosWSProdutos.asmx V0adosEsto1ue/esultadoV e V0adosPreco/esultadoV : %ipo de li'a"o do produto 4Eide V%Produto%ipoLi'acaoEnumV6. +bacosWSPedidos.asmx +bacosWSPedidos.asmx +bacosWSPedidos.asmx +bacosWSProdutos.asmx +bacosWSClientes.asmx +bacosWSPedidos.asmx %odos os Web Services %odos os Web Services +bacosWSPedidos.asmx Oudana no nmero do obBeto retornado pelo mtodo IStatus0isponiveisK. +'ora o pre$ixo do servio de entre'a aparece antes do nmero do obBeto. Govo parametro VPreco<nitario8rutoV na classe V0adosPedidos!temV : Preo unitCrio bruto. Govo parHmetro VDrupoClienteV na classe V0adosClientesV a Drupo do cliente. Govos parHmetros VCodi'oExternoDrupoV e VCodi'oDrupoV na classe V0adosSubDruposProdutosV a Sub:Drupo de produto. Govo parHmetro V%ipoLocalEntre'aV na classe V0adosEnderecoV. Este parHmetro identi$ica se o local de entre'a residencial ou comercial. Govos parHmetros VEmitirGotaSimbolicaV= V0est%ipoLocalEntre'aV e V0est/e$erenciaV na classe V0adosPedidosV. Govos c&di'os de erros 3UUU19= 3UUU12 e 3UUU3U. !nclus"o no manual de in$orma,es relativas ao $luxo de execu"o dos mtodos e novas in$orma,es destinadas ao uso da Crea do desenvolvedor. Govos parHmetros VEalorCupom0escontoV e VGumeroCupom0escontoV na classe V0adosPedidosV.

+bacosWSPedidos.asmx Criado o mecanismo de cripto'ra$ia de dados. Esta vers"o cripto'ra$a apenas al'umas propriedades. Propriedades cripto'ra$adas? #mailN

C"5ouCB"ON /est#mailN /estC"5N CartaoBumeroN CartaoCodigoSegurancaN

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B.
CartaoValidadeN CartaoBome7m%ressoN

Manual dos WebServices de integrao com o BACOS


Verso do Web Service: 5. B. 5

Criado o mecanismo de cripto'ra$ia de dados. Esta vers"o cripto'ra$a apenas al'umas propriedades. 3-J11J3UU9 *.U8.UUU* *.U8.UUU* +bacosWSClientes.asmx Propriedades cripto'ra$adas? #mailN

C"5ouCB"ON

You might also like