{"openapi":"3.0.3","info":{"title":"Vestillo — API de consulta","version":"1.0.0","description":"Servico independente no SERVERAP. Apenas leitura. Decimais sao strings para preservar precisao; datas civis conservam a data do Vestillo. after_id serve para paginar, nao para detectar alteracoes/exclusoes. Paginas ao vivo nao compartilham snapshot; tabelas MyISAM nao garantem consistencia atomica entre entidades. Esta API propria nao e fornecida pelo fabricante."},"servers":[{"url":"https://serverap.tail40a33a.ts.net"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Chave individual; enviar somente Authorization: Bearer <chave>. Nunca pela URL."}},"schemas":{"Page":{"type":"object","required":["data","next_after_id","queried_at"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_after_id":{"type":"integer","nullable":true},"queried_at":{"type":"string","format":"date-time"},"source":{"type":"string"}}}}},"paths":{"/v1/data/orders":{"get":{"operationId":"list_orders","tags":["Consultas"],"summary":"Ordens de produção","description":"Cabeçalhos de OP; datas civis da origem e situações originais.\n\nCampos: id, company_id, reference, status, issued_at, entered_at, planned_cut_at, cut_at, released_at, planned_sewing_at, planned_finish_at, finished_at, warehouse_id, collection_id, operations_only","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"reference","in":"query","required":false,"description":"Filtro exato pelo campo reference.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filtro exato pelo campo status.","schema":{"type":"string"}},{"name":"collection_id","in":"query","required":false,"description":"Filtro exato pelo campo collection_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/order_items":{"get":{"operationId":"list_order_items","tags":["Consultas"],"summary":"Itens de OP","description":"Quantidades salvas por produto, cor e tamanho; escopo pelo cabeçalho da OP.\n\nCampos: id, company_id, order_id, product_id, color_id, size_id, quantity, fulfilled_quantity, produced_quantity, damaged_quantity, defect_quantity, faction_quantity, status, finished, planned_date","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"order_id","in":"query","required":false,"description":"Filtro exato pelo campo order_id.","schema":{"type":"string"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}},{"name":"color_id","in":"query","required":false,"description":"Filtro exato pelo campo color_id.","schema":{"type":"string"}},{"name":"size_id","in":"query","required":false,"description":"Filtro exato pelo campo size_id.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filtro exato pelo campo status.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/order_releases":{"get":{"operationId":"list_order_releases","tags":["Consultas"],"summary":"Liberações de OP","description":"Liberações vinculadas à mesma OP do item, sem resolver vínculos contraditórios.\n\nCampos: id, company_id, order_id, order_item_id, product_id, color_id, size_id, quantity","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"order_id","in":"query","required":false,"description":"Filtro exato pelo campo order_id.","schema":{"type":"string"}},{"name":"order_item_id","in":"query","required":false,"description":"Filtro exato pelo campo order_item_id.","schema":{"type":"string"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/products":{"get":{"operationId":"list_products","tags":["Consultas"],"summary":"Produtos","description":"Cadastro operacional mínimo, sem observações livres, imagens ou credenciais.\n\nCampos: id, company_id, reference, description, active, item_type, group_id, collection_id, unit_id, secondary_unit_id, conversion_factor, conversion_type, package_quantity, setup_minutes, created_at, changed_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"reference","in":"query","required":false,"description":"Filtro exato pelo campo reference.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}},{"name":"item_type","in":"query","required":false,"description":"Filtro exato pelo campo item_type.","schema":{"type":"string"}},{"name":"group_id","in":"query","required":false,"description":"Filtro exato pelo campo group_id.","schema":{"type":"string"}},{"name":"collection_id","in":"query","required":false,"description":"Filtro exato pelo campo collection_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/product_variants":{"get":{"operationId":"list_product_variants","tags":["Consultas"],"summary":"Grades de produtos","description":"Cor, tamanho e código de barras; escopo pelo produto.\n\nCampos: id, company_id, product_id, color_id, size_id, barcode, disabled, changed_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}},{"name":"color_id","in":"query","required":false,"description":"Filtro exato pelo campo color_id.","schema":{"type":"string"}},{"name":"size_id","in":"query","required":false,"description":"Filtro exato pelo campo size_id.","schema":{"type":"string"}},{"name":"barcode","in":"query","required":false,"description":"Filtro exato pelo campo barcode.","schema":{"type":"string"}},{"name":"disabled","in":"query","required":false,"description":"Filtro exato pelo campo disabled.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/technical_sheets":{"get":{"operationId":"list_technical_sheets","tags":["Consultas"],"summary":"Fichas de operações","description":"Valores salvos da ficha; não recalcula históricos nem substitui os contratos de custos.\n\nCampos: id, company_id, product_id, active, total_minutes, uses_sheet_setup, setup_minutes, uses_sheet_package, package_quantity, created_at, changed_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/sheet_operations":{"get":{"operationId":"list_sheet_operations","tags":["Consultas"],"summary":"Operações das fichas","description":"Sequência, tempos e capacidades originais, sem escolher uma fórmula universal.\n\nCampos: id, company_id, sheet_id, operation_id, sequence, operation_description, sector_id, balance_id, timed_minutes, calculated_minutes, seconds, capacity_pieces, active","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"sheet_id","in":"query","required":false,"description":"Filtro exato pelo campo sheet_id.","schema":{"type":"string"}},{"name":"operation_id","in":"query","required":false,"description":"Filtro exato pelo campo operation_id.","schema":{"type":"string"}},{"name":"sector_id","in":"query","required":false,"description":"Filtro exato pelo campo sector_id.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/material_sheets":{"get":{"operationId":"list_material_sheets","tags":["Consultas"],"summary":"Fichas de materiais","description":"Cabeçalhos da ficha completa de materiais, vinculados à empresa declarada na origem.\n\nCampos: id, company_id, product_id, active, total, created_at, changed_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/sheet_materials":{"get":{"operationId":"list_sheet_materials","tags":["Consultas"],"summary":"Materiais das fichas","description":"Consumo, destino e custos salvos; destino produtivo não representa almoxarifado.\n\nCampos: id, company_id, sheet_id, material_product_id, destination_id, sequence, quantity, cost_percentage, unit_price, value, calculated_cost","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"sheet_id","in":"query","required":false,"description":"Filtro exato pelo campo sheet_id.","schema":{"type":"string"}},{"name":"material_product_id","in":"query","required":false,"description":"Filtro exato pelo campo material_product_id.","schema":{"type":"string"}},{"name":"destination_id","in":"query","required":false,"description":"Filtro exato pelo campo destination_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/packages":{"get":{"operationId":"list_packages","tags":["Consultas"],"summary":"Pacotes","description":"Pacotes vinculados à empresa do grupo; não infere empresa de pacotes órfãos.\n\nCampos: id, company_id, group_id, product_id, order_item_id, reference, color_id, size_id, quantity, produced_quantity, defect_quantity, alternative_quantity, completion, status, entered_at, exited_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"group_id","in":"query","required":false,"description":"Filtro exato pelo campo group_id.","schema":{"type":"string"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}},{"name":"order_item_id","in":"query","required":false,"description":"Filtro exato pelo campo order_item_id.","schema":{"type":"string"}},{"name":"reference","in":"query","required":false,"description":"Filtro exato pelo campo reference.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filtro exato pelo campo status.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/package_groups":{"get":{"operationId":"list_package_groups","tags":["Consultas"],"summary":"Grupos de pacotes","description":"Agrupamentos produtivos com empresa explícita.\n\nCampos: id, company_id, product_id, created_at","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"product_id","in":"query","required":false,"description":"Filtro exato pelo campo product_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/package_operations":{"get":{"operationId":"list_package_operations","tags":["Consultas"],"summary":"Operações dos grupos","description":"Tempos e sequências dos grupos usados pelos cupons; a precisão difere da ficha.\n\nCampos: id, company_id, group_id, operation_id, sector_id, balance_id, minutes, sequence","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"group_id","in":"query","required":false,"description":"Filtro exato pelo campo group_id.","schema":{"type":"string"}},{"name":"operation_id","in":"query","required":false,"description":"Filtro exato pelo campo operation_id.","schema":{"type":"string"}},{"name":"sector_id","in":"query","required":false,"description":"Filtro exato pelo campo sector_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/production":{"get":{"operationId":"list_production","tags":["Consultas"],"summary":"Apontamentos de produção","description":"Cupons brutos com escopo pela empresa do grupo do pacote; TempoOperacao não é eficiência.\n\nCampos: id, company_id, package_id, operation_id, employee_id, faction_id, date, sequence, operation_time","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"package_id","in":"query","required":false,"description":"Filtro exato pelo campo package_id.","schema":{"type":"string"}},{"name":"operation_id","in":"query","required":false,"description":"Filtro exato pelo campo operation_id.","schema":{"type":"string"}},{"name":"employee_id","in":"query","required":false,"description":"Filtro exato pelo campo employee_id.","schema":{"type":"string"}},{"name":"faction_id","in":"query","required":false,"description":"Filtro exato pelo campo faction_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/employees":{"get":{"operationId":"list_employees","tags":["Consultas"],"summary":"Funcionários — cadastro operacional","description":"Identificação operacional; exclui documentos, endereço, contatos, salário, imagem e credenciais.\n\nCampos: id, company_id, reference, name, active, calendar_id, shift_minutes, calculates_production","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"reference","in":"query","required":false,"description":"Filtro exato pelo campo reference.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/productivity":{"get":{"operationId":"list_productivity","tags":["Consultas"],"summary":"Resumos diários salvos","description":"Tempo e jornada persistidos; sem declarar Tempo/Jornada como eficiência de relatório.\n\nCampos: id, company_id, employee_id, date, productive_minutes, shift_minutes","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"employee_id","in":"query","required":false,"description":"Filtro exato pelo campo employee_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/manual_times":{"get":{"operationId":"list_manual_times","tags":["Consultas"],"summary":"Tempos manuais","description":"Lançamentos de tempo por funcionário e data, sem observações pessoais.\n\nCampos: id, company_id, employee_id, date, minutes","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"employee_id","in":"query","required":false,"description":"Filtro exato pelo campo employee_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/occurrences":{"get":{"operationId":"list_occurrences","tags":["Consultas"],"summary":"Ocorrências de jornada","description":"Identificador e duração da ocorrência; exclui texto livre e descrição que possa revelar informação pessoal.\n\nCampos: id, company_id, employee_id, occurrence_id, date, minutes","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"from","in":"query","required":false,"description":"Inicio civil inclusivo. Enviar junto de to; maximo 366 dias.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"employee_id","in":"query","required":false,"description":"Filtro exato pelo campo employee_id.","schema":{"type":"string"}},{"name":"occurrence_id","in":"query","required":false,"description":"Filtro exato pelo campo occurrence_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/data/standard_operations":{"get":{"operationId":"list_standard_operations","tags":["Consultas"],"summary":"Operações padrão","description":"Catálogo operacional associado explicitamente à empresa.\n\nCampos: id, company_id, reference, description, active, sector_id, balance_id, manual","parameters":[{"name":"company_id","in":"query","required":false,"description":"Empresa autorizada. Omitido: empresas explicitamente liberadas para a chave.","schema":{"type":"integer","minimum":1}},{"name":"after_id","in":"query","required":false,"description":"Cursor retornado pela pagina anterior. Nao e um filtro de alteracoes.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Registros por pagina.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"reference","in":"query","required":false,"description":"Filtro exato pelo campo reference.","schema":{"type":"string"}},{"name":"active","in":"query","required":false,"description":"Filtro exato pelo campo active.","schema":{"type":"string"}},{"name":"sector_id","in":"query","required":false,"description":"Filtro exato pelo campo sector_id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pagina autorizada; vazia somente se a consulta terminou sem registros.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/catalog":{"get":{"operationId":"catalog","summary":"Catalogo e empresas liberados para a chave","responses":{"200":{"description":"Conjuntos, campos, filtros e empresas autorizados."},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/v1/ready":{"get":{"operationId":"readiness","summary":"Conectividade de leitura com o banco","responses":{"200":{"description":"Banco acessivel com transacao somente leitura."},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}},"/health":{"get":{"operationId":"health","summary":"Estado do processo; nao comprova acesso ao banco","security":[],"responses":{"200":{"description":"Processo em execucao."}}}},"/v1/indicators/employee-production":{"get":{"operationId":"employee_production","tags":["Indicadores"],"summary":"Produtividade e eficiencia por funcionario","description":"Reconstrucao de minutos e denominadores conforme modalidade. daily: linhas por dia; report: linha do funcionario no periodo, nao rodape sintetico. Base incompleta devolve unavailable e motivos, nunca percentual inventado. Comparacao operacional integral ainda depende de validacao com os relatorios do Vestillo.","parameters":[{"name":"company_id","in":"query","required":true,"description":"Empresa autorizada.","schema":{"type":"integer","minimum":1}},{"name":"employee_id","in":"query","required":true,"description":"Funcionario da empresa.","schema":{"type":"integer","minimum":1}},{"name":"date_from","in":"query","required":true,"description":"Inicio civil inclusivo; periodo maximo 31 dias.","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":true,"description":"Fim civil inclusivo.","schema":{"type":"string","format":"date"}},{"name":"mode","in":"query","required":true,"description":"Contrato de calculo explicito.","schema":{"type":"string","enum":["daily","report"]}}],"responses":{"200":{"description":"Componentes e indices com disponibilidade e limitacoes explicitadas."},"422":{"description":"Fonte excedeu a cota de linhas; reduza o periodo. Nenhum indice parcial e devolvido."},"400":{"description":"Filtro invalido; confira nomes, datas e limites."},"401":{"description":"Chave ausente, expirada ou revogada."},"403":{"description":"Empresa ou conjunto nao permitido para esta chave."},"429":{"description":"Limite de consultas; respeite Retry-After."},"503":{"description":"Banco indisponivel ou limite de concorrencia; nao representa lista vazia."}}}}}}