Manual Laserchip

Verso 2.1 Quarta-Feira, 05 de Outubro de 2016.
Documento de Integrao da Plataforma
Laserchip x Arte Digital (E-Commerce)
Verso do documento v2.1
Histrico do Documento
Data Verso Descrio Autor

24/07/2014 1.0 Elaborao do documento. Rodrigo Guimares
26/06/2015 1.1 Adio do campo sDscDocFiscal na funo Rodrigo Guimares
ProductAddUpdate.
31/07/2015 1.2 Remoo da funo SetClientImported. Rodrigo Guimares
Incluso da propriedade NuLocalInventory
na funo ProductAddUpdate.
22/09/2016 2.0 Alterao, traduo e remoo de tags das Rodrigo Cordeiro
funes: ProductAddUpdate,
GetNewOrders, GetOrder, GetClient,
GetOrderItems e SetOrderImported.
Descrio do processo de carga inicial de
produtos.
05/10/2016 2.1 Correo nas tags de telefone da funo Rodrigo Cordeiro
GetClient.
Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

(21) 3553-2625
www.laserchip.com.br 1
ndice
Introduo ................................................................................................ 3
Funo ProductAddUpdate .......................................................................... 4
Funo GetNewOrders ................................................................................ 5
Funo GetOrder ....................................................................................... 6
Funo GetClient ....................................................................................... 7
Funo GetOrderItems ............................................................................... 8
Funo SetOrderImported .......................................................................... 9
Carga Inicial de Produtos ............................................................................ 10

(21) 3553-2625
Introduo
Este documento tem o objetivo de documentar a parte tcnica do

processo de integrao e-commerce entre Laserchip e Arte Digital (E-
Commerce). Para o funcionamento da integrao e-commerce
necessrio a criao de dois WebServices na plataforma e-commerce que
sero responsveis por receber as informaes de produtos e devolver os
pedidos com seus respectivos produtos e clientes associados. Os dois
WebServices so listados abaixo com suas respectivas funes:
1. Catalog (WebService)
a. ProductAddUpdate (Funo)
2. Order (WebService)
a. GetNewOrders (Funo)
b. GetOrder (Funo)
c. GetClient (Funo)
d. GetOrderItems (Funo)
e. SetOrderImported (Funo)

(21) 3553-2625
Funes
1. a. ProductAddUpdate
Funo responsvel por receber os dados de produtos enviados pelo integrador e-commerce
Laserchip realizando incluses ou atualizaes dos dados dos produtos.
Parmetros:
Nome do Tipo Descrio Obrigatoriedade

Parmetro
strData String String XML com os dados. SIM
strUser String Nome do usurio para acesso ao servio. SIM
strPwd String Senha do usurio para acesso ao servio. SIM
Exemplo strData:
<?xml version="1.0" encoding="utf-16" ?>

<Product xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<sDescricaoFiscal>TENIS ASICS GEL KINSEI 3</sDescricaoFiscal>
<sDescricaoCor>AZUL</sDescricaoCor>
<sDescricaoTamanho>42</sDescricaoTamanho>
<sReferenciaBasica>00001</sReferenciaBasica>
<sDescricaoBasica>TENIS ASICS GEL KINSEI 3</sDescricaoBasica>
<sReferenciaCompleta>0000100206</sReferenciaCompleta>
<sDescricaoCompleta>TENIS ASICS GEL KINSEI 3 AZUL 42</sDescricaoCompleta>
<sFlgSituacao>1</sFlgSituacao>
<iCodigoFornecedor>1</iCodigoFornecedor>
<iPeso>1000</iPeso>
<iAltura>360</iAltura>
<iLargura>410</iLargura>
<iComprimento>100</iComprimento>
<iPrecoVenda>25000</iPrecoVenda>
<iQtdeEstoque>10</iQtdeEstoque>
<sObservacao>Com design repaginado, o Tnis Asics Gel Kinsei 3 oferece mais flexibilidade e
ventilao para seus ps. Alm disso, traz o consagrado amortecimento GEL que garante uma
eficiente absoro de impactos.</sObservacao>
<sElemento1>MASCULINO</sElemento1>
<sElemento2>SINTTICO</sElemento2>
<sElemento3>CALADO</sElemento3>
<sSubElemento3>CASUAL</sSubElemento3>
<sElemento4>VERO</sElemento4>
<sElemento5>2016</sElemento5>
<sElemento6>TNIS</sElemento6>
<sSubElemento6>ASICS GEL KINSEI 3</ sSubElemento6>
</Product>
Descrio dos Elementos:
Nome Parmetro Tipo Tamanho Descrio

sDescricaoFiscal string 40 Descrio fiscal do produto.
sDescricaoCor string 50 Descrio da cor.
sDescricaoTamanho string 50 Descrio do tamanho.
sReferenciaBasica string 10 Referncia bsica do produto. (Produto configurvel)
sDescricaoBasica string 100 Descrio bsica do produto.
sReferenciaCompleta string 20 Referncia completa do produto. (Produto simples)
sDescricaoCompleta string 255 Descrio completa do produto com cor e tamanho.
sFlgSituacao int - Indica se o produto est ativo no sistema da Laserchip.
(1 Ativo / 0 Inativo)
iCodigoFornecedor int - Cdigo de identificao do fornecedor do produto no sistema
da Laserchip.
iPeso int - Peso do produto, com unidade de medida em quilos com 3
casas decimais. (Sem formatao, apenas nmeros. Por
exemplo: 2,5 Kg equivalem a 2500)
iAltura int - Altura do produto, com unidade de medida em centmetros
com 3 casas decimais. (Sem formatao, apenas nmeros.
Por exemplo: 20,5 cm equivalem a 20500)
iLargura int - Largura do produto, com unidade de medida em centmetros
com 3 casas decimais. (Sem formatao, apenas nmeros.
Por exemplo: 11,52 cm equivalem a 11520)
(21) 3553-2625
iComprimento int - Comprimento do produto, com unidade de medida em
centmetros com 3 casas decimais. (Sem formatao,
apenas nmeros. Por exemplo: 53,65 cm equivalem a
53650)
iPrecoVenda int - Preo de venda do produto com 2 casas decimais. (Sem
formatao, apenas nmeros. Por exemplo: R$ 249,99
equivalem a 24999)
iQtdeEstoque int - Quantidade em estoque.
sObservacao string 8000 Descrio detalhada do produto.
sElemento1 string 50 Descrio do elemento 1.
sSubElemento3 string 100 Descrio do subelemento 3.
sSubElemento6 string 100 Descrio do subelemento 6.
Exemplo Retorno:
<?xml version="1.0" encoding="utf-16"?>
<Return xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<idRet>1</idRet>
<idErr></idErr>
<dsErr></dsErr>
</Return>

idRet int - Cdigo do retorno da operao. (1 Sucesso, 0 Falha)
idErr int - Cdigo do erro da operao, caso ocorra uma falha.
dsErr string 1000 Descrio do erro da operao, caso ocorra uma falha.
2. a. GetNewOrders
Funo responsvel por retornar os cdigos de novos pedidos realizados no site.
Parmetros:

Parmetro
Exemplo de Retorno:

<Receipts xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<iCodigoPedido>11</iCodigoPedido>
</Receipts>

iCodigoPedido int - Cdigo sequencial interno do pedido.

(21) 3553-2625
2. b. GetOrder
Funo responsvel por retornar os dados do pedido realizado no site.
Parmetros:

Parmetro
Exemplo strData:

<Order xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
</Order>

Exemplo de Retorno:
<Receipt xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<dDataPedido>2006-11-23T08:43:20.953</dDataPedido>
<iValorTotalPedido>160100</iValorTotalPedido>
<iValorTotalProdutos>159800</iValorTotalProdutos>
<iCodigoCliente>1</iCodigoCliente>
<sNomeCliente>Otto Mathi</sNomeCliente>
<sLogradouro>Rua X</sLogradouro>
<sBairro>Boqueirao</sBairro>
<sNumeroLogradouro>345</sNumeroLogradouro>
<sComplemento>Apto 305</sComplemento>
<sCEP>17055000</sCEP>
<sMunicipio>Praia Grande</sMunicipio>
<sDDDTelefone>15</sDDDTelefone>
<sTelefone>45215632</sTelefone>
<sUF>SP</sUF>
<sObservacaoLogradouro>Prximo a estao de metro Paraiso.</sObservacaoLogradouro>
<iCodigoIBGE>330057</iCodigoIBGE>
</Receipt>

dDataPedido datetime 23 Data em que o pedido foi realizado.
iValorTotalPedido int - Valor total do pedido com 2 casas decimais. (Sem
formatao, apenas nmeros. Por exemplo: R$ 100,00
equivalem a 10000)
iValorTotalProdutos int - Valor total em produtos do pedido com 2 casas decimais.
(Sem formatao, apenas nmeros. Por exemplo: R$
100,00 equivalem a 10000)
iCodigoCliente int - Cdigo do cliente no site.
sNomeCliente string 50 Nome do cliente.
sLogradouro string 80 Logradouro.
sBairro string 80 Bairro do endereo.
sNumeroLogradouro string 10 Nmero do endereo.
sComplemento string 30 Complemento do endereo.
sCEP string 10 CEP do endereo. (Sem formatao, apenas nmeros)
sMunicipio string 80 Municpio do endereo.
sDDDTelefone string 2 DDD do telefone.
sTelefone string 9 Nmero do telefone. (Sem formatao, apenas nmeros)

(21) 3553-2625
sUF string 2 Sigla da UF do endereo.
sObservacaoLogradouro string 200 Referncia do endereo de entrega.
iCodigoIBGE int - Cdigo IBGE do municpio.
2. c. GetClient
Funo responsvel por retornar os dados de um cliente do site atravs do cdigo de
cadastro.
Parmetros:

Parmetro
Exemplo strData:

<Customer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
</Customer>

iCodigoCliente int - Cdigodo cliente no site.
Exemplo Retorno:

<Client xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<sEmail>Jose@emailservidor.com.br</sEmail>
<sNomeCliente>Jos Cardoso</sNomeCliente>
<sCNPJ/>
<sIM/>
<sIE/>
<sCPF>04542748442</sCPF>
<dDataNascimento>1973-07-04T00:00:00</dDataNascimento>
<sSexo>M</sSexo>
<sDDDTelefone>11</sDDDTelefone>
<sTelefone>11111111</sTelefone>
<sDDDTelefoneCelular>11</sDDDTelefoneCelular>
<sTelefoneCelular>11111111</sTelefoneCelular>
<sDDDTelefoneComercial/>
<sTelefoneComercial/>
<sFlgTipoCliente>F</sFlgTipoCliente>
<sRG>424446444</sRG>
<sEmissorRG>SP</sEmissorRG>
<sLogradouro>Bernardino de Campos</sLogradouro>
<sNumeroLogradouro>100</sNumeroLogradouro>
<sComplemento/>
<sBairro>Paraiso</sBairro>
<sCEP>04004040</sCEP>
<sMunicipio>Sao Paulo</sMunicipio>
<sUF>SP</sUF>
<sObservacaoLogradouro>Proximo a estao paraiso do metro.</sObservacaoLogradouro>
<iCodigoIBGE>123123</iCodigoIBGE>
</Client>

(21) 3553-2625

iCodigoCliente int - Cdigo do cliente no site.
sEmail string 50 E-mail do cliente.
sNomeCliente string 50 Nome do cliente.
sCNPJ string 14 CNPJ do cliente. (Sem formatao, apenas nmeros)
sIM string 20 Inscrio municipal do cliente. (Sem formatao, apenas
nmeros)
sIE string 20 Inscrio estadual do cliente. (Sem formatao, apenas
nmeros)
sCPF string 11 CPF do cliente. (Sem formatao, apenas nmeros)
dDataNascimento datetime 23 Data de nascimento do cliente.
sSexo string 1 Sexo do cliente. (M Masculino / F Feminino)
sDDDTelefone string 2 DDD do telefone. (Sem formatao, apenas nmeros)
sTelefone string 9 Nmero do telefone do cliente. (Sem formatao, apenas
nmeros)
sDDDTelefoneCelular string 2 DDD do telefone celular. (Sem formatao, apenas
nmeros)
sTelefoneCelular string 9 Nmero do telefone celular do cliente. (Sem formatao,
apenas nmeros)
sDDDTelefoneComercial string 2 DDD do telefone comercial. (Sem formatao, apenas
nmeros)
sTelefoneComercial string 9 Nmero do telefone comercial do cliente. (Sem
formatao, apenas nmeros)
sFlgTipoCliente string 1 Indicao do tipo do cliente. (F Fsica / J Jurdica)
sRG string 20 Nmero do RG do cliente. (Sem formatao, apenas
nmeros)
sEmissorRG string 20 rgo emissor do RG do cliente.
sLogradouro string 80 Logradouro.
sNumeroLogradouro string 10 Nmero do endereo.
sComplemento string 30 Complemento do endereo.
sBairro string 80 Bairro do endereo.
sCEP string 10 CEP do endereo. (Sem formatao, apenas nmeros)
sMunicipio string 80 Municpio do endereo.
sUF string 2 Sigla da UF do endereo.
sObservacaoLogradouro string 200 Referncia do endereo de entrega.
iCodigoIBGE int - Cdigo IBGE do municpio.
2. d. GetOrderItems
Funo responsvel por retornar os itens do pedido realizado no site.
Parmetros:

Parmetro
Exemplo strData:

<Order xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
</Order>


(21) 3553-2625
Exemplo Retorno:

<ReceiptItems xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<ReceiptItem>
<iQtdeVendida>1000</iQtdeVendida>
<iPrecoVendaOriginal>79900</iPrecoVendaOriginal>
<iPrecoVendaFinal>79900</iPrecoVendaFinal>
</ReceiptItem>
<ReceiptItem>
<iQtdeVendida>1000</iQtdeVendida>
<iPrecoVendaOriginal>79900</iPrecoVendaOriginal>
<iPrecoVendaFinal>79900</iPrecoVendaFinal>
</ReceiptItem>
</ReceiptItems>

sReferenciaCompleta string 20 Referncia completa do produto. (SKU)
iQtdeVendida int - Quantidade do produto vendido com 3 casas decimais.
(Sem formatao, apenas nmeros. Por exemplo: 5
equivalem a 5000)
iPrecoVendaOriginal int - Preo original do produto sem desconto com 2 casas
decimais. (Sem formatao, apenas nmeros. Por
exemplo: R$ 120,00 equivalem a 12000)
iPrecoVendaFinal int - Preo final do produto com desconto com 2 casas
decimais. (Sem formatao, apenas nmeros. Por
exemplo: R$ 90,00 equivalem a 9000)
2. e. SetOrderImported
Funo responsvel por marcar o pedido como importado no site para que na prxima
chamada do mtodo GetNewOrders no seja enviado novamente.
Parmetros:

Parmetro
Exemplo strData:
<Order xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
</Order>


(21) 3553-2625
Exemplo Retorno:
<Return xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<idRet>1</idRet>
<idErr></idErr>
<dsErr></dsErr>
</Return>

idRet int - Cdigo do retorno da operao. (1 Sucesso / 0 Falha)
idErr int - Cdigo do erro da operao, caso ocorra uma falha.
dsErr string 1000 Descrio do erro da operao, caso ocorra uma falha.
3. Carga Inicial de Produtos

Procedimento inicial que deve ser realizado para o primeiro envio em massa de produtos
para o ambiente e-commerce. Para a execuo deste procedimento, ser gerado um arquivo
.csv, sem cabealho e com o separador | (barra vertical) contendo as seguintes colunas.
1. sDescricaoFiscal
2. sDescricaoCor
3. sDescricaoTamanho
4. sReferenciaBasica
5. sDescricaoBasica
6. sReferenciaCompleta
7. sDescricaoCompleta
8. sFlgSituacao
9. iCodigoFornecedor
10. iPeso
11. iAltura
12. iLargura
13. iComprimento
14. iPrecoVenda
15. iQtdeEstoque
16. sObservacao
17. sTituloElemento1
18. sElemento1
20. sElemento2
22. sElemento3
23. sTituloSubElemento3
24. sSubElemento3
26. sElemento4
28. sElemento5
30. sElemento6
31. sTituloSubElemento6
32. sSubElemento6

(21) 3553-2625

Manual Laserchip

Enviado por

Direitos autorais:

Formatos disponíveis

Manual Laserchip

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Laserchip

Enviado por

Direitos autorais:

Formatos disponíveis

Verso 2.1 Quarta-Feira, 05 de Outubro de 2016.

Documento de Integrao da Plataforma

Laserchip x Arte Digital (E-Commerce)

Verso do documento v2.1

Data Verso Descrio Autor

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Funo ProductAddUpdate .......................................................................... 4

Funo GetNewOrders ................................................................................ 5

Funo GetOrder ....................................................................................... 6

Funo GetClient ....................................................................................... 7

Funo GetOrderItems ............................................................................... 8

Funo SetOrderImported .......................................................................... 9

Carga Inicial de Produtos ............................................................................ 10

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Este documento tem o objetivo de documentar a parte tcnica do

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Nome do Tipo Descrio Obrigatoriedade

<?xml version="1.0" encoding="utf-16" ?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Nome do Tipo Descrio Obrigatoriedade

<?xml version="1.0" encoding="utf-16"?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Nome do Tipo Descrio Obrigatoriedade

<?xml version="1.0" encoding="utf-16"?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Nome do Tipo Descrio Obrigatoriedade

<?xml version="1.0" encoding="utf-16"?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

<?xml version="1.0" encoding="utf-16"?>

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Nome Parmetro Tipo Tamanho Descrio

Nome do Tipo Descrio Obrigatoriedade

<?xml version="1.0" encoding="utf-16"?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

<?xml version="1.0" encoding="utf-16"?>

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Nome do Tipo Descrio Obrigatoriedade

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Descrio dos Elementos:

Nome Parmetro Tipo Tamanho Descrio

3. Carga Inicial de Produtos

Rua Visconde de Inhama, 77 - 2 Andar Centro Rio de Janeiro RJ CEP 20091-007.

Você também pode gostar