--- title: "FAQ - Perguntas e Respostas" url: "https://devcenter.stone.com.br/conciliacao-faq" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_FAQ+-+Perguntas+e+Respostas,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9jb25jaWxpYWNhby1mYXEi,s_wvHprSNHbaOk_tJ4.png" --- # FAQ - Perguntas e Respostas ## [O que é Conciliação?](#o-que-é-conciliação) Conciliação é a demonstração de todo o movimento financeiro processado com a adquirente (vendas, recebimentos, cancelamentos, ajustes, chargebacks e taxas), mostrando o valor líquido e bruto de cada movimentação. Você pode fazer também o cruzamento das informações da adquirente com as informações enviadas no extrato bancário. A conciliação diz a real situação financeira do seu negócio, auxiliando na tomada de decisões importantes. ## [Como funciona a Conciliação da Stone?](#como-funciona-a-conciliação-da-stone) Na Stone os seus arquivos de conciliação são gerados a partir do momento que você começa a transacionar no ambiente de produção. Ou seja, não é necessária nenhuma habilitação específica no cadastro para que isso aconteça. Os arquivos da Stone são entregues no formato XML e ficam disponíveis no webservice de conciliação. Para baixar os arquivos, você precisa enviar uma requisição para a API de conciliação informando sempre uma data e a affiliation key correspondente à sua loja." ## [Como faço para começar a usar?](#como-faço-para-começar-a-usar) Para receber os arquivos de conciliação da Stone, você já precisa ser um cliente credenciado. Depois disso, é necessário solicitar o seu código AffiliationKey para o seu contato comercial ou para nosso time de Relacionamento com o Cliente, pelo e-mail [meajuda@stone.com.br.](mailto:meajuda@stone.com.br.) Com o código em mãos, você precisa apenas configurar a requisição para baixar os arquivos. Você pode ver mais detalhes sobre como fazer isso na nossa documentação. ## [Posso receber o arquivo no formato posicional ao invés do XML?](#posso-receber-o-arquivo-no-formato-posicional-ao-invés-do-xml) Infelizmente não, o formato atual do arquivo de conciliação da Stone é apenas XML. ## [Existe um limite de tempo para baixar arquivos retroativos?](#existe-um-limite-de-tempo-para-baixar-arquivos-retroativos) Sim, temos até 12 meses de dado retroativo. No endereço da requisição, você pode informar qualquer data para receber o arquivo correspondente, desde que seja de um período no qual a sua loja já estava credenciada na Stone, e que respeite o limite de 12 meses para trás a contar do dia da requisição. ## [Quais são as informações que o arquivo de Conciliação entrega?](#quais-são-as-informações-que-o-arquivo-de-conciliação-entrega) O arquivo de Conciliação da Stone demostra todas as transações e eventos ocorridos no dia referenciado, junto com as suas respectivas informações financeiras. O arquivo permite o acompanhamento desde a captura até o pagamento/desconto de cada uma das transações e lançamentos realizados. Com a Conciliação Stone, você consegue visualizar de forma bastante clara o valor líquido e bruto de cada parcela, o valor líquido e bruto de cancelamentos, quais parcelas da transação foram antecipadas e qual foi o custo da antecipação de cada parcela, além de todas as informações referentes à chargebacks. O arquivo contempla também eventos financeiros, como aluguéis de POS, ajustes financeiros e transferência interna. ## [Como identificar uma transação cancelada?](#como-identificar-uma-transação-cancelada) Quando ocorre o cancelamento de uma transação, a tag `` dentro do nó Events é preenchida com o valor 1. Quando ocorre o desconto de um cancelamento, a tag `` dentro do nó Events é preenchida com o valor 1. ## [Posso realizar um cancelamento parcial?](#posso-realizar-um-cancelamento-parcial) Sim, é possível realizar o cancelamento parcial ou total de uma transação, independentemente de ser ou não uma transação parcelada. É possível realizar essa operação com a ajuda do nosso time de Relacionamento com o Cliente, através do e-mail [meajuda@stone.com.br](mailto:meajuda@stone.com.br), ou através do portal da Stone. ## [Quais ações podem ser um "evento financeiro"?](#quais-ações-podem-ser-um-evento-financeiro) O aluguel é enviado como um evento dentro de FinancialEvents. Nesse caso, a tag `` é preenchida com o valor 3 (código referente ao evento aluguel) e a tag `` demonstra o valor do aluguel. ## [É possível enxergar os dados das outras adquirentes neste arquivo?](#é-possível-enxergar-os-dados-das-outras-adquirentes-neste-arquivo) Não. Cada adquirente é responsável pela apresentação dos seus dados ao cliente final. Ou seja, a partir do arquivo de Conciliação da Stone é possível enxergar todos os dados transacionais e eventos que passaram pela adquirência da Stone. " ## [Com qual periodicidade recebo os dados para conciliar?](#com-qual-periodicidade-recebo-os-dados-para-conciliar) Os arquivos são disponibilizados diariamente e você pode baixá-los através da API a partir das 4h da manhã do dia posterior ao qual se deseja conciliar. ## [É gerado algum código único apresentado no arquivo?](#é-gerado-algum-código-único-apresentado-no-arquivo) Sim, toda transação gera um código único da transação, que é nomeado como AcquirerTransactionKey (também chamado de Stone Id). No caso da Stone, esse código pode ter até 35 dígitos. ## [Existe um ambiente de homologação para a conciliação?](#existe-um-ambiente-de-homologação-para-a-conciliação) Não temos um ambiente de homologação para a conciliação. ## [Existe uma documentação para os termos "próprios" que são mostrados no arquivo de conciliação?](#existe-uma-documentação-para-os-termos-próprios-que-são-mostrados-no-arquivo-de-conciliação) Os termos que aparecem no arquivo de conciliação estão explicados na nossa documentação: [Documentação](https://devcenter.stone.com.br/conciliacao) ## [Quais são as possíveis mensagens de erro?](#quais-são-as-possíveis-mensagens-de-erro) As mensagens de retorno de erro mais comuns são as três abaixo: - "Conciliation generation is only permitted in past dates." ​ A requisição para obter o arquivo de um determinado dia deve ser feita após as 5:00 da manhã do dia posterior. - "Missing or invalid authorization security header" Essa mensagem é retornada quando algum campo no header da requisição está incorreto. - "Message": "An error has occured." Esse erro acontece quando existe alguma indisponibilidade na API de conciliação. Nesses casos, por favor entre em contato com o nosso time ([aloparceiro@stone.com.br](mailto:aloparceiro@stone.com.br)). Caso você receba um retorno diferente, nos envie um email para maiores esclarecimentos. ## [Existem arquivos com transações de venda, porém sem eventos de pagamento?](#existem-arquivos-com-transações-de-venda-porém-sem-eventos-de-pagamento) Sim, existem arquivos que não apresentam nenhum pagamento. Essa situação ocorre em dias que a sua loja efetuou vendas normalmente, mas não recebeu nenhum pagamento de transações anteriores. ## [Como é demonstrado o fluxo de uma transação parcelada?](#como-é-demonstrado-o-fluxo-de-uma-transação-parcelada) Em uma transação parcelada, o container "Installments", dentro do nó "Transactions", é gerado para cada parcela da transação. Ou seja, para uma transação parcelada em 6 vezes são gerados 6 nós "Installments" e cada um contém a informação de uma parcela. ## [Quanto tempo as informações para Conciliação demoram para serem disponibilizadas?](#quanto-tempo-as-informações-para-conciliação-demoram-para-serem-disponibilizadas) As informações são disponibilizadas sempre em D+1. Ou seja, se você realizou uma venda no sexta-feira, poderá ver os dados referentes a ela no arquivo do sábado. É recomendado que o arquivo seja baixado após ás 6h, para garantir que todas as informações do dia anterior estejam carregadas. ## [É possível passar um período de datas na API de conciliação?](#é-possível-passar-um-período-de-datas-na-api-de-conciliação) Não, cada requisição baixa o arquivo apenas para um dia. Porém é possível configurar, através de desenvolvimento no seu sistema, uma série de requisições simultâneas para baixar arquivos correspondentes a um período de datas. ## [É possível obter um arquivo contendo informações de mais de um estabelecimento comercial (Stone Code)?](#é-possível-obter-um-arquivo-contendo-informações-de-mais-de-um-estabelecimento-comercial-stone-code) Não. A requisição é feita informando StoneCode (identificador do lojista na Stone) e o dia de referência, ou seja, para cada estabelecimento que se deseja obter um arquivo, é necessário realizar uma nova chamada. ## [O que fazer se não encontrei transações no arquivo?](#o-que-fazer-se-não-encontrei-transações-no-arquivo) Verifique a tag ``. Ela informa a data e hora em que o arquivo foi gerado no formato aaaammddHHmmss. A hora de geração é informada com 3 horas a mais, portanto se a hora informada for anterior à 8h da manhã (080000), significa que o arquivo esta sendo gerado antes das 5h da manhã. Neste caso, passe a realizar a requisição **somente após as 5h**, e mande um email para [souparceiro@stone.com.br](mailto:aloparceiro@stone.com.br), solicitando a limpeza do cache, conforme o template sugerido. ## [Qual é a regra de arredondamento de centavos?](#qual-é-a-regra-de-arredondamento-de-centavos) A regra é a seguinte: 1. Dividir o valor total pela quantidade de parcelas (Por exemplo R$170,03 em 4 parcelas. 170,03/4 = 42,5075); 2. Arredondar o resultado de todas as parcelas para baixo (o valor com duas casas decimais mais próximo. No exemplo acima é 42,50); 3. A diferença deve ser adicionada à primeira parcela. Vamos à alguns exemplos: **R$170,03 em 4 parcelas** | Parcela | Valor | | :------ | :------- | | 1 | R$ 42.53 | | 2 | R$ 42.50 | | 3 | R$ 42.50 | | 4 | R$ 42.50 | **R$192,65 em 4 parcelas** | Parcela | Valor | | :------ | :------- | | 1 | R$ 48.17 | | 2 | R$ 48.16 | | 3 | R$ 48.16 | | 4 | R$ 48.16 | **R$550,00 em 4 parcelas** | Parcela | Valor | | :------ | :-------- | | 1 | R$ 137.50 | | 2 | R$ 137.50 | | 3 | R$ 137.50 | | 4 | R$ 137.50 | **R$264,56 em 6 parcelas** | Parcela | Valor | | :------ | :------- | | 1 | R$ 44.11 | | 2 | R$ 44.09 | | 3 | R$ 44.09 | | 4 | R$ 44.09 | | 5 | R$ 44.09 | | 6 | R$ 44.09 | ## [Transações de Link de Pagamento são exibidas no arquivo de conciliação?](#transações-de-link-de-pagamento-são-exibidas-no-arquivo-de-conciliação) Sim, as transações de Link de Pagamento seguem o mesmo comportamento de outras transações, inclusive transações de Link com Split. ## [Troquei de conciliadora e gostaria de revogar o acesso da antiga, como posso fazer?](#troquei-de-conciliadora-e-gostaria-de-revogar-o-acesso-da-antiga-como-posso-fazer) Será necessário resgatar o e-mail de confirmação de consentimento dado à sua antiga conciliadora, depois é só clicar no botão "Cancelar Acesso". Ele foi enviado a partir do remetente [no\_reply@stone.com.br.](https://devcenter.stone.com.br/no_reply@stone.com.br "no_reply@stone.com.br") Caso não localize o e-mail, será necessário entrar em contato com o time de relacionamento da Stone ([meajuda@stone.com.br](mailto:meajuda@stone.com.br)) para que a revogação seja realizada internamente pelo time de conciliação. --- **Jornada: [Tirar dúvidas e acompanhar mudanças](https://devcenter.stone.com.br/conciliacao-faq)** Etapa 1 de 3 [**Próxima etapa**Fale conosco](https://devcenter.stone.com.br/conciliacao-fale-conosco) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.