--- title: "Extrato da Agenda Stone (novo)" url: "https://devcenter.stone.com.br/conciliacao-novo-extrato-agenda-stone" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Extrato+da+Agenda+Stone+(novo),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9jb25jaWxpYWNhby1ub3ZvLWV4dHJhdG8tYWdlbmRhLXN0b25lIg,s_yFM93s9TGfdNIBZp.png" --- # Extrato da Agenda Stone (novo) ## [Endpoint](#endpoint) ```text GET https://conciliation.stone.com.br/v2/merchant/conciliation-file ``` ### [Query params](#query-params) | Nome | Obrigatório | Tipo | Descrição | | :--------------- | :---------- | :----- | :--------------- | | layout | não | string | (padrão: XML2_2) | | referenceDate | sim | string | | | paymentProfileId | sim | string | | | poiType | sim | string | | ### [Headers](#headers) | Nome | Obrigatório | Tipo | Descrição | | :---------------- | :---------- | :----- | :------------------------------------------------------------------------------- | | Accept-Encoding | não | string | Arquivo é sempre retornado zipado (padrão: gzip) | | x-user-type | não | string | Deve ser usado somente se você for cliente Stone, utilizando sua chave própria criada diretamente no portal | | Authorization | sim | string | Deve ser passado o token JWT para caso de conciliadoras ou a chave própria se for cliente Stone no padrão Basic Auth. | | X-Accept-Redirect | não | string | (padrão: true) | Novos identificadores A partir de Setembro de 2026, credenciamentos criados na Stone passaram a contar com novos identificadores, que substituem o StoneCode no processo de conciliação: `paymentProfileId` e `poiType`. A partir desse endpoint será possível extrair o arquivo de conciliação por novos esses identificadores. _O endpoint por StoneCode continua ativo para clientes que possuem esse identificador._ **O arquivo permanece com mesmo formato e o mesmo conteúdo, não é necessária nenhuma mudança estrutural na sua integração.** Caso ainda não conheça os novos identificadores do cliente, você pode consultá-los a partir do documento (CNPJ/CPF) nesse endpoint: [Consulta de identificadores do lojista](https://devcenter.stone.com.br/conciliacao-consulta-de-identificadores-do-lojista) Disponibilização do arquivo O pedido deve ser feito somente depois das **5:00 da manhã do dia seguinte** ao qual dia você deseja conciliar Abaixo estão os possíveis códigos de retorno e o descritivo de cada um. | StatusCode | Mensagem | Descrição | | :--------- | :-------------------- | :------------------------------------------------------------------------------- | | 200 | OK | Sua requisição foi bem sucedida e o arquivo que foi buscado está transmitido no corpo da mensagem. | | 307 | Redirect | Sua requisição foi bem sucedida e redirecionada para o arquivo já cacheado. Use o header Location na resposta para o acesso. | | 400 | Bad Request | Você deve confirmar os parâmetros utilizados. Como exemplo: - referenceDate - paymentProfileId - poiType | | 401 | Unauthorized | Valores de autenticação incorretos. | | 403 | Forbidden | Authorization Token não pertence ao documento associado para o qual o arquivo está sendo solicitado. | | 404 | Page Not Found | Significa erro na montagem da requisição. Normalmente causado pelo caminho da rota incorreto. | | 500 | Internal Server Error | Erro interno no servidor. | | 503 | Service Unavailable | Quando o sistema da conciliação está com algum problema de funcionamento. | | 504 | TimeOut | Significa que algum dos componentes chamados pela conciliação demorou para entregar o resultado. | Authorization: Conciliadoras [Como gerar seu token de acesso](https://devcenter.stone.com.br/conciliacao-gerando-seu-token-de-acesso) Authorization: Cliente Stone Para se autenticar conosco você deve enviar a Chave de API no cabeçalho Authorization, seguindo o padrão da [HTTP Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication). Para montar a requisição Basic Auth, você deve utilizar sua Chave Secreta da seguinte maneira: **User**: _chave_ **Password**: _vazio_ Os layouts disponíveis no momento são o XML2\_2 e XML2\_4 Timeout Cada requisição possui um tempo limite de 2 minutos. Comprimindo o arquivo Para acelerar a transferência de arquivos, você pode solicita-los em formato compactado. Para fazer isso, é necessário incluir a chave `Accept-Encoding` com o valor `gzip` no cabeçalho da requisição. Download do arquivo Ao realizar o download, o arquivo vem nomeado como `{paymentProfileId}-{poiType}-{dataReferencia}-XML2_2-without_reversals.xml` (_Se a versão for a 2.4, muda apenas a parte "XML2\_4"_) --- **Jornada: [Baixar o arquivo de conciliação](https://devcenter.stone.com.br/conciliacao-extrato-da-agenda-stone)** Etapa 2 de 10 [**Etapa anterior**Extrato da Agenda Stone](https://devcenter.stone.com.br/conciliacao-extrato-da-agenda-stone)[**Próxima etapa**Limpeza de Cache](https://devcenter.stone.com.br/conciliacao-limpeza-de-cache-em-lote) 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.