> ## Documentation Index > Fetch the complete documentation index at: https://docs.gestio.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Changelog da API > Acompanhe as novidades, correções e mudanças de versão da API Fique por dentro das atualizações e do histórico de versões da API. Este changelog é atualizado continuamente com melhorias, correções de bugs e outras mudanças relevantes. Tem uma sugestão de feature ou melhoria? Envie pelo [portal de sugestões](https://sugestoes.gestio.com.br/). Encontrou algum problema? [Abra um ticket](https://ajuda.gestio.com.br/hc/pt-br/requests/new). A API segue versionamento (`v2`, `v3`, ...). Mudanças aditivas (novos campos opcionais, novos endpoints) não quebram integrações existentes. Sempre que uma mudança exigir atenção especial, ela será destacada com um aviso abaixo. *** ## Novos campos e anexos em Contas a Pagar e Pedido de Compra O lançamento de Contas a Pagar passa a expor competência, código de barras e Custo ABC. A consulta de um Pedido de Compra passa a devolver os arquivos anexados ao pedido e às notas fiscais. **O que mudou:** * Novos campos opcionais em `POST /v2/financeiro/contaspagar`, `PUT /v2/financeiro/contaspagar` e nas consultas `GET /v2/financeiro/contaspagar`, `/baixados` e `/{ex}/{fil}/{nrtrs}/{seqtrs}`: * `PeriodoDeCompetencia` (`datetime`) — período de competência do lançamento * `CodigoDeBarras` (`string`) — código de barras do boleto * `CodigoDoCustoABC` (`string`) — código do Custo ABC; quando informado, precisa ser um Custo ABC válido da empresa * `DescricaoDoCustoABC` (`string`, somente leitura) — descrição do Custo ABC * Novos campos somente leitura em `GET /v2/compras/pedido/{numeroPedido}`: * `Arquivos` — anexos do pedido (`Id`, `NomeDoArquivo`, `Url` com token SAS e `Observacao`) * `ArquivosNotasFiscais` — anexos de notas fiscais do pedido, no mesmo formato * As listas `GET /v2/compras/pedido/abertos` e `/encerrados` não preenchem os anexos * Mudança aditiva: integrações existentes continuam funcionando sem alteração **Exemplo — Trecho do lançamento de Contas a Pagar:** ```json theme={null} { "numeroDaTransacao": 44102, "periodoDeCompetencia": "2026-09-01T00:00:00", "codigoDeBarras": "34191790010104351004791020150008291070026000", "codigoDoCustoABC": "ABC-01", "descricaoDoCustoABC": "Custo operacional" } ``` **Exemplo — Trecho do Pedido de Compra consultado por número:** ```json theme={null} { "numeroDoPedido": 9021, "arquivos": [ { "id": "8c1e2a40-1b2f-4d3a-9e10-6f7a8b9c0d11", "nomeDoArquivo": "proposta.pdf", "url": "https://storage.example/proposta.pdf?sv=...", "observacao": null } ], "arquivosNotasFiscais": [ { "id": "a11b22c3-d44e-455f-8667-77889900aabb", "nomeDoArquivo": "nfe-9021.xml", "url": "https://storage.example/nfe-9021.xml?sv=...", "observacao": null } ] } ``` *** ## Responsável de compras e total de cotações na Ordem de Compra A consulta de Ordem de Compra passa a informar o colaborador responsável pelas compras e quantas cotações estão vinculadas à ordem. **O que mudou:** * Novos campos somente leitura em `GET /v2/compras/ordem/abertas`, `/encerradas` e `/{id}`: * `DescricaoDoColaboradorResponsavelCompras` (`string`) — nome do colaborador responsável pelas compras * `TotalDeCotacoes` (`int`) — quantidade de cotações vinculadas à ordem * Mudança aditiva: integrações existentes continuam funcionando sem alteração **Exemplo — Trecho da resposta de uma Ordem de Compra:** ```json theme={null} { "numeroDaOrdem": 5821, "descricaoDoColaboradorResponsavelCompras": "Maria Souza", "totalDeCotacoes": 3 } ``` *** ## Campos da reforma tributária na Nota Fiscal de Serviço A NFS-e passa a expor os dados de IBS/CBS e as situações tributárias de PIS, COFINS e CSLL usados na reforma tributária. **O que mudou:** * Novos campos em `GET /v2/faturamento/nfse/{id}` e demais consultas e gravações de NFS-e (`POST`/`PUT /v2/faturamento/nfse`): * `CodigoIndicadorDaOperacao` (`string`), `CodigoTipoDaOperacao` (`int`) e `CodigoIndicadorDoDestinatario` (`int`) — indicadores da operação IBS/CBS * `CodigoDaSituacaoTributariaIBSCBS` (`string`) — CST de IBS/CBS * `ClassificacaoIBSCBS` (`string`) — classificação tributária (`cClassTrib`) * `AliquotaIBSMunicipal`, `ValorIBSMunicipal`, `AliquotaIBSEstadual`, `ValorIBSEstadual`, `AliquotaCBS` e `ValorCBS` (`decimal`) * `CodigoDaSituacaoTributariaPIS` e `CodigoDaSituacaoTributariaCOFINS` (`string`) — CST de PIS e COFINS * `CodigoDaRetencaoPisCofinsCsll` (`string`) — tipo de retenção de PIS, COFINS e CSLL * Mudança aditiva: integrações existentes continuam funcionando sem alteração **Exemplo — Trecho da NFS-e:** ```json theme={null} { "codigoNBS": "1.1502.10.00", "codigoIndicadorDaOperacao": "100301", "codigoTipoDaOperacao": 1, "codigoDaSituacaoTributariaIBSCBS": "000", "classificacaoIBSCBS": "000001", "aliquotaIBSMunicipal": 0.1, "valorIBSMunicipal": 10.0, "aliquotaIBSEstadual": 0.1, "valorIBSEstadual": 10.0, "aliquotaCBS": 0.9, "valorCBS": 90.0 } ``` *** ## Valor bruto, retenções e anexos em Contas a Pagar O lançamento de Contas a Pagar passa a detalhar o valor bruto e os impostos retidos, e a consulta por chave passa a devolver os arquivos anexados ao título. **O que mudou:** * Novos campos em `POST /v2/financeiro/contaspagar`, `PUT /v2/financeiro/contaspagar` e nas consultas `GET /v2/financeiro/contaspagar`, `/baixados` e `/{ex}/{fil}/{nrtrs}/{seqtrs}`: * `ValorBruto` (`decimal`) — valor do lançamento antes dos impostos retidos * `ValorPISRetido`, `ValorCOFINSRetido`, `ValorCSLLRetido`, `ValorIRRetido`, `ValorISSRetido` e `ValorINSSRetido` (`decimal`) * `ValorDoLancamento` passa a representar o valor líquido do título * Novo campo somente leitura `Arquivos` no `GET /v2/financeiro/contaspagar/{ex}/{fil}/{nrtrs}/{seqtrs}` e nas respostas de inclusão, alteração e exclusão — lista os anexos do lançamento (`Id`, `NomeDoArquivo`, `Url` com token SAS e `Observacao`) * As listagens `GET /v2/financeiro/contaspagar` e `/baixados` não preenchem `Arquivos` * Mudança aditiva: integrações existentes continuam funcionando sem alteração **Exemplo — Trecho do lançamento com retenções e anexo:** ```json theme={null} { "valorBruto": 1650.5, "valorPISRetido": 10.73, "valorCOFINSRetido": 49.52, "valorCSLLRetido": 16.51, "valorIRRetido": 24.76, "valorISSRetido": 33.01, "valorINSSRetido": 15.47, "valorDoLancamento": 1500.5, "arquivos": [ { "id": "3f2a1b00-9c8d-4e7f-a123-456789abcdef", "nomeDoArquivo": "boleto.pdf", "url": "https://storage.example/boleto.pdf?sv=...", "observacao": null } ] } ``` ## Novos campos no cadastro de Produto O body de inclusão e alteração de produto passa a expor campos que já existiam no cadastro interno da plataforma, mas ainda não estavam disponíveis na API de integração. **O que mudou:** * Novos campos opcionais em `POST /v2/produto` e `PUT /v2/produto` (também retornados nas consultas `GET`): * `CodigoGenerico` (`string`) — código genérico do produto * `DescricaoDoProdutoIngles` (`string`) — descrição em inglês (o campo `DescricaoDoProduto` continua preenchendo apenas a descrição em português) * `PesoBruto` e `PesoLiquido` (`decimal`) — substituem o uso do campo `Peso`, que não preenchia os pesos bruto e líquido na plataforma * `Altura`, `Largura` e `Comprimento` (`string`) — dimensões do produto * O campo `Peso` permanece no contrato por compatibilidade, mas não popula `PesoBruto`/`PesoLiquido`. Prefira os novos campos. * Mudança aditiva: integrações existentes continuam funcionando sem alteração **Exemplo — Trecho do body de inclusão/alteração:** ```json theme={null} { "codigoInterno": "PROD-001", "codigoGenerico": "GEN-001", "descricaoDoProduto": "Produto exemplo", "descricaoDoProdutoIngles": "Example product", "pesoBruto": 1.5, "pesoLiquido": 1.2, "altura": "10", "largura": "20", "comprimento": "30" } ``` *** ## Filtro por centro de custo nas Requisições de Compra Agora é possível restringir o retorno das requisições de compra a um ou mais centros de custo específicos. **O que mudou:** * Novo parâmetro opcional `CodigosCentroCustos` (lista de `string`) em `GET /v2/compras/requisicao/abertas` e `GET /v2/compras/requisicao/encerradas` * Se omitido, o comportamento é o mesmo de antes: retorna requisições de todos os centros de custo * O parâmetro é repetido na query string para enviar múltiplos códigos **Exemplo — Requisições abertas filtradas por centro de custo:** ```http theme={null} GET /v2/compras/requisicao/abertas?CodigoDaFilial=1&CodigosCentroCustos=001&CodigosCentroCustos=002 ``` *** ## Campo de projeto liberado na Requisição de Compra Os campos de projeto vinculados à Requisição de Compra, que já existiam internamente, agora são retornados publicamente pela API. **O que mudou:** * Campos `CodigoDoProjeto` (`int`, opcional) e `DescricaoDoProjeto` (`string`) passam a ser retornados em `GET /v2/compras/requisicao/abertas`, `GET /v2/compras/requisicao/encerradas` e `GET /v2/compras/requisicao/{id}` * Nenhuma ação é necessária caso sua integração já ignore campos desconhecidos no payload **Exemplo — Trecho da resposta de uma Requisição de Compra:** ```json theme={null} { "numeroDaRequisicao": 1024, "codigoDoCentroDeCusto": "001", "codigoDoProjeto": 42, "descricaoDoProjeto": "Reforma Filial Centro" } ``` *** ## Novos endpoints de Tipo e Motivo de Compra Adicionados endpoints de consulta para apoiar o preenchimento de pedidos e requisições de compra a partir de uma integração externa. **O que mudou:** * Novo endpoint `GET /v2/compras/gerenciamento/tipodecompra` — lista os tipos de compra cadastrados, com filtro opcional `somenteAtivos` * Novo endpoint `GET /v2/compras/gerenciamento/motivo` — lista os motivos de compra cadastrados (ordenados por descrição), com filtro opcional `somenteAtivos` **Exemplo — Tipos de compra ativos:** ```http theme={null} GET /v2/compras/gerenciamento/tipodecompra?somenteAtivos=true ``` ```json theme={null} [ { "codigoDoTipoDeCompra": 1, "descricaoDoTipoDeCompra": "Material de Consumo", "ativo": true } ] ``` ## Campo de código NBS na Nota Fiscal de Serviço **O que mudou:** * Novo campo `CodigoNBS` (`string`) no retorno de `GET /v2/faturamento/nfse/{id}` e demais consultas de NFS-e, com a classificação do serviço prestado conforme a tabela NBS (Nomenclatura Brasileira de Serviços) *** ## Data de liberação para aprovação em Ordem, Pedido e Requisição de Compra **O que mudou:** * Novo campo `DataLiberacaoParaAprovacao` (`datetime`, opcional) no retorno de: * `GET /v2/compras/ordem/abertas`, `/encerradas` e `/{id}` (Ordem de Compra) * `GET /v2/compras/pedido/abertos`, `/encerrados` e `/{numeroPedido}` (Pedido de Compra) * `GET /v2/compras/requisicao/abertas`, `/encerradas` e `/{id}` (Requisição de Compra) * Indica o momento em que o documento foi liberado para entrar no fluxo de aprovação, sem depender de uma consulta adicional ao histórico de aprovações/reprovações ```json theme={null} { "numeroDaOrdem": 5821, "dataDaOrdem": "2026-05-20T09:12:00", "dataLiberacaoParaAprovacao": "2026-05-20T09:15:32" } ``` *** ## Novos campos em Ordem e Pedido de Compra **O que mudou:** * Novo campo `NumeroDaRequisicaoDeEstoque` (`decimal`, opcional) em `GET /v2/compras/ordem/abertas`, `/encerradas` e `/{id}` — identifica a requisição de estoque que originou a ordem de compra, quando aplicável * Novo campo `IdPedidoWS` (`string`) em `GET /v2/compras/pedido/abertos`, `/encerrados` e `/{numeroPedido}` — identificador auxiliar do pedido, pensado para facilitar o rastreio de pedidos criados/consultados via integração *** ## Número da requisição de compra na Ordem de Compra **O que mudou:** * Novo campo `NumeroDaRequisicaoDeCompra` (`decimal`, opcional) em `GET /v2/compras/ordem/abertas`, `/encerradas` e `/{id}` — identifica diretamente qual requisição deu origem à ordem, sem necessidade de consulta adicional *** ## Importação de endereçamento de produtos via API **O que mudou:** * Novo endpoint `POST /v2/sistema/importacao/enderecamento-de-produto` — recebe um arquivo Excel com o mapeamento de endereçamento de produtos no estoque (localização física do produto no almoxarifado) * Aceita o parâmetro de query `preview` (`bool`, padrão `false`): quando `true`, retorna apenas o total de registros identificados no arquivo, sem confirmar a importação **Exemplo — Pré-visualização da importação:** ```http theme={null} POST /v2/sistema/importacao/enderecamento-de-produto?preview=true Content-Type: multipart/form-data ``` ```json theme={null} { "totalDeRegistros": 340, "produtoMapeamentoEstoque": [ { "codigoDaFilial": 1, "codigoDoAlmoxarifado": 2, "codigoDaSecao": "A01", "idProd": 1523 } ] } ``` *** ## Novos endpoints de Requisição de Estoque Adicionados endpoints para consulta de requisições de estoque (RE), completando a cobertura que já existia para requisições de compra. **O que mudou:** * Novo endpoint `GET /v2/estoque/requisicao/pendentes` — retorna as requisições de estoque pendentes por empresa e filial (`filial`), com limite opcional de registros (`qtde`) * Novo endpoint `GET /v2/estoque/requisicao/finalizadas` — retorna as requisições de estoque já finalizadas, com os mesmos parâmetros **Exemplo — Requisições de estoque pendentes:** ```http theme={null} GET /v2/estoque/requisicao/pendentes?filial=1&qtde=50 ``` ```json theme={null} [ { "numeroDaRequisicao": 771, "dataDaRequisicao": "2026-02-24T10:00:00", "codigoDoCentroDeCusto": "003", "pendente": true, "liberadoParaAprovacao": true } ] ``` *** ## Filtro por código do cliente e campo de competência em Contas a Receber **O que mudou:** * Novo parâmetro opcional `codigoDoCliente` (`int`) em `GET /v2/financeiro/contasreceber` e `GET /v2/financeiro/contasreceber/baixados` — filtra os títulos a receber de um cliente específico * Novo campo `PeriodoDeCompetencia` (`datetime`, opcional) no retorno de ambos os endpoints **Exemplo — Títulos baixados de um cliente específico:** ```http theme={null} GET /v2/financeiro/contasreceber/baixados?codigoDoCliente=1523 ``` ```json theme={null} { "numeroDaTransacao": 88231, "codigoDoCliente": 1523, "dataDeEmissao": "2026-01-10T00:00:00", "periodoDeCompetencia": "2026-01-01T00:00:00", "dataDePagamento": "2026-01-20T00:00:00" } ``` *** Notou algo que não está documentado ou tem sugestões para este changelog? Fale com o time de integração Gestio.