Escolar Documentos
Profissional Documentos
Cultura Documentos
Envio de Arquivo
Versão 3.0.1
01/02/2019
Sumário
Controle de versões ......................................................................................................................................................................................................... 2
INTRODUÇÃO ................................................................................................................................................................................................................... 3
ARQUITETURA DE COMUNICAÇÃO .................................................................................................................................................................................. 4
MODELO CONCEITUAL E OPERACIONAL ...................................................................................................................................................................... 4
ENDEREÇO DO WEB SERVICE (WSDL) .......................................................................................................................................................................... 4
PROCEDIMENTOS............................................................................................................................................................................................................. 5
DESCONTINUADOS ...................................................................................................................................................................................................... 5
A SER UTILIZADO .......................................................................................................................................................................................................... 5
C01 - TAG REGISTROS ................................................................................................................................................................................................ 10
C02 - TAG CABEÇALHO............................................................................................................................................................................................... 10
DETALHES DO CABECALHO .................................................................................................................................................................................... 10
C10 – TAG REGISTRO ................................................................................................................................................................................................. 11
DETALHES DO REGISTRO ........................................................................................................................................................................................ 12
TABELA I – Meio de Captura ..........................................................................................................................................................................................14
TABELA II – Modalidade .................................................................................................................................................................................................14
TABELA III – Moeda ........................................................................................................................................................................................................14
TABELA IV – Operadora..................................................................................................................................................................................................15
TABELA V – Produto .......................................................................................................................................................................................................16
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
Controle de versões
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
INTRODUÇÃO
Este manual tem como objetivo apresentar a definição das especificações e critérios técnicos necessários para a utilização do Web Service
disponibilizado pela Conciliadora para integração das informações dos clientes.
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
ARQUITETURA DE COMUNICAÇÃO
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
PROCEDIMENTOS
DESCONTINUADOS
Os seguintes procedimentos foram descontinuados:
1. A – WSEnviaXMLArquivoCliente
2. B – WSEnviaArquivoVendaCliente
3. C – WSEnviaArquivoCliente
A SER UTILIZADO
O procedimento a ser utilizado é o XMLVendaCliente.
Neste procedimento devem ser passados os seguintes parâmetros:
1. idEmpresa – Código do tipo inteiro fornecido pela Conciliadora;
2. sSenha – Fornecido pela Conciliadora;
3. sDadosXML – String contendo os dados no formato XML a serem enviados.
Para testes através de ferramentas como por exemplo: Postman, deve-se usar o Escaping Characters para SOAP XML ao passar o
sDadosXML.
Exemplo:
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
<ns1:XmlVendaCliente>
<ns1:idEmpresa>683</ns1:idEmpresa>
<ns1:sSenha>123456</ns1:sSenha>
<ns1:sDadosXML>
<registros>
<cabecalho>
<Empresa>683</Empresa>
<DataInicial>30/01/2019</DataInicial>
<DataFinal>30/01/2019</DataFinal>
<Versao>3</Versao>
<Lote>1</Lote>
<NomeSistema>SoftHouse - Software</NomeSistema>
</cabecalho>
<registro>
<Produto>5</Produto>
<DescricaoTipoProduto>MAESTRO</DescricaoTipoProduto>
<CodigoAutorizacao>000000</CodigoAutorizacao>
<DataVenda>30/01/2019</DataVenda>
<ValorVendaParcela>15.00</ValorVendaParcela>
<TotalVenda>15.00</TotalVenda>
<Taxa>0.00</Taxa>
<Parcela>1</Parcela>
<TotalDeParcelas>1</TotalDeParcelas>
<NSU>1</NSU>
<MeioCaptura>2</MeioCaptura>
</registro>
</registros>
</ns1:sDadosXML>
</ns1:XmlVendaCliente>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
COMPOSIÇÃO DO XML A SER ENVIADO
O XML a ser enviado deve ser gerado utilizando-se a codificação UTF-8 conforme o layout descrito a seguir:
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
Completar com zeros a
C15 CodigoAutorizacao Número da autorização da transação string Sim
esquerda até 6 posições
Código interno do Cliente que identifica a
C16 IdentificadorPagamento string Não -
transação dentro só sistema do mesmo
C17 DataVenda Data em que foi realizado a transação string Sim Data Formato: 00/00/0000
C18 DataVencimento Data prevista de pagamento da transação. string Não Data Formato: 00/00/0000
Valor bruto da parcela quando a transação for
C19 ValorVendaParcela parcelada se não informar o valor bruto da string Sim Formato: 0.00
transação
Valor líquido da parcela quando a transação
C20 ValorLiquidoParcela for parcelada se não informar o valor líquido string Não Formato: 0.00
da transação
C21 TotalVenda Total da transação realizada string Sim Formato: 0.00
Porcentagem da Taxa cobrada pela
C22 Taxa string Não Formato: 0.00
adquirente na transação (%)
Número da parcela em caso de transação
C23 Parcela string Sim Formato: 00
parcelada caso contrário informe zero.
Total de parcelas da transação se parcelada,
C24 TotalDeParcelas string Sim Formato: 00
caso contrário informe zero.
Valor bruto da parcela quando a transação for
C25 ValorBrutoMoeda parcelada se não informar o valor bruto da decimal Não Formato: 0.00
transação quando estrangeira
Valor líquido da parcela quando a transação
C26 ValorLiquidoMoeda for parcelada se não informar o valor líquido decimal Não Formato: 0.00
da transação quando estrangeira
C27 CotacaoMoeda Valor da cotação utilizado na transação decimal Não Formato: 0.00
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
C28 Moeda Código da moeda string Não Consulte TABELA III
C29 NSU Número sequencial Unico da transação string Sim -
Transaction Id – Número de identificação da
C30 TID string Não -
transação de e-commerce na adquirente
Número do terminal no qual a transação foi
C31 Terminal string Não -
realizada
C32 MeioCaptura Meio utilizado para efetuar a transação string Sim Consulte TABELA I
C33 Operadora Adquirente utilizada para efetuar a transação string Não Consulte TABELA IV
C34 Modalidade Modalidade na qual a transação foi realizada string Não Consulte TABELA II
PS. Todas as tag’s que não forem obrigatórias não precisam ser enviadas.
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
C01 - TAG REGISTROS
O arquivo XML deve ser iniciado pela Tag <registros> e finalizado pela Tag </registros>
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
Turno = 03, Caixa = 4, número sequencial único = 001 então o lote iria ficar como 034001
Turno = 02, Caixa = 3, número sequencial único = 001 então o lote iria ficar como 023001
PS. Sempre que houver necessidade de reenviar as vendas (inclusão de venda não enviada anteriormente, correção de alguma
informação, exclusão de venda enviada errada), o lote deverá ser reenviado novamente com todas as vendas. (Para excluir uma
venda do lote, basta enviar o lote sem a venda a ser excluída).
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
DETALHES DO REGISTRO
Vendas Parceladas
Em caso de vendas parceladas todas as parcelas devem ser enviadas no arquivo XML, sendo cada parcela em uma
Tag <registro> conforme exemplo a seguir.
Ex: Venda de R$100,00 parcelada em duas vezes:
Primeira parcela:
<registro>
<Produto>00</Produto>
<DescricaoTipoProduto>XXXXXXXXXXXXXX</DescricaoTipoProduto>
<CodigoAutorizacao>000000</CodigoAutorizacao>
<IdentificadorPagamento>XXXXXXXXXX</IdentificadorPagamento>
<DataVenda>05/11/2015</DataVenda>
<DataVencimento>05/12/2015</DataVencimento>
<ValorVendaParcela>50.00</ValorVendaParcela>
<ValorLiquidoParcela>49.50</ValorLiquidoParcela>
<TotalVenda>100.00</TotalVenda>
<Taxa>1.00</Taxa>
<Parcela>1</Parcela>
<TotalDeParcelas>2</TotalDeParcelas>
<NSU>123</NSU>
<TID>00000000000000000</TID>
<Terminal>0</Terminal>
<MeioCaptura>1</MeioCaptura>
<Operadora>1</Operadora>
<Modalidade>2</Modalidade>
</registro>
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
Segunda parcela:
<registro>
<Produto>00</Produto>
<DescricaoTipoProduto>XXXXXXXXXXXXXX</DescricaoTipoProduto>
<CodigoAutorizacao>000000</CodigoAutorizacao>
<IdentificadorPagamento>XXXXXXXXXX</IdentificadorPagamento>
<DataVenda>05/11/2015</DataVenda>
<DataVencimento>05/01/2016</DataVencimento>
<ValorVendaParcela>50.00</ValorVendaParcela>
<ValorLiquidoParcela>49.50</ValorLiquidoParcela>
<TotalVenda>100.00</TotalVenda>
<Taxa>1.00</Taxa>
<Parcela>2</Parcela>
<TotalDeParcelas>2</TotalDeParcelas>
<NSU>123</NSU>
<TID>00000000000000000</TID>
<Terminal>0</Terminal>
<MeioCaptura>1</MeioCaptura>
<Operadora>1</Operadora>
<Modalidade>2</Modalidade>
</registro>
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
TABELA I – Meio de Captura TABELA II – Modalidade TABELA III – Moeda
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
TABELA V – Produto
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
301 TICKET ALIMENTACAO 322 GOODCARD DEBITO
302 VR ALIMENTACAO Obsoleto 323 GOODCARD CREDITO
303 TICKET REFEICAO 324 GOODCARD CREDITO PARCELADO
304 TICKET PAPEL 325 GOODCARD VOUCHER
305 Banricard Débito 326 TICKET
306 Banricard Crédito 327 TICKET PARCELADO
307 BANRICARD PARCELADO 328 POLICARD TEF (Debito)
308 VERDECARD DEBITO 329 SODEXO REFEICAO
309 VERDECARD CREDITO 330 SODEXO ALIMENTACAO
310 VERDECARD PARCELADO 331 SODEXO PREMIUM PASS
311 Banricompras Débito 332 SODEXO GIFT PASS
312 Banricompras Crédito 333 SODEXO CULTURA PASS
313 BANRICOMPRAS PARCELADO 334 SODEXO MOBILITY PASS CARRO
314 Banricompras Pré-Datado 335 TICKET CAR
315 ECX CARD CREDITO 336 ELO CULTURA
316 ECX CARD PARCELADO 337 CARTAO SHELL
317 VISA CREDITO CONVERSOR DE MOEDA 338 AVISTA CREDITO
318 MASTER PEDÁGIO 339 PAGAR.ME DEBITO
319 ELO CARNÊ 340 PAGAR.ME CREDITO
320 MASTER CARNÊ 341 PAGAR.ME PARCELADO
321 MASTERCARD CREDITO CONVERSOR 342 BANRICARD VOUCHER
MOEDA
344 BANESCARD CREDITO
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
345 BANESCARD VOUCHER 367 VALECARD
346 FORTBRASIL DEBITO 368 DA CASA DEBITO
347 FORTBRASIL CREDITO 369 DA CASA CREDITO
348 FORTBRASIL VOUCHER 370 DA CASA VOUCHER
349 NUTRICASH DEBITO 371 CABAL VOUCHER
350 SENFF DEBITO 372 VR ALIMENTACAO
351 SENFF CREDITO 373 VR AUTO
352 SENFF VOUCHER 374 VR CULTURA
353 NUTRICASH CREDITO 375 VR REFEICAO
354 NUTRICASH VOUCHER 376 Rede Uze Credito
355 POLICARD CREDITO 377 Rede Uze Debito
356 POLICARD TITULO 378 Rede Uze Voucher
357 POLICARD CONVENIO 379 Rede Uze Pre Pago
358 POLICARD CREDITO DIGITAL 380 Valecard Credito
359 POLICARD CUPOM ELETRONICO 381 Valecard Debito
360 POLICARD CUPOM PAPEL 382 Valecard Voucher
361 Green Card Débito 383 Tricard Credito
362 Green Card Crédito 384 Planvale Titulo
363 GREEN CARD VOUCHER 385 Planvale Convênio
364 SOLLUS 386 Planvale Credito Digital
365 Coopercard Débito 387 Planvale Compras
366 Coopercard Crédito 388 Planvale TEF
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
389 Planvale Alimentação 413 GetNet Cupom Eletrônico
390 Planvale Premiação 414 GetNet Cupom Papel
391 Banescard Titulo 415 Sorocred Voucher
392 Banescard Convenio 416 Sorocred Crediário
393 Banescard Credito Digital 417 PagSeguro Cartão de Crédito
394 Banescard Credito 418 PagSeguro Boleto
395 Banescard Debito 419 PagSeguro Débito Online (TEF)
396 Banescard Cupom Eletronico 420 Saldo PagSeguro
397 Banescard Cupom Papel 421 PagSeguro Oi Paggo
398 Valecard Titulo 422 PagSeguro Depósito em Conta
399 Valecard Convenio 423 Safra Pay Crédito
400 Valecard Credito Digital 424 Safra Pay Débito
401 Valecard Cartão de Credito 425 Safra Pay Voucher
402 Valecard TEF 426 PagSeguro Cartão de Débito
403 Valecard Cupom Eletrônico 427 Verocheque Crédito
404 Valecard Cupom Papel 428 Verocheque Débito
405 BNDES Master 429 Verocheque Voucher
406 BNDES Visa 430 PagSeguro Voucher
409 GetNet Recorrente 431 Convcard Benefício
410 GetNet Título 432 Valemais Credito
411 GetNet Convenio 433 Valemais Debito
412 GetNet Credito Digital 434 Valemais Voucher
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br
435 Valeshop Débito 451 BonusCred Alimentação
436 Valeshop Crédito 452 BonusCred Refeição
437 Valeshop Voucher 453 BonusCred Outros
438 Brasil Convênio Débito 454 Cartão Pré-Datado Alimentação
439 Brasil Convênio Crédito 455 Cartão Pré-Datado Refeição
440 Brasil Convênio Voucher 456 Cartão Pré-Datado Outros
441 Boleto 457 Alimentare Alimentação
442 BrasilCard Débito 458 Alimentare Refeição
443 BrasilCard Crédito 459 Alimentare Outros
444 BrasilCard Voucher 460 Bigcard Crédito
445 FIt Card Débito 461 Bigcard Débito
446 FIt Card Crédito 462 Bigcard Voucher
447 FIt Card Voucher 463 Infocard Crédito
448 NutriCard Alimentação 464 Infocard Débito
449 NutriCard Refeição 465 Infocard Voucher
450 NutriCard Outros 466 Credsystem Voucher
Conciliadora de cartões
Avenida do Contorno, 3513 – 5º Andar – Santa Efigênia – BH – MG
www.conciliadora.com.br