Pular para o conteúdo

Changelog

As entradas vão da mais recente para a mais antiga e cobrem tanto a Ligga API quanto este portal. Mudanças anteriores a 21 de maio de 2026 estão no histórico do repositório.

2026-10-05 — Expansão operacional (candidata, ainda não publicada)

Seção intitulada “2026-10-05 — Expansão operacional (candidata, ainda não publicada)”
  • Catálogo — itens, produtos, serviços, combos, categorias, composições, fornecedores e imagens.
  • Vendas — criação e edição atômicas de itens e parcelas, recebimentos parciais, estornos e cancelamento com recomposição do estoque.
  • Despesas — parcelas, rateios, recorrência, baixas parciais e estornos.
  • Financeiro — escrita de contas, PIX, carteiras, cartões, maquininhas e taxas; transferências internas, pagamentos de faturas, abertura de saldo e extrato.
  • Consistência — comandos financeiros usam Idempotency-Key UUID e resultado gravado na mesma transação; conflitos de estado retornam 409 resource_conflict.
  • Escopo — Produção, Repasses, Documentos e Vitrines não fazem parte desta expansão. Os lançamentos registram operações internas do LIGGA; não movimentam dinheiro em bancos ou adquirentes.
  • Publicação — implementação e testes locais. A ativação depende da aplicação coordenada do banco e dos handlers, com validação em DEV antes de produção.
  • Adicionado — clientes e fornecedores com subcadastros, vínculos, campos e documentos.
  • Adicionado — agendas, tipos de evento, regras, modelos, horários disponíveis e escrita de agendamentos.
  • Adicionado — consultas de carteiras, cartões, faturas, maquininhas e taxas.
  • Alterado — plano e limites efetivos ficam em GET /v1/team. GET /v1/me retorna somente a chave.
  • Adicionado — contrato e usuários da equipe com acesso somente leitura.
  • Alterado — idempotência em todas as escritas, com reserva durável e tratamento de resultado indeterminado.
  • Retirado da API pública — Pets, Projetos, Oportunidades, Formulários e Veículos. As páginas antigas explicam o escopo atual.
  • Organização — serviços e produtos sob Catálogo; referência com a mesma tipografia e temas do portal.
  • Alterado — navegação organizada em Catálogo (produtos e serviços), Financeiro, Agenda e Cadastros.
  • Retirado do portal — quadro de sugestões e seu login. Os dados existentes foram preservados.
  • Escopo atual — Projetos, Oportunidades e Formulários estão adiados. A API de frota está fora do desenvolvimento. As páginas e contratos de leitura já existentes foram preservados para integrações em uso.
  • Adicionado — dez recursos novos, somente leitura: Agendamentos (appointments), Serviços (services), Produtos (products), Estoque (inventory), Contas bancárias (bank-accounts), Projetos (projects), Oportunidades (deals, com /v1/deals/stages), Formulários (forms), Veículos (vehicles) e Pets (pets). Todos com paginação por cursor, filtros e verificação do módulo do contrato.
  • Adicionado — página própria para cada um dos catorze recursos, na seção Recursos, com campos, filtros e exemplos.

Programa de API v2: módulos, burst e chaves com checksum

Seção intitulada “Programa de API v2: módulos, burst e chaves com checksum”
  • Adicionado — acesso por módulo do Monte seu Plano: cada recurso passa a exigir o módulo correspondente habilitado no contrato, com os erros 403 api_disabled e 403 module_not_enabled. Veja Módulos e escopos.
  • Adicionado — novo formato de chave de API, com 34 caracteres e checksum CRC32 embutido. As chaves no formato anterior continuam válidas.
  • Adicionado — janela de burst por segundo, somada às cotas por minuto e por dia. Os valores por plano estão em Limites de requisições.
  • Adicionado — restrição opcional de IP por chave, com o erro 403 ip_not_allowed.
  • Alterado — GET /v1/me passa a devolver modules e rate_limits.burst_per_second.
  • Adicionado — guias Módulos e escopos e Modo teste.
  • Adicionado — portal de documentação em docs.ligga.app.
  • Adicionado — guias migrados do material antigo, mais dois novos: Idempotência e Formatos de identificador.
  • Adicionado — exemplos por linguagem para cURL, Node.js, Python, PHP e n8n.
  • Adicionado — três receitas iniciais.
  • Adicionado — quadro público de sugestões, retirado do portal em 08/09/2026.