{"openapi":"3.0.3","info":{"title":"Domínio Sync Ops API — Jaguar Contabilidade","version":"1.0.0","description":"\n**API de integração direta e leitura analítica do Domínio Sistemas (Sybase SQL Anywhere 17).**\n\nEsta API expõe consultas em tempo real para as aplicações da Jaguar Contabilidade:\n- **Monster Jaguar**: Conciliação de extratos bancários, contas a pagar/receber, fornecedores, histórico de acumuladores e líquidos de folha.\n- **Departamento Pessoal**: Afastamentos temporários e médicos (FOAFASTAMENTOS), férias/período aquisitivo (FOAQUISITIVOS), colaboradores ativos/históricos, volumetria da folha, rubricas e histórico salarial.\n- **Contábil**: Plano de contas analítico, balancetes clássicos e mensalizados, DRE, conferências extras de checklist, diagnósticos de provisões e saldos.\n- **Fiscal**: Faturamento, NCMs, CFOPs, apuração do Simples Nacional, volumetria e emissão de demonstrativos oficiais.\n- **Cadastros Gerais & Societário**: Empresas, sócios e módulos habilitados.\n- **Honorários**: Contas a receber do escritório, clientes, eventos e categorias.\n- **Inteligência Jaguar & BGR**: Snapshots, auditorias de plano de contas, fator R e prévias de relatórios.\n- **Sincronizações & Jobs (Background)**: Acionamento e consulta de status de todas as rotinas assíncronas (afastamentos, avisos, consignados, espelhos, produtos e SIEG).\n\n---\n### Autenticação\nEnvie a chave no cabeçalho **`X-API-Key`**.\nA chave padrão de produção já vem pré-configurada neste ambiente interativo.\n","contact":{"name":"Equipe de Tecnologia — Jaguar Contabilidade","url":"https://portal.jaguarcontabilidade.com.br"}},"servers":[{"url":"https://dominio-sync-api.jaguarcontabilidade.com.br","description":"Servidor Atual"},{"url":"https://dominio-sync-api.jaguarcontabilidade.com.br","description":"Produção VPS (Traefik / HTTPS)"},{"url":"http://localhost:8091","description":"Desenvolvimento Local"}],"tags":[{"name":"Monster Jaguar","description":"Consultas utilizadas pela esteira contábil e conciliação bancária"},{"name":"Departamento Pessoal","description":"Afastamentos, colaboradores, controle de férias, folha de pagamento e histórico funcional"},{"name":"Contabilidade & Balancete","description":"Plano de contas, balancetes, conferências do checklist, provisões e saldos"},{"name":"Fiscal & Faturamento","description":"Faturamento, operações CFOP, NCM, apuração do Simples Nacional e demonstrativos"},{"name":"Métricas Domínio","description":"Indicadores gerenciais próprios da Jaguar: horas, produtividade, volumetria por origem e percentual de digitação, calculados diretamente no Domínio sem dependência do e-Kontroll"},{"name":"Cadastros Gerais & Societário","description":"Empresas cadastradas, quadro de sócios e módulos do Domínio"},{"name":"Honorários do Escritório","description":"Módulo de honorários do Domínio Sistemas para gestão do escritório"},{"name":"Inteligência Jaguar & BGR","description":"Métricas avançadas, análise de Fator R, snapshots e relatórios BGR"},{"name":"Sincronizações & Jobs (Background)","description":"Disparadores de sincronização assíncrona e consulta de progresso"},{"name":"Sistema & Monitoramento","description":"Health check e integridade"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Chave de autenticação da API (header `X-API-Key`)"}},"schemas":{"VolumetriaOrigem":{"type":"object","required":["total","manual","importado","percentual_digitado","origens","por_origem_codigo"],"properties":{"total":{"type":"integer","example":205},"manual":{"type":"integer","example":9},"importado":{"type":"integer","example":196},"percentual_digitado":{"type":"number","format":"double","example":4.39},"origens":{"type":"object","properties":{"manual":{"type":"integer","example":9},"xml":{"type":"integer","example":191},"api":{"type":"integer","example":5},"outras":{"type":"integer","example":0}}},"por_origem_codigo":{"type":"object","additionalProperties":{"type":"integer"},"example":{"0":9,"5":191,"33":5}}}},"VolumetriaFiscalCompetencia":{"type":"object","properties":{"empresa_codigo":{"type":"string","example":"209"},"competencia":{"type":"string","example":"2026-01"},"entradas":{"$ref":"#/components/schemas/VolumetriaOrigem"},"saidas":{"$ref":"#/components/schemas/VolumetriaOrigem"},"servicos_tomados":{"$ref":"#/components/schemas/VolumetriaOrigem"},"servicos_prestados":{"$ref":"#/components/schemas/VolumetriaOrigem"},"transportes_tomados":{"$ref":"#/components/schemas/VolumetriaOrigem"},"outras_entradas":{"$ref":"#/components/schemas/VolumetriaOrigem"},"documentos_nao_fiscais":{"$ref":"#/components/schemas/VolumetriaOrigem"},"total_documentos":{"type":"integer","example":568}}}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/ops/monster-jaguar/contas-pagar":{"get":{"tags":["Monster Jaguar"],"summary":"Contas a Pagar do Domínio (EFENTRADASPAG)","description":"Lista parcelas de compras e serviços tomados registradas no módulo fiscal/financeiro.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"},"description":"Código da empresa"},{"name":"competencia","in":"query","required":false,"schema":{"type":"string","example":"2026-08"},"description":"Competência (AAAA-MM)"},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08-01"},"description":"Vencimento inicial (AAAA-MM-DD)"},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08-31"},"description":"Vencimento final (AAAA-MM-DD)"},{"name":"somenteAbertas","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"true"}},{"name":"maximo","in":"query","required":false,"schema":{"type":"integer","default":3000}}],"responses":{"200":{"description":"Lista de parcelas a pagar"}}}},"/ops/monster-jaguar/contas-receber":{"get":{"tags":["Monster Jaguar"],"summary":"Contas a Receber do Domínio (EFSAIDASPAR / EFSERVICOSPAR)","description":"Lista parcelas de vendas e serviços prestados para conciliação contábil.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"},"description":"Código da empresa"},{"name":"competencia","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08-31"}},{"name":"somenteAbertas","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"true"}}],"responses":{"200":{"description":"Lista de parcelas a receber"}}}},"/ops/monster-jaguar/fornecedores":{"get":{"tags":["Monster Jaguar"],"summary":"Fornecedores da Empresa (EFORNECEDORES / GEFORN)","description":"Consulta fornecedores cadastrados na empresa no Domínio.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por razão social ou CNPJ"},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":500}}],"responses":{"200":{"description":"Lista de fornecedores"}}}},"/ops/monster-jaguar/folha":{"get":{"tags":["Monster Jaguar"],"summary":"Líquidos da Folha por Colaborador (FOMOVTO)","description":"Consulta valores líquidos de salários e adiantamentos calculados na folha para casar com o extrato.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"dataDe","in":"query","required":false,"schema":{"type":"string"}},{"name":"dataAte","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Líquidos individuais da folha"}}}},"/ops/monster-jaguar/acumuladores":{"get":{"tags":["Monster Jaguar"],"summary":"Acumuladores Fiscais & Históricos de Baixa (EFACUMULADORES)","description":"Consulta acumuladores fiscais da empresa com seus respectivos códigos e textos de histórico de pagamento/baixa.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Lista de acumuladores"}}}},"/ops/pessoal/afastamentos":{"get":{"tags":["Departamento Pessoal"],"summary":"Afastamentos do Domínio em Tempo Real (FOAFASTAMENTOS)","description":"Consulta em tempo real os registros de afastamentos (médicos, licença maternidade, acidentes, etc.) direto do banco do Domínio com resolução de datas de término e dados do atestado/médico.","parameters":[{"name":"codiEmp","in":"query","required":false,"schema":{"type":"string","example":"35"},"description":"Código da empresa"},{"name":"colaborador","in":"query","required":false,"schema":{"type":"string"},"description":"Código do colaborador (i_empregados)"},{"name":"cpf","in":"query","required":false,"schema":{"type":"string"},"description":"CPF do colaborador"},{"name":"nome","in":"query","required":false,"schema":{"type":"string"},"description":"Nome do colaborador"},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-01-01"},"description":"Data limite inicial"},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-12-31"},"description":"Data limite final"},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":100}}],"responses":{"200":{"description":"Afastamentos encontrados"}}}},"/ops/pessoal/periodo-aquisitivo":{"get":{"tags":["Departamento Pessoal"],"summary":"Períodos Aquisitivos de Férias (FOAQUISITIVOS)","description":"Consulta os períodos aquisitivos de férias de um colaborador ou de toda a empresa, incluindo limites de gozo, dias de direito e saldo.","parameters":[{"name":"codiEmp","in":"query","required":false,"schema":{"type":"string","example":"35"}},{"name":"cpf","in":"query","required":false,"schema":{"type":"string"}},{"name":"nome","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Períodos aquisitivos encontrados"}}}},"/ops/api-jaguar/colaboradores":{"get":{"tags":["Departamento Pessoal"],"summary":"Cadastro Completo de Colaboradores (FOEMPREGADOS)","description":"Retorna a lista de empregados cadastrados com dados contratuais, cargos, salários, admissão, demissão e status.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"situacao","in":"query","required":false,"schema":{"type":"string","enum":["ATIVO","DEMITIDO","AFASTADO","TODOS"],"default":"ATIVO"}}],"responses":{"200":{"description":"Colaboradores encontrados"}}}},"/ops/api-jaguar/volumetria-folha":{"get":{"tags":["Departamento Pessoal"],"summary":"Volumetria Mensal da Folha","description":"Contagem e resumo de colaboradores processados na folha por competência.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Volumetria"}}}},"/ops/api-jaguar/folha-movimento":{"get":{"tags":["Departamento Pessoal"],"summary":"Movimento Analítico de Folha (Rubricas & Eventos)","description":"Retorna os eventos detalhados de proventos e descontos calculados.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"colaborador","in":"query","required":false,"schema":{"type":"string"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":500}}],"responses":{"200":{"description":"Movimento detalhado"}}}},"/ops/api-jaguar/historico-salarial":{"get":{"tags":["Departamento Pessoal"],"summary":"Histórico de Alterações Salariais (FOSALAR)","description":"Consulta o histórico de evolução e reajustes salariais dos empregados.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2025-01-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-12-31"}}],"responses":{"200":{"description":"Histórico salarial"}}}},"/ops/api-jaguar/historico-trocas":{"get":{"tags":["Departamento Pessoal"],"summary":"Histórico de Trocas de Cargo e Departamento","description":"Consulta o histórico de transferências de cargo, filial e departamento.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2025-01-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-12-31"}}],"responses":{"200":{"description":"Histórico de trocas"}}}},"/ops/complexidade/dp-movimento":{"get":{"tags":["Departamento Pessoal"],"summary":"Complexidade de Movimentações do DP","description":"Totalização de admissões, demissões, afastamentos e eventos na competência.","parameters":[{"name":"codiEmp","in":"query","required":false,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Métricas de DP"}}}},"/ops/calculos-trabalhistas/dominio/collaborators":{"get":{"tags":["Departamento Pessoal"],"summary":"Colaboradores para Módulo de Cálculos Trabalhistas","description":"Lista de empregados filtrados para conferência de verbas rescisórias e cálculo.","parameters":[{"name":"companyCode","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Colaboradores"}}}},"/ops/calculos-trabalhistas/dominio/competencias":{"get":{"tags":["Departamento Pessoal"],"summary":"Competências Calculadas do Colaborador","description":"Lista as competências com folha calculada para importação trabalhista.","parameters":[{"name":"companyCode","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"collaboratorCode","in":"query","required":true,"schema":{"type":"string","example":"1"}}],"responses":{"200":{"description":"Competências"}}}},"/ops/calculos-trabalhistas/dominio/import":{"post":{"tags":["Departamento Pessoal"],"summary":"Importação Detalhada de Folha para Cálculos Trabalhistas","description":"Importa todas as rubricas e bases de cálculo das competências informadas.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"collaboratorCode":{"type":"string","example":"1"},"competencias":{"type":"array","items":{"type":"string"},"example":["2026-07","2026-08"]}}}}}},"responses":{"200":{"description":"Importação realizada"}}}},"/ops/plano-contas":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Plano de Contas Analítico (CTCONTAS)","description":"Consulta contas analíticas do plano de contas da empresa, com código reduzido, classificação e nome.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":3000}}],"responses":{"200":{"description":"Contas do plano"}}}},"/ops/api-jaguar/plano-contas":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Plano de Contas via API Jaguar","description":"Consulta estrutura completa do plano de contas.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Plano de contas"}}}},"/ops/api-jaguar/balancete":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Balancete de Verificação Clássico","description":"Balancete analítico completo com saldo anterior, débitos, créditos e saldo atual.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Balancete"}}}},"/ops/api-jaguar/balancete-mensalizado":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Balancete Mensalizado (Mês a Mês)","description":"Retorna a evolução das contas do balancete distribuídas mês a mês no período informado.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Balancete mensalizado"}}}},"/ops/api-jaguar/estrutura-dre":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Estrutura da DRE da Empresa","description":"Consulta os grupos e mapeamento de contas da Demonstração do Resultado do Exercício.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Estrutura da DRE"}}}},"/ops/saldo-contas":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Saldo Pontual de Contas Contábeis","description":"Consulta o saldo de uma lista específica de contas contábeis no final de uma competência.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}},{"name":"contas","in":"query","required":false,"schema":{"type":"string","example":"5,8,9"}}],"responses":{"200":{"description":"Saldos das contas"}}}},"/ops/balancete-conferencia":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Balancete de Conferência do Checklist Contábil","description":"Cruzamento automatizado para o Checklist Contábil.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Conferência de balancete"}}}},"/ops/conferencias-extra":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Conferências Extras do Checklist (Depreciação, Honorários, Folha)","description":"Calcula depreciação acumulada, conferência de honorários e saldo de encargos trabalhistas em aberto.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Conferências extras"}}}},"/ops/conferencias-extra-diagnostico":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Diagnóstico das Conferências Extras","description":"Detalhamento analítico e rastreabilidade dos cálculos de depreciação e honorários.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Diagnóstico detalhado"}}}},"/ops/provisoes-conferencia":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Conferência de Provisões de 13º e Férias","description":"Compara os relatórios de provisão do módulo Folha contra os saldos contábeis do Balancete.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Conferência de provisões"}}}},"/ops/provisoes-diagnostico":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Diagnóstico de Provisões de 13º e Férias","description":"Bases de cálculo detalhadas por empregado e conciliação de divergências.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Diagnóstico de provisões"}}}},"/ops/contas-pagar-receber":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Conferência Contábil de Clientes e Fornecedores","description":"Compara o saldo do razão contábil das contas de clientes e fornecedores contra o financeiro.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Conferência de clientes e fornecedores"}}}},"/ops/contas-pagar-receber-diagnostico":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Diagnóstico de Clientes e Fornecedores","description":"Identifica lançamentos contábeis e financeiros sem correspondência.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Diagnóstico analítico"}}}},"/ops/cmv-cpv-dominio":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Conferência de CMV e CPV","description":"Apuração do Custo de Mercadorias Vendidas no Domínio.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"CMV/CPV"}}}},"/ops/historicos-validacao":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Validação de Históricos Contábeis","description":"Identifica lançamentos sem histórico padrão ou com descrições atípicas.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Históricos validados"}}}},"/ops/complexidade/lancamentos":{"get":{"tags":["Contabilidade & Balancete"],"summary":"Volumetria de Lançamentos Contábeis","description":"Contagem de partidas dobradas processadas na contabilidade.","parameters":[{"name":"codiEmp","in":"query","required":false,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Volumetria de lançamentos"}}}},"/ops/api-jaguar/faturamento":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Faturamento Geral da Empresa (Saídas & Serviços)","description":"Consulta o faturamento bruto fiscal apurado na escrita fiscal.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Faturamento"}}}},"/ops/api-jaguar/faturamento-ncm":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Faturamento por NCM de Produtos","description":"Faturamento analítico de mercadorias agrupado por classificação NCM.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Faturamento por NCM"}}}},"/ops/api-jaguar/operacoes-cfop":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Operações Fiscais por CFOP","description":"Totalização das notas fiscais por Código Fiscal de Operação (CFOP).","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","enum":["E","S"],"default":"S"}}],"responses":{"200":{"description":"Operações por CFOP"}}}},"/ops/api-jaguar/simples-nacional":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Apuração do Simples Nacional (PGDAS-D)","description":"Consulta receitas, alíquotas efetivas, anexos e valor do imposto calculado no Simples Nacional.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Apuração Simples Nacional"}}}},"/ops/api-jaguar/volumetria-fiscal":{"get":{"tags":["Métricas Domínio"],"summary":"Volumetria fiscal por família, origem e percentual digitado","description":"Indicador gerencial calculado **diretamente no Domínio**, sem dependência do e-Kontroll.\n\nA resposta separa corretamente as famílias que convivem em `EFENTRADAS`:\n- **entradas** — NF-e de mercadorias (ICMS);\n- **servicos_tomados** — NFS-e recebidas (ISS e retenções);\n- **transportes_tomados** — CT-e;\n- **outras_entradas** — espécies fiscais ainda não classificadas;\n- **documentos_nao_fiscais** — faturas/lançamentos gerenciais;\n- **saidas** e **servicos_prestados**.\n\nCada família contém `total`, `manual`, `importado`, `percentual_digitado`, origens nomeadas e\n`por_origem_codigo` para auditoria. Somente os códigos comprovados são nomeados:\n`0 = manual`, `5 = XML`, `33 = API`; os demais permanecem em `outras` sem de-para inventado.\n\nO período usa a **data de escrituração**, coerente com a competência fiscal. Situações 2, 6 e 9\n(cancelada/inválida conforme cadastro do Domínio) são excluídas. Dados históricos podem diferir de\nexports antigos de ferramentas terceiras quando houve lançamento retroativo após o snapshot.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"209"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","format":"date","example":"2026-01-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","format":"date","example":"2026-09-30"}}],"responses":{"200":{"description":"Volumetria mensal por família e origem","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","example":true},"rows":{"type":"array","items":{"$ref":"#/components/schemas/VolumetriaFiscalCompetencia"}},"meta":{"type":"object"}}}}}}}}},"/ops/api-jaguar/documentos-detalhados":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Documentos Fiscais Detalhados","description":"Lista individual de notas fiscais com chave de acesso de 44 dígitos, modelo, série e emitente.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","enum":["entrada","saida"],"default":"entrada"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":200}}],"responses":{"200":{"description":"Documentos detalhados"}}}},"/ops/api-jaguar/impostos":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Impostos & Guias Apuradas","description":"Resumo dos tributos calculados no módulo fiscal (ICMS, ISS, IRPJ, CSLL, PIS, COFINS, etc.).","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Impostos apurados"}}}},"/ops/saldos-fiscal":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Saldos do Módulo Fiscal vs Contábil","description":"Conferência de saldos apurados na escrita fiscal para conciliação contábil.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Saldos fiscais"}}}},"/ops/saldos-fiscal-impostos":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Saldos Fiscais de Impostos Retidos e Devidos","description":"Validação de retenções de impostos tomados e prestados.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}}],"responses":{"200":{"description":"Saldos de impostos"}}}},"/ops/api-jaguar/demonstrativo":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Demonstrativo Tributário Oficial (JSON & HTML)","description":"Gera o demonstrativo oficial de conferência com contrato analítico e template HTML renderizado.","parameters":[{"name":"tributo","in":"query","required":true,"schema":{"type":"string","enum":["simples-nacional"],"default":"simples-nacional"}},{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":true,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Demonstrativo gerado"}}}},"/ops/checklist-obrigacoes":{"get":{"tags":["Fiscal & Faturamento"],"summary":"Checklist de Obrigações Acessórias","description":"Verificação do status de envio e conferência de declarações obrigatórias.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string","example":"2026-08"}},{"name":"modo","in":"query","required":false,"schema":{"type":"string","enum":["resumo","detalhe"],"default":"resumo"}}],"responses":{"200":{"description":"Obrigações"}}}},"/ops/api-jaguar/fornecedores":{"get":{"tags":["Cadastros Gerais & Societário"],"summary":"Fornecedores via API Jaguar","description":"Consulta de fornecedores gerais cadastrados na base do Domínio.","parameters":[{"name":"codiEmp","in":"query","required":false,"schema":{"type":"string","example":"35"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Busca textual"},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":500}}],"responses":{"200":{"description":"Fornecedores encontrados"}}}},"/ops/api-jaguar/empresas":{"get":{"tags":["Cadastros Gerais & Societário"],"summary":"Empresas Cadastradas no Domínio (GEEMPRE)","description":"Lista as empresas cadastradas no Domínio com dados cadastrais e fiscais.","parameters":[{"name":"empresas","in":"query","required":false,"schema":{"type":"string","example":"35,682"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["ATIVO","INATIVO","TODOS"],"default":"ATIVO"}}],"responses":{"200":{"description":"Empresas"}}}},"/ops/api-jaguar/socios":{"get":{"tags":["Cadastros Gerais & Societário"],"summary":"Sócios & Administradores (GESOCIOS)","description":"Quadro societário com nomes, CPFs, percentual de quotas e cargos de administração.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Sócios"}}}},"/ops/quadro-societario":{"get":{"tags":["Cadastros Gerais & Societário"],"summary":"Quadro Societário Analítico","description":"Detalhamento do capital social, quotas e responsabilidade legal.","parameters":[{"name":"codiEmp","in":"query","required":true,"schema":{"type":"string","example":"35"}}],"responses":{"200":{"description":"Quadro societário"}}}},"/ops/api-jaguar/modulos":{"get":{"tags":["Cadastros Gerais & Societário"],"summary":"Módulos Ativos por Empresa","description":"Consulta quais módulos (Contabilidade, Escrita Fiscal, Folha) estão ativos em cada empresa.","responses":{"200":{"description":"Módulos"}}}},"/ops/api-jaguar/horas-modulo":{"get":{"tags":["Métricas Domínio"],"summary":"Horas trabalhadas por empresa, colaborador, competência e módulo","description":"Soma das sessões de login/logout do Domínio (`GELOGUSER`), agrupada no SQL Anywhere para suportar\nperíodos longos e consultas por colaborador. O total bruto foi confrontado com o método 1.04 do\ne-Kontroll: **16 de 18 competências coincidiram ao segundo**; as duas diferenças eram mês ainda aberto.\n\nUma sessão por módulo pode se sobrepor a outra. Por isso, o bruto é a métrica compatível com o\noráculo, mas não deve ser confundido com jornada trabalhista nem com tempo ativo — a tabela não\nregistra atividade/ociosidade. A união de intervalos deve ser exibida separadamente como indicador\ngerencial complementar.","parameters":[{"name":"empresas","in":"query","required":false,"schema":{"type":"string","example":"35"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Horas trabalhadas"}}}},"/ops/api-jaguar/clientes-honorarios":{"get":{"tags":["Honorários do Escritório"],"summary":"Clientes de Honorários (HRVCLIENTE)","description":"Cadastro dos clientes gerenciados no módulo de honorários da Jaguar Contabilidade.","parameters":[{"name":"escritorio","in":"query","required":false,"schema":{"type":"string","default":"1"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["ATIVO","INATIVO","TODOS"],"default":"ATIVO"}}],"responses":{"200":{"description":"Clientes de honorários"}}}},"/ops/api-jaguar/contas-receber":{"get":{"tags":["Honorários do Escritório"],"summary":"Contas a Receber de Honorários","description":"Parcelas e faturamento emitido contra os clientes do escritório.","parameters":[{"name":"escritorio","in":"query","required":false,"schema":{"type":"string","default":"1"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Contas a receber"}}}},"/ops/api-jaguar/contas-pagas-escritorio":{"get":{"tags":["Honorários do Escritório"],"summary":"Contas Pagas do Próprio Escritório","description":"Despesas e pagamentos quitados pela própria Jaguar.","parameters":[{"name":"escritorio","in":"query","required":false,"schema":{"type":"string","default":"1"}},{"name":"de","in":"query","required":false,"schema":{"type":"string","example":"2026-08-01"}},{"name":"ate","in":"query","required":false,"schema":{"type":"string","example":"2026-08-31"}}],"responses":{"200":{"description":"Contas pagas"}}}},"/ops/api-jaguar/categorias-honorarios":{"get":{"tags":["Honorários do Escritório"],"summary":"Categorias de Serviços de Honorários","description":"Classificação dos serviços cobrados dos clientes.","parameters":[{"name":"escritorio","in":"query","required":false,"schema":{"type":"string","default":"1"}}],"responses":{"200":{"description":"Categorias"}}}},"/ops/api-jaguar/eventos-honorarios":{"get":{"tags":["Honorários do Escritório"],"summary":"Eventos de Faturamento de Honorários","description":"Tabela de eventos e lançamentos de honorários.","parameters":[{"name":"escritorio","in":"query","required":false,"schema":{"type":"string","default":"1"}}],"responses":{"200":{"description":"Eventos"}}}},"/ops/honorarios-grupos/cache":{"get":{"tags":["Honorários do Escritório"],"summary":"Cache de Grupos de Empresas & Clientes","description":"Mapeamento consolidado de grupos econômicos para rateio de honorários.","responses":{"200":{"description":"Grupos e cache"}}}},"/ops/inteligencia-jaguar/companies":{"get":{"tags":["Inteligência Jaguar & BGR"],"summary":"Busca de Empresas na Inteligência Jaguar","description":"Busca unificada de empresas com dados consolidados para painéis executivos.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","example":"ACIAJA"}}],"responses":{"200":{"description":"Empresas encontradas"}}}},"/ops/inteligencia-jaguar/snapshot":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Snapshot Analítico de Empresa","description":"Gera consolidação contábil, financeira e fiscal dos últimos N meses.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"months":{"type":"integer","default":12}}}}}},"responses":{"200":{"description":"Snapshot gerado"}}}},"/ops/inteligencia-jaguar/employee":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Perfil Analítico do Colaborador (Inteligência)","description":"Histórico detalhado de custos, folha e afastamentos do empregado.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"employeeCode":{"type":"string","example":"56"}}}}}},"responses":{"200":{"description":"Perfil analítico"}}}},"/ops/inteligencia-jaguar/payroll-events":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Eventos Analíticos da Folha (Inteligência)","description":"Detalhamento de rubricas e impacto orçamentário.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"competencia":{"type":"string","example":"2026-08"}}}}}},"responses":{"200":{"description":"Eventos analíticos"}}}},"/ops/inteligencia-jaguar/validacao-plano-contas":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Auditoria e Validação do Plano de Contas","description":"Audita amarração de contas com o plano referencial e DRE.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"}}}}}},"responses":{"200":{"description":"Resultado da auditoria"}}}},"/ops/faturamento-prolabore":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Análise de Fator R (Faturamento × Pró-Labore)","description":"Cruza a receita de serviços com as retiradas de pró-labore para enquadramento no Simples Nacional.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"de":{"type":"string","example":"2025-08-01"},"ate":{"type":"string","example":"2026-08-31"}}}}}},"responses":{"200":{"description":"Análise do Fator R"}}}},"/ops/bgr/preview":{"post":{"tags":["Inteligência Jaguar & BGR"],"summary":"Prévia do Relatório BGR (Business & Growth Report)","description":"Gera a prévia consolidada de métricas gerenciais, faturamento e custos para o cliente.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companyCode":{"type":"string","example":"35"},"competencia":{"type":"string","example":"2026-08"}}}}}},"responses":{"200":{"description":"Prévia BGR"}}}},"/ops/pessoal-afastamentos/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status da Sincronização de Afastamentos DP","description":"Retorna o status atual da rotina de sincronização de afastamentos para o Supabase.","responses":{"200":{"description":"Status da sincronização"}}}},"/ops/pessoal-afastamentos/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sincronização de Afastamentos DP","description":"Inicia o processo em background que extrai afastamentos do Domínio e atualiza o módulo do Portal Interno.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Sincronização iniciada"}}}},"/ops/pessoal-avisos/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status da Sincronização de Avisos de Vencimento","responses":{"200":{"description":"Status"}}}},"/ops/pessoal-avisos/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sincronização de Avisos de Vencimento","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"competencia":{"type":"string","example":"2026-08"},"company_codes":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Iniciada"}}}},"/ops/pessoal-consignado/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status da Sincronização de Consignados","responses":{"200":{"description":"Status"}}}},"/ops/pessoal-consignado/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sincronização de Empréstimos Consignados","responses":{"200":{"description":"Iniciada"}}}},"/ops/controle-folha-dp/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Controle da Folha DP","responses":{"200":{"description":"Status"}}}},"/ops/controle-folha-dp/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sincronização do Controle da Folha DP","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"competencia":{"type":"string","example":"2026-08"},"company_codes":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Iniciada"}}}},"/ops/calculos-trabalhistas-dominio/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Sync de Cálculos Trabalhistas","responses":{"200":{"description":"Status"}}}},"/ops/calculos-trabalhistas-dominio/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sync de Cálculos Trabalhistas","responses":{"200":{"description":"Iniciada"}}}},"/ops/dp-validacao-eventos/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status da Validação de Eventos DP","responses":{"200":{"description":"Status"}}}},"/ops/dp-validacao-eventos/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sync de Validação de Eventos DP","responses":{"200":{"description":"Iniciada"}}}},"/ops/dominio-mirror/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Espelho do Domínio (Empresas/Filiais)","responses":{"200":{"description":"Status"}}}},"/ops/dominio-mirror/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Atualização do Espelho do Domínio","responses":{"200":{"description":"Iniciada"}}}},"/ops/dominio-produtos/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Sync de Produtos do Domínio","responses":{"200":{"description":"Status"}}}},"/ops/dominio-produtos/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sync de Produtos do Domínio","responses":{"200":{"description":"Iniciada"}}}},"/ops/dominio-fornecedores/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Sync de Fornecedores do Domínio","responses":{"200":{"description":"Status"}}}},"/ops/dominio-fornecedores/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sync de Fornecedores do Domínio","responses":{"200":{"description":"Iniciada"}}}},"/ops/sieg-nsu/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Sync SIEG por NSU","responses":{"200":{"description":"Status"}}}},"/ops/sieg-nsu/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Sync SIEG por NSU","responses":{"200":{"description":"Iniciada"}}}},"/ops/sieg-backfill/status":{"get":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Status do Backfill SIEG","responses":{"200":{"description":"Status"}}}},"/ops/sieg-backfill/sync":{"post":{"tags":["Sincronizações & Jobs (Background)"],"summary":"Disparar Backfill SIEG por Período","responses":{"200":{"description":"Iniciada"}}}},"/health":{"get":{"tags":["Sistema & Monitoramento"],"summary":"Health Check do Serviço","description":"Retorna o status operacional do daemon dominio-sync-ops e das rotinas de sincronização.","security":[],"responses":{"200":{"description":"Serviço ativo","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","example":true},"service":{"type":"string","example":"dominio-sync-ops"},"status":{"type":"string","example":"idle"}}}}}}}}}}}