Depósito Não Identificado
DepositoNaoIdentificado
Rotina do módulo Financeiro (submenu Caixa) que permite registrar um “depósito não identificado” — um valor recebido em uma carteira (conta bancária/caixa) sem que a origem/título correspondente tenha sido reconhecido no momento do lançamento.
Visão Geral
Rotina do módulo Financeiro (submenu Caixa) que permite registrar um “depósito não identificado” — um valor recebido em uma carteira (conta bancária/caixa) sem que a origem/título correspondente tenha sido reconhecido no momento do lançamento. O sistema gera a movimentação financeira (débito/crédito) na carteira Logada pelo Usuário e, conforme o fato contábil configurado, realiza a integração contábil automaticamente. A rotina também permite imprimir o comprovante do caixa referente à operação.
Endpoints
POST /DepositoNaoIdentificado/Salvar
Registra um novo depósito não identificado a partir dos dados informados na tela (carteira, valor, data de emissão e documento). Internamente, o valor é lançado como movimentação financeira na carteira de destino, e o sistema realiza a integração contábil automaticamente e conforme o fato contabil banco 39 – DEPÓSITO NÃO IDENTIFICADO (BCODEPNI)
Permissão: coberta pela permissão de acesso à rotina “EditViewDeDepositoNaoIdentificado” (ID 1592) — não há permissão granular própria de “Salvar” nesta versão do sistema.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| dto | DTOCabecalhoDeOperacoes | Sim | Objeto enviado no corpo da requisição. Só os campos abaixo são usados por esta ação; os demais campos do DTO (compartilhado com outras rotinas financeiras) são ignorados. |
| dto.TitulosAProcessar | Lista de DTODeTituloAProcessar | Sim (ao menos 1 item) | Lista de itens a processar; apenas o primeiro item da lista é usado para gerar o depósito. |
| dto.TitulosAProcessar[0].IDDaCarteiraDePagamento | int | Sim | Código da carteira (banco/caixa) onde o depósito será lançado. |
| dto.TitulosAProcessar[0].Valor | decimal | Sim | Valor do depósito, em moeda corrente. Deve ser maior que zero. |
| dto.TitulosAProcessar[0].ValorMoeda | decimal | Sim | Valor do depósito convertido/expresso na moeda estrangeira, quando aplicável. |
| dto.TitulosAProcessar[0].DataEmissao | data | Sim | Data de emissão do depósito (data do lançamento contábil/financeiro). |
| dto.Documento | texto | Não | Número/identificação do documento associado ao depósito. |
“` POST /DepositoNaoIdentificado/Salvar { “Documento”: “12345”, “TitulosAProcessar”: [ { “IDDaCarteiraDePagamento”: 10, “Valor”: 500.00, “ValorMoeda”: 0, “DataEmissao”: “2026-09-10” } ] } “`
“`json { “success”: true, “CodigoDaOperacao”: “0000001234”, “listaDeOperacoesFinanceiras”: [], “listaDeOperacoesContabeis”: [] } “`
POST /DepositoNaoIdentificado/Imprimir
Gera/prepara o arquivo do comprovante de caixa (relatório Crystal Reports “ComprovanteCaixa.rpt”) a ser usado na impressão do comprovante da operação. Se a pasta de destino (`~/DocumentosDoFinanceiro/ComprovanteCaixa/Cliente`) não existir, ela é criada; se o arquivo do relatório ainda não existir nessa pasta, ele é copiado do modelo padrão (`~/DocumentosDoFinanceiro/ComprovanteCaixa/Padrao`).
Permissão: coberta pela permissão de acesso à rotina “EditViewDeDepositoNaoIdentificado” (ID 1592) — não há permissão granular própria de “Imprimir” nesta versão do sistema.
Parâmetros: nenhum (a ação não recebe parâmetros de entrada; opera sobre arquivos fixos do servidor).
“` POST /DepositoNaoIdentificado/Imprimir “`
“`json { “success”: true } “`
Modelos de Dados
DTOCabecalhoDeOperacoes (apenas campos relevantes a esta rotina — o DTO completo é compartilhado com outras rotinas financeiras):
| Campo | Tipo | Descrição |
|---|---|---|
| Documento | texto | Documento associado ao depósito |
| TitulosAProcessar | lista de DTODeTituloAProcessar | Itens a processar; só o primeiro é considerado |
DTODeTituloAProcessar (apenas campos usados por esta rotina — o DTO completo é compartilhado com outras rotinas financeiras):
| Campo | Tipo | Descrição |
|---|---|---|
| IDDaCarteiraDePagamento | int | Carteira (banco/caixa) onde o depósito é lançado |
| Valor | decimal | Valor do depósito em moeda corrente |
| ValorMoeda | decimal | Valor do depósito em moeda estrangeira, quando aplicável |
| DataEmissao | data | Data de emissão do depósito |
Regras de Negócio
- Lista de itens vazia bloqueia o salvamento. Se `TitulosAProcessar` vier vazio ou nulo, a ação não processa nada e lança uma mensagem de erro genérica.Mensagem exibida: “Não foi possível Salvar. Os dados informados podem estar incorretos. Verifique se os dados informados estão corretos.”
- O valor do depósito deve ser maior que zero. Caso contrário, a inclusão é bloqueada.Mensagem exibida: “Não foi possível realizar novo depósito. O valor do depósito deve ser maior que 0. Valor informado : {valor informado}. Informe um valor maior que zero”
- A carteira informada precisa existir. Se o código de carteira não for encontrado, a operação é bloqueada.Mensagem exibida: “Não foi possível obter carteira. A carteira informada não foi encontrada Código informado : {código informado}. Verifique os parâmetros informados”
- A carteira (ou a filial da carteira) precisa estar configurada para receber depósitos não identificados. Se nem a carteira nem sua filial tiverem uma “carteira de depósito não identificado” configurada, a operação é bloqueada.Mensagem exibida: “Não foi possível obter carteira. A carteira e a filial da carteira informada não possuem uma carteira para depósitos não identificados. Configure a carteira {código}-{nome da agência} ou a filial : {filial}”
- Precisa existir um fato contábil configurado para depósito não identificado, e ele precisa estar ativo. Sem isso, a operação é bloqueada.Mensagem exibida (fato não configurado): “Não foi possível obter fato contábil. O fato contábil para depósito não identificado não foi encontrado. Configure o sistema para realizar esta operação”
Mensagem exibida (fato inativo): “Não foi possível obter fato contábil. O fato contábil para depósito não identificado está inativo. Configure o sistema para realizar esta operação” - Integração contábil automática. Após lançar as movimentações financeiras (débito na carteira e crédito na carteira de depósito não identificado), o sistema tenta integrar automaticamente com a contabilidade. Se alguma movimentação gerada não tiver um fato contábil associado, a integração contábil é ignorada silenciosamente (sem erro) e apenas registrada em log.
- Impressão do comprovante depende de um modelo de relatório pré-instalado no servidor (`ComprovanteCaixa.rpt`, pasta “Padrao”). Se o modelo padrão não existir fisicamente no servidor, a cópia falha (erro de arquivo não encontrado, não tratado como mensagem de negócio).
Permissões
Acesso à rotina: “EditViewDeDepositoNaoIdentificado” (ID 1592) — recurso do menu Financeiro, subordinado a “Caixa” (ID 1589).
| Ação | Permissão | ID |
|---|---|---|
| Salvar | coberta por “EditViewDeDepositoNaoIdentificado” | — |
| Imprimir | coberta por “EditViewDeDepositoNaoIdentificado” | — |