Pré-requisitos
Campos de retorno
Campo | Tipo | Formato | Descrição | Obrigatório? |
---|---|---|---|---|
Data | VarChar(8) | yyyyMMdd | Data da solicitação ex: 20200729 | Sim |
Hora | VarChar(6) | hhmmss | Hora da solicitação ex: 160055 | Sim |
CodigoSistemaSatelite | VarChar(10) | Cliente Solicita com time de Serviços Live | Sim | |
Chave | Guid | Chave de acesso Obtida no método ObterChaveAcesso | Sim | |
Numero | String | 0AAMMDDHHMMSSMMM | Número do Ticket de entrada, ver detalhes no item "DICA 01" acima | Sim |
Documentos | List | Objetos de Ticket(Documento) no formato da mensagem ver detalhes abaixo | Sim |
Importante
Os parâmetros devem ser passados na ordem apresentada abaixo.
Documentos (List)
Campos Produto | Tipo | Descrição/ Formato | Obrigatório |
---|---|---|---|
NumeroSequencia | Varchar(6) | Numero sequencia do documento implementar a cada documento. Ex: 1 | Sim |
Ativo | Boolean | Situação do produto. | Não |
CNPJFornecedor | Varchar(20) | CNPJ do fornecedor do produto. | Não |
CNPJFornecedorEscalaNaoRelevante | Varchar(20) | CNPJ do Fornecedor da escala não relevante *Obrigatório caso o campo “EscalaNaoRelevante” esteja como “true”. | *Não |
Classificacoes | List | Lista dos classificadores do produto. | Não |
CodigoAlternativo | Varchar(20) | Código alternativo do produto. | Sim |
CodigoClassificacaoFiscal | Varchar(20) | Código da classificação fiscal do produto NCM (Nomenclatura Comum do Mercosul). Ex: 96099000 | Sim |
CodigoItemServico | Varchar(4) | Código de item serviço do produto. | Não |
CodigoPadrao | Varchar(20) | Código padrão do produto. | Sim |
CodigoPrincipal | Varchar(18) | Código principal do Live. | Não |
CodigoProdutoPorFornecedor | Varchar(20) | Código de produto por fornecedor. | Não |
DescontoMaximo | Double | Desconto máximo do produto. | Não |
DescontoVendaPromocao | Double | Desconto de venda em promoção do produto. | Não |
Descricao | Varchar(200) | Descrição do produto. | Sim |
DescricaoResumida | Varchar(50) | Descrição resumida do produto. | Sim |
DescricaoTipoProduto | Varchar(50) | Descrição do Tipo de Produto. Os valores podem variar de acordo com o cadastro realizado por cada usuário. Os tipos mais comuns e que geralmente já estão cadastrados são: Consumo Os valores devem ser passados exatamente como no cadastro do sistema. | Sim |
EscalaNaoRelevante | Boolean | Informa se o produto pertence a uma escala não relevante. | Não |
IPPT | Varchar(1) | Código IPPT do produto. | Não |
IndicadorArredondamento | Boolean | Indicador de arredondamento. | Não |
InserirClassificacao | Boolean | Sinalizador de inclusão da classificação do produto. | Não |
PesoBruto | Double | Peso bruto do produto. | Não |
PesoLiquido | Double | Peso líquido do produto. | Não |
PrecoCentralizado | Boolean | Sinalizador de preço centralizado. | Não |
ProdutoFornecedores | List | Lista de produto fornecedor | Não |
QuantidadeCasaDecimal | Int | Quantidade de casas decimais de quantidade do produto. | Não |
QuantidadeCasaDecimalValor | Int | Quantidade de casas decimais de valor do produto. | Não |
QuantidadeMultiplaCompra | Double | Quantidade de multiplicidade de compra do produto. | Não |
SiglaUnidadeMedida | Varchar(10) | Unidade de medida do produto. Os valores podem variar de acordo com o cadastro realizado por cada usuário. Os tipos mais comuns e que geralmente já estão cadastrados são: UN CX PC KG Os valores devem ser passados exatamente como no cadastro do sistema. | Sim |
SituacaoTributariaOrigem | Situação tributária do produto. Conforme exemplos abaixo: Nacional EstrangeiraImportacaoDireta EstrangeiraAdquiridaMercadoInterno NacionalSupQuarentaPorCento NacionalProdutivo NacionalInfOuIgualQuarentaPorCento EstrangeiraImpDiretaSemSimilar EstrangeiraAdqMercadoIntSemSimilar NacionalSupSetentaPorCento O valor é case sensitive e deve ser passado exatamente como exemplo acima. | Não | |
SituacaoVenda | Boolean | Ativa ou desativa o produto para venda | Não |
Classificacoes | Tipo | Descrição / Formato | Obrigatório? |
DescricaoClassificacao | String(50) | Descrição da classificação de produto. Deve estar cadastrado previamente. | Não |
DescricaoTipoClassificacao | String(50) | Descrição do tipo de classificador da classificação de produto. Deve estar cadastrado previamente. | Não |
ProdutoFornecedores | Tipo | Descrição / Formato | Obrigatório? |
AceitaPedidoCompra | Boolean | Loja aceita pedido de compra | Não |
CNPJ_CPF | Varchar(20) | CNPJ da loja. | Não |
CodigoFornecedor | Varchar(10) | Código do fornecedor | Não |
Consignado | Boolean | Permite venda consignada | Não |
ProdutoFornecedorUnidadesMedida | List | Lista de Unidades Medidas do Produto fornecedor | Não |
QuantidadeMultiplaCompra | Float | Quantidade de multiplicidade de compra do produto. | Não |
QuantidadePacoteCaixa | Float | Quantidade de pacotes por caixa do produto. | Não |
QuantidadeUnidadeCaixa | Float | Quantidade de unidades por caixa do produto. | Não |
ProdutoFornecedorUnidadesMedida | Tipo | Descrição / Formato | Obrigatório? |
FatorConversao | Double | Fator de conversão | Sim |
SiglaUnidadeMedida | Varchar(10) | Sigla da unidade de medida | sim |
Exemplo de Chamada do Método
Exemplo de chamada e retorno do método ManterClienteLC_Integracao
1 - Exemplo somente com campos obrigatórios:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/" xmlns:ren="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data" xmlns:ren1="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <soapenv:Header/> <soapenv:Body> <liv:ManterProdutoLC_Integracao> <liv:produto xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <ren1:Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</ren1:Chave> <ren1:CodigoSistemaSatelite>XXXXXXXXX</ren1:CodigoSistemaSatelite> <ren1:Data>20220124</ren1:Data> <ren1:Hora>100000</ren1:Hora> <ren1:Numero>0191205115556676</ren1:Numero> <ren1:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <b:anyType i:type="a:LC_Produto"> <a:NumeroSequencia>1</a:NumeroSequencia> <a:Ativo>true</a:Ativo> <a:CNPJFornecedor>07278350000163</a:CNPJFornecedor> <a:CNPJFornecedorEscalaNaoRelevante>07278350000163</a:CNPJFornecedorEscalaNaoRelevante> <a:Classificacoes> <b:anyType i:type="a:LC_ClassificacaoProduto"> <a:DescricaoClassificacao>Produto</a:DescricaoClassificacao> <a:DescricaoTipoClassificacao>MODELO</a:DescricaoTipoClassificacao> </b:anyType> </a:Classificacoes> <a:CodigoAlternativo>999888011</a:CodigoAlternativo> <a:CodigoClassificacaoFiscal>96099000</a:CodigoClassificacaoFiscal> <a:CodigoItemServico/> <a:CodigoPadrao>999888011</a:CodigoPadrao> <a:CodigoPrincipal>999888011</a:CodigoPrincipal> <a:CodigoProdutoPorFornecedor>999888011</a:CodigoProdutoPorFornecedor> <a:DescontoMaximo>100</a:DescontoMaximo> <a:DescontoVendaPromocao>100</a:DescontoVendaPromocao> <a:Descricao>PRODUTO TESTE SOAP CONNECTOR </a:Descricao> <a:DescricaoResumida>PRODUTO TESTE SOAP CONNECTOR </a:DescricaoResumida> <a:DescricaoTipoProduto>REVENDA</a:DescricaoTipoProduto> <a:EscalaNaoRelevante>true</a:EscalaNaoRelevante> <a:IPPT>0</a:IPPT> <a:IndicadorArredondamento>true</a:IndicadorArredondamento> <a:InserirClassificacao>true</a:InserirClassificacao> <a:PesoBruto>0</a:PesoBruto> <a:PesoLiquido>0</a:PesoLiquido> <a:PrecoCentralizado>true</a:PrecoCentralizado> <a:ProdutoFornecedores> <b:anyType i:type="a:LC_ProdutoFornecedor"> <a:AceitaPedidoCompra>true</a:AceitaPedidoCompra> <a:CNPJ_CPF>07278350000163</a:CNPJ_CPF> <a:CodigoFornecedor>2</a:CodigoFornecedor> <a:Consignado>true</a:Consignado> <a:Principal>false</a:Principal> <a:ProdutoFornecedorUnidadesMedida> <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida"> <a:FatorConversao>1.10</a:FatorConversao> <a:SiglaUnidadeMedida>PC</a:SiglaUnidadeMedida> </b:anyType> <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida"> <a:FatorConversao>1.20</a:FatorConversao> <a:SiglaUnidadeMedida>CX</a:SiglaUnidadeMedida> </b:anyType> </a:ProdutoFornecedorUnidadesMedida> <a:QuantidadeMultiplaCompra>10.20</a:QuantidadeMultiplaCompra> <a:QuantidadePacoteCaixa>10.20</a:QuantidadePacoteCaixa> <a:QuantidadeUnidadeCaixa>10.20</a:QuantidadeUnidadeCaixa> <a:TemTaxaServico>true</a:TemTaxaServico> </b:anyType> </a:ProdutoFornecedores> <a:QuantidadeCasaDecimal>2</a:QuantidadeCasaDecimal> <a:QuantidadeCasaDecimalValor>2</a:QuantidadeCasaDecimalValor> <a:QuantidadeMultiplaCompra>2</a:QuantidadeMultiplaCompra> <a:SiglaUnidadeMedida>UN</a:SiglaUnidadeMedida> <a:SituacaoTributariaOrigem>Nacional</a:SituacaoTributariaOrigem> <a:SituacaoVenda>true</a:SituacaoVenda> </b:anyType> </ren1:Documentos> </liv:produto> </liv:ManterProdutoLC_Integracao> </soapenv:Body> </soapenv:Envelope>
2 - Exemplo com demais campos:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/" xmlns:ren="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data" xmlns:ren1="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <soapenv:Header/> <soapenv:Body> <liv:ManterProdutoLC_Integracao> <liv:produto xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <ren:ClassID>?</ren:ClassID> <ren:Creation>2019-11-28T00:00:00</ren:Creation> <ren:LastUpdate>2019-11-28T00:00:00</ren:LastUpdate> <ren1:Chave>ec6e631b-9f93-4076-96da-a30e97423b6e</ren1:Chave> <ren1:CodigoSistemaSatelite>2200002661</ren1:CodigoSistemaSatelite> <ren1:Data>20191127</ren1:Data> <ren1:Hora>120000</ren1:Hora> <ren1:Numero>0191205115556676</ren1:Numero> <ren1:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <b:anyType i:type="a:LC_Produto"> <a:NumeroSequencia>1</a:NumeroSequencia> <a:Ativo>true</a:Ativo> <a:CNPJFornecedor>07278350000163</a:CNPJFornecedor> <a:CNPJFornecedorEscalaNaoRelevante>07278350000163</a:CNPJFornecedorEscalaNaoRelevante> <a:Classificacoes> <b:anyType i:type="a:LC_ClassificacaoProduto"> <a:DescricaoClassificacao>Royal canin</a:DescricaoClassificacao> <a:DescricaoTipoClassificacao>MODELO</a:DescricaoTipoClassificacao> </b:anyType> </a:Classificacoes> <a:CodigoAlternativo>999888011</a:CodigoAlternativo> <a:CodigoClassificacaoFiscal>96099000</a:CodigoClassificacaoFiscal> <a:CodigoItemServico/> <a:CodigoPadrao>999888011</a:CodigoPadrao> <a:CodigoPrincipal>999888011</a:CodigoPrincipal> <a:CodigoProdutoPorFornecedor>999888011</a:CodigoProdutoPorFornecedor> <a:DescontoMaximo>100</a:DescontoMaximo> <a:DescontoVendaPromocao>100</a:DescontoVendaPromocao> <a:Descricao>PRODUTO TESTE SOAP CONNECTOR </a:Descricao> <a:DescricaoResumida>PRODUTO TESTE SOAP CONNECTOR </a:DescricaoResumida> <a:DescricaoTipoProduto>REVENDA</a:DescricaoTipoProduto> <a:EscalaNaoRelevante>true</a:EscalaNaoRelevante> <a:IPPT>0</a:IPPT> <a:IndicadorArredondamento>true</a:IndicadorArredondamento> <a:InserirClassificacao>true</a:InserirClassificacao> <a:PesoBruto>0</a:PesoBruto> <a:PesoLiquido>0</a:PesoLiquido> <a:PrecoCentralizado>true</a:PrecoCentralizado> <a:ProdutoFornecedores> <b:anyType i:type="a:LC_ProdutoFornecedor"> <a:AceitaPedidoCompra>true</a:AceitaPedidoCompra> <a:CNPJ_CPF>07278350000163</a:CNPJ_CPF> <a:CodigoFornecedor>2</a:CodigoFornecedor> <a:Consignado>true</a:Consignado> <a:Principal>false</a:Principal> <a:ProdutoFornecedorUnidadesMedida> <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida"> <a:FatorConversao>1.10</a:FatorConversao> <a:SiglaUnidadeMedida>PC</a:SiglaUnidadeMedida> </b:anyType> <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida"> <a:FatorConversao>1.20</a:FatorConversao> <a:SiglaUnidadeMedida>CX</a:SiglaUnidadeMedida> </b:anyType> </a:ProdutoFornecedorUnidadesMedida> <a:QuantidadeMultiplaCompra>10.20</a:QuantidadeMultiplaCompra> <a:QuantidadePacoteCaixa>10.20</a:QuantidadePacoteCaixa> <a:QuantidadeUnidadeCaixa>10.20</a:QuantidadeUnidadeCaixa> <a:TemTaxaServico>true</a:TemTaxaServico> </b:anyType> </a:ProdutoFornecedores> <a:QuantidadeCasaDecimal>2</a:QuantidadeCasaDecimal> <a:QuantidadeCasaDecimalValor>2</a:QuantidadeCasaDecimalValor> <a:QuantidadeMultiplaCompra>2</a:QuantidadeMultiplaCompra> <a:SiglaUnidadeMedida>UN</a:SiglaUnidadeMedida> <a:SituacaoTributariaOrigem>Nacional</a:SituacaoTributariaOrigem> <a:SituacaoVenda>true</a:SituacaoVenda> </b:anyType> </ren1:Documentos> </liv:produto> </liv:ManterProdutoLC_Integracao> </soapenv:Body> </soapenv:Envelope>
Retorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ManterProdutoLC_IntegracaoResponse xmlns="http://LiveConnector/"> <ManterProdutoLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/> </ManterProdutoLC_IntegracaoResponse> </s:Body> </s:Envelope>
Retorno xml - Soap:
Retorno Raw - Http Soap: