{"openapi":"3.1.0","info":{"title":"SZ Open API","version":"0.0.1"},"servers":[{"url":"https://app.solarz.com.br"}],"paths":{"/openApi/seller/plant/premium/voucher":{"put":{"tags":["plants"],"summary":"Resgatar vouchers para plantas","description":"Recebe uma lista de pares plantId e voucherCode, resgata o máximo possível e retorna os resultados com erros quando houver","operationId":"redeemVouchers","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VoucherRedeemItemDto"}}}},"required":true},"responses":{"200":{"description":"Resultado do resgate dos vouchers","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VoucherRedeemResultDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VoucherRedeemResultDto"}}}}}}},"/openApi/seller/plant/monitoring":{"put":{"tags":["plant-management"],"summary":"Configurar monitoramento de usinas","description":"Define se uma ou mais usinas são monitoradas (ativas) ou não monitoradas (arquivadas)","operationId":"setPlantMonitoring","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantMonitoringForm"}}},"required":true},"responses":{"200":{"description":"Status de monitoramento atualizado","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Requisição inválida","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"403":{"description":"Sem permissão sobre a usina","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/ticket":{"post":{"tags":["tickets"],"summary":"Cria ticket","description":"Cria um ticket por usina (singleTicket=false, padrão) ou um ticket único para todas as usinas (singleTicket=true). Cada usina precisa estar visível ao usuário, monitorada e premium. title, description e checklist são texto puro: marcações como @[nome](id) ou #[nome](id) são recusadas. type e plantIds são obrigatórios; subtypeId tem que ser um subtipo disponível à conta e é obrigatório quando a conta exige subtipo. assigneeIds são usuários da conta. dueDate no formato yyyy-MM-dd. Limites por requisição: até 100 plantIds, 50 itens de checklist e 20 assigneeIds; acima disso, divida em várias chamadas. Com singleTicket=false a criação não é atômica: cada usina é gravada separadamente, então em erro ou timeout parte dos tickets pode já ter sido criada. Antes de repetir a chamada, consulte /openApi/seller/ticket/list para não duplicar. Resposta: os tickets criados, no formato de /openApi/seller/ticket/list.","operationId":"create","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCreateForm"}}},"required":true},"responses":{"200":{"description":"Tickets criados","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}}},"400":{"description":"Validação: usina, responsável, subtipo, marcação ou campo obrigatório","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}}}}}},"/openApi/seller/ticket/{ticketId}":{"post":{"tags":["tickets"],"summary":"Altera ticket","description":"Alteração parcial: só muda o campo enviado. Campos: title, description, type, subtypeId, status, dueDate, assigneeIds (substitui a lista, até 20), affectsPerformance, affectsReport. dueDate e subtypeId aceitam null para limpar. Trocar type sem enviar subtypeId remove o subtipo; para manter um, envie subtypeId do novo tipo junto. Diferente da criação, a alteração não exige subtipo mesmo quando a conta exige: subtypeId null ou troca de type sem subtypeId deixam o ticket sem subtipo, como na edição pela tela. Texto puro, sem marcações. Gera o mesmo histórico da tela; concluir ticket com affectsPerformance fecha os alertas das usinas. Se o ticket mudar durante a gravação, responde 400 e a chamada pode ser repetida. Resposta: o ticket no formato de /openApi/seller/ticket/list.","operationId":"update","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiTicketUpdateForm"}}},"required":true},"responses":{"200":{"description":"Ticket alterado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}},"400":{"description":"Validação, JSON inválido ou ticket modificado durante a gravação","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}}}}}}},"/openApi/seller/ticket/{ticketId}/plant/{plantId}/remove":{"post":{"tags":["tickets"],"summary":"Remove usina do ticket","description":"Desvincula a usina do ticket e registra USINA_REMOVIDA no histórico. O ticket precisa manter pelo menos uma usina: remover a última responde 400.","operationId":"removePlant","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"plantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"Usina removida"},"400":{"description":"Usina fora do ticket, sem permissão ou última usina"},"401":{"description":"Unauthorized"},"404":{"description":"Ticket não encontrado para o integrador"}}}},"/openApi/seller/ticket/{ticketId}/comments":{"get":{"tags":["tickets"],"summary":"Comentários paginados do ticket","description":"Comentários do ticket, mais recentes primeiro. content vem em markdown: o texto digitado pelo usuário sai escapado, e as únicas marcações ativas são as geradas pela Solarz. Anexos do ticket viram link [arquivo](url) com URL pré-assinada do S3 (vale por poucos minutos; renove em /openApi/seller/ticket/{ticketId}/attachments), seguido de _(não verificado por antivírus)_ quando virusScan não é CLEAN; anexo com vírus (INFECTED) não vira link. Menções viram **@Nome (email)**. Sanitize HTML ao renderizar. page é 1-based, no pedido e na resposta; pageSize entre 1 e 100 (padrão 20).","operationId":"comments","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"Página de comentários","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketCommentDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketCommentDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketCommentDto"}}}}}},"post":{"tags":["tickets"],"summary":"Comenta no ticket","description":"Comentário em texto puro (até 5120 caracteres), gravado sem os espaços das pontas, como na tela. Marcações como @[nome](id) ou #[nome](id) são recusadas: pela Open API não há menção nem citação de anexo. Resposta igual ao item de GET /openApi/seller/ticket/{ticketId}/comments.","operationId":"comment","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCommentForm"}}},"required":true},"responses":{"200":{"description":"Comentário criado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCommentDto"}}}},"400":{"description":"Texto vazio, longo demais, com marcação ou com caractere nulo","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCommentDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCommentDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketCommentDto"}}}}}}},"/openApi/seller/ticket/{ticketId}/checklist":{"get":{"tags":["tickets"],"summary":"Checklist do ticket","description":"Todos os itens, sem paginação, na ordem da tela: createdAt crescente (empate: id). Não há teto de itens por ticket, como na tela.","operationId":"checklist","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Itens do checklist","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}}}},"post":{"tags":["tickets"],"summary":"Adiciona itens ao checklist","description":"Lista de itens { text, done }, um ou vários. text é texto puro (até 255): marcações como @[nome](id) ou #[nome](id) são recusadas. No máximo 50 itens por requisição e 200 no checklist do ticket. Resposta: os itens criados.","operationId":"addChecklistItems","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemForm"}}}},"required":true},"responses":{"200":{"description":"Itens criados","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}},"400":{"description":"{\"msg\"}: corpo ausente ou que não é lista, lista vazia ou acima de 50 itens, checklist do ticket acima de 200 itens, text vazio, acima de 255, com marcação ou com U+0000 (a mensagem indica o item: [i].text)","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}}}}},"/openApi/seller/ticket/{ticketId}/checklist/{itemId}":{"post":{"tags":["tickets"],"summary":"Edita item do checklist","description":"{ text?, done? }: só muda o que vier. text é texto puro (até 255), sem marcações.","operationId":"editChecklistItem","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiTicketChecklistEditForm"}}},"required":true},"responses":{"200":{"description":"Item alterado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}},"400":{"description":"{\"msg\"}: text vazio, acima de 255, com marcação ou com U+0000; corpo ilegível","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}},"404":{"description":"Ticket ou item não encontrado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemDto"}}}}}}},"/openApi/seller/ticket/{ticketId}/checklist/{itemId}/remove":{"post":{"tags":["tickets"],"summary":"Remove item do checklist","operationId":"removeChecklistItem","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"Item removido"},"401":{"description":"Unauthorized"},"404":{"description":"Ticket ou item não encontrado"}}}},"/openApi/seller/ticket/{ticketId}/checklist/clear":{"post":{"tags":["tickets"],"summary":"Limpa o checklist do ticket","operationId":"clearChecklist","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"Checklist limpo"},"401":{"description":"Unauthorized"},"404":{"description":"Ticket não encontrado para o integrador"}}}},"/openApi/seller/ticket/{ticketId}/attachments":{"get":{"tags":["tickets"],"summary":"Anexos paginados do ticket","description":"Todos os anexos do ticket, mais recentes primeiro, cada um com URL pré-assinada do S3 gerada na hora (vale por poucos minutos; chame de novo para renovar). virusScan: CLEAN (verificado e liberado), PENDING (ainda não verificado), INFECTED (vírus detectado) ou NOT_SCANNED (enviado antes de a verificação existir). Arquivo que não está CLEAN não foi garantido pela Solarz; baixá-lo é responsabilidade do cliente. page é 1-based, no pedido e na resposta; pageSize entre 1 e 100 (padrão 20).","operationId":"attachments","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"Página de anexos","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketAttachmentDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketAttachmentDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketAttachmentDto"}}}}}},"post":{"tags":["tickets"],"summary":"Anexa arquivo ao ticket","description":"Multipart com o campo file (até 10 MB). O tipo é conferido pelo conteúdo e precisa bater com o Content-Type da parte. O arquivo entra como virusScan PENDING até a verificação de vírus. Respeita a cota de armazenamento da conta. Resposta no formato de um item de GET /openApi/seller/ticket/{ticketId}/attachments.","operationId":"attach","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"Anexo criado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"400":{"description":"{\"msg\"}: file ausente ou vazio, nome do arquivo ausente, acima de 255 caracteres ou com U+0000, tipo não suportado ou diferente do declarado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"413":{"description":"Arquivo acima de 10 MB, ou cota estourada: {\"error\": \"STORAGE_QUOTA_EXCEEDED\", \"msg\", \"quotaType\", \"currentUsage\", \"maxAllowed\", \"usagePercentage\"}","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"429":{"description":"Limite de uploads por minuto da conta; header Retry-After","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}},"502":{"description":"Falha ao gravar o arquivo no armazenamento: {\"msg\"}","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}}}}}}},"/openApi/seller/ticket/list":{"post":{"tags":["tickets"],"summary":"Lista paginada de tickets do integrador","description":"Retorna uma página de tickets do integrador logado, com os mesmos filtros do dashboard de tickets. O corpo aceita page (1-based), pageSize e o objeto filters.","operationId":"list","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketListParams"}}}},"responses":{"200":{"description":"Página de tickets","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageUsinaTicketListItemDto"}}}},"400":{"description":"page ou pageSize menor que 1: {\"msg\": \"page: Página inválida\"}","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageUsinaTicketListItemDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageUsinaTicketListItemDto"}}}}}}},"/openApi/seller/subscription/list":{"post":{"tags":["subscriptions"],"summary":"Lista de assinaturas do integrador logado","description":"Retorna uma página de assinaturas do integrador logado, contendo id, nome e licenças disponíveis","operationId":"listSubscriptions","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionListParams"}}},"required":true},"responses":{"200":{"description":"Lista de assinaturas","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageSubscriptionDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageSubscriptionDto"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageSubscriptionDto"}}}}}}},"/openApi/seller/plants/units-with-credits":{"post":{"tags":["plants"],"summary":"Lista de plantas e unidades com créditos do integrador","description":"Retorna uma página de plantas e unidades com créditos do integrador e recebe um body com a pagina e o tamanho dela","operationId":"listPlantsWithUnitsAndCredit","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantListParams"}}},"required":true},"responses":{"200":{"description":"Lista de plantas","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantWithUnitsDTO"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantWithUnitsDTO"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantWithUnitsDTO"}}}}}}}},"/openApi/seller/plantWithInfos/list":{"post":{"tags":["plants"],"summary":"Lista de plantas do usuário logado","description":"Retorna uma página de plantas do usuário logado e recebe um body com a pagina e o tamanho dela","operationId":"listPlantsWithInfos","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantListParams"}}},"required":true},"responses":{"200":{"description":"Lista de plantas","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantWithInfosDto"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantWithInfosDto"}}}}}}},"/openApi/seller/plant/premium/remove":{"post":{"tags":["plant-management"],"summary":"Agendar remoção de usinas do premium","description":"Agenda a remoção de usinas de uma assinatura premium. A remoção efetiva respeita o período mínimo de permanência do plano.","operationId":"removePlantsFromPremium","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantPremiumForm"}}},"required":true},"responses":{"200":{"description":"Remoção das usinas agendada","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Requisição inválida","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"403":{"description":"Assinatura não pertence ao integrador","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/plant/premium/add":{"post":{"tags":["plant-management"],"summary":"Adicionar usinas ao premium","description":"Adiciona uma lista de usinas a uma assinatura premium existente","operationId":"addPlantsToPremium","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantPremiumForm"}}},"required":true},"responses":{"200":{"description":"Usinas adicionadas com sucesso","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Requisição inválida","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"403":{"description":"Assinatura não pertence ao integrador","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/plant/performance/plantId/{plantId}":{"post":{"tags":["plant-energy-data"],"summary":"Performance da planta ","description":"Retorna a performance da planta de acordo com o dashboard da solarz (1D, 15D, 365D)","operationId":"getPerformance","parameters":[{"name":"plantId","in":"path","description":"Id da usina","required":true,"schema":{"type":"integer","description":"Plant id","example":1},"example":1}],"responses":{"200":{"description":"Lista de produção diária ","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantEnergyPerformanceDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantEnergyPerformanceDto"}}}}}}},"/openApi/seller/plant/list":{"post":{"tags":["plants"],"summary":"Lista de plantas do usuário logado","description":"Retorna uma página de plantas do usuário logado e recebe um body com a pagina e o tamanho dela","operationId":"listPlants","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantListParams"}}},"required":true},"responses":{"200":{"description":"Lista de plantas","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantDto"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantDto"}}}}}}},"/openApi/seller/plant/list/simple":{"post":{"tags":["plants"],"summary":"Lista simplificada de plantas do usuário logado","description":"Retorna uma página com informações simplificadas de plantas do usuário logado","operationId":"listPlantsSimple","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantListParams"}}},"required":true},"responses":{"200":{"description":"Lista de plantas","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantSimpleDto"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantSimpleDto"}}}}}}},"/openApi/seller/plant/list/premium":{"post":{"tags":["plants"],"summary":"Lista de plantas premium do usuário logado","description":"Retorna uma página de plantas premium do usuário logado e recebe um body com a pagina e o tamanho dela","operationId":"listPlantsPremium","parameters":[{"name":"params","in":"query","description":"DTO que contem page e pageSize","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlantListParams"}}},"required":true},"responses":{"200":{"description":"Lista de plantas premium","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantDto"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PagePlantDto"}}}}}}},"/openApi/seller/plant/energy/plantId/{plantId}/year/{year}":{"post":{"tags":["plant-energy-data"],"summary":"Produção de energia por ano","description":"Retorna a lista de produção de uma planta em um ano  repassados e uma data. O ano deve ser maior que 2010 e deve ser repassado como um exemplo: 2023","operationId":"getEnergyProductionByYear","parameters":[{"name":"plantId","in":"path","description":"id da usina","required":true,"schema":{"type":"integer","description":"Plant id","example":1},"example":1},{"name":"year","in":"path","description":"Ano a ser buscado em int","required":true,"schema":{"type":"integer","description":"Year after 2010 and not in the future","example":2022},"example":2022}],"responses":{"200":{"description":"Lista de produção mensal ","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MonthEnergyProductionDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MonthEnergyProductionDto"}}}}}}}},"/openApi/seller/plant/energy/plantId/{plantId}/month/{yearMonth}":{"post":{"tags":["plant-energy-data"],"summary":"Produção de energia por mês","description":"Retorna a lista de produção de uma planta em um mês   passando uma data. A data deve ser depois de 2010-01 e deve ser repassado como um exemplo: 2023-01","operationId":"getEnergyProductionByYearMonth","parameters":[{"name":"plantId","in":"path","description":"id da usina","required":true,"schema":{"type":"integer","description":"Plant id","example":1},"example":1},{"name":"yearMonth","in":"path","description":"Mês e ano a serem colocados no formato por exemplo: 2023-10","required":true,"schema":{"type":"string","description":"Year month after 2010-jan and not in the future","example":"2022-01"},"example":"2022-01"}],"responses":{"200":{"description":"Lista de produção diária ","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DayEnergyProductionDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DayEnergyProductionDto"}}}}}}}},"/openApi/seller/plant/energy/dayRange":{"post":{"tags":["plant-energy-data"],"summary":"Relatórios da Planta","description":"Retorna a lista de relatórios de usinas de usinasrecebe um body com um id de usina e um periodo de dias","operationId":"getEnergyProductionByDayRange","parameters":[{"name":"params","in":"query","description":"DTO que ontem o plantId, toLocalDate e fromLocalDate","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnergyProductionParams"}}},"required":true},"responses":{"200":{"description":"Relatórios","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DayEnergyProductionDto"}}}}},"401":{"description":"Recurso nao disponivel para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DayEnergyProductionDto"}}}}}}}},"/openApi/seller/plant/create":{"post":{"tags":["plants"],"summary":"Criar Planta","description":"Cria uma usina para o integrador logado, recebe dados de um formulario","operationId":"createPlant","parameters":[{"name":"params","in":"query","description":"Objeto que recebe os parâmetros do formulário","required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlantForm"}}},"required":true},"responses":{"200":{"description":"Planta criada","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantDto"}}}}},"500":{"description":"Exeções lançadas","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantDto"}}}}}}}},"/openApi/seller/performance-rule/update":{"post":{"tags":["performance-rules"],"summary":"Altera regra de desempenho","description":"Alteração parcial: o id vai no corpo e só muda o campo enviado. Campos: name, tagIds (substitui a lista), performance15Days, performance30Days, allowedMissingEnergy, maxAllowedMissingEnergy. Cada janela enviada precisa de min e max em %, maiores ou iguais a 0 e com min menor ou igual a max. As janelas não podem ser desligadas: janela ausente ou null mantém os limites atuais. A regra padrão aceita limites e tolerância, mas tagIds responde 400. Mesma validação do portal para nome e tags; as usinas das tags envolvidas, inclusive as removidas, são verificadas de novo. Resposta: a regra no formato de /openApi/seller/performance-rule/{id}.","operationId":"update_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleUpdateForm"}}},"required":true},"responses":{"200":{"description":"Regra alterada","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"400":{"description":"Validação, JSON inválido ou tagIds na regra padrão","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"404":{"description":"Regra não encontrada para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}}}}},"/openApi/seller/performance-rule/create":{"post":{"tags":["performance-rules"],"summary":"Cria regra de desempenho de tag","description":"Cria uma regra para as tags informadas, com a mesma validação do portal: name obrigatório (até 255 caracteres), tagIds com ao menos uma tag livre da conta (tag já usada em outra regra ou de outra conta é recusada). performance15Days e performance30Days são obrigatórios, cada um com min e max em %, maiores ou iguais a 0 e com min menor ou igual a max. allowedMissingEnergy (padrão false) e maxAllowedMissingEnergy (padrão 3) controlam a tolerância a dias sem geração. Não cria regra padrão: ela já existe na conta. As usinas das tags são verificadas de novo após a criação. Resposta: a regra no formato de /openApi/seller/performance-rule/{id}.","operationId":"create_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleCreateForm"}}},"required":true},"responses":{"200":{"description":"Regra criada","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"400":{"description":"Validação: nome, tag indisponível, limites incoerentes ou janela ausente","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}}}}},"/openApi/seller/collaborator/plants/revoke":{"post":{"tags":["plant-management"],"summary":"Revogar acesso de usinas de um colaborador","description":"Remove usinas da lista de usinas visíveis para um colaborador (IntegradorUsuario)","operationId":"revokePlantVisibility","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaboratorPlantVisibilityForm"}}},"required":true},"responses":{"200":{"description":"Acesso revogado","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Requisição inválida","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"404":{"description":"Colaborador não encontrado","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/collaborator/plants/revokeAll":{"post":{"tags":["plant-management"],"summary":"Revogar acesso a todas as usinas de um colaborador","description":"Remove o acesso do colaborador a todas as usinas","operationId":"revokeAllPlantVisibility","parameters":[{"name":"collaboratorId","in":"query","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Acesso revogado de todas as usinas","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"404":{"description":"Colaborador não encontrado","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/collaborator/plants/grant":{"post":{"tags":["plant-management"],"summary":"Conceder acesso de usinas a um colaborador","description":"Adiciona usinas à lista de usinas visíveis para um colaborador (IntegradorUsuario)","operationId":"grantPlantVisibility","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaboratorPlantVisibilityForm"}}},"required":true},"responses":{"200":{"description":"Acesso concedido","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Requisição inválida","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"404":{"description":"Colaborador não encontrado","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/collaborator/plants/grantAll":{"post":{"tags":["plant-management"],"summary":"Conceder acesso a todas as usinas de um colaborador","description":"Concede ao colaborador acesso a todas as usinas do integrador","operationId":"grantAllPlantVisibility","parameters":[{"name":"collaboratorId","in":"query","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Acesso concedido a todas as usinas","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"404":{"description":"Colaborador não encontrado","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/clients":{"get":{"tags":["users"],"summary":"Usuários","description":"Retorna a lista de clientes","operationId":"listClients","parameters":[{"name":"documento","in":"query","description":"CPF do Cliente","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserDto"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserDto"}}}}}}},"post":{"tags":["users"],"summary":"Criar cliente","description":"Cria um cliente (proprietário de planta) na conta do integrador. O e-mail precisa ser único dentro da conta. Limite de 1 requisição a cada 5 segundos por conta.","operationId":"createClient","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientForm"}}},"required":true},"responses":{"201":{"description":"Cliente criado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"400":{"description":"Documento, telefone, CEP ou e-mail inválidos","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"403":{"description":"Forbidden","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"429":{"description":"Too Many Requests","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}}}}},"/openApi/seller/clients/{id}":{"get":{"tags":["users"],"summary":"Detalhe do cliente","description":"Retorna os dados completos de um cliente, incluindo documento, telefone e endereço. Use antes de editar para saber o que já está preenchido.","operationId":"getClient","parameters":[{"name":"id","in":"path","description":"Id do cliente","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Dados do cliente","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"403":{"description":"Cliente não pertence ao integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}}}},"post":{"tags":["users"],"summary":"Editar cliente","description":"Edição parcial: apenas os campos presentes no payload são alterados, os ausentes mantêm o valor atual. Limite de 1 requisição a cada 5 segundos por conta, compartilhado com a criação.","operationId":"updateClient","parameters":[{"name":"id","in":"path","description":"Id do cliente","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientPatchForm"}}},"required":true},"responses":{"200":{"description":"Cliente atualizado","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"400":{"description":"Documento, telefone ou CEP inválidos","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"403":{"description":"Cliente não pertence ao integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}},"429":{"description":"Too Many Requests","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClientDetailDto"}}}}}}},"/openApi/seller/client/{id}/access-code":{"post":{"tags":["users"],"summary":"Enviar código de acesso ao app","description":"Envia ao cliente informado o e-mail de boas-vindas com o código de acesso ao app","operationId":"sendAccessCode","parameters":[{"name":"id","in":"path","description":"Id do cliente","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Código de acesso enviado"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests"}}}},"/openApi/seller/ticket/{ticketId}/history":{"get":{"tags":["tickets"],"summary":"Histórico paginado do ticket","description":"Linha do tempo do ticket, mais recente primeiro: mudanças de status (type STATUS) e alterações de título (TITULO), responsáveis (RESPONSAVEL), prazo (PRAZO) e usina removida (USINA_REMOVIDA). Ações de quem não é da conta do ticket (suporte Solarz, inclusive em representação) aparecem com actor.name \"Suporte Solarz\", solarz=true e id/email nulos. page é 1-based, no pedido e na resposta; pageSize entre 1 e 100 (padrão 20).","operationId":"history","parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"Página do histórico","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketHistoryDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketHistoryDto"}}}},"404":{"description":"Ticket não encontrado para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiTicketHistoryDto"}}}}}}},"/openApi/seller/tags":{"get":{"tags":["tags"],"summary":"Lista de tags do usuário principal","description":"Retorna a lista de tags do usuário logado","operationId":"listTags","responses":{"200":{"description":"Lista de tags do integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TagDto"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TagDto"}}}}}}}},"/openApi/seller/plantReport/report":{"get":{"tags":["plant-report"],"summary":"Relatórios da Planta","description":"Retorna a lista de relatórios de usinas a partir dos Ids repassados e uma data","operationId":"getPlantReports","parameters":[{"name":"plantIds","in":"query","description":"Ids das usinas","required":true,"schema":{"type":"array","items":{"type":"integer","format":"int64"}}},{"name":"monthYear","in":"query","description":"Data","required":false,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Status","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsDTO"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsDTO"}}}}},"500":{"description":"Recurso indisponível para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsDTO"}}}}}}}},"/openApi/seller/plantReport/period/report":{"get":{"tags":["plant-report"],"summary":"Relatórios da Planta por período","description":"Retorna a lista de relatórios de uma usina em um período informando o id e as datas. A data deve ser repassada da seguinte forma: 2024-01","operationId":"getPlantsReportsPeriod","parameters":[{"name":"plantId","in":"query","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"yearMonthStart","in":"query","description":"Data inicial do período. Formato: yyyy-MM","required":true,"schema":{"type":"string"}},{"name":"yearMonthEnd","in":"query","description":"Data final do período. Formato: yyyy-MM","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lista de relatórios","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsCompleteDTO"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsCompleteDTO"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsCompleteDTO"}}}}},"500":{"description":"Recurso indisponível para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlantReportsCompleteDTO"}}}}}}}},"/openApi/seller/plantReport/period/invoice":{"get":{"tags":["plant-report"],"summary":"Faturas da Planta por periodo","description":"Retorna a lista de faturas de uma usina em um período informando o id da usina e as datas. A data deve ser repassada da seguinte forma: 2024-01","operationId":"getPlantsFaturasPeriod","parameters":[{"name":"plantId","in":"query","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"yearMonthStart","in":"query","description":"Data inicial do período. Formato: yyyy-MM","required":true,"schema":{"type":"string"}},{"name":"yearMonthEnd","in":"query","description":"Data final do período. Formato: yyyy-MM","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lista de relatórios","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}}},"500":{"description":"Recurso indisponível para o integrador","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}}}}}},"/openApi/seller/plantRealTimeData/powerCurve/day/{day}/unitePortals/{unitePortals}/plantId/{plantId}":{"get":{"tags":["plant-real-time-data"],"summary":"Curva de potência","description":"Este endpoint não está mais disponível.","operationId":"getPowerCurve","responses":{"410":{"description":"Este recurso foi descontinuado.","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/openApi/seller/plant/{plantId}/rateio":{"get":{"tags":["plant-report"],"summary":"Lista de compensação vigente da usina","description":"Retorna a lista de compensação vigente da usina, incluindo todas as unidades participantes, tipo da lista e dados de alocação","operationId":"getRateio","parameters":[{"name":"plantId","in":"path","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Lista de compensação vigente","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantRateioDTO"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantRateioDTO"}}}},"404":{"description":"Usina não encontrada para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantRateioDTO"}}}}}}},"/openApi/seller/plant/{plantId}/document/link":{"get":{"tags":["plant-report"],"summary":"Link do documento da planta","description":"Retorna o link HTML público de um relatório ou fatura da usina para o mês informado","operationId":"getPlantDocumentLink","parameters":[{"name":"plantId","in":"path","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"type","in":"query","description":"Tipo do documento: relatorio ou fatura","required":true,"schema":{"type":"string"}},{"name":"yearMonth","in":"query","description":"Mês/Ano no formato yyyy-MM","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Link do documento","content":{"*/*":{"schema":{"type":"object"}}}},"400":{"description":"Tipo inválido","content":{"*/*":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"object"}}}},"404":{"description":"Usina não encontrada","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/openApi/seller/plant/status":{"get":{"tags":["plants"],"summary":"Status da Planta","description":"Retorna o status da planta de, recebendo o ID dela","operationId":"status","parameters":[{"name":"id","in":"query","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Status","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatusDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatusDto"}}}},"500":{"description":"Recurso nao disponivel para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatusDto"}}}}}}},"/openApi/seller/plant/power":{"get":{"tags":["plants"],"summary":"Potência da Planta","description":"Retorna a potência da planta, recebendo o ID dela","operationId":"findPlant","parameters":[{"name":"id","in":"query","description":"Id da usina","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Status","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantPowerDTO"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantPowerDTO"}}}},"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantPowerDTO"}}}},"500":{"description":"Recurso nao disponivel para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PlantPowerDTO"}}}}}}},"/openApi/seller/performance-rule/{id}":{"get":{"tags":["performance-rules"],"summary":"Detalha regra de desempenho","description":"Regra de desempenho da conta, no mesmo formato de um item de /openApi/seller/performance-rule/list.","operationId":"get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Regra de desempenho","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}},"404":{"description":"Regra não encontrada para o integrador","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}}}}}}},"/openApi/seller/performance-rule/list":{"get":{"tags":["performance-rules"],"summary":"Lista paginada de regras de desempenho","description":"Regras de desempenho da conta (a regra padrão e as regras de tag), ordenadas por id, cada uma com suas tags. performance15Days e performance30Days trazem os limites mínimo e máximo (em %) de cada janela; janela desligada vem null. page é 1-based, no pedido e na resposta; pageSize entre 1 e 100 (padrão 20).","operationId":"list_1","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"Página de regras de desempenho","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiPerformanceRuleDto"}}}},"400":{"description":"page ou pageSize fora do limite: {\"msg\": \"A página deve ser maior ou igual a 1\"}","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiPerformanceRuleDto"}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpenApiPageOpenApiPerformanceRuleDto"}}}}}}},"/openApi/seller/collaborators":{"get":{"tags":["users"],"summary":"Listar colaboradores","description":"Retorna uma lista com todos os colaboradores do integrador","operationId":"listCollaborators","responses":{"200":{"description":"Lista dos colaboradores","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserDto"}}}}},"401":{"description":"Unauthorized","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserDto"}}}}}}}}},"components":{"schemas":{"VoucherRedeemItemDto":{"type":"object","properties":{"plantId":{"type":"integer","format":"int64"},"voucherCode":{"type":"string"}}},"VoucherRedeemResultDto":{"type":"object","properties":{"redeemed":{"type":"array","items":{"$ref":"#/components/schemas/VoucherRedeemResultItemDto"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/VoucherRedeemResultItemDto"}}}},"VoucherRedeemResultItemDto":{"type":"object","properties":{"plantId":{"type":"integer","format":"int64"},"voucherCode":{"type":"string"},"error":{"type":"string"}}},"PlantMonitoringForm":{"type":"object","properties":{"plantIds":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":2000,"minItems":0,"uniqueItems":true},"monitored":{"type":"boolean"}},"required":["monitored","plantIds"]},"OpenApiTicketChecklistItemForm":{"type":"object","properties":{"text":{"type":"string","maxLength":255,"minLength":0},"done":{"type":"boolean"}},"required":["text"]},"OpenApiTicketCreateForm":{"type":"object","properties":{"title":{"type":"string","maxLength":255,"minLength":0},"description":{"type":"string","maxLength":5120,"minLength":0},"type":{"type":"string","enum":["GERACAO","CONCESSIONARIA","MANUTENCAO","LIMPEZA","COMERCIAL","COMISSIONAMENTO","VISITA","RELATORIOS","AUTO_BAIXA_PERFORMANCE","FABRICANTE"]},"subtypeId":{"type":"integer","format":"int64"},"status":{"type":"string","enum":["ABERTO","EM_ANDAMENTO","EM_ESPERA","CONCLUIDO","CANCELADO"]},"dueDate":{"type":"string","format":"date"},"assigneeIds":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":20,"minItems":0},"affectsPerformance":{"type":"boolean"},"affectsReport":{"type":"boolean"},"plantIds":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":100,"minItems":0},"singleTicket":{"type":"boolean"},"checklist":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketChecklistItemForm"},"maxItems":50,"minItems":0}},"required":["plantIds","title","type"]},"ReponsavelTicketDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"ticketId":{"type":"integer","format":"int64"},"name":{"type":"string"},"email":{"type":"string"},"avatarUrl":{"type":"string"}}},"UsinaTicketListItemDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"titulo":{"type":"string"},"numero":{"type":"integer","format":"int32"},"usinaCount":{"type":"integer","format":"int32"},"clienteCount":{"type":"integer","format":"int32"},"usinaName":{"type":"string"},"clienteName":{"type":"string"},"clienteId":{"type":"integer","format":"int64"},"usinaId":{"type":"integer","format":"int64"},"status":{"type":"string"},"tipo":{"type":"string"},"subtipo":{"type":"string"},"afetaDesempenho":{"type":"boolean"},"afetaRelatorio":{"type":"boolean"},"prazo":{"type":"string","format":"date"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"closedAt":{"type":"string","format":"date-time"},"responsaveis":{"type":"array","items":{"$ref":"#/components/schemas/ReponsavelTicketDto"}}}},"OpenApiTicketUpdateForm":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"type":{"type":"string","enum":["GERACAO","CONCESSIONARIA","MANUTENCAO","LIMPEZA","COMERCIAL","COMISSIONAMENTO","VISITA","RELATORIOS","AUTO_BAIXA_PERFORMANCE","FABRICANTE"]},"subtypeId":{"type":"integer","format":"int64"},"status":{"type":"string","enum":["ABERTO","EM_ANDAMENTO","EM_ESPERA","CONCLUIDO","CANCELADO"]},"dueDate":{"type":"string","format":"date"},"assigneeIds":{"type":"array","items":{"type":"integer","format":"int64"}},"affectsPerformance":{"type":"boolean"},"affectsReport":{"type":"boolean"}}},"OpenApiTicketCommentForm":{"type":"object","properties":{"content":{"type":"string","minLength":1}},"required":["content"]},"OpenApiTicketAttachmentDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"virusScan":{"type":"string","enum":["PENDING","CLEAN","INFECTED","NOT_SCANNED"]}}},"OpenApiTicketCommentDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"createdAt":{"type":"string","format":"date-time"},"author":{"$ref":"#/components/schemas/OpenApiTicketUserDto"},"content":{"type":"string"},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}},"mentions":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketUserDto"}}}},"OpenApiTicketUserDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"email":{"type":"string"}}},"OpenApiTicketChecklistItemDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"text":{"type":"string"},"done":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"OpenApiTicketChecklistEditForm":{"type":"object","properties":{"text":{"type":"string"},"done":{"type":"boolean"}}},"ListTicketFiltersDto":{"type":"object","properties":{"tituloQuery":{"type":"string"},"usinas":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"clientes":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"responsaveis":{"$ref":"#/components/schemas/ResponsaveisFilterDto"},"cidades":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"tags":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"excludeTags":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"status":{"type":"array","items":{"type":"string","enum":["ABERTO","EM_ANDAMENTO","EM_ESPERA","CONCLUIDO","CANCELADO"]},"uniqueItems":true},"tipo":{"type":"array","items":{"type":"string","enum":["GERACAO","CONCESSIONARIA","MANUTENCAO","LIMPEZA","COMERCIAL","COMISSIONAMENTO","VISITA","RELATORIOS","AUTO_BAIXA_PERFORMANCE","FABRICANTE"]},"uniqueItems":true},"subtipo":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"apenasAtrasados":{"type":"boolean"},"vencimento":{"$ref":"#/components/schemas/VencimentoFilterDto"},"orderBy":{"type":"string"},"orderDirection":{"type":"string"},"withoutResponsavel":{"type":"boolean"},"usinaResponsavelId":{"type":"integer","format":"int64"}}},"ResponsaveisFilterDto":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"semResponsavel":{"type":"boolean"}}},"TicketListParams":{"type":"object","properties":{"page":{"type":"string","description":"Número da página, começando em 1","example":1},"pageSize":{"type":"string","description":"Quantidade de itens por página","example":20},"filters":{"$ref":"#/components/schemas/ListTicketFiltersDto","description":"Filtros da listagem (mesma estrutura do dashboard de tickets)"}}},"VencimentoFilterDto":{"type":"object","properties":{"desde":{"type":"string","format":"date"},"ate":{"type":"string","format":"date"},"somenteAtrasados":{"type":"boolean"},"semDataVencimento":{"type":"boolean"}}},"PageUsinaTicketListItemDto":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"first":{"type":"boolean"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/UsinaTicketListItemDto"}},"number":{"type":"integer","format":"int32"},"sort":{"$ref":"#/components/schemas/SortObject"},"numberOfElements":{"type":"integer","format":"int32"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}},"PageableObject":{"type":"object","properties":{"unpaged":{"type":"boolean"},"offset":{"type":"integer","format":"int64"},"sort":{"$ref":"#/components/schemas/SortObject"},"pageSize":{"type":"integer","format":"int32"},"paged":{"type":"boolean"},"pageNumber":{"type":"integer","format":"int32"}}},"SortObject":{"type":"object","properties":{"unsorted":{"type":"boolean"},"empty":{"type":"boolean"},"sorted":{"type":"boolean"}}},"SubscriptionListParams":{"type":"object","properties":{"page":{"type":"string","description":"Non zero-based page","example":1},"pageSize":{"type":"string","description":"Page size","example":20}}},"PageSubscriptionDto":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"first":{"type":"boolean"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionDto"}},"number":{"type":"integer","format":"int32"},"sort":{"$ref":"#/components/schemas/SortObject"},"numberOfElements":{"type":"integer","format":"int32"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}},"SubscriptionDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Subscription ID","example":1234},"name":{"type":"string","description":"Subscription name (plan title)","example":"Plano Avançado"},"availableLicenses":{"type":"integer","format":"int32","description":"Available licenses on this subscription","example":5}}},"PlantListParams":{"type":"object","properties":{"page":{"type":"string","description":"Nom zero-based page","example":1},"pageSize":{"type":"string","description":"Page size","example":20},"plantName":{"type":"string","description":"Filtro opcional por nome da planta (denominação da UC)","example":"Residência João"},"ownerDocument":{"type":"string","description":"Filtro opcional por documento do proprietário/cliente da planta","example":12345678900},"ownerEmail":{"type":"string","description":"Filtro opcional por e-mail do proprietário/cliente da planta","example":"cliente@email.com"}}},"ClientePlantDTO":{"type":"object","properties":{"nome":{"type":"string"},"email":{"type":"string"},"cpf":{"type":"string"},"telefone":{"type":"string"},"concessionaria":{"type":"string"}}},"EnderecoDto":{"type":"object","properties":{"bairro":{"type":"string"},"logradouro":{"type":"string"},"cidade":{"type":"string"},"siglaEstado":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"cep":{"type":"string"}}},"PlantWithUnitsDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"installedPower":{"type":"number"},"energyProducedKwh":{"type":"number"},"status":{"$ref":"#/components/schemas/StatusDto"},"dataInstalacao":{"type":"string","format":"date-time"},"cliente":{"$ref":"#/components/schemas/ClientePlantDTO"},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"responsavel":{"$ref":"#/components/schemas/UserDto"},"unidades":{"type":"array","items":{"$ref":"#/components/schemas/UnidadeConsumidoraDto"}}}},"StatusDto":{"type":"object","properties":{"plantId":{"type":"integer","format":"int64"},"status":{"type":"string"},"at":{"type":"string","format":"date-time"}}},"UnidadeConsumidoraDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"denominacao":{"type":"string"},"contrato":{"type":"string"},"concessionariaSigla":{"type":"string"},"creditoFP":{"type":"number"},"creditoPT":{"type":"number"}}},"UserDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"email":{"type":"string"}}},"PagePlantWithInfosDto":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"first":{"type":"boolean"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/PlantWithInfosDto"}},"number":{"type":"integer","format":"int32"},"sort":{"$ref":"#/components/schemas/SortObject"},"numberOfElements":{"type":"integer","format":"int32"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}},"PlantWithInfosDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"installedPower":{"type":"number"},"energyProducedKwh":{"type":"number"},"status":{"$ref":"#/components/schemas/StatusDto"},"dataInstalacao":{"type":"string","format":"date-time"},"cliente":{"$ref":"#/components/schemas/ClientePlantDTO"},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"responsavel":{"$ref":"#/components/schemas/UserDto"}}},"PlantPremiumForm":{"type":"object","properties":{"subscriptionId":{"type":"integer","format":"int64"},"plantIds":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":2000,"minItems":0}},"required":["plantIds","subscriptionId"]},"PlantEnergyPerformanceDto":{"type":"object","properties":{"total1D":{"type":"number"},"total15D":{"type":"number"},"total30D":{"type":"number"},"total365D":{"type":"number"},"expected1D":{"type":"number"},"expected15D":{"type":"number"},"expected30D":{"type":"number"},"expected365D":{"type":"number"},"installationDate":{"type":"string","format":"date"}}},"PagePlantDto":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"first":{"type":"boolean"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/PlantDto"}},"number":{"type":"integer","format":"int32"},"sort":{"$ref":"#/components/schemas/SortObject"},"numberOfElements":{"type":"integer","format":"int32"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}},"PlantDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"installedPower":{"type":"number"},"status":{"$ref":"#/components/schemas/StatusDto"},"dataInstalacao":{"type":"string","format":"date-time"},"cliente":{"$ref":"#/components/schemas/ClientePlantDTO"},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"tags":{"type":"array","items":{"$ref":"#/components/schemas/TagDto"}},"responsavel":{"$ref":"#/components/schemas/UserDto"}}},"TagDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"ColetaSimpleDto":{"type":"object","properties":{"nomeUsinaPortal":{"type":"string"},"apiNome":{"type":"string"}}},"PagePlantSimpleDto":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"first":{"type":"boolean"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/PlantSimpleDto"}},"number":{"type":"integer","format":"int32"},"sort":{"$ref":"#/components/schemas/SortObject"},"numberOfElements":{"type":"integer","format":"int32"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}},"PlantSimpleDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"arquivada":{"type":"boolean"},"premium":{"type":"boolean"},"denominacao":{"type":"string"},"coletas":{"type":"array","items":{"$ref":"#/components/schemas/ColetaSimpleDto"}}}},"MonthEnergyProductionDto":{"type":"object","properties":{"yearMonth":{"type":"string"},"total":{"type":"number"},"totalExpected":{"type":"number"}}},"DayEnergyProductionDto":{"type":"object","properties":{"total":{"type":"number"},"totalExpected":{"type":"number"},"date":{"type":"string","format":"date"}}},"EnergyProductionParams":{"type":"object","properties":{"fromLocalDate":{"type":"string","description":"Start date inclusive","example":"yyyy-MM-dd"},"toLocalDate":{"type":"string","description":"End date inclusive","example":"yyyy-MM-dd"},"plantId":{"type":"string","description":"Page size","example":1}},"required":["fromLocalDate","plantId","toLocalDate"]},"CreatePlantForm":{"type":"object","properties":{"name":{"type":"string"},"totalPower":{"type":"number"},"expectedAnnualGeneration":{"type":"number"},"totalInvested":{"type":"number"},"archived":{"type":"boolean"},"tags":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"users":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true},"installDate":{"type":"string","format":"date"},"enderecoDeUsinaDTO":{"$ref":"#/components/schemas/PlantAddressForm"},"plantOwnerData":{"$ref":"#/components/schemas/PlantOwnerDataForm"},"energyProduction":{"$ref":"#/components/schemas/ExpectedProductionForm"}}},"ExpectedProductionForm":{"type":"object","properties":{"jannuary":{"type":"number"},"february":{"type":"number"},"march":{"type":"number"},"april":{"type":"number"},"may":{"type":"number"},"june":{"type":"number"},"july":{"type":"number"},"august":{"type":"number"},"september":{"type":"number"},"october":{"type":"number"},"november":{"type":"number"},"december":{"type":"number"}}},"PlantAddressForm":{"type":"object","properties":{"zipCode":{"type":"string"},"city":{"type":"string"},"street":{"type":"string"},"number":{"type":"string"},"complement":{"type":"string"},"country":{"type":"string"},"latitude":{"type":"string"},"longitude":{"type":"string"},"completeAddress":{"type":"string"},"district":{"type":"string"}}},"PlantOwnerDataForm":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"email":{"type":"string"},"name":{"type":"string"},"document":{"type":"string"},"areaCode":{"type":"string"},"phoneNumber":{"type":"string"}}},"OpenApiPerformanceRangeForm":{"type":"object","properties":{"min":{"type":"number","minimum":0},"max":{"type":"number","minimum":0}},"required":["max","min"]},"OpenApiPerformanceRuleUpdateForm":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string","maxLength":255,"minLength":0},"tagIds":{"type":"array","items":{"type":"integer","format":"int64"}},"performance15Days":{"$ref":"#/components/schemas/OpenApiPerformanceRangeForm"},"performance30Days":{"$ref":"#/components/schemas/OpenApiPerformanceRangeForm"},"allowedMissingEnergy":{"type":"boolean"},"maxAllowedMissingEnergy":{"type":"integer","format":"int32","minimum":0}},"required":["id"]},"OpenApiPerformanceRuleDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"defaultRule":{"type":"boolean"},"performance15Days":{"$ref":"#/components/schemas/Range"},"performance30Days":{"$ref":"#/components/schemas/Range"},"allowedMissingEnergy":{"type":"boolean"},"maxAllowedMissingEnergy":{"type":"integer","format":"int32"},"tags":{"type":"array","items":{"$ref":"#/components/schemas/TagItem"}},"createdAt":{"type":"string","format":"date-time"}}},"Range":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"}}},"TagItem":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"colorHex":{"type":"string"}}},"OpenApiPerformanceRuleCreateForm":{"type":"object","properties":{"name":{"type":"string","maxLength":255,"minLength":0},"tagIds":{"type":"array","items":{"type":"integer","format":"int64"},"minItems":1},"performance15Days":{"$ref":"#/components/schemas/OpenApiPerformanceRangeForm"},"performance30Days":{"$ref":"#/components/schemas/OpenApiPerformanceRangeForm"},"allowedMissingEnergy":{"type":"boolean"},"maxAllowedMissingEnergy":{"type":"integer","format":"int32","minimum":0}},"required":["name","performance15Days","performance30Days","tagIds"]},"CollaboratorPlantVisibilityForm":{"type":"object","properties":{"collaboratorId":{"type":"integer","format":"int64"},"plantIds":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":2000,"minItems":0}},"required":["collaboratorId","plantIds"]},"ClientAddressForm":{"type":"object","properties":{"cep":{"type":"string","description":"Obrigatório quando o endereço é enviado. CEP com ou sem máscara; define cidade e estado","example":60000000,"minLength":1},"street":{"type":"string","description":"Opcional.","example":"Rua das Flores"},"number":{"type":"string","description":"Opcional.","example":100},"district":{"type":"string","description":"Opcional.","example":"Centro"},"complement":{"type":"string","description":"Opcional.","example":"Apto 5"}},"required":["cep"]},"ClientForm":{"type":"object","properties":{"name":{"type":"string","description":"Obrigatório. Nome do cliente, no máximo 50 caracteres","example":"João Silva","maxLength":50,"minLength":0},"email":{"type":"string","format":"email","description":"Obrigatório. E-mail do cliente, único dentro da conta do integrador","example":"joao@exemplo.com","minLength":1},"document":{"type":"string","description":"Opcional. CPF ou CNPJ, com ou sem máscara","example":12345678909},"countryCode":{"type":"string","description":"Opcional. Código do país do telefone, sem o +. Assume 55 quando omitido","example":55},"phoneNumber":{"type":"string","description":"Opcional. DDD + número, sem o código do país","example":85999998888},"address":{"$ref":"#/components/schemas/ClientAddressForm","description":"Opcional. Endereço do cliente; se enviado, o CEP é obrigatório e define cidade e estado"},"sendWelcomeEmail":{"type":"boolean","description":"Obrigatório. Se true, envia ao cliente o e-mail de boas-vindas com o código de acesso ao app. Não tem default de propósito: numa sincronização em massa o valor precisa ser uma escolha, para não disparar um e-mail por cliente sem querer.","example":false}},"required":["email","name","sendWelcomeEmail"]},"AddressDto":{"type":"object","properties":{"cep":{"type":"string","example":60000000},"street":{"type":"string","example":"Rua das Flores"},"number":{"type":"string","example":100},"district":{"type":"string","example":"Centro"},"complement":{"type":"string","example":"Apto 5"},"cityName":{"type":"string","description":"Cidade resolvida pelo CEP","example":"Fortaleza"},"stateUf":{"type":"string","description":"UF resolvida pelo CEP","example":"CE"}}},"ClientDetailDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Id do cliente","example":42},"name":{"type":"string","description":"Nome do cliente","example":"João Silva"},"email":{"type":"string","description":"E-mail do cliente","example":"joao@exemplo.com"},"document":{"type":"string","description":"CPF ou CNPJ, apenas dígitos","example":12345678909},"countryCode":{"type":"string","description":"Código do país do telefone, sem o +","example":55},"phoneNumber":{"type":"string","description":"DDD + número, sem o código do país","example":85999998888},"address":{"$ref":"#/components/schemas/AddressDto"}}},"ClientPatchForm":{"type":"object","properties":{"name":{"type":"string","description":"Opcional. Novo nome, no máximo 50 caracteres","example":"João da Silva","maxLength":50,"minLength":0},"email":{"type":"string","format":"email","description":"Opcional. Novo e-mail, único dentro da conta do integrador","example":"joao@exemplo.com"},"document":{"type":"string","description":"Opcional. CPF ou CNPJ, com ou sem máscara","example":12345678909},"countryCode":{"type":"string","description":"Opcional. Código do país do telefone, sem o +","example":55},"phoneNumber":{"type":"string","description":"Opcional. DDD + número, sem o código do país","example":85999998888},"address":{"$ref":"#/components/schemas/ClientAddressForm","description":"Opcional. Apenas os campos enviados são alterados; se o endereço vier, o CEP é obrigatório e define cidade e estado"}}},"OpenApiPageOpenApiTicketHistoryDto":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketHistoryDto"}},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"OpenApiTicketActorDto":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"email":{"type":"string"},"solarz":{"type":"boolean"}}},"OpenApiTicketHistoryDto":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"actor":{"$ref":"#/components/schemas/OpenApiTicketActorDto"},"previousValue":{"type":"string"},"newValue":{"type":"string"},"previousUsers":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketUserDto"}},"newUsers":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketUserDto"}}}},"OpenApiPageOpenApiTicketCommentDto":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketCommentDto"}},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"OpenApiPageOpenApiTicketAttachmentDto":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiTicketAttachmentDto"}},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"InformacaoPostoTarifarioDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"energiaRegistrada":{"type":"number"},"energiaInjetada":{"type":"number"},"energiaCompensada":{"type":"number"},"energiaFaturada":{"type":"number"},"creditoCiclo":{"type":"number"},"tarifa":{"type":"number"},"tarifaCompensada":{"type":"number"},"tarifaTE":{"type":"number"},"creditoAcumulado":{"type":"number"},"postoTarifarioEnum":{"type":"string","enum":["PONTA","FORA_PONTA","INTERMEDIARIO","RESERVADO"]},"informacaoRelatorioId":{"type":"integer","format":"int64"}}},"PlantReportsDTO":{"type":"object","properties":{"idPlant":{"type":"integer","format":"int64"},"economy":{"type":"number"},"invoiced":{"type":"number"},"generation":{"type":"number"},"consumption":{"type":"number"},"monthYear":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"units":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}},"UnitPlantReportDTO":{"type":"object","properties":{"unitId":{"type":"integer","format":"int64"},"denomination":{"type":"string"},"mesAno":{"type":"string","format":"date-time"},"reportInformation":{"type":"array","items":{"$ref":"#/components/schemas/InformacaoPostoTarifarioDTO"}}}},"PlantReportsCompleteDTO":{"type":"object","properties":{"idPlant":{"type":"integer","format":"int64"},"economy":{"type":"number"},"invoiced":{"type":"number"},"generation":{"type":"number"},"performance":{"type":"number"},"power":{"type":"number"},"totalConsumptionFP":{"type":"number"},"totalConsumptionPT":{"type":"number"},"totalConsumptionInst":{"type":"number"},"financialFeedback":{"type":"number"},"totalInvested":{"type":"number"},"totalEconomy":{"type":"number"},"totalFinancialFeedback":{"type":"number"},"monthYear":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"units":{"type":"array","items":{"$ref":"#/components/schemas/UnitPlantReportDTO"}}}},"EnergiaRegistradaPostoDTO":{"type":"object","properties":{"postoTarifario":{"type":"string"},"energiaRegistradaKwh":{"type":"number"}}},"PlantRateioDTO":{"type":"object","properties":{"plantId":{"type":"integer","format":"int64"},"tipo":{"type":"string"},"unidades":{"type":"array","items":{"$ref":"#/components/schemas/UnidadeRateioDTO"}}}},"UnidadeRateioDTO":{"type":"object","properties":{"unitId":{"type":"integer","format":"int64"},"denominacao":{"type":"string"},"tipo":{"type":"string"},"percentual":{"type":"number"},"consumoInstantaneoKwh":{"type":"number"},"creditoKwh":{"type":"number"},"energiaRegistradaPorPosto":{"type":"array","items":{"$ref":"#/components/schemas/EnergiaRegistradaPostoDTO"}}}},"PlantPowerDTO":{"type":"object","properties":{"plantId":{"type":"integer","format":"int64"},"plantName":{"type":"string"},"status":{"type":"string"},"installedPower":{"type":"number"},"instantPower":{"type":"number"},"totalGenerated":{"type":"number"},"generation365Days":{"type":"number"}}},"OpenApiPageOpenApiPerformanceRuleDto":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/OpenApiPerformanceRuleDto"}},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}}}}}