{"openapi":"3.1.0","info":{"title":"Promoter — Public Read API","version":"1.0.0","description":"API REST somente-leitura e multitenant para consulta dos dados do Promoter (cadastro, execução, campo, fotos, planner). O tenant é resolvido pelo token (X-API-Key). Paginação por cursor (keyset). Apenas verbos GET."},"servers":[{"url":"https://promoter-api.laivon.com/v1"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Meta","description":"Descoberta do contrato."},{"name":"Cadastro","description":"Clientes, PDVs, agentes, produtos, formulários, equipes, redes."},{"name":"Execução","description":"Atendimentos e cobertura."},{"name":"Campo","description":"Coletas de campo (field_*)."},{"name":"Fotos","description":"Evidências fotográficas."},{"name":"Planner","description":"Planejamento de visitas."}],"paths":{"/openapi.json":{"get":{"tags":["Meta"],"summary":"Documento OpenAPI desta API","security":[],"responses":{"200":{"description":"OpenAPI 3.1","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/clients":{"get":{"tags":["Cadastro"],"summary":"Lista clients","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"category_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID da categoria do cliente."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Client"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/clients/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de clients","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Client"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/locals":{"get":{"tags":["Cadastro"],"summary":"Lista locals","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"classification_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID da rede."},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"Cidade (ILIKE)."},{"name":"uf","in":"query","required":false,"schema":{"type":"string"},"description":"UF/estado (ILIKE)."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Local"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/locals/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de locals","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Local"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/agents":{"get":{"tags":["Cadastro"],"summary":"Lista agents","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"type_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID do tipo de agente."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Agent"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/agents/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de agents","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Agent"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/products":{"get":{"tags":["Cadastro"],"summary":"Lista products","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"subgroup_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID do subgrupo."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/products/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de products","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Product"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/product-groups":{"get":{"tags":["Cadastro"],"summary":"Lista product-groups","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductGroup"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/product-groups/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de product-groups","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ProductGroup"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/forms":{"get":{"tags":["Cadastro"],"summary":"Lista forms","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"project_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID do projeto."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Form"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/forms/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de forms","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Form"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/teams":{"get":{"tags":["Cadastro"],"summary":"Lista teams","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Team"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/teams/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de teams","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Team"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/classifications":{"get":{"tags":["Cadastro"],"summary":"Lista classifications","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Busca por nome (ILIKE)."},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtra por ativo/inativo."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Classification"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/classifications/{id}":{"get":{"tags":["Cadastro"],"summary":"Detalhe de classifications","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Classification"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/point-sale":{"get":{"tags":["Campo"],"summary":"Lista point-sale","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldPointSale"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/point-sale/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de point-sale","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldPointSale"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/prices":{"get":{"tags":["Campo"],"summary":"Lista prices","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldPrice"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/prices/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de prices","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldPrice"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/validity":{"get":{"tags":["Campo"],"summary":"Lista validity","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldValidity"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/validity/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de validity","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldValidity"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ruptures":{"get":{"tags":["Campo"],"summary":"Lista ruptures","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldRupture"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ruptures/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de ruptures","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldRupture"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/restocked":{"get":{"tags":["Campo"],"summary":"Lista restocked","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldRestocked"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/restocked/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de restocked","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldRestocked"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/breakdowns":{"get":{"tags":["Campo"],"summary":"Lista breakdowns","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"product_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de produto."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FieldBreakdown"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/breakdowns/{id}":{"get":{"tags":["Campo"],"summary":"Detalhe de breakdowns","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FieldBreakdown"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/photos":{"get":{"tags":["Fotos"],"summary":"Lista photos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"task_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de atendimento (task)."},{"name":"form_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de formulário."},{"name":"status","in":"query","required":false,"schema":{"type":"integer"},"description":"Status da foto (0=pendente, 1=aprovada, 2=recusada)."},{"name":"favorite","in":"query","required":false,"schema":{"type":"boolean"},"description":"Apenas destacadas."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Photo"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/photos/{id}":{"get":{"tags":["Fotos"],"summary":"Detalhe de photos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID interno do recurso."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Photo"},"meta":{"type":"null"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tasks":{"get":{"tags":["Execução"],"summary":"Lista atendimentos (tasks)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"situation_id","in":"query","required":false,"schema":{"type":"integer"},"description":"Código de situação (30 pend, 50 realizado, 70 cancelado)."},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Sync incremental: retorna registros atualizados a partir desta data (ISO-8601)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/coverage":{"get":{"tags":["Execução"],"summary":"Cobertura por cliente (planejado × realizado)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final (YYYY-MM-DD)."},{"name":"client_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de cliente, lista separada por vírgula (ex.: 1,2,3)."}],"responses":{"200":{"description":"OK (sem paginação; agregado por cliente)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CoverageRow"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/planner-records":{"get":{"tags":["Planner"],"summary":"Sistemática planejada (última versão por padrão)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Tamanho da página (máx 500)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de paginação (use meta.next_cursor da página anterior)."},{"name":"local_id","in":"query","required":false,"schema":{"type":"string"},"description":"IDs de PDV, lista separada por vírgula."},{"name":"agent_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID do agente."},{"name":"form_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID de formulário."},{"name":"week","in":"query","required":false,"schema":{"type":"integer"},"description":"Semana."},{"name":"version","in":"query","required":false,"schema":{"type":"integer"},"description":"Versão específica (default: a mais recente de cada planner)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlannerRecord"}},"meta":{"$ref":"#/components/schemas/Meta"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Token no formato pk_live_<key_id>.<secret>. Também aceito via Authorization: Bearer."}},"schemas":{"Meta":{"type":"object","properties":{"count":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}}},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"},"details":{"type":["object","null"],"additionalProperties":true}}},"request_id":{"type":["string","null"]}}},"Client":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"cnpj":{"type":["string","null"]},"corporate_name":{"type":["string","null"]},"client_category_id":{"type":["integer","null"]},"companie_id":{"type":["integer","null"]},"billing_type_id":{"type":["integer","null"]},"active":{"type":"boolean"},"defaulter":{"type":"boolean"},"date_start":{"type":["string","null"],"format":"date"},"date_contract":{"type":["string","null"],"format":"date"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Local":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"mix_id":{"type":["integer","null"]},"classification_id":{"type":["integer","null"]},"name":{"type":"string"},"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"neighborhood":{"type":["string","null"]},"street":{"type":["string","null"]},"number":{"type":["string","null"]},"complement":{"type":["string","null"]},"zipcode":{"type":["string","null"]},"corporate_name":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Agent":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"active":{"type":"boolean"},"agent_type_id":{"type":["integer","null"]},"access_level_id":{"type":["integer","null"]},"situation_agent_id":{"type":["integer","null"]},"project_id":{"type":["integer","null"]},"client_id":{"type":["integer","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"admission_date":{"type":["string","null"],"format":"date"},"birth_date":{"type":["string","null"],"format":"date"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Product":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"active":{"type":"boolean"},"product_subgroup_id":{"type":["integer","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"ProductGroup":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Form":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":"integer"},"name":{"type":"string"},"active":{"type":"boolean"},"display_order":{"type":["integer","null"]},"id_project":{"type":["integer","null"]},"client_id":{"type":["integer","null"]},"duration":{"type":["number","null"]},"price":{"type":["number","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Team":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Classification":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"name":{"type":"string"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldPointSale":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"amount":{"type":["number","null"]},"exist":{"type":"boolean"},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldPrice":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"competitor":{"type":"boolean"},"price":{"type":["number","null"]},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldValidity":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"amount":{"type":["number","null"]},"expiration_date":{"type":["string","null"],"format":"date"},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldRupture":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"rupture":{"type":"boolean"},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldRestocked":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"amount":{"type":["number","null"]},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"FieldBreakdown":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"task_id":{"type":"integer"},"amount":{"type":["number","null"]},"date":{"type":["string","null"],"format":"date"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Photo":{"type":"object","properties":{"id":{"type":"integer"},"local_id":{"type":"integer"},"client_id":{"type":"integer"},"product_id":{"type":"integer"},"form_id":{"type":"integer"},"task_id":{"type":"integer"},"photo":{"type":"string"},"code":{"type":["string","null"]},"description":{"type":["string","null"]},"observation":{"type":["string","null"]},"date":{"type":["string","null"],"format":"date"},"status":{"type":"integer"},"favorite":{"type":"boolean"},"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"Task":{"type":"object","properties":{"id":{"type":"integer"},"id_integration":{"type":["string","null"]},"situation_id":{"type":["integer","null"]},"id_agent":{"type":["integer","null"]},"id_local":{"type":["integer","null"]},"schedule_initial_dt":{"type":["string","null"],"format":"date-time"},"schedule_final_dt":{"type":["string","null"],"format":"date-time"},"real_initial_dt":{"type":["string","null"],"format":"date-time"},"real_final_dt":{"type":["string","null"],"format":"date-time"},"insert_dt":{"type":["string","null"],"format":"date-time"},"last_update_dt":{"type":["string","null"],"format":"date-time"},"type":{"type":["string","null"]},"agent_name":{"type":["string","null"]}}},"CoverageRow":{"type":"object","properties":{"client_id":{"type":["integer","null"]},"client_name":{"type":["string","null"]},"total":{"type":"integer"},"realized":{"type":"integer"},"pending":{"type":"integer"}}},"PlannerRecord":{"type":"object","properties":{"id":{"type":"integer"},"planner_id":{"type":"integer"},"planner_import_id":{"type":["integer","null"]},"local_id":{"type":"integer"},"agent_id":{"type":"integer"},"form_id":{"type":"integer"},"version":{"type":"integer"},"day":{"type":"integer"},"week":{"type":"integer"},"billing":{"type":"boolean"},"duration":{"type":["string","null"]},"step":{"type":"integer"},"activation":{"type":["number","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}}},"responses":{"BadRequest":{"description":"Parâmetro/filtro inválido (data, limit, cursor).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"Unauthorized":{"description":"Token ausente, malformado, inválido, expirado ou revogado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"Forbidden":{"description":"Escopo insuficiente ou tenant inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"NotFound":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"RateLimited":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}