{"openapi":"3.0.1","info":{"title":"4966 - API's","version":"1"},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/erivanjuniordocktech/4966/1"},{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/SANDOELLYTONSOUSA/4966-apis-estagio/1.0.0"},{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/SANDOELLYTONSOUSA/DebtStage/1.0.0"},{"url":"https://localhost/v2","description":"Generated server url"}],"security":[{"access_token":[],"client_id":[]}],"tags":[{"name":"Marcação de parada de acumulação","description":"Operações relacionadas à marcação de parada de acumulação"},{"name":"Custo de Operação","description":"Vínculos entre produtos e operações com custo de originação associado"}],"paths":{"/api/accounts/{id}/debt-stage":{"get":{"tags":["Marcação de parada de acumulação"],"summary":"Consulta marcação de parada de acumulação de uma conta","description":"Consulta marcação de parada de acumulação de uma conta por seu identificador","operationId":"findByAccountId","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"},"example":15}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}},"404":{"description":"Not Found. Mensagens possíveis:<ul><li>Nenhum registro encontrado para a conta informada</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}},"post":{"tags":["Marcação de parada de acumulação"],"summary":"Inclui a marcação de um estágio de dívida de uma conta","description":"Inclui a marcação de um estágio de dívida de uma conta","operationId":"includeMarking","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingPersist"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}}}},"patch":{"tags":["Marcação de parada de acumulação"],"summary":"Altera a marcação de um estágio de dívida de uma conta","description":"Altera a marcação de um estágio de dívida de uma conta","operationId":"updateMarking","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingUpdate"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}},"400":{"description":"Bad Request. Mensagens possíveis:<ul><li>Estágio informado já encontra-se definido para essa conta</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"404":{"description":"Not Found. Mensagens possíveis:<ul><li>Conta não encontrada para o código de identificação informado</li><li>Não existe definição de estágio para a conta informada</li></ul>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}}},"/api/accounts/debt-stage":{"get":{"tags":["Marcação de parada de acumulação"],"summary":"Lista todas as marcações de parada de acumulação","description":"Lista todas as marcações de parada de acumulação no intervalo de datas informado","operationId":"findAll_3","parameters":[{"name":"page","in":"query","description":"Página a ser mostrada (inicia em 0)","required":false,"schema":{"minimum":0,"type":"string","description":"Página a ser mostrada (inicia em 0)","example":0,"default":"0"},"example":0},{"name":"limit","in":"query","description":"Quantidade de elementos em cada página","required":false,"schema":{"maximum":50,"minimum":1,"type":"string","description":"Quantidade de elementos em cada página","example":50,"default":"50"},"example":50},{"name":"sort","in":"query","description":"Nome do campo a ser utilizado na ordenação","required":true,"schema":{"type":"string","description":"Nome do campo a ser utilizado na ordenação","example":"id"},"example":"id"},{"name":"order","in":"query","description":"Direção da ordenação. Utilize ASC para ordenação ascendente e DESC para descendente. Padrão ASC. Sem distinção de maiúsculas e minúsculas","required":false,"schema":{"type":"string","description":"Direção da ordenação. Utilize ASC para ordenação ascendente e DESC para descendente. Padrão ASC. Sem distinção de maiúsculas e minúsculas","example":"desc","default":"asc","enum":["asc","desc"]},"example":"desc"},{"name":"dock_flag_stop","in":"query","description":"Marcação de parada de acumulação Dock","required":false,"schema":{"type":"boolean"}},{"name":"issuer_stage","in":"query","description":"Marcação de estágio de parada de acumulação do emissor","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"operator","in":"query","description":"Permite que os usuários especifiquem o operador lógico a ser aplicado em relação aos campos dockFlagStop e issuerStage em suas consultas. Este campo aceita os valores AND ou OR","required":false,"schema":{"type":"string","description":"Permite que os usuários especifiquem o operador lógico a ser aplicado em relação aos campos dockFlagStop e issuerStage em suas consultas. Este campo aceita os valores AND ou OR","default":"AND","enum":["AND","OR"]}},{"name":"curing_stage","in":"query","description":"Marcação de estágio de cura","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"start_date","in":"query","description":"Data inicial para busca da marcação de parada de acumulação no formato yyyy-MM-dd'T'HH:mm:ss.SSSZ (e.g. 2024-03-20T16:49:00.000Z)","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","description":"Data final para busca da marcação de parada de acumulação no formato yyyy-MM-dd'T'HH:mm:ss.SSSZ (e.g. 2024-03-20T16:49:00.000Z)","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseAccrualStopMarkingResponse"}}}},"400":{"description":"Bad Request. Mensagens possíveis:<ul><li>Data inicial deve ser anterior a data final</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"422":{"description":"Unprocessable Entity. Mensagens possíveis:<ul><li>Intervalo de datas deve ser inferior a um ano</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}}},"/api/accounts/{id}/curing-stage":{"post":{"tags":["Marcação de parada de acumulação"],"summary":"Inclui a marcação de um estágio de cura de uma conta","description":"Inclui a marcação de um estágio de cura de uma conta","operationId":"includeCuring","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CuringStagePersist"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}},"404":{"description":"Not Found. Mensagens possíveis:<ul><li>Conta não encontrada para o código de identificação informado</li>"},"422":{"description":"Unprocessable Entity. Mensagens possíveis:<ul><li>Estágio de cura já encontra-se definido para essa conta</li><li>Status da conta não está definido com flagPerda ativada</li><li>A conta informada não possui flag stop dock definida</li><li>Estágio de cura informado não é permitido, valores válidos são, 1 ou 2</li>"},"500":{"description":"Erro Interno do Serviço"}}},"patch":{"tags":["Marcação de parada de acumulação"],"summary":"Altera a marcação de um estágio de cura de uma conta","description":"Altera a marcação de um estágio de cura de uma conta","operationId":"updateCuringStage","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CuringStagePersist"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}},"400":{"description":"Bad Request"},"404":{"description":"Not Found. Mensagens possíveis:<ul><li>Conta não encontrada para o código de identificação informado</li></ul>"},"422":{"description":"Unprocessable Entity. Mensagens possíveis:<ul><li>Status da conta não está definido com flagPerda ativada</li><li>Estágio de cura informado é igual ao já registrado</li><li>A conta informada não possui flag stop dock definida</li></li><li>Não existe definição de estágio de cura para a conta informada</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}},"delete":{"tags":["Marcação de parada de acumulação"],"summary":"Remove a marcação de um estágio de cura de uma conta","description":"Remove a marcação de um estágio de cura de uma conta","operationId":"removeMarking","parameters":[{"name":"id","in":"path","description":"Código de identificação da conta","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}}},"400":{"description":"Bad Request"},"404":{"description":"Not Found. Mensagens possíveis:<ul><li>Conta não encontrada para o código de identificação informado</li></ul>"},"422":{"description":"Unprocessable Entity. Mensagens possíveis:<ul><li>Não existe definição de estágio de cura para conta informada</li>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}}},"/api/products/{productId}/operations/{operationId}/origination-costs":{"delete":{"tags":["Custo de Operação"],"summary":"Permite a remoção de uma vinculação específica entre um produto e uma operação financeira.","description":"Permite a remoção de uma vinculação específica entre um produto e uma operação financeira, garantindo que apenas o item correspondente aos identificadores do produto e da operação fornecidos seja excluído.","operationId":"delete","parameters":[{"name":"productId","in":"path","description":"Identificador do produto","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","description":"Identificador da operação financeira","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"422":{"description":"<p>Bad Request. Possíveis causas:</p>\n<ul>\n    <li>Não é possível remover a vinculação.</li>\n</ul>\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}},"post":{"tags":["Custo de Operação"],"summary":"Cria uma vinculação entre produto e uma operação financeira com o seu custo de originação associado.","description":"Permite a criação de uma vinculação específica entre um produto e uma operação financeira  com um custo de originação associado.","operationId":"save","parameters":[{"name":"productId","in":"path","description":"Identificador do produto","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","description":"Identificador da operação financeira","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginCostRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginCostResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"422":{"description":"<p>Bad Request. Possíveis causas:</p>\n<ul>\n    <li>Não é possível atualizar essa vinculação.</li>\n</ul>\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}},"patch":{"tags":["Custo de Operação"],"summary":"Atualiza a vinculação existente entre um produto e uma operação financeira com o seu custo de originação associado.","description":"Permite a atualização de uma vinculação específica entre um produto e uma operação financeira com um custo de originação associado, garantindo que apenas o item, correspondente aos identificadores do produto e da operação fornecidos, seja atualizado.","operationId":"patch","parameters":[{"name":"productId","in":"path","description":"Identificador do produto (convênio)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","description":"Identificador da operação financeira","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginCostRequest"}}},"required":true},"responses":{"200":{"description":"Objeto de resposta atualizado  representando uma vinculação existente entre um produto e uma operação financeira com o seu custo de originação associado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginCostResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"422":{"description":"<p>Bad Request. Possíveis causas:</p>\n<ul>\n    <li>Não é possível atualizar essa vinculação.</li>\n</ul>\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}},"get":{"tags":["Custo de Operação"],"summary":"Listar vinculação existente entre um produto e uma operação financeira com o seu custo de originação associado.","description":"Recupera a vinculação existente entre um produto e uma operação financeira com o seu custo de originação associado a partir dos identificadores do produto e da operação financeira.","operationId":"find","parameters":[{"name":"productId","in":"path","description":"Identificador do produto (convênio)","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","description":"Identificador da operação financeira","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Objeto de resposta representando uma vinculação existente entre um produto e uma operação financeira com o seu custo de originação associado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginCostResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}}},"/api/products/operations/origination-costs":{"get":{"tags":["Custo de Operação"],"summary":"Listar as vinculações existentes entre  produto e operação financeira com os seus custos de originação associados.","description":"Recupera as vinculações de produtos e operações financeiras com seus custos de originação, sendo possível filtragem de dados a partir dos identificadores do produto (convênio) e da operação financeira, assim como do valor de custo de originação associado (valores do mínimo ao máximo).","operationId":"findAll","parameters":[{"name":"page","in":"query","description":"Página a ser mostrada (inicia em 0)","required":false,"schema":{"minimum":0,"type":"string","description":"Página a ser mostrada (inicia em 0)","example":0,"default":"0"},"example":0},{"name":"limit","in":"query","description":"Quantidade de elementos em cada página","required":false,"schema":{"maximum":50,"minimum":1,"type":"string","description":"Quantidade de elementos em cada página","example":50,"default":"50"},"example":50},{"name":"sort","in":"query","description":"Nome do campo a ser utilizado na ordenação","required":true,"schema":{"type":"string","description":"Nome do campo a ser utilizado na ordenação","example":"id"},"example":"id"},{"name":"order","in":"query","description":"Direção da ordenação. Utilize ASC para ordenação ascendente e DESC para descendente. Padrão ASC. Sem distinção de maiúsculas e minúsculas","required":false,"schema":{"type":"string","description":"Direção da ordenação. Utilize ASC para ordenação ascendente e DESC para descendente. Padrão ASC. Sem distinção de maiúsculas e minúsculas","example":"desc","default":"asc","enum":["asc","desc"]},"example":"desc"},{"name":"operation_id","in":"query","description":"Filtra as vinculações pela operação financeira.","required":false,"schema":{"type":"integer","description":"id da operação financeira","format":"int64","example":123},"example":123},{"name":"product_id","in":"query","description":"Filtra as vinculações pelo produto (convênio) específico.","required":false,"schema":{"type":"integer","description":"id do produto (convênio)","format":"int64","example":123},"example":123},{"name":"cost_min","in":"query","description":"Filtra as vinculações com custo de originação associado maior ou igual ao valor especificado.","required":false,"schema":{"type":"number","description":"Valor mínimo do custo de originação associado","format":"money","example":123.0},"example":123.0},{"name":"cost_max","in":"query","description":"Filtra as vinculações com custo de originação associado menor ou igual ao valor especificado.","required":false,"schema":{"type":"number","description":"Valor máximo do custo de originação associado","format":"money","example":123.0},"example":123.0}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOriginCostResponse"}}}},"400":{"description":"<p>Bad Request. Possíveis causas:</p>\n<ul>\n    <li>Valor informado do identificador da operação inválido.</li>\n    <li>Valor informado do identificador do produto inválido.</li>\n    <li>Valor informado do custo de originação inválido.</li>\n</ul>\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformApiError"}}}}}}}},"components":{"schemas":{"AccrualStopMarkingPersist":{"required":["issuer_stage"],"type":"object","properties":{"issuer_stage":{"type":"integer","description":"Estágio para inclusão Stop Accrual","format":"int32","example":1}},"description":"Objeto de requisição para inclusão de estágio"},"CuringStagePersist":{"required":["curing_stage"],"type":"object","properties":{"curing_stage":{"type":"integer","description":"Estágio de cura","format":"int32","example":1}},"description":"Objeto de requisição para inclusão de estágio"},"AccrualStopMarkingResponse":{"type":"object","properties":{"id":{"type":"integer","description":"Código de identificação da marcação de parada de acumulação","format":"int64","example":1},"account_id":{"type":"integer","description":"Código de identificação da conta","format":"int64","example":1},"dock_flag_stop":{"type":"boolean","description":"Marcação realizada pela Dock","example":false},"dock_update_date":{"type":"string","description":"Data de marcação realizada pela Dock","format":"date-time","example":"2023-12-15T11:00:00Z"},"issuer_stage":{"type":"integer","description":"Estagio incluido pelo emissor","format":"int32","example":1},"issuer_update_date":{"type":"string","description":"Data de marcação realizada pelo emissor","format":"date-time","example":"2023-12-15T11:00:00Z"},"curing_stage":{"type":"integer","description":"Estagio de cura","format":"int32","example":1}},"description":"Objeto de resposta de marcação do Stop Accrual"},"PlatformApiError":{"type":"object","properties":{"error":{"required":["code","description","id"],"type":"object","properties":{"id":{"type":"string","description":"Código rastreador da requisição","example":"a3e6e02b-8f20-4c4e-8e40-c4aa8083d070"},"description":{"type":"string","description":"Descrição amigável do erro","example":"Dado informado inválido"},"code":{"type":"string","description":"Código do erro. Em caso de erro negocial, este campo assume o seguinte formato: [APP]-[CODE]. Para demais erros, será preenchido com o código de status HTTP","example":"DOCK-0001-RNF"},"error_details":{"uniqueItems":true,"type":"array","description":"Descrição de cada campo que possui um erro de contrato","items":{"$ref":"#/components/schemas/PlatformApiErrorDetail"}}},"description":"Resultado de erro para uma chamada http"}}},"PlatformApiErrorDetail":{"required":["attribute","messages"],"type":"object","properties":{"attribute":{"type":"string","description":"Nome do atributo que originou o erro","example":"birthdate"},"messages":{"uniqueItems":true,"type":"array","description":"Lista de causas do erro","example":["INVALID_FORMAT"],"items":{"type":"string","description":"Lista de causas do erro","example":"[\"INVALID_FORMAT\"]","enum":["INVALID_DATA_TYPE","INVALID_LENGTH","INVALID_FORMAT","INVALID_VALUE","REQUIRED_ATTRIBUTE_MISSING"]}}},"description":"Contém informações sobre erros de contrato"},"AccrualStopMarkingUpdate":{"required":["issuer_stage"],"type":"object","properties":{"issuer_stage":{"type":"integer","description":"Estágio para atualizar a marcação de dívida","format":"int32","example":1}},"description":"Objeto para atualização de estágio"},"SortRequest":{"required":["sort"],"type":"object","properties":{"sort":{"type":"string","description":"Nome do campo a ser utilizado na ordenação","example":"id"},"order":{"type":"string","description":"Direção da ordenação. Utilize ASC para ordenação ascendente e DESC para descendente. Padrão ASC. Sem distinção de maiúsculas e minúsculas","example":"desc","default":"asc","enum":["ASC","DESC","asc","desc"]}},"description":"Ordenação da lista de dados. Ordenação padrão é ascendente"},"Ordination":{"type":"object","properties":{"sort":{"type":"string","description":"Nome do campo utilizado na ordenação","example":"id"},"order":{"type":"string","description":"Direção utilizada na ordenação","example":"desc","enum":["asc","desc"]}},"description":"Metadados da ordenação"},"PageMetadataResponse":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"ordination":{"$ref":"#/components/schemas/Ordination"}},"description":"Metadados da listagem"},"Pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Página atual (inicia em 0)","format":"int32"},"limit":{"type":"integer","description":"Quantidade de elementos em cada página, não necessariamente igual ao tamanho da página atual","format":"int32"},"first":{"type":"boolean","description":"Flag que sinaliza se a página atual é a primeira"},"last":{"type":"boolean","description":"Flag que sinaliza se a página atual é a última"},"total_elements_count":{"type":"integer","description":"Quantidade total de elementos","format":"int64"},"page_count":{"type":"integer","description":"Quantidade de páginas resultantes","format":"int32"}},"description":"Metadados da paginação"},"PageResponseAccrualStopMarkingResponse":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/PageMetadataResponse"},"content":{"type":"array","description":"Conteúdo da página (pode ser vazio)","items":{"$ref":"#/components/schemas/AccrualStopMarkingResponse"}}},"description":"Conteúdo paginado"},"OriginCostRequest":{"type":"object","properties":{"cost":{"type":"number","description":"Custo","format":"money","example":123.0}},"description":"Objeto de requisição representando uma vinculação existente entre um produto e uma operação financeira com seu custo de originação associado."},"OriginCostResponse":{"type":"object","properties":{"id":{"type":"integer","description":"Código identificador da vinculação de produto e operação","format":"int64","example":1},"operation_id":{"type":"integer","description":"Código identificador da operação financeira","format":"int64","example":1},"product_id":{"type":"integer","description":"Código identificador do produto (convênio)","format":"int64","example":1},"cost":{"type":"number","description":"Valor do custo de originação associado","format":"money","example":123.0}},"description":"Objeto de resposta representando uma vinculação existente entre um produto e uma operação financeira com seu custo de originação associado."},"PageOriginCostResponse":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/PageMetadataResponse"},"content":{"type":"array","description":"Conteúdo da página (pode ser vazio)","items":{"$ref":"#/components/schemas/OriginCostResponse"}}},"description":"Conteúdo paginado"}},"securitySchemes":{"access_token":{"type":"apiKey","name":"access_token","in":"header"},"client_id":{"type":"apiKey","name":"client_id","in":"header"}}}}