vendor/crosiersource/crosierlib-radx/src/Entity/Financeiro/Movimentacao.php line 111

Open in your IDE?
  1. <?php
  3. namespace CrosierSource\CrosierLibRadxBundle\Entity\Financeiro;
  5. use ApiPlatform\Core\Annotation\ApiFilter;
  6. use ApiPlatform\Core\Annotation\ApiResource;
  7. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\BooleanFilter;
  8. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\DateFilter;
  9. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\OrderFilter;
  10. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\RangeFilter;
  11. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\SearchFilter;
  12. use ApiPlatform\Core\Serializer\Filter\PropertyFilter;
  13. use CrosierSource\CrosierLibBaseBundle\ApiPlatform\Filter\NotLikeFilter;
  14. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\EntityHandler;
  15. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\NotUppercase;
  16. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\TrackDateOnly;
  17. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\TrackedEntity;
  18. use CrosierSource\CrosierLibBaseBundle\Entity\EntityId;
  19. use CrosierSource\CrosierLibBaseBundle\Entity\EntityIdTrait;
  20. use CrosierSource\CrosierLibBaseBundle\Utils\StringUtils\StringUtils;
  21. use DateTime;
  22. use Doctrine\ORM\Mapping as ORM;
  23. use Symfony\Component\Serializer\Annotation\Groups;
  24. use Symfony\Component\Serializer\Annotation\MaxDepth;
  25. use Symfony\Component\Serializer\Annotation\SerializedName;
  26. use Symfony\Component\Validator\Constraints as Assert;
  28. /**
  29.  * Entidade 'Movimentação'.
  30.  *
  31.  * @ApiResource(
  32.  *     shortName="Financeiro/Movimentacao",
  33.  *     normalizationContext={"groups"={"movimentacao","fatura","modo","banco","operadoraCartao","bandeiraCartao","carteira","categoria","grupoItem","grupo","entityId"},"enable_max_depth"=true},
  34.  *     denormalizationContext={"groups"={"movimentacao"},"enable_max_depth"=true},
  35.  *
  36.  *     itemOperations={
  37.  *          "get"={"path"="/fin/movimentacao/{id}", "security"="is_granted('ROLE_FINAN')"},
  38.  *          "put"={"path"="/fin/movimentacao/{id}", "security"="is_granted('ROLE_FINAN')"},
  39.  *          "delete"={"path"="/fin/movimentacao/{id}", "security"="is_granted('ROLE_FINAN_ADMIN')"}
  40.  *     },
  41.  *     collectionOperations={
  42.  *          "get"={"path"="/fin/movimentacao", "security"="is_granted('ROLE_FINAN')"},
  43.  *          "post"={"path"="/fin/movimentacao", "security"="is_granted('ROLE_FINAN')"}
  44.  *     },
  45.  *
  46.  *     attributes={
  47.  *          "pagination_items_per_page"=10,
  48.  *          "formats"={"jsonld", "csv"={"text/csv"}}
  49.  *     }
  50.  *
  51.  * )
  52.  * @ApiFilter(PropertyFilter::class)
  53.  *
  54.  * @ApiFilter(SearchFilter::class,
  55.  *     properties={
  56.  *     "id": "exact",
  57.  *     "fatura": "exact",
  58.  *     "descricao": "partial",
  59.  *     "categoria": "exact",
  60.  *     "categoria.codigoSuper": "exact",
  61.  *     "carteira": "exact",
  62.  *     "carteira.codigo": "exact",
  63.  *     "modo": "exact",
  64.  *     "status": "exact",
  65.  *     "centroCusto": "exact",
  66.  *     "grupoItem": "exact",
  67.  *     "chequeNumCheque": "exact",
  68.  *     "dtMoviment": "exact"
  69.  * })
  70.  *
  71.  * @ApiFilter(DateFilter::class, properties={
  72.  *     "dtMoviment",
  73.  *     "dtUtil",
  74.  *     "dtVenctoEfetiva",
  75.  *     "dtVencto",
  76.  *     "dtPagto"
  77.  * })
  78.  *
  79.  * @ApiFilter(RangeFilter::class, properties={"valorTotal"})
  80.  *
  81.  * @ApiFilter(BooleanFilter::class, properties={
  82.  *     "recorrente"
  83.  * })
  84.  *
  85.  * @ApiFilter(OrderFilter::class, properties={
  86.  *     "id",
  87.  *     "descricao",
  88.  *     "dtUtil",
  89.  *     "dtVencto",
  90.  *     "dtVenctoEfetiva",
  91.  *     "dtPagto",
  92.  *     "valor",
  93.  *     "valorTotal",
  94.  *     "carteira.codigo",
  95.  *     "categoria.codigo",
  96.  *     "categoria.codigoSuper",
  97.  *     "modo.codigo",
  98.  *     "updated"
  99.  * }, arguments={"orderParameterName"="order"})
  100.  *
  101.  * @ApiFilter(NotLikeFilter::class, properties={"status"})
  102.  *
  103.  * @EntityHandler(entityHandlerClass="CrosierSource\CrosierLibRadxBundle\EntityHandler\Financeiro\MovimentacaoEntityHandler")
  104.  *
  105.  * @ORM\Entity(repositoryClass="CrosierSource\CrosierLibRadxBundle\Repository\Financeiro\MovimentacaoRepository")
  106.  * @ORM\Table(name="fin_movimentacao")
  107.  * @TrackedEntity
  108.  *
  109.  * @author Carlos Eduardo Pauluk
  110.  */
  111. class Movimentacao implements EntityId
  112. {
  114.     const ALL_SERIAL_GROUPS = ['movimentacao', 'modo', 'banco', 'tipoLancto', 'carteira', 'categoria', 'centroCusto', 'grupoItem', 'operadoraCartao', 'bandeiraCartao', 'cadeia', 'fatura'];
  116.     use EntityIdTrait;
  118.     /**
  119.      * @Groups("movimentacao")
  120.      * @ORM\Column(name="uuid", type="string", nullable=true)
  121.      * @NotUppercase()
  122.      */
  123.     public ?string $UUID = null;
  125.     /**
  126.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Fatura", inversedBy="movimentacoes")
  127.      * @ORM\JoinColumn(name="fatura_id", nullable=true)
  128.      * @Groups("movimentacao")
  129.      * @MaxDepth(2)
  130.      */
  131.     public ?Fatura $fatura = null;
  133.     /**
  134.      * @ORM\Column(name="fatura_ordem", type="integer", nullable=true)
  135.      * @Groups("movimentacao")
  136.      */
  137.     public ?int $faturaOrdem = null;
  139.     /**
  140.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Modo")
  141.      * @ORM\JoinColumn(name="modo_id")
  142.      * @Groups("movimentacao")
  143.      */
  144.     public ?Modo $modo = null;
  146.     /**
  147.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Banco")
  148.      * @ORM\JoinColumn(name="documento_banco_id", nullable=true)
  149.      * @Groups("movimentacao")
  150.      */
  151.     public ?Banco $documentoBanco = null;
  153.     /**
  154.      * @ORM\Column(name="documento_num", type="string", length=200, nullable=true)
  155.      * @Groups("movimentacao")
  156.      */
  157.     public ?string $documentoNum = null;
  159.     /**
  160.      * CPF/CNPJ de quem paga esta movimentação.
  161.      *
  162.      * @ORM\Column(name="sacado_documento", type="string", nullable=true)
  163.      * @Groups("movimentacao")
  164.      */
  165.     public ?string $sacadoDocumento = null;
  167.     /**
  168.      * Nome/Razão Social de quem paga esta movimentação.
  169.      *
  170.      * @ORM\Column(name="sacado_nome", type="string", nullable=true)
  171.      * @Groups("movimentacao")
  172.      */
  173.     public ?string $sacadoNome = null;
  175.     /**
  176.      * CPF/CNPJ de quem recebe esta movimentação.
  177.      *
  178.      * @ORM\Column(name="cedente_documento", type="string", nullable=true)
  179.      * @Groups("movimentacao")
  180.      */
  181.     public ?string $cedenteDocumento = null;
  183.     /**
  184.      * Nome/Razão Social de quem recebe esta movimentação.
  185.      *
  186.      * @ORM\Column(name="cedente_nome", type="string", nullable=true)
  187.      * @Groups("movimentacao")
  188.      */
  189.     public ?string $cedenteNome = null;
  191.     /**
  192.      * @ORM\Column(name="quitado", type="boolean", nullable=true)
  193.      * @Groups("movimentacao")
  194.      */
  195.     public ?bool $quitado = false;
  197.     /**
  198.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Movimentacao")
  199.      * @ORM\JoinColumn(name="movimentacao_pagante_id", nullable=true)
  200.      * @Groups("movimentacao")
  201.      * @MaxDepth(1)
  202.      */
  203.     public ?Movimentacao $movimentacaoPagante = null;
  205.     /**
  206.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\TipoLancto")
  207.      * @ORM\JoinColumn(name="tipo_lancto_id", nullable=true)
  208.      * @Groups("movimentacao")
  209.      */
  210.     public ?TipoLancto $tipoLancto = null;
  212.     /**
  213.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Carteira")
  214.      * @ORM\JoinColumn(name="carteira_id")
  215.      * @Groups("movimentacao")
  216.      * @MaxDepth(2)
  217.      */
  218.     public ?Carteira $carteira = null;
  220.     /**
  221.      * Carteira informada em casos de TRANSF_PROPRIA.
  222.      *
  223.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Carteira")
  224.      * @ORM\JoinColumn(name="carteira_destino_id", nullable=true)
  225.      * @Groups("movimentacao")
  226.      * @MaxDepth(2)
  227.      */
  228.     public ?Carteira $carteiraDestino = null;
  230.     /**
  231.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Categoria")
  232.      * @ORM\JoinColumn(name="categoria_id")
  233.      * @Groups("movimentacao")
  234.      * @MaxDepth(2)
  235.      */
  236.     public ?Categoria $categoria = null;
  238.     /**
  239.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\CentroCusto")
  240.      * @ORM\JoinColumn(name="centrocusto_id", nullable=true)
  241.      * @Groups("movimentacao")
  242.      */
  243.     public ?CentroCusto $centroCusto = null;
  245.     /**
  246.      * Caso seja uma movimentação agrupada em um Grupo de Movimentação (item).
  247.      *
  248.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\GrupoItem", inversedBy="movimentacoes")
  249.      * @ORM\JoinColumn(name="grupo_item_id", nullable=true)
  250.      * @Groups("movimentacao")
  251.      * @MaxDepth(2)
  252.      */
  253.     public ?GrupoItem $grupoItem = null;
  255.     /**
  256.      * @ORM\Column(name="status", type="string", length=50, nullable=true)
  257.      * @Groups("movimentacao")
  258.      */
  259.     public ?string $status = null;
  261.     /**
  262.      * @ORM\Column(name="descricao", type="string", length=500)
  263.      * @Groups("movimentacao")
  264.      */
  265.     public ?string $descricao = null;
  267.     /**
  268.      * Data em que a movimentação efetivamente aconteceu.
  269.      *
  270.      * @ORM\Column(name="dt_moviment", type="datetime")
  271.      * @Groups("movimentacao")
  272.      * @TrackDateOnly
  273.      */
  274.     public ?DateTime $dtMoviment = null;
  276.     /**
  277.      * Data prevista para pagamento.
  278.      *
  279.      * @ORM\Column(name="dt_vencto", type="datetime")
  280.      * @Groups("movimentacao")
  281.      * @TrackDateOnly
  282.      */
  283.     public ?DateTime $dtVencto = null;
  285.     /**
  286.      * Data prevista (postergando para dia útil) para pagamento.
  287.      *
  288.      * @ORM\Column(name="dt_vencto_efetiva", type="datetime")
  289.      * @Groups("movimentacao")
  290.      * @TrackDateOnly
  291.      */
  292.     public ?DateTime $dtVenctoEfetiva = null;
  294.     /**
  295.      * Data em que a movimentação foi paga.
  296.      *
  297.      * @ORM\Column(name="dt_pagto", type="datetime", nullable=true)
  298.      * @Groups("movimentacao")
  299.      * @TrackDateOnly
  300.      */
  301.     public ?DateTime $dtPagto = null;
  303.     /**
  304.      * Se dtPagto != null ? dtPagto : dtVencto.
  305.      *
  306.      * @ORM\Column(name="dt_util", type="datetime", nullable=true)
  307.      * @Groups("movimentacao")
  308.      * @TrackDateOnly
  309.      */
  310.     public ?DateTime $dtUtil = null;
  312.     /**
  313.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Banco")
  314.      * @ORM\JoinColumn(name="cheque_banco_id", nullable=true)
  315.      * @Groups("movimentacao")
  316.      */
  317.     public ?Banco $chequeBanco = null;
  319.     /**
  320.      * Código da agência (sem o dígito verificador).
  321.      *
  322.      * @ORM\Column(name="cheque_agencia", type="string", length=30, nullable=true)
  323.      * @Groups("movimentacao")
  324.      */
  325.     public ?string $chequeAgencia = null;
  327.     /**
  328.      * Número da conta no banco (não segue um padrão).
  329.      *
  330.      * @ORM\Column(name="cheque_conta", type="string", length=30, nullable=true)
  331.      * @Groups("movimentacao")
  332.      */
  333.     public ?string $chequeConta = null;
  335.     /**
  336.      * @ORM\Column(name="cheque_num_cheque", type="string", length=30, nullable=true)
  337.      * @Groups("movimentacao")
  338.      */
  339.     public ?string $chequeNumCheque = null;
  341.     /**
  342.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\OperadoraCartao")
  343.      * @ORM\JoinColumn(name="operadora_cartao_id", nullable=true)
  344.      * @Groups("movimentacao")
  345.      * @MaxDepth(2)
  346.      */
  347.     public ?OperadoraCartao $operadoraCartao = null;
  349.     /**
  350.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\BandeiraCartao")
  351.      * @ORM\JoinColumn(name="bandeira_cartao_id", nullable=true)
  352.      * @Groups("movimentacao")
  353.      */
  354.     public ?BandeiraCartao $bandeiraCartao = null;
  356.     /**
  357.      * Geralmente o NSU.
  358.      *
  359.      * @ORM\Column(name="id_transacao_cartao", type="string", nullable=true)
  360.      * @Groups("movimentacao")
  361.      */
  362.     public ?string $idTransacaoCartao = null;
  364.     /**
  365.      * Número do cartão, geralmente identificado como: **** **** **** 1234
  366.      * @ORM\Column(name="num_cartao", type="string", nullable=true)
  367.      * @Groups("movimentacao")
  368.      */
  369.     public ?string $numCartao = null;
  371.     /**
  372.      * @ORM\Column(name="recorrente", type="boolean", nullable=true)
  373.      * @Groups("movimentacao")
  374.      */
  375.     public ?bool $recorrente = false;
  377.     /**
  378.      * @ORM\Column(name="recorr_frequencia", type="string", length=50, nullable=true)
  379.      * @Groups("movimentacao")
  380.      */
  381.     public ?string $recorrFrequencia = null;
  383.     /**
  384.      * @ORM\Column(name="recorr_tipo_repet", type="string", length=50, nullable=true)
  385.      * @Groups("movimentacao")
  386.      */
  387.     public ?string $recorrTipoRepet = null;
  389.     /**
  390.      * Utilizar 32 para marcar o último dia do mês.
  391.      *
  392.      * @ORM\Column(name="recorr_dia", type="integer", nullable=true)
  393.      * @Groups("movimentacao")
  394.      */
  395.     public ?int $recorrDia = null;
  397.     /**
  398.      * Utilizado para marcar a variação em relação ao dia em que seria o vencimento.
  399.      * Exemplo: dia=32 (último dia do mês) + variacao=-2 >>> 2 dias antes do último dia do mês
  400.      *
  401.      * @ORM\Column(name="recorr_variacao", type="integer", nullable=true)
  402.      * @Groups("movimentacao")
  403.      */
  404.     public ?int $recorrVariacao = null;
  406.     /**
  407.      * Valor bruto da movimentação.
  408.      *
  409.      * @ORM\Column(name="valor", type="decimal", precision=15, scale=2)
  410.      * @Groups("N")
  411.      * @Assert\Type(type="string")
  412.      */
  413.     public ?string $valor = null;
  415.     /**
  416.      * Possíveis descontos (sempre negativo).
  417.      *
  418.      * @ORM\Column(name="descontos", type="decimal", precision=15, scale=2, nullable=true)
  419.      * @Groups("N")
  420.      * @Assert\Type(type="string")
  421.      */
  422.     public ?string $descontos = null;
  424.     /**
  425.      * Possíveis acréscimos (sempre positivo).
  426.      *
  427.      * @ORM\Column(name="acrescimos", type="decimal", precision=15, scale=2, nullable=true)
  428.      * @Groups("N")
  429.      * @Assert\Type(type="string")
  430.      */
  431.     public ?string $acrescimos = null;
  433.     /**
  434.      * @ORM\Column(name="valor_total", type="decimal", precision=15, scale=2)
  435.      * @Groups("N")
  436.      * @Assert\Type(type="string")
  437.      */
  438.     public ?string $valorTotal = null;
  440.     /**
  441.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Cadeia", inversedBy="movimentacoes")
  442.      * @ORM\JoinColumn(name="cadeia_id", referencedColumnName="id", nullable=true)
  443.      * @Groups("movimentacao")
  444.      * @MaxDepth(2)
  445.      */
  446.     public ?Cadeia $cadeia = null;
  448.     /**
  449.      * @ORM\Column(name="parcelamento", type="boolean", nullable=true)
  450.      * @Groups("movimentacao")
  451.      */
  452.     public ?bool $parcelamento = false;
  454.     /**
  455.      * O número da parcela.
  456.      *
  457.      * @ORM\Column(name="parcela_num", type="integer", nullable=true)
  458.      * @Groups("movimentacao")
  459.      */
  460.     public ?int $parcelaNum = null;
  462.     /**
  463.      * A qtde total de parcelas.
  464.      *
  465.      * @ORM\Column(name="qtde_parcelas", type="integer", nullable=true)
  466.      * @Groups("movimentacao")
  467.      */
  468.     public ?int $qtdeParcelas = null;
  471.     /**
  472.      * Caso a movimentação faça parte de uma cadeia, informa em qual posição.
  473.      * Não deve ser utilizado para armazenar o número da parcela, pois a cadeia pode conter mais movimentações que o
  474.      * número de parcelas do parcelamento.
  475.      *
  476.      * @ORM\Column(name="cadeia_ordem", type="integer", nullable=true)
  477.      * @Groups("movimentacao")
  478.      */
  479.     public ?int $cadeiaOrdem = null;
  481.     /**
  482.      * Informa o total de movimentações na cadeia.
  483.      *
  484.      * @ORM\Column(name="cadeia_qtde", type="integer", nullable=true)
  485.      * @Groups("movimentacao")
  486.      */
  487.     public ?int $cadeiaQtde = null;
  489.     /**
  490.      * @ORM\Column(name="obs", type="string", length=5000, nullable=true)
  491.      * @Groups("movimentacao")
  492.      */
  493.     public ?string $obs = null;
  495.     /**
  496.      * Marcador para agrupar movimentações que foram importadas juntas.
  497.      *
  498.      * @Groups("movimentacao")
  499.      * @ORM\Column(name="uuid_importacao", type="string", nullable=true)
  500.      * @NotUppercase()
  501.      */
  502.     public ?string $uuidImportacao = null;
  504.     /**
  505.      * @ORM\Column(name="json_data", type="json", nullable=true)
  506.      * @NotUppercase()
  507.      * @Groups("movimentacao")
  508.      */
  509.     public ?array $jsonData = null;
  512.     /**
  513.      * @Groups("movimentacao")
  514.      * @return null|string
  515.      */
  516.     public function getSacado(): ?string
  517.     {
  518.         if ($this->sacadoDocumento && $this->sacadoNome) {
  519.             return StringUtils::mascararCnpjCpf($this->sacadoDocumento) . ' - ' . $this->sacadoNome;
  520.         }
  521.         return null;
  522.     }
  525.     /**
  526.      * @Groups("movimentacao")
  527.      * @return null|string
  528.      */
  529.     public function getCedente(): ?string
  530.     {
  531.         if ($this->cedenteDocumento && $this->cedenteNome) {
  532.             return StringUtils::mascararCnpjCpf($this->cedenteDocumento) . ' - ' . $this->cedenteNome;
  533.         }
  534.         return null;
  535.     }
  537.     /**
  538.      * @Groups("movimentacao")
  539.      * @SerializedName("valor")
  540.      * @return null|float
  541.      */
  542.     public function getValorFormatted(): ?float
  543.     {
  544.         return (float)$this->valor;
  545.     }
  547.     /**
  548.      * @Groups("movimentacao")
  549.      * @SerializedName("valor")
  550.      * @param null|float $valor
  551.      */
  552.     public function setValorFormatted(?float $valor)
  553.     {
  554.         $this->valor = $valor;
  555.     }
  558.     /**
  559.      * @Groups("movimentacao")
  560.      * @SerializedName("descontos")
  561.      * @return null|float
  562.      */
  563.     public function getDescontosFormatted(): ?float
  564.     {
  565.         return (float)$this->descontos;
  566.     }
  568.     /**
  569.      * @Groups("movimentacao")
  570.      * @SerializedName("descontos")
  571.      * @param null|float $descontos
  572.      */
  573.     public function setDescontosFormatted(?float $descontos)
  574.     {
  575.         $this->descontos = $descontos;
  576.     }
  579.     /**
  580.      * @Groups("movimentacao")
  581.      * @SerializedName("acrescimos")
  582.      * @return null|float
  583.      */
  584.     public function getAcrescimosFormatted(): ?float
  585.     {
  586.         return (float)$this->acrescimos;
  587.     }
  589.     /**
  590.      * @Groups("movimentacao")
  591.      * @SerializedName("acrescimos")
  592.      * @param null|float $acrescimos
  593.      */
  594.     public function setAcrescimosFormatted(?float $acrescimos)
  595.     {
  596.         $this->acrescimos = $acrescimos;
  597.     }
  600.     /**
  601.      * @Groups("movimentacao")
  602.      * @SerializedName("valorTotal")
  603.      * @return null|float
  604.      */
  605.     public function getValorTotalFormatted(): ?float
  606.     {
  607.         return (float)$this->valorTotal;
  608.     }
  610.     /**
  611.      * @Groups("movimentacao")
  612.      * @SerializedName("valorTotal")
  613.      * @param null|float $valorTotal
  614.      */
  615.     public function setValorTotalFormatted(?float $valorTotal)
  616.     {
  617.         $this->valorTotal = $valorTotal;
  618.     }
  621.     /**
  622.      * @Groups("movimentacao")
  623.      * @return string
  624.      */
  625.     public function getDescricaoMontada(): string
  626.     {
  627.         $sufixo = '';
  629.         if ($this->parcelamento || ($this->qtdeParcelas && $this->parcelaNum)) {
  630.             $zerosfill = strlen('' . $this->qtdeParcelas);
  631.             $zerosfill = $zerosfill < 2 ? 2 : $zerosfill;
  632.             $sufixo .= ' (' . str_pad($this->parcelaNum ?? 0, $zerosfill, '0', STR_PAD_LEFT) . '/' . str_pad($this->qtdeParcelas ?? 0, $zerosfill, '0', STR_PAD_LEFT) . ')';
  633.         }
  635.         if ($this->documentoNum) {
  636.             $sufixo .= ' (Doc: ' . $this->documentoNum . ')';
  637.         }
  639.         if ($this->chequeNumCheque) {
  640.             $nomeBanco = '';
  641.             if ($this->chequeBanco) {
  642.                 $nomeBanco = $this->chequeBanco->nome . ' - ';
  643.             }
  644.             $sufixo .= '<br /> (CHQ: ' . $nomeBanco . 'nº ' . $this->chequeNumCheque . ')';
  645.         }
  647.         if ($this->bandeiraCartao || $this->operadoraCartao) {
  648.             if ($this->bandeiraCartao) {
  649.                 $sufixo .= ' (Bandeira: ' . $this->bandeiraCartao->descricao . ')';
  650.                 if (!$this->operadoraCartao) {
  651.                     $sufixo .= ' (Operadora não informada)';
  652.                 }
  653.             }
  654.             if ($this->operadoraCartao) {
  655.                 $sufixo .= ' (Operadora: ' . $this->operadoraCartao->descricao . ')';
  656.                 if (!$this->bandeiraCartao) {
  657.                     $sufixo .= ' (Bandeira não informada)';
  658.                 }
  659.             }
  660.         }
  663.         if ($this->numCartao) {
  664.             $sufixo .= ' (**** ' . $this->numCartao . ')';
  665.         }
  667.         return $this->descricao . $sufixo;
  668.     }
  671.     /**
  672.      * Calcula e seta o valor total.
  673.      */
  674.     public function calcValorTotal(): void
  675.     {
  676.         $valorTotal = $this->valor + $this->descontos + $this->acrescimos;
  677.         $this->valorTotal = $valorTotal;
  678.     }
  681.     /**
  682.      * Retorna as outras movimentações que fazem parte da mesma cadeia desta.
  683.      *
  684.      * @return array
  685.      */
  686.     public function getOutrasMovimentacoesDaCadeia(): array
  687.     {
  688.         $outrasMovs = [];
  689.         if ($this->cadeia) {
  690.             foreach ($this->cadeia->movimentacoes as $outraMov) {
  691.                 if ($outraMov->getId() !== $this->getId()) {
  692.                     $outrasMovs[] = $outraMov;
  693.                 }
  694.             }
  695.         }
  696.         return $outrasMovs;
  697.     }
  699.     /**
  700.      * @return bool
  701.      * @Groups("movimentacao")
  702.      */
  703.     public function isTransferenciaEntreCarteiras(): bool
  704.     {
  705.         return
  706.             $this->cadeia &&
  707.             $this->cadeia->movimentacoes &&
  708.             $this->cadeia->movimentacoes->count() === 2 &&
  709.             $this->categoria &&
  710.             in_array($this->categoria->codigo, [199, 299], true);
  711.     }
  713.     /**
  714.      * @return bool
  715.      * @Groups("movimentacao")
  716.      */
  717.     public function isTransferenciaEntradaCaixa(): bool
  718.     {
  719.         return
  720.             $this->cadeia &&
  721.             $this->cadeia->movimentacoes &&
  722.             $this->cadeia->movimentacoes->count() === 3 &&
  723.             $this->categoria &&
  724.             in_array($this->categoria->codigo, [101, 102, 199, 299], true);
  725.     }
  727.     /**
  728.      * @return bool
  729.      * @Groups("movimentacao")
  730.      */
  731.     public function isUltimaNaCadeia(): bool
  732.     {
  733.         return
  734.             $this->cadeia &&
  735.             $this->cadeia->movimentacoes &&
  736.             $this->cadeia->movimentacoes->count() === $this->cadeiaOrdem;
  737.     }
  739.     /**
  740.      * Nos casos das movimentações entre carteiras 1.99 ou 2.99...
  741.      * @Groups("movimentacao")
  742.      * @MaxDepth(2)
  743.      *
  744.      * @return null|Movimentacao
  745.      */
  746.     public function getMovimentacaoOposta(): ?Movimentacao
  747.     {
  748.         if ($this->isTransferenciaEntreCarteiras()) {
  749.             return $this->getOutrasMovimentacoesDaCadeia()[0];
  750.         }
  751.         return null;
  752.     }
  753. }