INTRODUÇÃO
Este documento tem por objetivo disponibilizar layout de arquivos para integração de dados entre a plataforma de E-Commerce Chleba e seus parceiros.
O modelo de integração vai ser por WebService, fazendo autenticação e passando o modelo XML.
Este documento contempla layout dos seguintes arquivos de dados:
- Integração de Produtos
- Recuperação de pedidos
- Situação dos Pedidos (status)
- Personalização de Preços: Grupo
- Personalização de Preços: Cliente
- Personalização de Preços: Preços
- Personalização de Preços: Condição
WEBSERVICE
O modelo tem por objetivo fazer autenticação no sistema e será consumido pelo sistema do parceiro.
LINK DE ACESSO AO EXEMPLO:
Integração
USUÁRIO PARA AUTENTICAÇÃO
Para efetuar os primeiros testes utilize o login e senha padrão do sistema.
Username = admin
Password = admin
MODELO DE RETORNO DE DADOS
Para cada método consumido o sistema vai responder no formato:
Exemplo de formato resposta de método
<?xml version='1.0' encoding='iso-8859-1' standalone='yes'?>"
<Parceiro>
<codigo><![CDATA[codigo]]</codigo>
<mensagem><![CDATA[mensagem]]</mensagem>
</Parceiro>
TABELA DE MENSAGENS
Os codigo-mensagem de retorno são:
Código (0 – Descrição do erro)
Código (1 - Login e/ou senha inválido(s))
Codigo (2 – Processado)
Exemplo de chamada no .NET
net.chleba.tecnologia.ServiceAuthHeader sah = new WebApplicationTeste.net.chleba.tecnologia.ServiceAuthHeader();
sah.UserName = "admin";
sah.Password = "admin";
net.chleba.tecnologia.Integracao integracao = new WebApplicationTeste.net.chleba.tecnologia.Integracao();
integracao.ServiceAuthHeaderValue = sah;
string retorno = integracao.IntegracaoProdutos("<xml><Parceiro>teste</Parceiro><xml>");
MÉTODOS DA API
IntegracaoProdutos
Este método tem por objetivo integrar os dados dos produtos entre o sistema do parceiro e a loja virtual.
Este arquivo será fornecido pelo parceiro, para que o sistema da loja possa consumir os dados fornecidos no formado do arquivo apresentado abaixo.
O link definitivo de acesso ao arquivo ou a disponibilização de uma área para upload do arquivo na loja será definido no momento que iniciar a operação de integração.
ESTRUTURA DO ARQUIVO XML
Abaixo estão descritos informações da tabela de departamentos, atributos, itens de atributos e de produtos. Estas tabelas em conjunto, montam o arquivo de produtos.
ESTRUTURA DA TABELA DE DEPARTAMENTOS
Campo |
Tamanho |
Observação |
| Informações do departamento | ||
| nome | Char(100) | Nome do departamento. Campo obrigatório. |
| codigo | Char(100) | Identificação do departamento. Campo obrigatório. |
| Informações das categorias do departamento | ||
| nome | Char(100) | Nome da categoria pertencente a um departamento. Campo obrigatório. |
| codigo | Char(100) | Identificação da categoria. Campo obrigatório. |
ESTRUTURA DA TABELA DE ATRIBUTOS
Campo |
Tamanho |
Observação |
| Informações dos atributos | ||
| atributo_id | inteiro | Identificação do atributo. Campo obrigatório. |
| nome | Char(100) | Nome do atributo do produto. (Ex: Cor, Tamanho, Voltagem). Campo obrigatório. |
ESTRUTURA DA TABELA DE ITENS DE ATRIBUTOS
Campo |
Tamanho |
Observação |
| Informações dos itens dos atributos | ||
| atributoitem_id | inteiro | Identificação do item do atributo. Campo obrigatório. |
| atributo_id | inteiro | Identificação atributo. Campo obrigatório. |
| nome | Char(100) | Nome do atributo do produto. (Ex: Cor, Tamanho, Voltagem). Campo obrigatório. |
ESTRUTURA DA TABELA DE ITENS DE PRODUTOS
Campo |
Tamanho |
Observação |
| Informações do produto | ||
| CodigoProduto | Char(100) | Identificação do produto no parceiro. Campo obrigatório. |
| SKU | Char(100) | Identificação do produto no Fabricante. Campo obrigatório. |
| Fabricante | Char(100) | Nome do fabricante. Campo obrigatório. |
| modeloFabricante | Char(100) | Modelo do produto no fabricante. Campo obrigatório. |
| descricao | Char(2000) | Descrição do produto. Campo obrigatório. |
| fichaTecnica | Char(2000) | Ficha técnica do produto, ou seja, uma descrição detalhada e técnica do produto. Campo obrigatório. |
| pesoComEmbalagem | Decimal(10,2) | Peso do produto com a embalagem. Este peso será usado para cálculo do frete. Campo obrigatório. |
| pesoProduto | Decimal(10,2) | Peso do produto sem embalagem. Campo obrigatório. |
| preco | Decimal(10,2) | Preço do produto. Campo obrigatório. |
| precoPromocao | Decimal(10,2) | Preço do produto em promoção. Caso o produto não esteja em promoção, deve ser informado o preço normal do produto. Na apresentação de produtos na loja, caso o preço do produto seja diferente do preço de promoção, então será apresentado a informação De >> Por. Campo obrigatório. |
| imagem | Char(500) | Link com a imagem pequena do produto no site do parceiro. Esta imagem será apresentada em todo o site. Esta imagem deverá ter no máximo a seguinte dimensão: 113X138px. Campo opcional. |
| imagemGrande | Char(500) | Link com a imagem pequena do produto no site do parceiro. Esta imagem será apresentada em todo o site. Esta imagem deverá ter no máximo a seguinte dimensão: 113X138px. Campo opcional. |
| imagemGrande1 | Char(500) | Link com a imagem pequena do produto no site do parceiro. Esta imagem será apresentada em todo o site. Esta imagem deverá ter no máximo a seguinte dimensão: 113X138px. Campo opcional. |
| imagemGrande2 | Char(500) | Link com a imagem pequena do produto no site do parceiro. Esta imagem será apresentada em todo o site. Esta imagem deverá ter no máximo a seguinte dimensão: 113X138px. Campo opcional. |
| largura | Decimal(10,2) | Largura do produto. Campo opcional. |
| altura | Decimal(10,2) | Altura do produto. Campo opcional. |
| profundidade | Decimal(10,2) | Profundidade do produto. Campo opcional. |
| larguraemb | Decimal(10,2) | Largura da embalagem do produto. Campo opcional. |
| alturaemb | Decimal(10,2) | Altura da embalagem do produto. Campo opcional. |
| profundidadeemb | Decimal(10,2) | Profundidade da embalagem do produto. Campo opcional. |
| dddat | Char(2) | DDD do telefone de atendimento para esclarecimento de dúvidas do produto. Pode ser o ddd do fabricante. Campo opcional. |
| foneat | Char(10) | DDD do telefone de atendimento para esclarecimento de dúvidas do produto. Pode ser o ddd do fabricante. Campo opcional. |
| ddgat | Char(15) | Telefone 0800, caso a empresa tenha, para esclarecimento de dúvidas do produto. Campo opcional. |
| emailat | Char(100) | E-Mail da empresa, caso a empresa tenha, para esclarecimento de dúvidas do produto. Campo opcional. |
| prazoentrega | Inteiro | Prazo de entrega do produto. Campo obrigatório. |
| prazogarantia | Inteiro | Prazo de garantia do produto. Campo obrigatório. |
| tipoembpresente | Char(01) | Este campo indica se o produto pode ser embalado para presente ou não. Os valores que devem ser enviados são: 0: não pode ser embalado para presente; 1: pode ser embalado para presente. Campo obrigatório. |
| ativo | Char(1) | Campo para ativação ou não do produto. Campo obrigatório. |
| Informações do departamento onde o produto será publicado na loja | ||
| cod_depto | inteiro | Neste campo deverá vir o código do departamento, que irá remeter para a tabela de departamento que também deve vir mapeada no arquivo XML, conforme descrito na tabela de departamentos. Campo obrigatório. |
| cod_secao | inteiro | Neste campo deverá vir o código da categoria, que irá remeter para a tabela de departamento que também
deve vir mapeada no arquivo XML, conforme descrito na tabela de departamentos / categorias. Campo obrigatório. |
| estoque | inteiro | |
| Informações de modelos do produto | ||
| item | inteiro | Neste campo deverá vir um identificador de modelos do produto. Campo obrigatório. |
| atributoitem_id | inteiro | Neste campo deverá vir o código dos atributos que compõe cada modelo do produto. Exemplo: O produto é uma geladeira branca, com tamanho grande de 350 litros e com voltagem 110. Então para este produto será enviado 3 atributos. um para identificar a cor, outro para identificar o tamanho e outro para identificar a voltagem. Para o sistema da loja localizar estes atributos, será usado a tabela de atributos e itens descritos acima. Campo obrigatório. |
| Informações do agrupado | ||
| item | char | |
| linha | char | |
| descricao | char | |
| peso | decimal | |
ESTRUTURA DA TABELA DE PRODUTOS
<?xml version="1.0" encoding="iso-8859-1"?>
<loja nome="iGEletro" codigo="1">
<departamentos>
<departamento nome="CINE E FOTO" codigo="01">
<secao nome="Câmeras Digitais - Até 1 Megapixel" codigo="010404"/>
<secao nome="Câmeras Digitais - De 1 a 1.9 Megapixels" codigo="010408"/>
</departamento>
<departamento nome="ELETRÔNICOS" codigo="02">
<secao nome="DVD - DVD Player" codigo="020404"/>
<secao nome="DVD - Filmes" codigo="020408"/>
<secao nome="Home theater" codigo="0208"/>
</departamento>
</departamentos>
<atributos>
<atributo atributo_id="1" nome="Cor"/>
<atributo atributo_id="2" nome="Voltagem"/>
<atributo atributo_id="3" nome="Tamanho"/>
<atributo atributo_id="17" nome="Modelo"/>
<atributo atributo_id="20" nome="Numeração"/>
<atributo atributo_id="21" nome="Polegadas"/>
</atributos>
<atributoitens>
<atributoitem atributoitem_id="5" atributo_id="3" nome="P"/>
<atributoitem atributoitem_id="6" atributo_id="3" nome="M"/>
<atributoitem atributoitem_id="19" atributo_id="1" nome="Preto"/>
</atributoitens>
<produtos>
<produto CodigoProduto="02647" SKU="CodigoProdutoNoFabrincante"
Fabricante="ICONCEPTS" modeloFabricante="xxxxxxx"
descricao="descrição do produto." pesoComEmbalagem=" 0.030"
pesoProduto=" 0.000" preco="28.70" precoPromocao="28.70"
imagem="http://www.chleba.com.br/images/produtos/jpg/02647.jpg"
imagemGrande="http://www.chleba.com.br/zoom/jpg/02647.jpg"
imagemGrande1="http://www.chleba.com.br/images/zoom/02647_1.jpg" imagemGrande2="http://www.chleba.com.br/zoom/02647_2.jpg"
largura=".00" altura=".00" profundidade=".00" larguraemb="7.40"
alturaemb="16.30" profundidadeemb="1.50" prazoentrega="0"
prazogarantia="0" dddat="11" foneat="3338-2088" ddgat=" "
emailat="[email protected]" tipoembpresente="0" ativo=”S”>
<local cod_depto="04" cod_secao="04041212"/>
<modelos>
<modelo item="1" CodigoProdutoModelo=”XXX” estoque=”10”>
<atributo atributoitem_id="55"/>
<atributo atributoitem_id="19"/>
</modelo>
<modelo item="2" CodigoProdutoModelo=”YYY” estoque=”10”>
<atributo atributoitem_id="55"/>
<atributo atributoitem_id="20"/>
</modelo>
<modelo item="3" CodigoProdutoModelo=”ZZZ” estoque=”10”>
<atributo atributoitem_id="56"/>
<atributo atributoitem_id="20"/>
</modelo>
</modelos>
</produto>
</produtos>
</loja>
RecuperaPedido
Layout do arquivo de pedidos, itens de pedidos, clientes e endereço de entrega:
Este arquivo tem por objetivo integrar os dados dos pedidos, itens do pedido (produto(s) comprado pelo cliente), informações do cliente, assim como dados do endereço do cliente e o endereço de entrega, entre a loja virtual e o sistema do parceiro.
Este arquivo será fornecido pela loja e será consumido pelo sistema de integração do parceiro.
Desta forma, o parceiro deve se adequar para consumir os dados fornecidos no formado do arquivo apresentado abaixo.
ESTRUTURA DA TABELA DE DEPARTAMENTOS
Campo |
Tamanho |
Observação |
| Informações do Pedido | ||
| pedido_id | Inteiro | Identificação do pedido na loja. |
| dataVenda | Date | Data que a venda foi realizada na loja. O formato da data é: “yyyy-MM-dd hh:mm” |
| Transportadora | Char(01) | Os valores deste campo São: S: Sedex; E: E-Sedex; *Caso o parceiro tenha outra forma de entrega, é necessário conversar com a pessoa responsável pela integração dos dados na Chleba para que combinem quais serão os valores enviados para outras formas de entregas. |
| FormaPagamento | Char(02) | Neste campo enviamos a forma de pagamento do pedido. Os valores previamente enviados neste campo são: 1: Boleto Bancário 2: Visa 3: Mastercard 4: Amex 5: Diners 6: Cartões Bradesco 7: Financiamento Eletrônico Bradesco 8: Transferência Eletrônica entre Contas Bradesco 9: Itaú Shopline 10: Itaú Boleto 11: Itaú Cartão 12: Itaú Transferência 13: Itaú Financiamento 14: Visa Eletron * Caso o parceiro já tenha uma tabela de valores e queira que seja enviado estes valores que ele já possui, deve ser conversado com o responsável pela integração na chleba, para verificar a possibilidade de alteração dos valores acima e conseqüentemente enviado outros valores. * Caso o parceiro tenha outra forma de pagamento, deve ser combinado com o responsável pela integração na chleba, para combinarem os valores a serem enviados. |
| TitularCC | Char(100) | Neste campo vai o nome do titular do cartão de crédito, caso as formas de pagamento do tipo cartão, seja realizada a transação por meio off-line, através de maquinetas. * Caso seja transação On-Line, este campo vai em branco. |
| NumCC | Char(20) | Neste campo vai o número do cartão de crédito, caso as formas de pagamento do tipo cartão, seja realizada a transação por meio off-line, através de maquinetas. * Caso seja transação On-Line, este campo vai em branco |
| CodSegCC | Char(04) | Neste campo vai o código de segurança do cartão de crédito, caso as formas de pagamento do tipo cartão, seja realizada a transação por meio off-line, através de maquinetas. * Caso seja transação On-Line, este campo vai em branco. |
| DTValidadeCC | Char(07) | Neste campo vai a data de validade do cartão de crédito, caso as formas de pagamento do tipo cartão,
seja realizada a transação por meio off-line, através de maquinetas. * O formato dos valores enviados são: MM/yyyy. Exemplo: 06/2005. * Caso seja transação On-Line, este campo vai em branco. |
| CodAutorizacao | Char(100) | Neste campo vai o código de autorização da compra, caso a mesma tenha sido realizada por meio de pagamento On-Line (cartão de crédito, débito ou outra forma de pagamento disponível). * Caso seja transação Off-Line, este campo vai em branco. |
| Parcelas | Char(02) | Neste campo vai o total de parcelas que o cliente parcelou a compra. Caso seja pagamento á vista, vai o valor 1. |
| ValorFrete | Decimal(10,2) | Neste campo vai o valor do frete pago pelo cliente. |
| SubTotalCompra | Decimal(10,2) | Neste campo vai o valor da compra (sem inclusão do valor do frete e com desconto, caso tenha) pago pelo cliente. |
| Valorcompra | Decimal(10,2) | Neste campo vai o valor total da compra pago pelo cliente (inclui o valor do frete e já com o desconto calculado, caso tenha). |
| PorcentagemDesconto | Decimal(5,2) | Neste campo vai o desconto da compra caso a mesma tenha desconto. Se não tem desconto, o valor enviado é 0. |
| nomePresenteado | Char(100) | Neste campo vamos enviar o nome do presenteado, caso o cliente indique que a compra é para presente e caso o cliente informe o nome do presenteado. |
| MensagemCartao | Char(255) | Neste campo vai a mensagem do cartão, caso a loja possua campo para o cliente digitar mensagem de cartão. * Caso tenha opção de presente, o campo de mensagem é apresentado ao cliente. |
| Informações do Cliente | ||
| TipoPessoa | Char(01) | Neste campo será informado se o cliente é pessoa Física “F” ou Jurídica “J”. |
| CPFCNPJ | Char(20) | Neste campo será enviado o CPF, caso seja pessoa física ou o CNPJ do cliente, caso seja pessoa jurídica. |
| ClienteNome | Char(100) | Neste campo será enviado o nome, caso seja pessoa física ou a Razão social do cliente, caso seja pessoa jurídica. |
| InscRG | Char(10) | Neste campo será enviado o RG, caso seja pessoa física ou a Inscrição estadual do cliente, caso seja pessoa jurídica. |
| Char(10) | Neste campo será informado o e-mail do cliente. | |
| DTNasc | Char(10) | Neste campo será a data de nascimento do cliente, caso seja pessoa física. Caso seja pessoa jurídica, este campo vai em branco |
| Sexo | Char(01) | Neste campo será informado o sexo do cliente, caso o cliente seja pessoa física. Caso seja pessoa jurídica, informaremos o valor M. Os valores enviados podem ser: M: masculino; F: Feminino; |
| Informações e endereço de entrega do Cliente | ||
| tipoEndereco | Char(01) | Neste campo será informado se o endereço é do cliente ou é o endereço de entrega. Os valores deste campo são: C: Endereço do cliente; E: Endereço de entrega da compra; * Caso o endereço de entrega seja o mesmo endereço do cliente, mesmo assim será enviado dois registros (um identificando cliente e outro a entrega). |
| Nome | Char(100) | Neste campo será enviado o nome do destinatário cadastrado no endereço. Caso o endereço seja do próprio cliente, o nome vai em branco. |
| CEP | Char(08) | Neste campo será enviado o CEP do endereço |
| Endereco | Char(100) | Neste campo será enviado o endereço em questão. |
| Numero | Char(100) | Neste campo será enviado o número do endereço. |
| Complemento | Char(10) | Neste campo será enviado o complemento do endereço. |
| Bairro | Char(50) | Neste campo será enviado o bairro do endereço. |
| Cidade | Char(50) | Neste campo será enviado o nome da cidade do endereço. |
| UF | Char(02) | Neste campo será enviado o Estado do endereço. |
| DDDRes | Char(02) | Neste campo será enviado o DDD do telefone residencial. * Caso o DDD não tenha sido informado, será enviado em branco. * pode não ser informado o DDD para o endereço de entrega. |
| FoneRes | Char(15) | Neste campo será enviado o telefone residencial. * Caso o telefone residencial não tenha sido informado, será enviado em branco. * pode não ser informado o telefone para o endereço de entrega. |
| DDDCom | Char(02) | Neste campo será enviado o DDD do telefone comercial. * Caso o DDD não tenha sido informado, será enviado em branco. * pode não ser informado o DDD para o endereço de entrega. |
| FoneCom | Char(15) | Neste campo será enviado o telefone comercial. * Caso o telefone comercial não tenha sido informado, será enviado em branco. * pode não ser informado o telefone para o endereço de entrega. |
| Informações de itens de pedido (produtos e modelo do produto) | ||
| ProdutoCodigo | Char(50) | Neste campo será enviado o código do produto (SKU do produto no lojista) que o lojista usa para identificação do produto em seu sistema interno. |
| QTDE | Inteiro | Neste campo será enviado a quantidade de itens que o cliente comprou do produto em questão. |
| ValorUnitario | Decimal(10,2) | Neste campo será enviado o valor unitário do produto. |
| Atributoitem_id | Char(5) | Identificação do modelo do produto. Exemplo: O produto é uma geladeira branca, com tamanho grande de 350 litros e com voltagem 110. Então para este produto será enviado 3 atributos. um para identificar a cor, outro para identificar o tamanho e outro para identificar a voltagem. * O parceiro deve entrar em contato com o responsável pela integração na Chleba, para combinarem os códigos que serão enviados para identificação dos atributos do produto. |
| CodigoProdutoModelo | Varchar(100) | Código que identifica o item (SKU) |
| TabelaDesconto | Char | Código da tabela do cliente vinculada |
EXEMPLO DE ARQUIVO XML
<?xml version="1.0" encoding="iso-8859-1"?>
<loja nome="LojaParceiro" codigo="1">
<pedidos>
<pedido pedido_id="3175" Transportadora="S" FormaPagamento="V"
TitularCC="Galter" NumCC="4111111111111111" CodSegCC="123"
DTValidadeCC="06/2006" CodAutorizacao="" Parcelas="1"
ValorFrete="4.50" SubTotalCompra="49.78" Valorcompra="54.28"
PorcentagemDesconto="5" nomePresenteado="" MensagemCartao="">
<cliente TipoPessoa="F" CPFCNPJ="00000000000" ClienteNome="José
Galter" InscRg="00000000" Email="[email protected]"
DTNasc="1980-10-20" Sexo="M" TabelaDesconto==”10”>
<endereco>
<enderecoItem tipoEndereco="C" Nome="José Galter"
CEP="80030001" Endereco="Av. João Gualberto"
Numero="1673" Complemento="SL: 03" Bairro="Juveve"
Cidade="Curitiba" UF="PR" DDDRes="41"
FoneRes="2223333" DDDCom="41" FoneCom="32522529"/>
<enderecoItem tipoEndereco="E" Nome="José Galter"
CEP="80030001" Endereco="Av. João Gualberto"
Numero="1673" Complemento="SL: 03" Bairro="Juveve"
Cidade="Curitiba" UF="PR" DDDRes="41"
FoneRes="2223333" DDDCom="41" FoneCom="32522529"/>
</endereco>
</cliente>
<pedidoItens>
<pedidoItem ProdutoCodigo="02647" QTDE="1" ValorUnitario="28.70">
<modelo>
<atributo Atributoitem_id="55"/>
<atributo Atributoitem_id="20"/>
</modelo>
</pedidoItem>
<pedidoItem ProdutoCodigo="1024" QTDE="1" ValorUnitario="23.70">
<modelo>
<atributo Atributoitem_id="55"/>
<atributo Atributoitem_id="33"/>
</modelo>
</pedidoItem>
</pedidoItens>
</pedido>
</pedidos>
</loja>
AtualizaStatusPedido
Este método tem por objetivo integrar os dados dos status dos pedidos entre o sistema do parceiro e a loja virtual.
Este arquivo será fornecido pelo parceiro, para que o sistema da loja possa consumir os dados fornecidos no formado do arquivo apresentado abaixo.
EXEMPLO DE ARQUIVO XML
<?xml version="1.0" encoding="iso-8859-1" ?>
<loja nome="LojaParceiro" codigo="1">
<pedidos>
<pedido idpedido="1" idstatus="1" datastatus="2000-11-12 15:50" idtransporte="1656565" motivocancelamento="loremloremlorem" />
</pedidos>
</loja>
ESTRUTURA DO ARQUIVO XML
Campo |
Tamanho |
Observação |
| Informações do pedido | ||
| idpedido | Char(50) | Identificação do pedido no sistema da loja virtual. |
| idstatus | Char(02) | Neste campo deve ser informado o status do pedido no lojista. Abaixo segue uma tabela com os possíveis Status que a loja disponibiliza. |
| datastatus | Date | Data que a o status foi mudado no sistema do parceiro e consequentemente será informado na loja, pois algumas consultas de pedidos leva em consideração esta data. O formato da data é: “yyyy-MM-dd hh:mm”. |
| idtransporte | Char(50) | Neste campo, o parceiro poderá enviar a identificação da compra da transportadora ou correios, para o cliente poder consultar e acompanhar o andamento da entrega da compra. |
| motivoCancelamento | Char(255) | Quando um determinado pedido for cancelado, ele deverá ser informado o motivo do cancelamento. * Só deverá ser usado, caso o pedido em questão estiver com status cancelado. |
Personalização de Preços - Grupo
Método para envio dos dados do grupo, para vinculo de clientes e tabela de desconto.
ENDEREÇO DE HOMOLOGAÇÃO
http://tecnologia.chleba.net:108/webservice/Grupo.asmx
Usuário: chleba
Senha: chleba2012
EXEMPLO XML DE CHAMADA EM C#
net.chleba.tecnologia.ServiceAuthHeader sah = new net.chleba.tecnologia.ServiceAuthHeader();
sah.UserName = "chleba";
sah.Password = "chleba2012";
net.chleba.tecnologia.TabelaDesconto tb = new net.chleba.tecnologia.TabelaDesconto();
tb.ServiceAuthHeaderValue = sah;
string xml = @"<lojas><loja nome=""XXX"" lojaId=""1""><grupos><grupo Codigo=""TAB1"" Descricao=""Código da tabela 1"" Fator=""0.79"" LinhaCod=""0"" Ativo=""true"" /><grupo Codigo=""TAB2"" Descricao=""Código da tabela 2"" Ativo=""false"" /></grupos></loja><loja nome=""XXX"" lojaId=""2""><grupos><grupo Codigo=""TAB3"" Descricao=""Código da tabela 3"" Ativo=""true"" /><grupo Codigo=""TAB4"" Descricao=""Código da tabela 4"" Ativo=""false""/></grupos></loja></lojas>";
Response.Write(tb.Atualiza(xml));
EXEMPLO DE ARQUIVO XML
<lojas>
<loja nome=”XXX” lojaId="1">
<grupos>
<grupo Codigo="TAB1" Descricao="Código da tabela 1" Ativo="true" />
<grupo Codigo="TAB2" Descricao="Código da tabela 2" Ativo="false" />
</ grupos >
</loja>
<loja nome="XXX" lojaId="1">
<grupos>
<grupo Codigo="TAB3" Descricao="Código da tabela 3" Ativo="true" />
<grupo Codigo="TAB4" Descricao="Código da tabela 4" Ativo="false"/>
</grupos>
</loja>
</lojas>
ESTRUTURA DO ARQUIVO XML
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| Nome | Char(20) | |
| LojaID | inteiro | Padrão é = 1. |
| Codigo | String(10) | Código único do sistema. |
| Descricao | String(10) | Descrição da Tabela. |
| Ativo | True / false | |
RETORNO
OK > Se todos os dados foram atualizados com sucesso
Mensagem de erro > caso tenham sido encontrados erros no processamento
GrupoCliente
Personalização de Preço - Cliente
Método para envio dos dados do grupo, para vinculo de clientes e tabela de desconto.
ENDEREÇO DE HOMOLOGAÇÃO
http://tecnologia.chleba.net:108/webservice/Grupo.asmx
Usuário: chleba
Senha:chleba2012
EXEMPLO XML DE CHAMADA EM C#
net.chleba.tecnologia.ServiceAuthHeader sah = new net.chleba.tecnologia.ServiceAuthHeader();
sah.UserName = "chleba";
sah.Password = "chleba2012";
net.chleba.tecnologia.TabelaPrecoCliente tpc = new net.chleba.tecnologia.TabelaPrecoCliente();
tpc.ServiceAuthHeaderValue = sah;
string xml = @"<clientes><cliente CpfCnpj=""04056665941"" CodigoTabDesconto=""TAB2"" /><cliente CpfCnpj=""04056665941"" CodigoTabDesconto=""TAB3"" /><cliente CpfCnpj=""11380243254"" CodigoTabDesconto=""TAB1"" /></clientes>";
Response.Write(tpc.Atualiza(xml));
EXEMPLO DE ARQUIVO XML
<clientes>
<cliente CpfCnpj=" 098.150.204-04" CodigoTabDesconto="TAB1" />
<cliente CpfCnpj=" 098.150.204-04" CodigoTabDesconto="TAB3" />
<cliente CpfCnpj=" 72.453.038/0001-20" CodigoTabDesconto="TAB1" />
</clientes>
ESTRUTURA DO ARQUIVO XML
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| CpgCnpj | Char(1) | |
| CodigoTabDesconto | Char(10) | |
RETORNO
OK > Se todos os dados foram atualizados com sucesso
Mensagens de erro > caso tenham sido encontrados erros no processamento
GrupoPrecos
Personalização de Preços - Preços
Método para vinculo entre Grupo e preços por SKU.
ENDEREÇO DE HOMOLOGAÇÃO
http://tecnologia.chleba.net:108/webservice/GrupoPreco.asmx
Usuário: chleba
Senha: chleba2012
EXEMPLO XML DE CHAMADA EM C#
net.chleba.tecnologia.ServiceAuthHeader sah = new net.chleba.tecnologia.ServiceAuthHeader();
sah.UserName = "chleba";
sah.Password = "chleba2012";
net.chleba.tecnologia.TabelaPrecoCliente tpc = new net.chleba.tecnologia.TabelaPrecoCliente();
tpc.ServiceAuthHeaderValue = sah;
string xml = @"<precos><preco CodigoTabDesconto="TAB1" SKU=”0999P” Preco=”10,00”/><preco CodigoTabDesconto="TAB1" SKU=”0888P” Preco=”50,00”/><preco CodigoTabDesconto="TAB2" SKU=”123PP” Preco=”5,00”/></precos>";
Response.Write(tpc.Atualiza(xml));
EXEMPLO DE ARQUIVO XML
<precos>
<preco CodigoTabDesconto="TAB1" SKU=”0999P” Preco=”10,00”/>
<preco CodigoTabDesconto="TAB1" SKU=”0888P” Preco=”50,00”/>
<preco CodigoTabDesconto="TAB2" SKU=”123PP” Preco=”5,00”/>
</precos>
ESTRUTURA DO ARQUIVO XML
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| CodigoTabDesconto | Char(10) | |
| Sku | Char(30) | |
| Preco | Decimal(8,2) | |
RETORNO
Ok > Se todos os dados foram atualizados com sucesso
Mensagens de erro > caso tenham sido encontrados erros no processamento
GrupoCondicao
Personalização de Preços - Condição
Método para vinculo entre Grupo e condições de pagamento.
ENDEREÇO DE HOMOLOGAÇÃO
http://tecnologia.chleba.net:108/webservice/GrupoCondicao.asmx
Usuário: chleba
Senha:chleba2012
EXEMPLO XML DE CHAMADA EM C#
net.chleba.tecnologia.ServiceAuthHeader sah = new net.chleba.tecnologia.ServiceAuthHeader();
sah.UserName = "chleba";
sah.Password = "chleba2012";
net.chleba.tecnologia.TabelaPrecoCliente tpc = new net.chleba.tecnologia.TabelaPrecoCliente();
tpc.ServiceAuthHeaderValue = sah;
string xml = @"<precos><preco CodigoTabDesconto="TAB1" SKU=”0999P” Preco=”10,00”/><preco CodigoTabDesconto="TAB1" SKU=”0888P” Preco=”50,00”/><preco CodigoTabDesconto="TAB2" SKU=”123PP” Preco=”5,00”/></precos>";
Response.Write(tpc.Atualiza(xml));
EXEMPLO DE ARQUIVO XML
<condicoes>
<condicao CodigoTabDesconto="TAB1" codigocondicao=”101” condicao=”à vista” codigoformapagamento=”01” formapagamento=”boleto”/>
<condicao CodigoTabDesconto="TAB1" codigocondicao=”201” condicao=”à vista” codigoformapagamento =”02” formapagamento=”Visa”/>
<condicao CodigoTabDesconto="TAB1" codigocondicao=”202” condicao=”2x” codigoformapagamento =”02” formapagamento=”Visa”/>
</ condicoes >
ESTRUTURA DO ARQUIVO XML
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| CodigoTabDesconto | Char(10) | |
| CodigoCondicao | int | Cód para condição do pagamento |
| Condicao | Char(20) | Nome da condição de pagamento |
| CodigoFormaPagamento | int | Cód para forma de pagamento |
| FormaPagamento | Char(50) | Nome da forma de pagamento |
RETORNO
OK > Se todos os dados foram atualizados com sucesso
Mensagens de erro > caso tenham sido encontrados erros no processamento
Substituição tributária
Método para retorno do ST no carrinho de compras.
Cliente precisa desenvolver estrutura para receber o xml e retornar o valor ST final.
ENDEREÇO DE HOMOLOGAÇÃO
http://tecnologia.chleba.net:108/webservice/GrupoCondicao.asmx
Usuário: chleba
Senha:chleba2012
EXEMPLO DE ARQUIVO XML
<STs>
<st Sku=”AT0999” Valor=”10,00”/>
<st Sku=”BV1233” Valor=”90,00”/>
<st Sku=”XX000” Valor=”90,00”/>
</ STs>
ESTRUTURA DO ARQUIVO XML
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| Sku | Char(10) | Identificação do pedido no sistema da loja virtual |
| Valor | Decimal(8,2) | Padrão é = 1 |
EXEMPLO XML RETORNO
<RetornoST>
<st valor=”999,89”>
</ RetornoST >
ESTRUTURA DO ARQUIVO XML RETORNO
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| Valor | Decimal(8,2) | Padrão é = 1 |
Transportadoras
Método para retorno da listagem das transportadoras disponiveis.
Cliente precisa desenvolver estrutura para receber o xml abaixo e retornar a listagem das transportadoras
EXEMPLO DE ARQUIVO XML
<Transportadora>
<Transportadora CPFCNPJ=”03988076953” ValorCompra=”189,00” />
</ Transportadora >
ESTRUTURA DO ARQUIVO XML
| Informações do pedido | ||
Campo |
Tamanho |
Observação |
| CPFCNPJ | Char(14) | Identificação do cliente |
| ValorCompra | Decimal(8,2) | Valor da compra |
EXEMPLO XML RETORNO
<RetornoTransp>
<retorno NomeTransp=”JadLog” TempoEntrega=”10” Frete=”50,00”>
<retorno NomeTransp=”AlfaLog” TempoEntrega=”5” Frete=”18,00”>
</ RetornoTransp >
ESTRUTURA DO ARQUIVO XML RETORNO
| Campo | Tamanho | Observação |
| Informações do pedido | ||
| Valor | Decimal(8,2) | Padrão é = 1 |
ESTRUTURA DO ARQUIVO XML RETORNO
| Informações do pedido | ||
Campo |
Tamanho |
Observação |
| NomeTransp | Char(100) | Nome da Transportadora |
| TempoEntrega | Char(2) | Tempo Entrega |
PostEstoque
Este método envia e atualiza estoque de diversos skus.
URL: http://mwmintegracao.chleba.net/wsintegracao/PostEstoque
Método: PostEstoque
PARAMETROS DE ENTRADA: (devem ser inseridos no cabeçalho)
|
Parâmetro |
Tipo |
Info Adicional |
Obrigatório |
|
token |
String |
Sim |
|
|
login |
string |
Sim |
|
|
metodo |
String |
Sim |
Codigo do Produto: Código do distribuidor enviado no ‘modelo’ do produto.
{
"postestoque": [
{
"sku": "XX0001",
"estoque": 10,
"preco_normal" : 102.00,
"preco_promocao" : 99.00,
"preco_atacado" : 90.00,
“unidade”: “CAIXA”
}
]
}
Exemplo de retorno:
Sucesso
{
"codigo": 0,
"mensagem": "Operação efetuada com sucesso",
"ticket": "b9c86f0b-75f9-4eac-afb2-af134fdb4006",
"erros": [],
"dados_adicionais": null
}
Erro
{
"codigo": 999,
"mensagem": "Erros no processamento de alguns registros.",
"ticket": "f6dfdd07-1613-4cb6-a6b6-34c30fab04b7",
"erros": [
{
"Entidade": "Estoque",
"Item": "0",
"Erro": "Campo estoque obrigatório."
}
],
"dados_adicionais": null
}
PostCliente
Este método retorna todos os pedidos efetuados para a loja.
URL: http://integracao.chleba.net/wsintegracao/PostCliente
Método: PostCliente
PARAMETROS DE ENTRADA: (devem ser inseridos no cabeçalho)
|
Parâmetro |
Tipo |
Info Adicional |
Obrigatório |
|
token |
String |
Sim |
|
|
Login |
string |
Sim |
|
|
Método |
String |
Sim |
{
"PostCliente": {
"cliente": {
"TipoPessoa": "PJ",
"CPFCNPJ": "49351848000154",
"ClienteNome": "Cliente WebDev 4",
"InscRg": "00000000",
"Email": "[email protected]",
"DTNasc": "1980-10-20",
"Sexo": "M",
"Grupopreco": "tab1",
"CriterioCliente": "SS",
“LimiteCredito”:”1850.50” “,
"ValoremAbeto":”1200,00”,
"ValoresaVencer":”900,00”,
"ValoresVencidos":”50,00”,
“NomeFantasia”:””
},
"Enderecos": [
{
"Nome": "Trabalho",
"CEP": "05417030",
"Endereco": "Simão Alvares",
"Numero": "777",
"Complemento": "",
"Bairro": "Pinheiros",
"Cidade": "São Paulo",
"UF": "SP",
"DDDRes": "",
"FoneRes": "",
"DDDCom": "11",
"FoneCom": "31563256"
}
]
}
}
Exemplo de retorno:
Sucesso
{
"codigo": 0,
"mensagem": "Operação efetuada com sucesso",
"ticket": "639bc624-acd0-4797-b561-701e7fce1c23",
"erros": [],
"dados_adicionais": null
}
Erro
}
"codigo": 999,
"mensagem": "Erros no processamento de alguns registros.",
"ticket": "5344f4a1-a4f1-4f84-a504-f77cbd3c0121",
"erros": [
{
"Entidade": "GrupoPreçoCliente",
"Item": "0",
"Erro": "Campo partnumber obrigatório."
}
],
"dados_adicionais": null
}
PostPlanosPagamento
Este método recebe os planos de pagamento possíveis.
URL: http://integracao.chleba.net/wsintegracao/PostPlanosPagamento
Método: PostPlanosPagamento
PARAMETROS DE ENTRADA: (devem ser inseridos no cabeçalho)
|
Parâmetro |
Tipo |
Info Adicional |
Obrigatório |
|
token |
String |
Sim |
|
|
login |
string |
Sim |
|
|
metodo |
String |
Sim |
EX:
|
Tabela de nome dos planos de pagamento |
|||
|
CNPJ |
Codigo |
Descrição |
% |
|
x |
1 |
à vista |
-1% |
|
x |
2 |
15 dias |
0 |
|
x |
3 |
30 dias |
1% |
|
x |
4 |
45 dias |
2% |
|
x |
5 |
60 dias |
3% |
|
x |
6 |
90 dias |
4% |
Dados do envio:
{
"Postplanopagamento": {
"planopagameto": [
{
"cnpj": "0090999900000130",
"codigo": "1",
"descricao": “à Vista”,
“percentual”:-1.00,
“padrao”:”S”,
“ativo”:true
},
{
"cnpj": "0090999900000130",
"codigo": "2",
"descricao": “15/30 dias” ,
“percentual”:2.00,
“padrao”:”N”,
“ativo”:false
}
]
}
}
Obs: A informação padrao = S deve ser enviada apenas para um registro por CNPJ. É nessa opção que o sistema vai fixar a opção principal de pagamento.
Sem Retorno
{
"codigo": 0,
"mensagem": "Operação efetuada com sucesso",
"ticket": "5f5b9288-9c1c-48d3-bf5d-0a9ab7010f31",
"erros": [],
"dados_adicionais": {
" Postplanopagamento ": []
}
}
PostPlanosPagamentoProduto
Este método recebe os produtos vinculados aos planos de pagamento. Desconto por CNPJ vinculado ao SKU.
URL: http://integracao.chleba.net/wsintegracao/PostPlanosPagamentoProduto
Método: PostPlanosPagamentoProduto
PARAMETROS DE ENTRADA: (devem ser inseridos no cabeçalho)
|
Parâmetro |
Tipo |
Info Adicional |
Obrigatório |
|
token |
String |
Sim |
|
|
login |
string |
Sim |
|
|
metodo |
String |
Sim |
EX:
|
Tabela de preço por produtos x prazo de pagamento |
||||
|
CNPJ |
SKU |
Código prazo |
Preço varejo |
Preço Atacado |
|
X |
7893500018469 |
1 |
R$ 7,00 |
R$ 6,00 |
|
x |
7893500018469 |
2 |
R$ 7,10 |
R$ 6,00 |
|
x |
7893500018469 |
3 |
R$ 7,20 |
R$ 6,00 |
|
x |
7893500018469 |
4 |
R$ 7,30 |
R$ 7,30 |
|
x |
7893500018469 |
5 |
R$ 7,40 |
R$ 7,40 |
|
x |
7893500018469 |
6 |
R$ 7,50 |
R$ 7,50 |
|
x |
7896036097595 |
1 |
R$ 7,00 |
R$ 7,00 |
|
x |
7896036097595 |
2 |
R$ 7,10 |
R$ 7,10 |
|
x |
7896036097595 |
3 |
R$ 7,20 |
R$ 7,20 |
|
x |
7896036097595 |
4 |
R$ 7,30 |
R$ 7,30 |
|
x |
7896036097595 |
5 |
R$ 7,40 |
R$ 7,40 |
|
x |
7896036097595 |
6 |
R$ 7,50 |
R$ 7,50 |
Dados do envio:
{
"PostplanopagamentoProduto": {
"planopagametoproduto": [
{
"cnpj": "0090999900000130",
"codigo": "1",
"sku": “7896036097595”,
“preco”:”7,30”,
“preco_atacado”:”6,30”
},
{
"cnpj": "7893500018469",
"codigo": "1",
"sku": “7896036097595”,
“preco”:”7,50” ,
“preco_atacado”:”6,30”
}
]
}
}
Sem Retorno:
{
"codigo": 0,
"mensagem": "Operação efetuada com sucesso",
"ticket": "5f5b9288-9c1c-48d3-bf5d-0a9ab7010f31",
"erros": [],
"dados_adicionais": {
" PostplanopagamentoProduto ": []
}
}
PostCobranca
Este método recebe todas as cobranças abertas por CNPJ, sendo pedido dentro do Ecommerce ou não.
URL: http://integracao.chleba.net/wsintegracao/PostCobranca
Método: PostCobranca
PARAMETROS DE ENTRADA: (devem ser inseridos no cabeçalho)
|
Parâmetro |
Tipo |
Info Adicional |
Obrigatório |
|
token |
String |
Sim |
|
|
login |
string |
Sim |
|
|
metodo |
String |
Sim |
Dados do envio:
{
"Postcobranca": {
"cobranca": [
{
“CPFCNPJ”:"10157523000000" ,
“NrFatura”:"988822" ,
“Parcela” :"1" ,
“datafatura”:"2020-05-01",
“DataVencimento”:"2020-05-10" ,
“Valor”:"1910,00" ,
“ValorParcela”:"1910,00",
“NrPedidoInernet":”0988”,
“LinkNFe”:"http://....",
"Link2viaboleto":http://,
“ativo”:true
},
{
“CPFCNPJ”:"10157523000000" ,
“NrFatura”:"988822" ,
“Parcela” :"1" ,
“datafatura”:"2020-05-01",
“DataVencimento”:"2020-05-10" ,
“Valor”:"1910,00" ,
“ValorParcela”:"1910,00",
“NrPedidoInernet":”0988”,
“LinkNFe”:"http://....",
"Link2viaboleto":”http:”,
“ativo”:true
}
]
}
}
Sem Retorno
{
"codigo": 0,
"mensagem": "Operação efetuada com sucesso",
"ticket": "5f5b9288-9c1c-48d3-bf5d-0a9ab7010f31",
"erros": [],
"dados_adicionais": {
" PostCobranca ": []
}
}