Visão Geral

O Agiliza é a ferramenta de conciliação da Braspag criada para que você possa conferir o fluxo financeiro das vendas do seu estabelecimento. Nele, é possível cruzar o seu registro de vendas com o os valores pagos pela credenciadora dos pagamentos das transações de cartão de crédito, débito e voucher.

O Agiliza é a mais completa solução para o controle das transações feitas com cartão de crédito, débito e voucher, independente se o canal é e-commerce, call center ou mundo físico. O Agiliza funciona baseado em três pilares principais: importação de vendas, processamento do extrato e arquivo de saída.

Importação de Vendas

Ao importar suas vendas, você fornece para a Braspag as vendas processadas em seu sistema de pedidos. Se você processa suas transações com o Pagador Braspag (nosso gateway de pagamentos) ou com a API Cielo E-commerce, a importação é feita automaticamente.

Se você não é cliente do Pagador Braspag ou da API Cielo E-commerce, é necessário configurar a importação do Arquivo de Vendas da sua loja para o Agiliza. Você pode fazer essa configuração através da integração com a nossa API ou manualmente via portal do cliente Agiliza.

Processamento do Extrato

A sua credenciadora enviará para o Agiliza os extratos das vendas da sua loja. Após receber o seu arquivo de vendas e o extrato da credenciadora, o Agiliza começará o processo de conciliação.

Conciliar uma transação é o processo de identificação de uma venda registrada pela sua loja dentro do extrato da credenciadora, o que indica o processamento correto da transação dentro da credenciadora e serve para conferência do que a sua loja receberá em sua conta corrente, bem como todos os eventos possíveis para aquela venda, como antecipações, estornos e chargebacks, entre outros.

O Agiliza hoje suporta as principais credenciadoras do mercado:

• Cielo
• Rede
• Getnet
• GlobalPayments
• PagSeguro
• SafraPay
• Stone
• VR
• Valecard
• Banrisul
• BIN
• Mercado Pago
• Alelo
  

  Cada credenciadora possui layouts e eventos específicos em seu extrato. As especificidades de cada credenciadora podem ser conferidas em Informações sobre as adquirentes, tanto para CSV quanto para XML.

Arquivo de Saída

Por último, uma vez que todas as vendas importadas foram conciliadas corretamente com base no extrato da credenciadora, é possível gerar um arquivo de saída, em layout próprio da Braspag, para ser importado em ERPs ou quaisquer outros sistemas de gestão de vendas. Assim, é possível ter todo o ciclo de vida de uma transação atualizado diariamente, melhorando o controle financeiro da sua empresa.

Glossário

Registro de Recebíveis

O Registro de Recebíveis trouxe uma mudança na forma como os valores que uma loja tem a receber são liquidados e antecipados. Com isso, a conciliação financeira passa a ser feita entre as suas vendas e os valores de recebíveis registrados para o seu CPF ou CNPJ.

O que é o Registro de Recebíveis?

O Registro de Recebíveis está em vigor desde 07/06/2021, com a resolução nº 4.734/2019 do Conselho Monetário Nacional (CNM) e a Circular nº 3.952/2019 do Banco Central do Brasil.

Com isso, as credenciadoras e subcredenciadoras precisam registrar os recebíveis de cartão dos estabelecimentos em uma entidade registradora, que é responsável por disponibilizar as informações dos recebíveis entre financiadores.

O objetivo do registro é dar mais transparência e segurança para as operações de crédito e de antecipação de recebíveis. A UR registrada garante o valor que o estabelecimento tem disponível para negociação e permite, por exemplo, um contrato com uma instituição financeira com a qual não tenha relacionamento.

Qual é o papel das credenciadoras e subcredenciadoras?

As instituições credenciadoras devem registrar as agendas de recebíveis e os contratos de recebíveis negociados de seus usuários nas registradoras.

Quem são as registradoras?

São as entidades responsáveis pela organização, segurança e visibilidade dos recebíveis de cartões. As registradoras compõem o sistema de registro e disponibilizam as informações dos recebíveis para financiadores e credenciadoras, mediante autorização do usuário final recebedor (opt-in).

Financiadores

São instituições financeiras e não financeiras que podem comprar os recebíveis.

URs: as Unidades de Recebíveis

As URs são os valores que uma loja tem a receber por suas vendas. As URs são o resultado do agrupamento das seguintes informações:

• Data de liquidação;
• Arranjo de pagamento, que é a combinação entre o produto (crédito e débito) e a bandeira;
• Credenciadora (ou subcredenciadora);
• CPF ou CNPJ do recebedor.

O que mudou com o Registro de Recebíveis?

As principais novidades são a forma como sua loja visualiza o valor que tem para receber e a antecipação de recebíveis.

Antes, era possível acompanhar o ciclo de uma transação desde a captura até a liquidação. Hoje, as antecipações e gravames não são acompanhados individualmente até a liquidação, porque os valores que uma loja tem para receber são agrupados nas Unidades de Recebíveis.

Também antes do registro, a antecipação de recebíveis era feita pela antecipação de parcelas que seriam liquidadas no futuro. Mas desde o início do Registro de Recebíveis a antecipação é feita por valores (URs) que uma loja tem a receber. Além disso, é possível antecipar recebíveis com qualquer credenciadora.

Como visualizar os seus recebíveis

Gravame

O gravame é um registro que informa que um recebível foi dado como garantia em algum contrato ou negociação, por exemplo, a contratação de linhas de crédito num banco. O valor gravamado impede que o mesmo recebível seja dado em garantia em mais de uma operação. A liquidação do gravame é feita na conta do estabelecimento.

Crédito de gravame: é o valor dado como garantia pelo estabelecimento comercial e que será liquidado conforme a instrução do banco com o qual negociou.

Débito de gravame: é o lançamento na agenda do estabelecimento que corresponde a um saldo que estava livre de negociação e que agora foi negociado. Sinaliza que o valor não será liquidado pela credenciadora, mas sim pela instituição com a qual os recebíveis foram negociados.

Cessão

É a negociação de antecipação de recebíveis por troca de titularidade, ou seja, a UR de um estabelecimento passa a pertencer ao financiador. Com isso, a liquidação será feita no domicílio bancário do financiador.

Cessão fumaça

É uma cessão a constituir. Quando a loja não possui agenda futura de URs, a cessão será baseada no histórico de URs da loja e as URs que a vier a construir estarão comprometidas com essa cessão.

Funcionamento do Agiliza

O processo de conciliação de transações consiste no cruzamento dos dados enviados pela credenciadora com os dados das vendas informados pela loja. A Braspag recebe todos os eventos relativos a cada transação, como pagamentos, parcelamentos, estornos, chargebacks e antecipações, entre outros. Fazemos a conciliação tanto da venda como um todo, quanto dos eventos.

Uma transação pode estar conciliada, porém ter um ou mais eventos não conciliados. É preciso ter atenção à conciliação de todo o ciclo de vida de uma transação.

Assim, montamos a sua agenda financeira, com tudo o que sua loja vendeu, recebeu e irá receber, ao longo do tempo.

Tipos de eventos de um extrato

Veja abaixo a lista com todos os eventos que podem ser exibidos no seu extrato.

• Pagamentos em transações;
• Pagamentos em lote;
• Ajuste;
• Tarifa de serviços;
• Desagendamentos;
• Estornos;
• Chargebacks;
• Acelerações;
• Débito de cessão;
• Débito de gravame;
• Cessão fumaça;
• Crédito de cessão;
• Crédito de gravame;
• Débito compensação de valores;
• Crédito compensação de valores;
• Estorno débito de cessão;
• Estorno crédito de cessão;
• Estorno débito de gravame;
• Estorno crédito de gravame;
• Débito devido a compensação de cancelamento de transação em operação;
• Crédito devido a compensação de cancelamento de transação em operação;
• Débito de penhora;
• Crédito de penhora;
• Estorno de débito de penhora;
• Estorno de crédito de penhora;
• Débito devido a compensação de cancelamento em operação;
• Crédito devido a compensação de cancelamento em operação;
• Pagamentos de valores retidos;
• Débitos de valores retidos;
• Pagamentos de vendas antecipadas;
• Débitos de antecipação de vendas.

Agora, acompanhe o detalhamento dos principais eventos do seu extrato.

Vendas

Quando uma venda é realizada, via maquininha de cartão (POS), e-commerce, TEF ou outro canal, essa venda será informada no extrato da credenciadora com uma previsão de pagamento. Os dados gerais de uma venda serão informados, tais como:

• Valor bruto;
• Valor líquido (já descontada a taxa da credenciadora);
• Identificadores da venda (utilizados para cruzarmos a venda do lojista com o registro da credenciadora);
• Parcelas;
• Data prevista para realização de cada um dos eventos financeiros daquela venda.

Recebimento

É o evento que ocorre na data em que o pagamento de uma venda ou parcela de uma venda é creditado na conta do lojista, também conhecido como realização de pagamento. Normalmente é a confirmação de uma previsão já existente.

Antecipações

No processo de antecipação, o lojista solicita à credenciadora para antecipar os recebíveis que ele possui em sua agenda financeira. Por exemplo, caso você tenha uma venda que foi parcelada em 10 vezes, e você já recebeu o pagamento da primeira parcela, você poderá solicitar a antecipação do pagamento das nove parcelas restantes, pagando uma taxa para a realização desta operação.

Ajustes

Ajustes são eventos que ocorrem numa venda já finalizada. Dentre os ajustes possíveis, temos:

• Estornos: quando o lojista solicita a devolução ao comprador de uma venda já realizada;
• Chargebacks: quando o comprador não reconhece uma cobrança em seu cartão e a contesta diretamente no seu banco;
• Reagendamento: quando uma venda tem previsão de pagamento para uma data e, por algum motivo, será necessário mudar esta previsão.

Aceleração

Aceleração de parcela ocorre quando é realizada uma manutenção no plano parcelado, como cancelamento, chargeback ou alteração na quantidade de parcelas da venda. A mesma movimentação ocorre para os débitos de antecipação. Como exemplo, quando uma venda parcelada sofre chargeback, a credenciadora irá acelerar todas as parcelas ainda pendentes antes de realizar o chargeback. Isto impede que exista um furo na agenda financeira do cliente. Não está disponível para todas as credenciadoras.

Tarifa e Taxa

A tarifa é uma variação da taxa. Ambos são valores acordados entre o lojista e a credenciadora que serão cobrados a cada transação, e podem diferir entre crédito, débito e boleto, compra à vista ou parcelada e bandeira. A taxa é uma porcentagem, enquanto a tarifa é um valor fixo. Se a credenciadora oferece a tarifa, todas as transações terão o desconto de um valor fixo; se for a taxa, a cobrança será de uma porcentagem.

Mensalidade

Corresponde ao aluguel e manutenção da maquininha (POS) cobrado pela credenciadora e é considerado um ajuste. No Agiliza, a mensalidade é recorrente e tem data determinada para acontecer.

Valor Retido

Se um estabelecimento antecipa todo o valor que tem para receber é possível que, devido a estornos e chargebacks, fique com valor de crédito inferior aos débitos agendados. Para evitar essa situação, chamada de debit balance, a credenciadora pode reter um valor em uma operação de antecipação.

Importação das Vendas

Para que a conciliação funcione corretamente, é importante que as suas vendas sejam carregadas para o Agiliza.

Cliente Braspag e Cielo

Se você é cliente do gateway de pagamento Pagador Braspag ou usa a API Cielo E-commerce ou possui as maquininhas da Cielo (mundo físico), as suas vendas são importadas automaticamente pelo Agiliza mediante aceite do termo de concessão, durante a contratação do serviço. Neste manual, você pode ir direto para os tópicos sobre o arquivo de fluxo de caixa (arquivo de saída) em XML ou CSV.

Cliente de outros gateways e credenciadoras

Se você é cliente de outros gateways ou possui a maquininha (POS) de outras credenciadoras (que não sejam Cielo), você deverá fazer a importação das suas vendas. O carregamento das vendas para o Agiliza pode ser feito na Edição de Loja no portal do cliente Agiliza, por integração com a API Agiliza, transferência via SFTP ou transferência via webservice SOAP.

Importação via portal do cliente Agiliza

O layout está disponível em Manual de Arquivos de Vendas Externas e o formato deste arquivo deve ser CSV. Atente-se para os dados obrigatórios neste tipo de integração. Alguns campos que sempre devem ser enviados:

• Afiliação;
• Credenciadora (adquirente);
• Identificador da Filial;
• Valor da Venda;
• Quantidade de parcelas;
• NSU/DOC.

Campos que identificam a transação não são obrigatórios completos, porém existem alguns campos que permitem o cruzamento de uma venda com o registro que virá no extrato da credenciadora.

Importação via API Agiliza

Para saber mais sobre a importação via API, disponibilizamos o manual de integração no Postman. Veja mais em API do Agiliza.

Outras formas de importação

Você também pode fazer a transferência do arquivo de vendas via:

• Transferência automática: configuração de SFTP;
• Transferência de arquivos automática via webservice.

Arquivo de saída

É o arquivo conciliado, também chamado de arquivo de fluxo de caixa, que contém todas as vendas, pagamentos, estornos e cancelamentos, enfim, todos os movimentos que uma loja possui para determinada data.

O arquivo de saída é um meio de integração, e você poderá fazer o upload do arquivo conciliado para o seu ERP ou sistema de gestão para gerar um “contas a receber” e realizar as baixas das contas que receber dentro do seu sistema.

Nesse manual, você pode consultar a configuração de dois formatos de arquivo de saída, XML e CSV:

• Arquivos Fluxo de Caixa 2.0 – XML;
• Arquivos Fluxo de Caixa 2.0 – CSV.

API do Agiliza

Para fazer a integração com a API do Agiliza Braspag, veja a documentação no Postman.

Arquivos de vendas Externas - CSV

Arquivo de Transações para Upload

O arquivo de transações para upload é um arquivo de texto, mais especificamente um arquivo de valores separados por ponto-e-vírgula (CSV). As informações são guardadas em três tipos de registros, Header, Transação e Trailer.

Modelo do arquivo CSV para importação
Download do arquivo modelo de importação

Registro Header

Apenas um registro deste tipo é permitido por arquivo. O registro header deve estar na primeira linha do arquivo. O registro segue o seguinte padrão:

[Tipo de Registro];[Versão do Layout];[Período Inicial];[Período Final]

Registro Transação

Cada transação feita pela loja será demonstrada nesse registro, que se repetirá quantas vezes forem necessárias, a partir da linha 2 (logo após o Header).

O registro segue o seguinte padrão:

[Tipo de Registro];[Pedido];[Afiliação];[Adquirente];[TID];[NSU/DOC];[Código de Autorização] ; [Número do Cartão];[Valor];[Quantidade de Parcelas];[Data da Venda];[Hora da venda] ; [Identificador da filial]

Legenda:

1. Campo obrigatório.
2. O tipo de dados deste campo deve seguir restritamente o formato expresso na descrição.
3. O tipo inteiro aceita como um número válido qualquer valor entre -2.147.483.648 e 2.147.483.647. Entretanto, regras de domínio adicionais podem existir para os campos (o código de afiliação deve ser válido na adquirente, por exemplo).
4. O tipo inteiro longo aceita como um número válido qualquer valor entre – 9.223.372.036.854.775.808 e 9.223.372.036.854.775.807. Entretanto, regras de domínioadicionais podem existir para os campos (o NSU da transação deve ser válido na adquirente, por exemplo).
5. O tipo byte aceita como um número válido qualquer valor entre 0 e 255. Entretanto, regras de domínio adicionais podem existir para os campos (a parcela da transação deve ser no mínimo 1, por exemplo).

Informações Adicionais:

• Campo NSU - Quando não informado, este campo deve ser vazio.
• Campo TID - Quando não informado, este campo deve ser vazio.
• Campo Hora – Caso não tenha o valor exato, informar a hora como 00:00:00.

Registro Trailer

Apenas um registro deste tipo é permitido por arquivo. O registro trailer deve estar na última linha do arquivo. O registro segue o seguinte padrão:

[Tipo de Registro];[Quantidade de registros]

Formas de envio

Atualmente o conciliador Braspag oferece 3 (três) formas de envios para os arquivos de vendas:

• Upload Manual pela aplicação
• Transferência via SFTP
• Transferência via webservice

Transferência Manual: Upload de arquivos na aplicação.

Pre-Requisitos:

• Acesso à internet, usuário e senha com permissão para upload habilitada.
• Acessando a URL: https://reconciliation.braspag.com.br/WebSite
• No menu superior, localize a funcionalidade: “Área do lojista”
• Após clicar no botão “Área do lojista” aparecerá um menu na lateral esquerda do backoffice:
• Localize o botão “Upload de arquivos de Transações”, ao clicar, aparecerá a seguinte tela:

Agora basta selecionar a loja, e realizar o upload escolhendo o arquivo que deseja transmitir de sua máquina. Para iniciar a transmissão click em “Efetuar upload”.

Transferência automática: Configuração de SFTP

É possivel alimentar o conciliador com os dados de vendas, através desse protocolo de rede que fornece acesso a arquivos , transferência de arquivos e gerenciamento de arquivos sobre qualquer fluxo de dados confiável. Porém para que seja possível a realização da automação, esse processo exige alguns pré-requisitos:

• O Ambiente deverá ser configurado nos domínios do lojista.
• O lojista disponibilizará diariamente os arquivos de vendas no layout Braspag nesse domínio.
• A Braspag terá acesso liberado para se conectar e realizar as baixas

Transferência de arquivos automática via Webservice:

URL: https://reconciliation.braspag.com.br/WebServices/ReconciliationFilesWebservice.asmx

Método: SendTransactionFile

OBS: Os dados desse arquivo são codificados como um “array” de bytes, ou seja, deverá ser enviado os bytes do arquivo.

A solução para isso é utilizar a codificação Base64. Esse tipo de codificação é o padrão usado quando se deseja fazer transferência de dados binários utilizando texto como a fonte do meio de comunicação. Em outras palavras, essa codificação é capaz de representar conteúdo de texto em forma de binário.

Para gerar o conteúdo do FileContent, é preciso primeiro saber codificar um dado textual em Base64. Existem documentos na internet explicando todo o processo conversão. A maioria das linguagens de programação atualmente já possuem algum framework integrado com alguma função que faça a codificação/decodificação.

Referência: Caso o cliente queira codificar/decodificar um conteúdo como teste, ele pode acessar este site:

http://www.base64decode.org/

Request

Response

Tipos de erro

Quando o valor da TAG for igual a false, a coleção de será retornada de acordo com um ou mais códigos de erros. Vide tabela abaixo.

Exemplo

Arquivos Fluxo de Caixa 2.0 - XML

Introdução

Este manual tem como objetivo orientar o desenvolvimento do Arquivo de Fluxo de Caixa da plataforma conciliador no formato XML, e a extração do seu conteúdo através do Webservice

Legenda para os tipos de formato

Tipos de Formato (Tabela II)

1. Um Identificador Único Global ou GUID (do inglês, Globally Unique IDentifier) é um tipo especial de identificador utilizado em aplicações de software para providenciar um número de referência padrão mundial. Como, por exemplo, em uma definição de referência interna para um tipo de ponto de acesso em uma aplicação de software ou para a criação de chaves únicas em um banco de dados. O número total de chaves únicas (2128 ou ~3.4×1038) é tão grande que a probabilidade do mesmo número se repetir é muito pequena. Considerando que o Universo Observável contém 5x1022 estrelas, cada estrela poderia ter ~6.8×1015 dos seus próprios GUIDs. Caso seu sistema não reconheça o formato GUID, poderá trata-lo como texto.

2. O formato ISO 8601 é o formato de data padrão existente na recomendação oficial para Schemas XML http://www.w3.org/TR/xmlschema-2/#dateTime. Ele consiste na representação da data no formato yyyy-MM-dd. Caso o campo também tenha a informação de hora, a data vem seguida da letra “T” para separa-la da hora, no formato HH:mm:ss:mmmmmmm, seguida finalmente pela diferença de fuso horário. Para mais informações da ISO 8601 podem ser consultadas em:

http://en.wikipedia.org/wiki/ISO_8601.

Informações sobre as adquirentes

O principal insumo do Conciliador são os extratos eletrônicos gerados pelas adquirentes. Devido a isso, podem existir particularidades entre cada uma.
Abaixo a estimativa de dias em que a adquirente envia os eventos no extrato eletrônico:

Prazo de registro no extrato eletrônico (Tabela II)

Registro Header (Tabela III)

Registro de Transação Conciliada (Tabela IV)

Registro de Conciliação Manual (Tabela V)

Registro de Informação de Venda

1. As informações de venda são as transações enviadas pelo cliente do mundo físico, ou do gateway/sistema transacional utilizado para efetuar as transações. São a primeira parte da conciliação. O Identificador Único da Venda pode ser utilizado para visualizar a venda no WebSite do Conciliador, preenchendo a URL:

https://reconciliation.braspag.com.br/WebSite/Reports/TransactionDetails.aspx?SaleTransactionId=[ID]

OBS:Onde o texto [ID] deve ser substituído pelo identificador informado no registro.

1. O identificador da Venda no Sistema Transacional é o Identificador da Transação que é utilizado pelo sistema que efetuou a venda, seja ele um Gateway ou Sistema de Caixa/POS. Este valor pode ou não ser fornecido durante a importação da venda para o Conciliador. É de responsabilidade do cliente a decisão de informá-lo ou não.
2. O identificador da Filial deve ser fornecido pelo cliente toda vez que a importação de uma venda é realizada para o Conciliador. Apesar de não haver restrições para o formato do identificador da filial (campo Alfanumérico), é obrigatório que cada Filial possua um identificador único.
3. O Gerenciamento do Número do Pedido é de inteira responsabilidade do lojista. O Conciliador apenas armazena esta informação, mas nenhum tipo de validação é feito.
4. O Valor da Transação não é o valor das parcelas. O valor informado aqui é o valor integral da mesma, da forma como informado pelo cliente/gateway.

Registro de Informação da Adquirente

1. As informações da adquirente são os dados da venda que o Conciliador recebe dos extratos eletrônicos, o meio de integração da adquirente com os sistemas externos. São a segunda parte da conciliação. O Identificador Único da Transação pode ser utilizado para visualizar a venda no WebSite do Conciliador, preenchendo a URL:

https://reconciliation.braspag.com.br/WebSite/Reports/TransactionDetails.aspx?AcquirerTransactionId=[ID]

Onde o texto [ID] deve ser substituído pelo identificador informado no registro.

1. Devido à restrições de segurança, o número do cartão será informado de forma mascarada.
2. Quando uma transação é dividida em uma quantidade de parcelas onde o valor não pode ser distribuído igualmente entre as parcelas, surge a necessidade de colocar um valor extra em uma parcela específica. Esta parcela é chamada de parcela de arredondamento. Como exemplo, podemos adotar uma transação de R$ 100,00 dividida em três parcelas. Se a primeira parcela for a parcela de arredondamento, ela terá o valor de R$ 33,34 – enquanto as duas outras parcelas terão o valor de R$ 33,33.
3. A taxa de adquirência normalmente é expressa em porcentagem. O campo demonstra essa porcentagem multiplicada por 100. Portanto, se o valor deste campo for expresso como 275, isto indica uma taxa de adquirência de 2,75%.
4. Tabelas com os meios de captura informados estão disponíveis no Apêndice do Manual.
5. Uma tabela com as bandeiras disponíveis está disponível no Apêndice do Manual.
6. Uma tabela com os tipos de produto está disponível no Apêndice do Manual.

Registro de Evento

Meios de Captura

Cielo

Amex

Rede

GetNet

Outros

A tabela abaixo é valida para:

• Stone
• Global Payments
• First Data
• Ticket
• Sodexo

Observação: Para a adquirente Losango o campo é enviado “vazio”

Bandeiras

Tipos de Produtos

Cielo

Getnet

Redecard

Stone

Global Payments

First Data

Ticket

Sodexo

Categorias de Evento

Webservice Conciliador

Webservice é uma solução para integrar aplicações. Por meio dele, qualquer sistema pode se conectar para consultar ou inserir dados. Atualmente no Webservice do Conciliador é possível enviar o arquivo de vendas externas e baixar o conteúdo dos Arquivos de Fluxo de Caixa.

Inicialmente o acesso deverá ser liberado pela equipe de operações, através do e-mail, senha e o cadastro dos IPs informados pelo estabelecimento.

O Webservice está disponível através da URL:

https://reconciliation.braspag.com.br/WebServices/ReconciliationFilesWebService.asmx

Método: GetExportedFileV2

Request

   
      
      
         
            
            [Guid aleatório]   
            [Login do usuário da loja]   
            [Identificador da loja, fornecido pela Braspag]   
            [Identificador da adquirente]   
            [Senha do usuário da loja]   
            [Data de referência do arquivo]   
            [Extensão do arquivo]   
            [Tipo do arquivo]   
            
         
     

Response

--Bem sucedido

       
         
            
            124be5db-a809-47e1-b456-1f2e103caa17   
            true                  
             QXJxdWl2byBkZSB0ZXN0ZSBjb25jaWxpYWRvcg==   
            
         
      
   

-- Mal Sucedida   

       
         
            
            124be5db-a809-47e1-b456-1f2e103caa17   
            false   
               
                  
                  44   
                  Acesso não autorizado do IP para a loja fornecida na requisição.   
               
            
         
      
   

Apêndice

Utilizando o arquivo de Schema Definition (XSD)

Uma forma de integração com o Arquivo de Fluxo de Caixa do Conciliador no formato XML de maneira programada ou automática, é feita através do arquivo de definição de esquema, ou XML Schema Definition File.

O XML Schema é uma linguagem baseada no formato XML para definição de regras de validação (“esquemas”) em documentos no formato XML. Foi a primeira linguagem de esquema para XML que obteve recomendação por parte do W3C. Esta linguagem é uma alternativa ao DTD, cuja sintaxe não é baseada no formato XML.
Foi amplamente utilizado para desenvolvimento da NF-e (Nota Fiscal Eletrônica) Brasileira.

Um arquivo contendo as definições na linguagem XML Schema é chamado de XSD (XML Schema Definition), este descreve a estrutura de um documento XML.

O conciliador possui arquivos XSD para cada um de seus arquivos em XML. Desta forma, é possível, programaticamente compreender a estrutura do XML, supondo que o arquivo XSD seja corretamente interpretado pela ferramenta.

Neste manual, não serão citadas todas as formas de se trabalhar com o arquivo, entretanto, podemos demonstrar, através da utilização de uma ferramenta provida pela IDE de desenvolvimento Visual Studio, como gerar, programaticamente uma Classe em código-fonte que pode representar o conteúdo do arquivo.

Desta forma, será possível deserializar o conteúdo de qualquer arquivo dentro desta classe, e com isto utilizar os arquivos de conciliação em um sistema com código orientado a objetos.

Criando a classe do arquivo por meio do arquivo de definição de esquema
Com os arquivos de definição de esquema, você deverá utilizar uma ferramenta que pode ser acessada à partir da linha de comando da IDE do Visual Studio (Visual Studio Command Prompt). O nome do executável é “xsd” (sem aspas).

O executável possui uma série de parâmetros para customizar a geração da sua classe a partir do arquivo de definição de esquema. Caso você queira ver todas as opções, consulte a URL https://msdn.microsoft.com/en-us/library/x6c1kb0s(v=VS.100).aspx.
No exemplo abaixo, utilizamos o comando para gerar a classe da forma mais básica. Acesse o diretório onde os arquivos de esquemas estão salvos(normalmente são dois arquivos, “ConciliationFile.xsd” e “Guid.xsd”), usando o comando CD do DOS. Uma vez dentro deste diretório, basta executar o comando conforme abaixo: xsd

ConciliationFile.xsd Guid.xsd /classes

Um exemplo do efeito disto na linha de commando é demonstrado na imagem abaixo. A classe gerada terá o nome “ConciliationFile_Guid.cs”. Esta classe pode ser inserida em um projeto na linguagem C#, e com algumas alterações pode representar o conteúdo do arquivo por meio de deserialização.
Consulte o suporte de sua linguagem de desenvolvimento para verificar se a mesma possui algum tipo de automatização para interpretar a leitura do arquivo em XML. Isto pode facilitar seu processo de desenvolvimento e aprendizado do layout do mesmo

Arquivos Fluxo de Caixa 2.0 - CSV

Este manual tem como objetivo orientar o desenvolvimento do Arquivo de Fluxo de Caixa da plataforma conciliador no formato CSV, e a extração do seu conteúdo através do Webservice.

Legenda para os tipos de formato

1. Um Identificador Único Global ou GUID (do inglês, Globally Unique IDentifier) é um tipo especial de identificador utilizado em aplicações de software para providenciar um número de referência padrão mundial. Como, por exemplo, em uma definição de referência interna para um tipo de ponto de acesso em uma aplicação de software ou para a criação de chaves únicas em um banco de dados. O número total de chaves únicas (2128 ou ~3.4×1038) é tão grande que a probabilidade do mesmo número se repetir é muito pequena. Considerando que o Universo Observável contém 5x1022 estrelas, cada estrela poderia ter ~6.8×1015 dos seus próprios GUIDs. Caso seu sistema não reconheça o formato GUID, poderá trata-lo como texto

Informações sobre as adquirentes

O principal insumo do Conciliador são os extratos eletrônicos gerados pelas adquirentes. Devido a isso, podem existir particularidades entre cada uma.
Abaixo a estimativa de dias em que a adquirente envia os eventos no extrato eletrônico.

Prazo de registro no extrato eletrônico (Tabela II)

Registro Header (Tabela III)

Registro de Transação Conciliada (Tabela IV)

Registro de Conciliação Manual (Tabela V)

Registro de Informação de Venda (Tabela VI)

1. As informações de venda são as transações enviadas pelo cliente do mundo físico, ou do gateway/sistema transacional utilizado para efetuar as transações. São a primeira parte da conciliação. O Identificador Único da Venda pode ser utilizado para visualizar a venda no WebSite do Conciliador, preenchendo a URL:

https://reconciliation.braspag.com.br/WebSite/Reports/TransactionDetails.aspx?SaleTransactionId=[ID]

Onde o texto [ID] deve ser substituído pelo identificador informado no registro.

1. O identificador da Venda no Sistema Transacional é o Identificador da Transação que é utilizado pelo sistema que efetuou a venda, seja ele um Gateway ou Sistema de Caixa/POS. Este valor pode ou não ser fornecido durante a importação da venda para o Conciliador. É de responsabilidade do cliente a decisão de informá-lo ou não.
2. O identificador da Filial deve ser fornecido pelo cliente toda vez que a importação de uma venda é realizada para o Conciliador. Apesar de não haver restrições para o formato do identificador da filial (campo Alfanumérico), é obrigatório que cada Filial possua um identificador único.
3. O Gerenciamento do Número do Pedido é de inteira responsabilidade do lojista. O Conciliador apenas armazena esta informação, mas nenhum tipo de validação é feito.
4. O Valor da Transação não é o valor das parcelas. O valor informado aqui é o valor integral da mesma, da forma como informado pelo cliente/gateway.

Registro de Informação da Adquirente (Tabela VII)

1. As informações da adquirente são os dados da venda que o Conciliador recebe dos extratos eletrônicos, o meio de integração da adquirente com os sistemas externos. São a segunda parte da conciliação. O Identificador Único da Transação pode ser utilizado para visualizar a venda no WebSite do Conciliador, preenchendo a URL:

https://reconciliation.braspag.com.br/WebSite/Reports/TransactionDetails.aspx?AcquirerTransactionId=[ID]

Onde o texto [ID] deve ser substituído pelo identificador informado no registro.

1. Devido à restrições de segurança, o número do cartão será informado de forma mascarada.
2. Quando uma transação é dividida em uma quantidade de parcelas onde o valor não pode ser distribuído igualmente entre as parcelas, surge a necessidade de colocar um valor extra em uma parcela específica. Esta parcela é chamada de parcela de arredondamento. Como exemplo, podemos adotar uma transação de R$ 100,00 dividida em três parcelas. Se a primeira parcela for a parcela de arredondamento, ela terá o valor de R$ 33,34 – enquanto as duas outras parcelas terão o valor de R$ 33,33.
3. A taxa de adquirência normalmente é expressa em porcentagem. O campo demonstra essa porcentagem multiplicada por 100. Portanto, se o valor deste campo for expresso como 275, isto indica uma taxa de adquirência de 2,75%.
4. Tabelas com os meios de captura informados estão disponíveis no Apêndice do Manual.
5. Uma tabela com as bandeiras disponíveis está disponível no Apêndice do Manual.
6. Uma tabela com os tipos de produto está disponível no Apêndice do Manual.

Registro de Evento

1. Os eventos são divididos em 2 tipos: Eventos financeiros são eventos que informam cobranças ou pagamentos na agenda financeira da adquirente com o lojista. Eventos informacionais são avisos de alterações na agenda (reagendamentos de eventos financeiros) ou outras informações não financeiras (captura de transação). Além disso, eles podem estar ligados à transações ou não. Caso estejam ligados à transações, eles aparecerão logo abaixo dos registros de transações aos quais se referem. Caso contrário, serão mencionados no final do arquivo. Utilize corretamente o identificador do registro para saber como tratar estes eventos pela sua ligação.
2. O Identificador Único do Evento pode ser utilizado para visualizar os dados do evento no WebSite do Conciliador, preenchendo a URL: https://reconciliation.braspag.com.br/WebSite/Reports/EventDetails.aspx?Id=[ID] Onde o texto [ID] deve ser substituído pelo identificador informado no registro.
3. Uma tabela com as categorias de evento está disponível no apêndice do Manual.
4. Certos eventos podem não se referir à uma parcela da transação, como Estornos ou Chargebacks.
   Nesses casos, o campo Parcela da Transação ficará vazio.

Meios de Captura

Cielo

Amex

Rede

GetNet

Outros

A tabela abaixo é valida para:

• Stone
• Global Payments
• First Data
• Ticket
• Sodexo

Observação: Para a adquirente Losango o campo é enviado “vazio”

Bandeiras

Tipos de Produtos

Cielo

Getnet

Redecard

Stone

Global Payments

First Data

Ticket

Sodexo

Categorias de Evento

Webservice Conciliador

Webservice é uma solução para integrar aplicações. Por meio dele, qualquer sistema pode se conectar para consultar ou inserir dados. Atualmente no Webservice do Conciliador é possível enviar o arquivo de vendas externas e baixar o conteúdo dos Arquivos de Fluxo de Caixa.

Inicialmente o acesso deverá ser liberado pela equipe de operações, através do e-mail, senha e o cadastro dos IPs informados pelo estabelecimento.

O Webservice está disponível através da URL:

https://reconciliation.braspag.com.br/WebServices/ReconciliationFilesWebService.asmx

Método: GetExportedFileV2

Request

   
      
      
         
            
            [Guid aleatório]   
            [Login do usuário da loja]   
            [Identificador da loja, fornecido pela Braspag]   
            [Identificador da adquirente]   
            [Senha do usuário da loja]   
            [Data de referência do arquivo]   
            [Extensão do arquivo]   
            [Tipo do arquivo]   
            
         
     

Response

--Bem sucedido

       
         
            
            124be5db-a809-47e1-b456-1f2e103caa17   
            true                  
             QXJxdWl2byBkZSB0ZXN0ZSBjb25jaWxpYWRvcg==   
            
         
      
   

-- Mal Sucedida   

       
         
            
            124be5db-a809-47e1-b456-1f2e103caa17   
            false   
               
                  
                  44   
                  Acesso não autorizado do IP para a loja fornecida na requisição.   
               
            
         
      
   

Apêndice:

Utilizando o arquivo de Schema Definition (XSD)

Uma forma de integração com o Arquivo de Fluxo de Caixa do Conciliador no formato XML de maneira programada ou automática, é feita através do arquivo de definição de esquema, ou XML Schema Definition File.

O XML Schema é uma linguagem baseada no formato XML para definição de regras de validação (“esquemas”) em documentos no formato XML. Foi a primeira linguagem de esquema para XML que obteve recomendação por parte do W3C. Esta linguagem é uma alternativa ao DTD, cuja sintaxe não é baseada no formato XML.
Foi amplamente utilizado para desenvolvimento da NF-e (Nota Fiscal Eletrônica) Brasileira.

Um arquivo contendo as definições na linguagem XML Schema é chamado de XSD (XML Schema Definition), este descreve a estrutura de um documento XML.

O conciliador possui arquivos XSD para cada um de seus arquivos em XML. Desta forma, é possível, programaticamente compreender a estrutura do XML, supondo que o arquivo XSD seja corretamente interpretado pela ferramenta.

Neste manual, não serão citadas todas as formas de se trabalhar com o arquivo, entretanto, podemos demonstrar, através da utilização de uma ferramenta provida pela IDE de desenvolvimento Visual Studio, como gerar, programaticamente uma Classe em código-fonte que pode representar o conteúdo do arquivo.

Desta forma, será possível deserializar o conteúdo de qualquer arquivo dentro desta classe, e com isto utilizar os arquivos de conciliação em um sistema com código orientado a objetos.

Criando a classe do arquivo por meio do arquivo de definição de esquema
Com os arquivos de definição de esquema, você deverá utilizar uma ferramenta que pode ser acessada à partir da linha de comando da IDE do Visual Studio (Visual Studio Command Prompt). O nome do executável é “xsd” (sem aspas).

O executável possui uma série de parâmetros para customizar a geração da sua classe a partir do arquivo de definição de esquema. Caso você queira ver todas as opções, consulte a URL https://msdn.microsoft.com/en-us/library/x6c1kb0s(v=VS.100).aspx.
No exemplo abaixo, utilizamos o comando para gerar a classe da forma mais básica. Acesse o diretório onde os arquivos de esquemas estão salvos(normalmente são dois arquivos, “ConciliationFile.xsd” e “Guid.xsd”), usando o comando CD do DOS. Uma vez dentro deste diretório, basta executar o comando conforme abaixo: xsd

ConciliationFile.xsd Guid.xsd /classes

Um exemplo do efeito disto na linha de commando é demonstrado na imagem abaixo. A classe gerada terá o nome “ConciliationFile_Guid.cs”. Esta classe pode ser inserida em um projeto na linguagem C#, e com algumas alterações pode representar o conteúdo do arquivo por meio de deserialização.
Consulte o suporte de sua linguagem de desenvolvimento para verificar se a mesma possui algum tipo de automatização para interpretar a leitura do arquivo em XML. Isto pode facilitar seu processo de desenvolvimento e aprendizado do layout do mesmo